Jakarta Faces 3.0中ManagedBean获取ServletContext及EL调用问题

问题1：无法获取ServletContext实例访问自定义属性 #

问题现象 #

在ManagedBean中通过FacesContext获取ExternalContext后，调用getContext()强制转换为jakarta.servlet.ServletContext，或调用getApplicationMap()读取自定义属性，均返回null，且无任何报错信息。

原代码示例 #

@ManagedBean
@RequestScoped
public class TestBean {
    // 在构造方法中过早调用FacesContext
    public TestBean() {
        ExternalContext externalContext = FacesContext.getCurrentInstance().getExternalContext();
        ServletContext servletContext = (ServletContext) externalContext.getContext();
        String customAttr = (String) externalContext.getApplicationMap().get("customAttr");
        // 输出均为null
        System.out.println(servletContext.getAttribute("customAttr"));
        System.out.println(customAttr);
    }
}

原因分析 #

1. 生命周期时机错误：在ManagedBean构造方法中调用FacesContext.getCurrentInstance()时，FacesContext尚未完成初始化，导致获取的ExternalContext无效。
2. 自定义属性未正确注入：负责存储属性的ServletContextListener未通过@WebListener注解或web.xml注册，属性根本未存入ServletContext。
3. 依赖冲突：项目同时存在旧版javax.servlet与新版jakarta.servlet API，类加载混淆导致类型转换后实例无效。

规范解决方式 #

1. 在业务方法中访问FacesContext：避免在构造方法中操作上下文，改用请求触发的业务方法：

@ManagedBean
@RequestScoped
public class TestBean {
    public TestBean() {}

    public String accessServletContext() {
        ExternalContext externalContext = FacesContext.getCurrentInstance().getExternalContext();
        // 安全转换并读取属性
        if (externalContext.getContext() instanceof ServletContext servletContext) {
            String attrFromSC = (String) servletContext.getAttribute("customAttr");
            System.out.println("Attr from ServletContext: " + attrFromSC);
        }
        // 直接从applicationMap读取（推荐方式）
        String attrFromAppMap = (String) externalContext.getApplicationMap().get("customAttr");
        System.out.println("Attr from ApplicationMap: " + attrFromAppMap);
        return "result";
    }
}

2. 正确注册ServletContextListener：

@WebListener
public class CustomContextListener implements ServletContextListener {
    @Override
    public void contextInitialized(ServletContextEvent sce) {
        sce.getServletContext().setAttribute("customAttr", "Hello Jakarta EE");
    }
}

3. 清理依赖：移除所有javax.servlet相关依赖，确保仅引入jakarta.servlet.api（版本≥5.0）。

问题2：EL调用带参数方法报「Method not found」错误 #

问题现象 #

JSF页面中使用EL调用ManagedBean的带参数方法时，页面渲染报错：

javax.el.MethodNotFoundException: Method not found: com.example.TestBean@123456.testMethod(java.lang.String)

原代码示例 #

页面代码：

<h:form>
    <h:commandButton value="Test" action="#{testBean.testMethod('testParam')}" />
</h:form>

Bean代码：

@ManagedBean
@RequestScoped
public class TestBean {
    // 参数类型不匹配，且方法为非public
    private void testMethod(Integer param) {
        System.out.println("Param: " + param);
    }
}

原因分析 #

1. 参数类型不匹配：页面传递String类型参数，但Bean方法接收Integer类型，EL无法自动转换时触发方法找不到错误。
2. 方法访问修饰符错误：EL仅能访问public方法，私有/受保护方法无法被EL解析。
3. 作用域错误：Bean未标注有效作用域（如@NoneScoped），导致EL无法定位Bean实例。
4. EL语法错误：参数引号使用错误（如用双引号包裹字符串）或方法签名不匹配。

规范解决方式 #

1. 确保方法签名匹配且为public：

@ManagedBean
@RequestScoped
public class TestBean {
    // 参数类型与页面传递的String匹配
    public String testMethod(String param) {
        System.out.println("Received param: " + param);
        return "success";
    }
}

2. 正确传递不同类型参数：若需传递数值类型，直接在EL中使用数值，无需引号：

<h:commandButton value="Test Number" action="#{testBean.testNumberMethod(123)}" />

对应Bean方法：

public String testNumberMethod(Integer param) {
    System.out.println("Number param: " + param);
    return "success";
}

3. 标注有效作用域：根据业务需求选择@RequestScoped、@ViewScoped等作用域，避免使用@NoneScoped。
4. 规范EL语法：字符串参数用单引号包裹，方法调用格式为#{bean.method(param)}。

内容的提问来源于stack exchange，提问作者Samuel Marchant