使用 Eclipse 與 Java SE 6 建立獨立 Web Service 應用（上）——服務端發布與 WSDL 測試

Java SE 6 內建 JAX-WS 運行時，配合 Eclipse IDE 與 Ant，可輕鬆建立無需應用伺服器的獨立 Web Service 服務端。本教程逐步示範環境配置、專案建立、服務實作、wsgen 代碼生成、Endpoint.publish 發布、WSDL 驗證與 Web Services Explorer 測試。

開發環境準備

1. 安裝 Java SE 6 JDK（含 JAX-WS API 與運行時）。
2. 下載 Eclipse IDE for Java EE Developers (Ganymede 版)，解壓即用。
3. Eclipse 配置 JRE：Window → Preferences → Java → Installed JREs → Add → 指向 JDK 6 目錄，勾選啟用。
4. 設定 Compiler compliance level = 1.6（Preferences → Java → Compiler）。

建立服務端專案

1. File → New → Java Project，名稱 wsServerExample，使用專案專屬 JRE (Java SE 6)。
2. 新建套件 com.myfirst.wsServer。
3. 新建 Class SayHello（無 main），貼上服務實作：

package com.myfirst.wsServer;
import javax.jws.WebService;

@WebService
public class SayHello {
    private static final String SALUTATION = "Hello";
    public String getGreeting(String name) {
        return SALUTATION + " " + name;
    }
}

@WebService 註解標記為 Web Service 端點，Java SE 6 運行時掃描並啟用。

Ant 呼叫 wsgen 生成部署工件

1. 專案根目錄新建 build.xml：

<project default="wsgen">
  <target name="wsgen">
    <exec executable="wsgen">
      <arg line="-cp ./bin -keep -s ./src -d ./bin com.myfirst.wsServer.SayHello"/>
    </exec>
  </target>
</project>

2. 右鍵 build.xml → Run As → Ant Build，Console 顯示 BUILD SUCCESSFUL。
3. 專案重整，com.myfirst.wsServer.jaxws 套件出現 GetGreeting、GetGreetingResponse、SayHelloService 等 JAX-WS 工件類。

wsgen 讀取端點類，生成 WSDL 所需的所有可攜式工件（請求/回應 Bean、Service 類等）。

發布 Web Service

1. 同套件新建 RunService（含 main 方法）：

package com.myfirst.wsServer;
import javax.xml.ws.Endpoint;

public class RunService {
    public static void main(String[] args) {
        System.out.println("SayHello Web Service started.");
        Endpoint.publish("https://localhost:8080/wsServerExample", new SayHello());
    }
}

2. Run As → Java Application，Console 輸出啟動訊息，服務即在 8080 埠就緒。

Endpoint.publish 為 Java SE 6 新增 API，單行代碼完成 HTTP 端點發布與 WSDL 動態生成。

驗證 WSDL 與功能測試

1. 內部瀏覽器訪問 https://localhost:8080/wsServerExample?wsdl，顯示完整 WSDL 文檔。
2. 切換 Java EE Perspective，Run → Launch the Web Services Explorer。
3. 圖標 → WSDL Main → 輸入 WSDL URL → Go。
4. Operations 下點擊 getGreeting → Add 參數行 → 輸入 "Fiona" → Go。
5. Status 區顯示 return (string): Hello Fiona，驗證成功。

附錄：Web Service 核心術語

• XML：可擴展標記語言，攜帶結構化資料，純文本，跨平台共享。
• SOAP：簡單物件存取協議（1.2 版去名），輕量級 XML 訊息交換協議，跨 OS/語言。
• WSDL：Web 服務描述語言，機器可讀契約，含操作簽名、命名空間、端點 URI。

下篇將建立獨立客戶端調用此服務，並示範 SOAP 訊息監控。