Java調用WebService介面wsdl詳解

一、WebService介面wsdl是什麼

WebService介面wsdl（Web Services Description Language）是一種用於描述Web服務的語言，它基於XML語言，描述了如何訪問一個Web服務以及Web服務的參數和數據類型等信息。使用wsdl語言可以方便開發人員快速構建Web服務。一個wsdl文件包含了Web服務的全部描述信息，可以視為Web服務的契約，客戶端通過wsdl文檔描述文件可以了解到WebService所提供的服務內容、調用方式和參數等信息。

二、Java調用WebService介面wsdl的流程

Java調用WebService介面wsdl分為以下幾個步驟：

1. 導入WebService介面wsdl文件

2. 創建SOAP請求消息

3. 發送SOAP請求消息

4. 解析SOAP響應消息

三、導入WebService介面wsdl文件

在Java中，我們可以通過JAX-WS工具將wsdl文件導入為一個Java類，用於WebService的調用。導入wsdl文件的方式有兩種：

1. 使用wsimport工具命令自動生成Java類

wsimport -p com.example.webservice.client -keep http://localhost:8080/HelloWorld?wsdl 

2. 手工編寫Java類

手工編寫Java類需要根據wsdl文件中的信息，手動構建WebService客戶端。構建客戶端的主要步驟是：創建服務(Service)、創建埠(Port)、創建綁定(Binding)、創建QName、創建請求參數等。

四、創建SOAP請求消息

SOAP消息格式分為請求和響應兩個部分，通過構造SOAP消息的XML格式提供請求及響應的信息，其中請求XML格式遵照SOAP協議規範，XML必須包含SOAP消息頭和SOAP消息體兩個部分。SOAP消息體根據webservice伺服器端需要調用的介面方法及方法的參數進行組裝，SOAP消息頭包含一些必須的標記和客戶端自定義的標記，用於描述請求及響應的消息屬性信息。

// 創建 service 實例
HelloWorldService service = new HelloWorldService();
// 從 service 中獲取 port 實例
HelloWorld port = service.getHelloWorldPort();
// 組裝請求消息
BindingProvider bp = (BindingProvider) port;
SOAPMessage requestMsg = MessageFactory.newInstance().createMessage();
SOAPPart soapPart = requestMsg.getSOAPPart();
SOAPEnvelope soapEnvelope = soapPart.getEnvelope();
SOAPBody soapBody = soapEnvelope.getBody();
QName bodyName = new QName(service.getNamespaceURI(), "getHelloWorldAsString", "ns1");
SOAPBodyElement bodyElement = soapBody.addBodyElement(bodyName);

五、發送SOAP請求消息

使用JDK提供的HttpURLConnection或Apache提供的HttpClient等HTTP請求工具向webservice服務端發送SOAP消息請求，獲取SOAP響應消息，將響應消息轉化為Java對象，以供調用者使用。

// 發送請求，並獲取響應
URL endpoint = new URL("http://localhost:8080/HelloWorld");
HttpURLConnection conn = (HttpURLConnection) endpoint.openConnection();
ByteArrayOutputStream bout = new ByteArrayOutputStream();
requestMsg.writeTo(bout);
byte[] bytes = bout.toByteArray();
conn.setRequestProperty("Content-Length", String.valueOf(bytes.length));
conn.setRequestProperty("Content-Type", "text/xml;charset=UTF-8");
conn.setRequestProperty("SOAPAction", service.getNamespaceURI() + "getHelloWorldAsString");
conn.setDoOutput(true);
conn.getOutputStream().write(bytes);
ByteArrayInputStream bi = new ByteArrayInputStream(getBytes(conn));
SOAPMessage responseMsg = MessageFactory.newInstance().createMessage(null, bi);
conn.disconnect();

六、解析SOAP響應消息

解析響應SOAP消息的過程就是將一個XML格式的SOAP響應消息轉換為Java對象，從中提取需要的業務數據。SOAP響應消息同樣包含SOAP消息頭和SOAP消息體。

// 解析響應消息
SOAPEnvelope resEnvelope = responseMsg.getSOAPPart().getEnvelope();
SOAPBody resBody = resEnvelope.getBody();
Iterator iterator = resBody.getChildElements(bodyName);
if (iterator.hasNext()) {
    SOAPBodyElement bodyElement = (SOAPBodyElement) iterator.next();
    String retStr = bodyElement.getTextContent();
}

七、總結

以上是Java調用WebService介面wsdl的詳細流程，通過了解wsdl文件的定義、創建SOAP請求、發送SOAP請求以及解析SOAP響應等步驟，我們能夠更加方便地實現WebService客戶端的開發。