OmniFaces o:socket消息发送失败及类型转换异常求助

你遇到的核心问题是混合使用了Mojarra自带的WebSocket Push注解和OmniFaces的o:socket组件，这直接引发了类型转换异常和消息推送无响应的情况。下面是具体的分析和解决方案：

问题根源 #

你的代码中使用了@Push注解，但如果该注解来自Mojarra的com.sun.faces.cdi.Push而非OmniFaces的org.omnifaces.cdi.Push，注入的PushContext会是Mojarra的WebsocketPushContext实现。它和OmniFaces的o:socket依赖的SocketChannelManager管理的Scope完全不兼容，于是出现了ClassCastException（OmniFaces的ViewScope无法转换为Mojarra的ViewScope），同时因上下文不匹配，消息无法正确推送到客户端。

解决方案步骤 #

1. 修正@Push注解的导入 #

确保Bean中使用OmniFaces的@Push注解，移除Mojarra的相关导入：

// 正确导入OmniFaces的Push相关类
import org.omnifaces.cdi.Push;
import org.omnifaces.cdi.PushContext;

2. 修正Bean中的PushContext类型 #

注入OmniFaces标准的PushContext接口，而非Mojarra的实现类：

@ViewScoped
@Named("ButtonController")
public class ButtonController implements Serializable {
    @Inject
    @Push(channel = "someChannel") // 此处@Push必须为OmniFaces的注解
    private PushContext someChannel; // 使用OmniFaces的PushContext接口

    public void onPress(TaskButton button) {
        someChannel.send("someEvent");
        // 发送自定义对象时，需确保对象可JSON序列化（OmniFaces默认用Jackson处理）
        someChannel.send(new YourSerializableObject());
    }
}

3. 移除Mojarra的WebSocket配置 #

OmniFaces的o:socket会自动处理WebSocket端点，无需配置Mojarra自带的WebSocket Servlet。如果你之前在web.xml中配置了以下内容，请移除：

<!-- 移除Mojarra的WebSocket Servlet配置 -->
<!-- <servlet>
    <servlet-name>WebSocket Servlet</servlet-name>
    <servlet-class>com.sun.faces.push.WebSocketServlet</servlet-class>
</servlet>
<servlet-mapping>
    <servlet-name>WebSocket Servlet</servlet-name>
    <url-pattern>/javax.faces.push/*</url-pattern>
</servlet-mapping> -->

4. 确保ViewScope正常工作 #

在Tomcat + Weld环境下，需保证ViewScope配置正确：

• 在web.xml中添加或确认以下参数：

<context-param>
    <param-name>javax.faces.PARTIAL_STATE_SAVING</param-name>
    <param-value>true</param-value>
</context-param>

• 若使用OmniFaces的@ViewScoped，需导入org.omnifaces.cdi.ViewScoped；使用Mojarra的javax.faces.view.ViewScoped也完全兼容o:socket。

5. 增强客户端调试 #

可以在客户端代码中添加更详细的日志，方便确认消息接收状态：

function socketListener(message, channel, event) { 
    console.log("Received message from channel " + channel + ":", message); 
}
function _onopen() { 
    console.log("WebSocket connection opened for channel: someChannel"); 
}

额外注意事项 #

• Tomcat 8.5默认已启用WebSocket支持，无需额外配置，但要确保项目未排除相关依赖。
• 检查浏览器控制台是否有WebSocket连接错误（如404），可查看页面源码中o:socket生成的script标签，确认端点URL是否正确。

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