MTOM 服務 - 配置和執行


配置範例
執行範例

有兩個訊息傳輸最佳化機制 (MTOM) 服務用戶端,一個是對 Thin Client for JAX-WS with WebSphere Application Server 使用 Java 保存檔 (JAR) 的指令行版本,另一個是使用 JavaServer Pages (JSP) 檔來存取 MTOM 服務的 Servlet 版本。

範例服務端點
URI 說明
http://localhost:9080/WSSampleMTOM/MtomSampleService
使用 SOAP 1.1 的 MTOM 服務範例
http://localhost:9080/WSSampleMTOM/MtomSampleService12
使用 SOAP 1.2 的 MTOM 服務範例

9080 是預設值,但如果您安裝到 AppSrv01 設定檔以外的設定檔,則埠號不同。



配置範例

若要完成此範例的配置,請在伺服器上部署 JAX-WS Web 服務範例應用程式。 如果尚未部署範例應用程式,請參閱重建及部署 JaxWSServicesSamples.ear 檔的指示。

執行範例

在開始之前,您必須在執行用戶端之前先驗證應用程式伺服器是否在執行中。

MTOM 服務範例由兩個用戶端和已部署在伺服器上的單一 Enterprise Bean 組成。一個用戶端是指令行版本,使用 Thin Client for JAX-WS 來搭配 WebSphere Application Server JAR 檔。 另一個用戶端是使用 JSP 檔來存取 MTOM 服務的 Servlet 版本。

執行 MTOM 服務 Servlet
執行 MTOM 服務小型用戶端應用程式

MTOM 服務用戶端

MTOM 服務用戶端將 MTOM 編碼的檔案傳送至指定的服務端點。依預設,主機是設定為本端主機, 但您可以變更此值。需要檔名,此處並未提供預設值。在此範例中,服務會接收來自用戶端的檔案, 然後依照指定將檔案傳回 dispatch 或 proxy 程式設計模型中的用戶端。

執行 MTOM 服務 Servlet 用戶端

MTOM 服務 Servlet 用戶端不是由儲存器管理。

如需在 Thin Client for JAX-WS 環境中呼叫 Servlet 用戶端的相關資訊, 請參閱 WebSphere Application Server Information Center Library 中有關執行未受管理的 Web 服務 JAX-WS 用戶端的文件。

如果要從 WebSphere Application Server 執行簡易 MTOM Servlet 服務用戶端,請執行下列步驟:

  1. 啟動伺服器。
  2. 按一下執行

執行 MTOM 服務小型用戶端應用程式

WSSampleMTOMClient.jar 檔是指令行版本的 MTOM 服務小型用戶端應用程式。

在下列步驟中,app_server_root 變數是指應用程式伺服器安裝根目錄。

若要從 WebSphere Application Server 執行 MTOM 服務小型用戶端應用程式, 請根據您的作業系統來執行下列步驟:

  1. 啟動伺服器。
  2. 開啟命令提示字元。
  3. 跳至 JaxWSServicesSamples 目錄。

    在 Windows 作業系統上:

    cd app_server_root\samples\bin\JaxWSServicesSamples

    在 AIX、Linux 和 z/OS 之類的作業系統上:

    cd app_server_root/samples/bin/JaxWSServicesSamples

    在 iSeries 作業系統上:

    cd app_server_root/samples/bin/JaxWSServicesSamples

  4. 執行 MTOM 服務範例。

    在 Windows 作業系統上:

    runSampleMtom.bat -i filename -h hostname -p port -f urlSuffix -d -x -1 -2

    在 AIX、Linux 和 z/OS 之類的作業系統上:

    ./runSampleMtom.sh -i filename -h hostname -p port -f urlSuffix -d -x -1 -2

    在 iSeries 作業系統上:

    ./runSampleMtom -i filename -h hostname -p port -f urlsuffix -d -x -1 -2

    參數為:
    -i <filename> 是要傳送的檔案名稱。 這是必要的參數,並且未提供預設值。
    -h <hostname> 是主機的名稱。預設值是 localhost
    -p <port> 是埠號。預設值是 9080
    -f <urlsuffix> 服務端點環境定義。預設值是 /WSSampleMTOM/MtomSampleService。
    -d 指定只能使用 dispatch 模型。
    -x 指定只能使用 proxy 模型。
    -1 指定使用 SOAP 1.1。這是預設值。
    -2 指定使用 SOAP 1.2。

    下列範例說明在 Windows 作業系統上順利執行 MTOM 服務小型用戶端應用程式:

    runSampleMtom.bat -i c:\SYSLEVEL.IBM -p 9081
    >>---------------------------------------
    >>MTOM Dispatch 測試
    >>MTOM 從 'file:/c:/SYSLEVEL.IBM' 載入資料
    Aug 10, 2007 12:11:49 PM com.ibm.ws.ssl.config.SSLConfigManager
    INFO: ssl.disable.url.hostname.verification.CWPKI0027I
    >>MTOM 呼叫 Dispatch 含二進位內容
    >>接收到 MTOM 回應
    >>MTOM 寫入傳回影像至 dispatch_response.gif
    >>MTOM Dispatch 完成
    >>---------------------------------------
    >>MTOM Proxy 測試
    >>MTOM 呼叫含二進位內容的 Proxy
    >>接收到 MTOM 回應
    >>MTOM 寫入傳回影像至 proxy_response.gif
    >>MTOM Proxy 完成

若要進一步瞭解用戶端和應用程式如何運作,請參閱 MTOM 服務 TechNotes,或檢視 Java 原始程式碼。