天天看點

WebSocket在Struts2架構下發生配置沖突

最近在學習WebSocket的時候發現,當使用Struts2架構的時候發現WebSocket連接配接失效,浏覽器Firefox(54.0.1)報錯為:Firefox 無法建立到 ws://localhost/echoSocket 伺服器的連接配接。

WebSocket在Struts2架構下發生配置沖突

當然了,你不用懷疑浏覽器出什麼毛病了,當你使用chrome浏覽器以及高版本的IE(11)浏覽器的時候也報同樣的錯誤。

下面我們就說說為什麼會出現這種錯誤:

首先,你的Struts2在web.xml檔案中的fiter-mapping配置肯定是如下的:

<filter-mapping>
    <fiter-name>struts2</fiter-name>
    <url-pattern>/*</url-pattern>
</filter-mapping>
           

這樣的配置會攔截所有的http協定請求。這時你會問我的協定不是ws協定嗎,為什麼會被攔截?請注意:在實作websocket連線過程中,需要通過浏覽器發出websocket連線請求,然後伺服器發出回應,這個過程通常稱為“握手” 。在 WebSocket API,浏覽器和伺服器隻需要做一個握手的動作,然後,浏覽器和伺服器之間就形成了一條快速通道。明白了嗎?在通道第一次建立的時候,發送的依舊是http協定請求,隻不過該http協定包含了一些關于ws協定的頭資訊,當整個通道建立以後,之間的通信才切換為ws協定進行通信。

這下明白為什麼websocket在struts2中會産生沖突了吧。目前了,如果還不明白的請看下面解釋

當strut2攔截了所有請求或者websocket的請求位址在struts2的攔截範圍内。那麼!!!struts2會根據該請求位址去找對應的action,那麼這樣的話你的action中肯定沒有配置該請求位址,所有就沒有傳回或者傳回報錯,因而websocket通道建立失敗。浏覽器就會報出上面的錯誤。

解決措施:

在struts2的struts.xml中檔案配置一個struts.action.excludePattern屬性将該請求位址不做處理,那麼struts2自然不會理睬這個請求位址,因而websocket通道自然而然的就建立起來了。

<constant name="struts.action.excludePattern" value=".*Socket"/>
           

請注意: value的值是正規表達式驗證串,為什麼要這麼設計呢。請記住一句話,約定優于配置。

當然了,如果你隻有一個websocket背景的話,那麼你的value值的正規表達式的規則可以直接寫成你的這個websocket請求位址。

如果像我上面那樣寫的話,那麼所有以Socket結尾的websocket都不被sturts2理睬了。有意思的是,如果你的action的name值有以Socket結尾的,那麼這個action就失效了,請牢記,約定優于配置。

下面給一些代碼:(當然是拷貝别人的了,我怎麼可能會自己動手寫代碼呢)

jsp頁面代碼:

<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<%@ taglib prefix="s" uri="/struts-tags" %>
<%
    String basePath = request.getScheme() + "://" + request.getServerName() + request.getContextPath() + "/";//定位到根目錄
%>
<html>
<head>
    <base href="<%=basePath%>" target="_blank" rel="external nofollow" >
    <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
    <title>Insert title here</title>
    <script type="text/javascript" src="plugins/jquery.js"></script>
    <script type="text/javascript">
        var ws;
        var url = "ws://localhost/echoSocket";
        function connect() {
            alert("準備連接配接");
            if ('WebSocket' in window) {
                alert("建立WebSocket連接配接");
                ws = new WebSocket(url);
            } else if ('MozWebSocket' in window) {
                alert("建立MozWebSocket連接配接");
                ws = new MozWebSocket(url);
            } else {
                alert('WebSocket is not supported by this browser.');
                return;
            }

            ws.onmessage = function (event) {
                console.debug(event);
                $("#content").append(event.data + "<br/>");
            };

        }

        function send() {
            var value = $("#msg").val();
            ws.send(value);
        }


    </script>
</head>
<body>

<button οnclick="connect();">connect</button>
<hr/>
<input id="msg"/>
<button οnclick="send();">send</button>
<div id="content" style="border: 1px solid black; width: 200px; height: 300px;"></div>

</body>
</html>
           

背景WebSocket的java代碼

package cn.sharek.bsg.vmi.websocket;

import java.io.IOException;

import javax.websocket.OnClose;
import javax.websocket.OnMessage;
import javax.websocket.OnOpen;
import javax.websocket.Session;
import javax.websocket.server.ServerEndpoint;


@ServerEndpoint(value = "/echoSocket")
public class EchoSocket {
    @OnOpen
    public void open(Session session) {
        System.out.println("Session ID:" + session.getId());
    }

    @OnMessage
    public void receive(Session session, String msg) {
        System.out.println(msg);

        try {
            session.getBasicRemote().sendText("Echo:" + msg);
        } catch (IOException e) {
            e.printStackTrace();
        }

    }

    @OnClose
    public void close(Session session) {
        System.out.println(session.getId() + " session 關閉");
    }


}
           

請注意,這裡沒有什麼WebSocket配置類。因為沒有那個類也能用,隻不過所有的websocket類都會被注冊到tomcat中去。如果要加配置類也隻是為了指定哪些websocket不注冊或者是對指定的websocket做一些特别的處理,因而在無特殊要求的情況下也沒有必要使用WebSocket配置類。

繼續閱讀