Web 傳訊服務快速入門

Web 傳訊服務由一個執行時期 JavaTM 保存檔 (JAR) 及一個程式庫組成,執行時期 JAR 保存檔放在 WebSphere® Application Server 安裝目錄中,程式庫設計成作為公用程式 JAR 檔插入新的或現有的 Web 模組中。 這一節提供若干簡短指示來協助您啟用 Web 傳訊服務及開發啟用 Web 傳訊的應用程式。 這一節還包括若干鏈結,供您進入更詳細的章節。 .


步驟 1. 安裝 Web 傳訊服務。

您必須先安裝好 Web 傳訊服務,才能執行啟用 Web 傳訊的應用程式。 請參閱 IBM® WebSphere Application Server Feature Pack for Web 2.0 and Mobile 安裝指示,以取得相關資訊。

步驟 2:找出公用程式程式庫。

請找出隨附這份文件的 Web 傳訊服務公用程式庫。  

步驟 3. 啟用 Web 傳訊服務。

您必須啟用 Web 傳訊服務,才能執行啟用 Web 傳訊的應用程式。 請參閱啟用 Web 傳訊服務指示,以取得相關資訊。

  1. 登入 WebSphere Application Server 的管理主控台。
  2. 導覽至伺服器 -> 應用程式伺服器
  3. 選取現行應用程式伺服器。
  4. 展開「Web 儲存器設定」,然後選取「Web 儲存器傳輸鏈」。
  5. 選取 WCInboundDefault 傳輸鏈,或選取您在應用程式安裝期間選取的「虛擬主機」所對應的傳輸鏈。
  6. 選取「Web 儲存器入埠通道 (WCC 2)」。
  7. 選取「自訂內容」。
  8. 按一下新建
  9. 輸入 webmsgenabled 用於 name 內容,輸入 true 作為值。
  10. 按一下套用
  11. 按一下儲存 來儲存儲存庫資訊。
  12. 您可以立即重新啟動應用程式伺服器,或等到「配置服務整合匯流排」步驟之後。

步驟 4. 配置服務整合匯流排。

Web 傳訊應用程式必須有配置了已定義的主題空間之服務整合匯流排,才能執行。 至少必須在 Web 傳訊配置檔中提供匯流排名稱,Web 傳訊應用程式才能運作。

步驟 5. 將 Dojo Toolkit 插入 Web 模組中。

Dojo Toolkit 提供 Web 傳訊服務的用戶端支援。 最簡單的方法就是將 Dojo Toolkit 併入 Web 模組中。 如果沒有將 Dojo Toolkit 併入 Web 模組中(例如,由 Web 伺服器來靜態提供),就必須知道 dojo.js 檔的「統一資源識別碼 (URI)」位置,以便在任何 Web 模組簡報檔案中載入 Dojo Toolkit。

步驟 6. 在 Web 模組中嵌入 Web 傳訊公用程式程式庫。

插入 Web 傳訊公用程式庫的最佳位置是在 Web 模組的 WEB-INF/lib 目錄中,以作為一個公用程式庫。 請將在第 1 步驟中找到的 webmsg_applib.jar 檔複製到 Web 模組的 WEB-INF/lib 目錄中。 您可以在 Dojo Toolkit 的相同 Web 模組中,或在不同的 Web 模組中,使用 Web 傳訊公用程式庫。 主要互動點是 Bayeux 通訊協定通訊 URI。 請參閱安裝步驟,以取得進一步的資訊。

步驟 7. 判斷 Web 傳訊服務通訊 URI,將 Web 傳訊 Servlet 對映到這個 URI。

"/webmsgServlet" servlet-mapping 參數定義 Dojo Bayeux 用戶端和 Web 傳訊服務之間的通訊 URI。 在伺服器端,必須建立符合 dojox.cometd.init 起始設定參數的 Servlet 對映。 Servlet 對映會對映至 Servlet 類別 com.ibm.websphere.webmsg.servlet.WebMsgServlet。 這個 Servlet 提供在 Web 傳訊公用程式庫中。 web.xml 檔範例顯示如下。 請參閱開發啟用 Web 傳訊的應用程式,以取得相關資訊。
	
  <servlet>
    <description/>
    <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>/webmsgServlet</url-pattern>
  </servlet-mapping>
 

      
在第 9 步驟中,Dojo Toolkit cometd 用戶端將上面所定義的 URI 用於起始設定用途。 簡報檔案中有一個簡式起始設定陳述式用於第 9 步驟及某個範例中,顯示如下供您進行比較:  dojox.cometd.init( "webmsgServlet");

步驟 8. 建立 Web 傳訊配置檔。

Web 傳訊服務會讀取配置檔中的配置參數來處理送入的 Web 傳訊要求。 請在 WEB-INF 目錄(web.xml 檔的相同目錄)中,建立一個類似下列範例的 Web 傳訊配置檔 webmsg.json。 webmsg.json 檔指定為一個「JSON 物件(對映)」,每個符合現有 Servlet 名稱的索引鍵都對映於 Web 傳訊 Servlet。 配置概觀一節提供所有可能的配置選項的相關資訊。

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

步驟 9. 建立用戶端應用程式。

除了安裝應用程式之外,所有伺服器端設定都已經完成。 其餘作業是利用 Dojo Toolkit 功能來建立用戶端邏輯。 以下提供簡單的測試範例。 請注意起始設定 URI 參數符合 Web 傳訊 Servlet 對映的方式。

<html>
  <head>
    <title>cometd client/server test page</title>

    <script type="text/javascript" src="dojo/dojo.js" 
        djConfig="isDebug: true, parseOnLoad: true, debugAtAllCosts: false"></script>
    <script type="text/javascript">
       dojo.require("dojox.cometd");
       dojo.addOnLoad(function(){
          dojox.cometd.init("webmsgServlet")
          dojox.cometd.subscribe("/testtopic", window, "display");
         }
       );
       function display(msg) {
           alert("Message " + msg.data.test);
       }
    </script>
    <div align="left">
      <button Id="publishButton" onclick="dojox.cometd.publish('/testtopic', {test: 'Data'});">
         <span style="font-size:small">PUBLISH</span>
      </button>
    </div>
   </head>
   <body></body>
</html>
      

步驟 10. 安裝及執行應用程式。

請利用標準 Web 應用程式組合、安裝及測試程序來組合、安裝及測試應用程式。



使用條款 | 意見