JAX-WS及其在Java Web Service中的應用

一、JAX-WS入門介紹

Java API for XML Web Services (JAX-WS) 是用於開發 SOAP Web Services 的Java API。

JAX-WS API 通過 JAXB 實現 SOAP 消息與 Java 對象之間的映射轉換。 JAXB (Java Architecture for XML Binding) 是 Java 中的一個用於將 XML 表示與 Java 對象之間相互轉換的組件，也稱為 Object-XML 核心技術。

使用JAX-WS可以以Java接口為基礎自動生成Web Service的客戶端和服務器端代碼，同時支持對J2EE支持的Servlet容器和Web服務器以及J2EE支持的應用服務器的無縫集成。

二、JAX-WS與SOAP

SOAP（簡易對象接入協議）是一種基於XML的通信協議，用於交換不同操作系統和應用程序之間的結構化信息。SOAP支持HTTP、HTTPS、SMTP、FTP等協議，並允許在它們之間轉換數據。因為SOAP採用XML作為數據傳輸格式，所以並不依賴於操作系統或開發語言。

JAX-WS可以很容易地打包Java Bean作為SOAP消息傳輸，同時還可以使用JAXB將Java對象序列化和反序列化為XML。在開發 Web Services 應用時，JAX-WS commonly acts as the project’s core architecture，從而簡化了商業規模的Web Services應用的開發。

三、JAX-WS的主要組成部分

在Java編程中使用JAX-WS有以下幾個主要的概念：

1、SEI (Service Endpoint Interface)

Service Endpoint Interface (SEI) 是 Web service的接口定義。SEI 是包含在一個Web服務的替代 WSDL 文件中。SEI 包含服務方法的定義，方法所需的參數和方法返回值類型。在 JAX-WS中，SEI被聲明為一個Java接口，其中的每個方法都是一個 Web 服務端點（end point）

@WebService
public interface HelloWebService {
    @WebMethod
    public String sayHello(String name);
}

2、SIB (Service Implementation Bean)

Service Implementation Bean (SIB) 是 Web 服務的實際實現。它是包含 Web 服務端點實現的 Java 類。在 JAX-WS中，SIB可以是POJO（plain old Java object），也就是一個非EJB（Enterprise Java Bean）的Java類。

@WebService(endpointInterface = "com.example.HelloWebService")
public class HelloWebServiceImpl implements HelloWebService {
    @Override
    public String sayHello(String name) {
        return "Hello, " + name + "!";
    }
}

3、Endpoint

Endpoint 是 Web 服務端點。它是 Web 服務構建的核心部分。 Endpoint 將 SEI 與 SIB 關聯起來，從而做到了客戶端和服務器端之間的通信。

Endpoint.publish("http://localhost:8080/hello", new HelloWebServiceImpl());

4、Binding

Binding 是 Web Services 請求/響應的格式。SOAPBinding 表示請求/響應的格式採用 SOAP 消息傳輸，而 HTTPBinding 則表示格式為 HTTP。

@WebService(name = "HelloWebService", targetNamespace = "http://example.com")
@SOAPBinding(style = SOAPBinding.Style.RPC)
public interface HelloWebService {...}

5、WSDL (Web Service Description Language)

WSDL 是一種用於描述 Web 服務的語言。它可以描述 Web 服務的接口、消息格式、協議、服務地址等

四、JAX-WS使用示例

下面是一個完整的JAX-WS Web Services使用示例：

@WebService
public interface HelloWebService {
    @WebMethod
    public String sayHello(String name);
}

@WebService(endpointInterface = "com.example.HelloWebService")
public class HelloWebServiceImpl implements HelloWebService {
    @Override
    public String sayHello(String name) {
        return "Hello, " + name + "!";
    }
}

public class HelloWebServicePublisher{
    public static void main(String[] args) {
        Endpoint.publish("http://localhost:8080/hello", new HelloWebServiceImpl());
    }
}

@WebService(name = "HelloWebService", targetNamespace = "http://example.com")
@SOAPBinding(style = SOAPBinding.Style.RPC)
public interface HelloWebService {
    @WebMethod
    @SOAPBinding(parameterStyle = SOAPBinding.ParameterStyle.BARE)
    @WebResult(name = "result")
    public String sayHello(@WebParam(name = "name")String name);
}

public class HelloWebServiceClient {
    public static void main(String[] args) throws Exception {
        URL url = new URL("http://localhost:8080/hello?wsdl");
        QName qname = new QName("http://example.com", "HelloWebService");
        Service service = Service.create(url, qname);
        HelloWebService hello = service.getPort(HelloWebService.class);
        System.out.println(hello.sayHello("World!"));
    }
}

總結

JAX-WS是一種簡單易用、功能強大的Java API，專門用於Web Services的開發。在JAX-WS中，使用SEI、SIB、Endpoint、Binding等核心概念進行Web服務的定義、實現和發布；JAX-WS可以自動化實現SOAP請求和響應的序列化和反序列化，大量簡化了Web Services應用的開發。

相應的也要特別注意WSDL描述服務的接口、消息格式、協議、服務地址等配置，它也是Web Service應用最重要的文件之一。同時JAX-WS的靈活性使其成為一個難以抗拒的選擇，以簡化企業應用系統之間的通訊和交流。