Web 傳訊服務配置

Web 傳訊服務會從 JavaTM Platform Enterprise Edition (Java EE) 應用程式 Web 模組 Web Content/WEB-INF 目錄中,讀取 webmsg.json 檔內的配置資訊。 這個資訊是在應用程式啟動和停止時讀取,以便利用配置資訊來起始設定 Web 傳訊服務。 這個檔案與 Web 模組的 web.xml 檔在一起,這個檔案的位置無法改變。 webmsg.json 檔是以「JavaScriptTM 物件表示法 (JSON)」格式來指定,具體地說,這個檔案的內容應該代表 JSON 物件。 JSON 物件是鍵值組的集合。 請參閱下列 Web 傳訊配置檔範例:

{
   "WebMsgServlet": 
      {  
         "busName": "thebus", 
 	 "destination": "Default.Topic.Space", 
         "clientCanPublish": false,
         "longPollTimeout": 30
      }
}
      

JSON 物件中的每個金鑰都在指定了 webmsg.json 檔的相同 Web 模組中,指定現有的 Servlet 名稱。 每個鍵的值都是另一個指定了 Web 傳訊配置選項的 JSON 物件。 送入的 Web 傳訊要求由指定的 Servlet 的 Servlet 對映來決定。 這些送入要求是以指定的配置選項來處理。 下列範例是一個 web.xml 檔 Snippet,含有 WebMsgServlet Servlet 及相關聯的 Servlet 對映:

<servlet>
     <display-name>WebMsgServlet</display-name>
     <servlet-name>WebMsgServlet</servlet-name>   
     <servlet-class>
        com.ibm.websphere.webmsg.servlet.WebMsgServlet
     </servlet-class>
</servlet>
<servlet-mapping>
    <servlet-name>WebMsgServlet</servlet-name>  
    <url-pattern>/stockServlet</url-pattern>
</servlet-mapping>
      

在上述範例中,WebMsgServlet Servlet 對映至 /stockServlet。 任何對映至 /stockServlet 的送入 Web 傳訊要求,都是以上述 webmsg.json 範例中的配置參數來處理。 在這個情況下,Web 傳訊要求會使用服務整合匯流排 thebus、預設主題空間 Default.Topic.Space,Bayeux 長輪詢逾時是 30,Web 傳訊用戶端無法將訊息發佈到伺服器。

大部分配置都只需要建立一個 Servlet,以及相關的 webmsg.json 配置項目。 有時候必須在單一 Web 模組中建立多重定義。 例如,連接至不同的服務整合匯流排目的地、指定不同的預設目的地,或用 Bayeux 長輪詢逾時來分隔用戶端。 如果要根據配置參數來分開送入要求,就必須建立對映至 com.ibm.websphere.webmsg.servlet.WebMsgServlet 的新 Servlet 定義及新的 Servlet 對映。 最後,請在 webmsg.json 中,利用所需要的配置參數來建立新的項目。 這個項目必須有一個索引鍵對映至新建立的 Servlet。

配置小節

以下幾小節詳細說明所有可能的 Web 傳訊配置選項。



使用條款 | 意見