在 J2EE 平台部署 Web Services 完整指南（一）：環境建置與 JWSDP 整合

一、Web Services 背景與標準協定

Web Services 讓任何連網的具備 WS 能力機器提供服務。核心標準：

• WSDL：XML 描述服務介面。
• UDDI：XML 註冊發現協定，Client 查詢目錄取得服務資訊。
• SOAP：基於 HTTP+XML 的跨平台通訊協定。

流程：Client 向 UDDI 發送請求 → 目錄回傳符合服務 → 雙方透過 SOAP 通訊。

二、Java Web Services Developer Pack (JWSDP) 簡介

JWSDP 為整合下載包，含構建 Web Services 關鍵技術（JAX-RPC、JAXM、JAXR、JAXP、JSTL、SAAJ 等），由 Sun 與 Java 社群共同開發，加速 WS 開發。可在 J2EE 上運行或整合 JWSDP 組件。

三、下載與安裝前置作業

• J2EE SDK 1.3.1
• JWSDP EA2（較 EA1 多項改進）
• 環境變數：J2EE_HOME、JWSDP_HOME 指向正確安裝路徑（許多變數依賴它們）。

四、JWSDP 與 J2EE 手動整合步驟

（亦可用 Ant 腳本 %JWSDP_HOME%\bin\jw2sdponj2ee.bat 自動化）

4.1 建立 jwsdp-common.jar

1. 建立暫存目錄 %JWSDP_HOME%\work\jwsdp_jars
2. 複製 JAR 至暫存目錄：
   • %JWSDP_HOME%\common\lib：mail.jar、activation.jar、dom4j.jar、jaxrpc-api.jar、jaxrpc-ri.jar、jaxm-api.jar、jaxm-client.jar、jaxr-api.jar、jaxr-ri.jar、jaxp-api.jar、castor-0.9.3.9-xml.jar、commons-logging.jar、fscontext.jar、providerutil.jar
   • %JWSDP_HOME%\tools\jstl：jstl.jar、standard.jar
   • %JWSDP_HOME%\services\jaxm-provider\WEB-INF\lib：provider.jar（JAXM Provider，非同步通訊需用）
3. 切換至暫存目錄，執行：jar -cvf %JWSDP_HOME%\work\jwsdp-common.jar .

4.2 建立 jwsdp-endorsed.jar

1. 建立暫存目錄 %JWSDP_HOME%\work\endorsed_jars
2. 複製 %JWSDP_HOME%\common\endorsed 內 JAR：sax.jar、dom.jar、xercesImpl.jar、xalan.jar、xsltc.jar
3. 切換目錄，執行：jar -cvf %JWSDP_HOME%\work\jwsdp-endorsed.jar .

4.3 複製 JAR 至正確位置並設定 Classpath

1. 建立 %J2EE_HOME%\lib\system\endorsed 目錄
2. 複製 jwsdp-endorsed.jar 至該目錄
3. 編輯 %J2EE_HOME%\lib\setenv.bat：CPATH 最前插入 %SYSTEM_LIB_DIR%\endorsed\jwsdp-endorsed.jar
4. 編輯 %J2EE_HOME%\bin\userconfig.bat：啟用 J2EE_CLASSPATH，定義 SYSTEM_LIB_DIR，設定 J2EE_CLASSPATH=%SYSTEM_LIB_DIR%\jwsdp-common.jar
5. 編輯 %J2EE_HOME%\bin\j2ee.bat：最後一行 %JAVA_COMMAND% 加入 -Djava.endorsed.dirs=%J2EE_HOME%\lib\system\endorsed（僅 J2SDK 1.4 上跑 J2EE 1.3.x 需設）

五、Web Server 連接埠與安全權限配置

1. 編輯 %J2EE_HOME%\config\web.properties：http.port=8080（JWSDP Tomcat 預設 8080，避免衝突）
2. 編輯 %J2EE_HOME%\lib\security\server.policy 預設域末尾加入：

   permission java.io.FilePermission "<>", "read,write,delete";
   permission java.util.PropertyPermission "*", "read,write";
   permission java.lang.RuntimePermission "modifyThreadGroup";
   

   權限用於 JAXM Provider Admin Tool、jaxm-remote.jar、jaxm-soaprpc 範例運行。