如何使用CDI 2为JSF 2.3后台Bean注入SessionMap

嘿，我正好碰到过类似的升级场景，给你梳理下解决思路和正确的用法：

首先，你选的方向是对的——JSF 2.3新增的@SessionMap注解就是为了让CDI Bean能优雅地注入SessionMap，替代之前依赖FacesContext的方式。但可能是几个细节没到位导致没成功，咱们一步步来：

1. 确保依赖与配置正确 #

• JSF 2.3依赖：要使用Mojarra 2.3.x或MyFaces 2.3.x的API和实现，同时确保项目依赖中没有残留JSF 2.2的jar包（避免版本冲突）。
• CDI 2.0实现：比如Weld 3.x（对应Java EE 8），确保容器支持CDI 2.0（比如WildFly 14+、TomEE 8+等）。
• Web.xml配置：JSF 2.3需要Servlet 4.0环境，所以web.xml要声明为Java EE 8版本：

<web-app xmlns="http://xmlns.jcp.org/xml/ns/javaee"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee http://xmlns.jcp.org/xml/ns/javaee/web-app_4_0.xsd"
         version="4.0">
    <!-- 其他JSF配置，比如Faces Servlet、PROJECT_STAGE等 -->
</web-app>

2. 修正Bean的注解与注入代码 #

你之前的代码可能存在两个关键问题：作用域注解的选择和**@SessionMap的正确导入**。下面是修正后的完整代码：

import javax.inject.Named;
import javax.faces.view.ViewScoped; // 注意：是CDI兼容的ViewScoped
import javax.inject.Inject;
import javax.faces.annotation.SessionMap; // JSF 2.3新增的注解
import java.io.Serializable;
import java.util.Map;

@Named("environmentManager")
@ViewScoped
public class EnvironmentManagerBacking implements Serializable {

    @Inject
    @SessionMap
    private Map<String, Object> sessionMap;

    // 示例方法：使用sessionMap读写会话数据
    public void storeSessionData() {
        sessionMap.put("currentEnvironment", "production");
    }

    public String getCurrentEnvironment() {
        return (String) sessionMap.get("currentEnvironment");
    }
}

关键细节说明： #

• @ViewScoped的正确导入：必须用javax.faces.view.ViewScoped，这是JSF 2.3为CDI Bean提供的兼容作用域；旧的javax.faces.bean.ViewScoped是给JSF托管Bean（用@ManagedBean）用的，CDI容器不识别这个注解。
• @SessionMap的导入：要导入javax.faces.annotation.SessionMap，而不是其他自定义或旧的注解，这是JSF 2.3专门为CDI注入SessionMap提供的注解。
• 避免在Bean初始化时依赖FacesContext：之前用FacesContext.getCurrentInstance()拿SessionMap失败，大概率是因为在@PostConstruct或构造方法中调用——此时可能还没有请求上下文，FacesContext还未初始化。而通过@SessionMap注入是由CDI容器负责管理，会在合适的时机注入有效的SessionMap，更可靠。

3. PrimeFaces兼容性检查 #

PrimeFaces 6.2是支持JSF 2.3的，但如果遇到组件渲染异常，可以尝试升级到PrimeFaces 6.2的最新补丁版本，或者确认项目中没有混合其他不兼容的JSF组件库。

内容的提问来源于stack exchange，提问作者Manuel Gnerlich