本章主要詳細記錄如何讀懂一個WSDL描述檔案。

      在上一章裡面我們已經成功部署了一個WebService服務，並且通過瀏覽器能夠順利的看到WSDL檔案。那麼該檔案

表示什麼含義呢？通過這個檔案我們該如何呼叫他呢？

1、先列出一份簡單的wsdl

<?xml version="1.0" encoding="UTF-8"?>
<wsdl:definitions targetNamespace="http://www.ztesoft.com/axis/sayHello"
	xmlns:apachesoap="http://xml.apache.org/xml-soap" 
	xmlns:impl="http://www.ztesoft.com/axis/sayHello"
	xmlns:intf="http://www.ztesoft.com/axis/sayHello" 
	xmlns:soapenc="http://schemas.xmlsoap.org/soap/encoding/"
	xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/" 
	xmlns:wsdlsoap="http://schemas.xmlsoap.org/wsdl/soap/"
	xmlns:xsd="http://www.w3.org/2001/XMLSchema">
	
	<wsdl:message name="qryUserNameRequest">
		<wsdl:part name="name" type="xsd:string" />
	</wsdl:message>
	<wsdl:message name="qryUserNameResponse">
		<wsdl:part name="qryUserNameReturn" type="xsd:string" />
	</wsdl:message>
	
	<wsdl:portType name="HelloImpl">
		<wsdl:operation name="qryUserName" parameterOrder="name">
			<wsdl:input message="impl:qryUserNameRequest" name="qryUserNameRequest" />
			<wsdl:output message="impl:qryUserNameResponse" name="qryUserNameResponse" />
		</wsdl:operation>
	</wsdl:portType>
	
	<wsdl:binding name="SayHelloSoapBinding" type="impl:HelloImpl">
		<wsdlsoap:binding style="rpc" transport="http://schemas.xmlsoap.org/soap/http" />
		<wsdl:operation name="qryUserName">
			<wsdlsoap:operation soapAction="" />
			<wsdl:input name="qryUserNameRequest">
				<wsdlsoap:body encodingStyle="http://schemas.xmlsoap.org/soap/encoding/"
					namespace="http://www.ztesoft.com/axis/sayHello" use="encoded" />
			</wsdl:input>
			<wsdl:output name="qryUserNameResponse">
				<wsdlsoap:body encodingStyle="http://schemas.xmlsoap.org/soap/encoding/"
					namespace="http://www.ztesoft.com/axis/sayHello" use="encoded" />
			</wsdl:output>
		</wsdl:operation>
	</wsdl:binding>
	
	<wsdl:service name="HelloImplService">
		<wsdl:port binding="impl:SayHelloSoapBinding" name="SayHello">
			<wsdlsoap:address location="http://127.0.0.1:8080/axis/services/SayHello" />
		</wsdl:port>
	</wsdl:service>
	
</wsdl:definitions>
 

2、描述一個wsdl需要從那些方面描述

首先讓我們想一想，如果你想告訴別人你的網路服務，最起碼你要讓別人知道那些資訊，別人才能呼叫。

      1、服務的請求地址，最好多個服務繫結到一個地址上。傳遞引數時指明呼叫方法名就可以了。

      2、服務使用了什麼協議傳輸資料，例如soap協議，或者http協議的get方法，或者http協議的post方式等。

      3、在這個地址中，有哪些可以操作的方法。方法入參是什麼，出參是什麼。例如出參是UserInfo複雜物件。

      4、針對上面的方法，詳細描述入參或者出參的結構。例如UserInfo裡面有哪些String型別的，那些int型別的等。

3、針對上面提出的要求，我們來看看wsdl檔案內的內容。

上面的wsdl檔案由4個節點組成。首先根節點是wsdl:definitions表示這個是一個wsdl的定義檔案。（檔案從下往上看）

      3.1、wsdl:definitions：根節點，表示裡面的內容是用來描述webservice的，首先引入schema。這樣就不能亂寫了。

      3.2、wsdl:service：提供了一個地址，如果你想訪問這個服務就呼叫這個地址就行了。

      3.3、wsdl:binding：服務的協議，例如使用了soap協議。

      3.4、wsdl:portType：具體的服務集合，有哪些方法可以操作。方法入參是什麼，出參是什麼。

      3.5、wsdl:message：訊息的詳細資訊，詳細描述了出參是什麼，入參是什麼。

4、我對wsdl的一些看法

第一次看這個文件挺難理解的。如果你瞭解下面幾個原因我想看著也許挺容易的。

      1、比較複雜的東西應該抽取出來複用。例如上面的wsdl:portType裡面有方法入參和出參。之所以用wsdl:message抽

取出來作為一個節點描述入參和出參。不就是為了複用嗎，如果寫在一起有別的方法也用到這種型別入參或者出參。那豈

不是還要寫一次。

      2、其實這個和配置servlet有些相似。servlet配置時配置如下

	<servlet>
		<servlet-name>AxisServlet</servlet-name>
		<servlet-class>org.apache.axis.transport.http.AxisServlet</servlet-class>
	</servlet>

	<servlet-mapping>
		<servlet-name>AxisServlet</servlet-name>
		<url-pattern>/services/*</url-pattern>
	</servlet-mapping>

      例如上面想把一個url和一個類對應起來，中間加了一個servlet-name節點做為中間連線點，為什麼不直接把url和類映

射到一起呢？我想如果這樣做，可能不合理，要是直接對映。那麼多一個對應該類的請求就需要多寫一次類的全名，例如

<servlet-mapping>
	<servlet-class>org.apache.axis.transport.http.AxisServlet</servlet-class>
	<url-pattern>/services/*</url-pattern>
</servlet-mapping>
<servlet-mapping>
	<servlet-class>org.apache.axis.transport.http.AxisServlet</servlet-class>
	<url-pattern>/ws/*</url-pattern>
</servlet-mapping>

不是每一個都需要改。

      而這裡呢？wsdl:service可以看成是url-pattern。wsdl:binding則相當於是servlet-name。wsdl:portType相當於servlet-class

這樣看是不是容易了，而且還可以新增很多額外的資訊。例如wsdl:binding還可以新增一些描述資訊，例如使用什麼協議。

5、上面檔案的含義

      服務集合wsdl:service裡面有個服務SayHello的訪問地址是http://127.0.0.1:8080/axis/services/SayHello，這個服務的

使用協議（通過什麼方式傳輸資料）是wsdl:binding描述的。並且通過他我們還可以找到具體實現類wsdl:portType，在這

個類中有哪些方法wsdl:operation，以及方法的詳細入參（wsdl:input）出參（wsdl:output）。在wsdl:message中可以看

到引數的詳細組成。

6、通過上面的wsdl檔案，我們如何呼叫

package com.ztesoft.axis.client;

import javax.xml.namespace.QName;

import org.apache.axis.client.Call;
import org.apache.axis.client.Service;

public class Client {
	public static void main(String[] args) throws Exception {
		
		// wsdlsoap:address 節點中的地址值。
		String url = "http://127.0.0.1:8080/axis/services/SayHello";
		Service service = new Service();
		Call call = (Call) service.createCall();
		call.setTargetEndpointAddress(url);
		
		// wsdl:portType 裡面的操作方法。
		call.setOperationName(new QName(url, "qryUserName"));
		
		// 根據描述傳入一個String物件，因為可能有多個入參，所以使用Objct[]
		// 描述的返回引數是String， 強轉String。
		String result = (String) call.invoke(new Object[]{"Readiay"});
		System.out.println(result);;
	}
}

如何呼叫客戶端的內容。此處先做一個簡單說明。