[start]學習web service編程
2006年4月28日 劉濤（LiuTao.PRC@gmail.com）

1.? 通過IBM網站上的簡單例子建立感性認識
應用AXIS開始Web 服務之旅
1.1 Web Service服務端開發
編寫Hello.java，內容如下：

public ? class ?Hello {
? public ?String?hello(String?name) {
?? if (name == null )
???name? = ? "" ;
?? return ? " 你好 " + name + " ，歡迎來到Web服務的世界！ " ;
}
}

將文件改名為Hello.jws，并拷貝到AXIS應用目錄%AXIS_HOME%\下。
測試該Web服務：打開瀏覽器并輸入http://localhost:8080/axis/Hello.jws ，瀏覽器顯示如下結果：

There?is?a?Web?Service?here
????????
????????Click?to?see?the?WSDL?

到此我們已經完成了hello的Web服務了，那我們怎么告訴用戶如何來使用該服務呢？我們只需要告訴用戶我們的Web服務的URL地址： http://localhost:8080/axis/Hello.jws?wsdl 就可以了！下一節我們將介紹如何通過這個地址來訪問對應的Web服務。

1.2 Web Service客戶端開發
1.2.1 JAVA客戶端
使用AXIS的工具將使Web服務的訪問和我們之前介紹的創建一個Web服務一樣的簡單。我們前面安裝的AXIS環境中已經包含著這樣的工具，它是一個JAVA類，類名為：org.apache.axis.wsdl.WSDL2Java。打開命令行窗口，轉到AXIS目錄下的WEB-INF子目錄。確保Tomcat服務已經處于啟動狀態，鍵入命令 ：

Java?-Djava.ext.dirs=lib?org.apache.axis.wsdl.WSDL2Java?http://localhost:8080/axis/Hello.jws?wsdl

該命令執行的結果是在當前所在目錄下產生一個子目錄 localhost/axis/Hello_jws，該目錄下有四個JAVA源文件，它們分別是：
Hello.java 定義了Web服務接口，此例中只有一個hello方法。
HelloService.java 定義了用于獲取Web服務接口的方法。
HelloServiceLocator.java 接口HelloService的具體實現。
HelloSoapBindingStub.java Web服務客戶端樁，通過該類與服務器交互。

這四個JAVA類幫我們處理了大部分的邏輯，我們需要的僅僅是把這些類加到我們的項目然后創建一個我們自己的類來調用它們即可。為此我們新加一個類Main.java，為了方便，讓這個類與剛產生的四個類都在同一個包下。內容如下：

// Main.java
package ?localhost.axis.Hello_jws;
public ? class ?Main {
???? public ? static ? void ?main(String[]?args)? throws ?Exception {
????????HelloService?service? = ? new ?HelloServiceLocator();
????????Hello?hello? = ?service.getHello();?
????????System.out.println( " Response: " + hello.hello( " 罐頭 " ));?
????}
}

使用以下命令進行編譯：

javac?-classpath?lib\axis.jar;lib\jaxrpc.jar?localhost\axis\Hello_jws\*.java

如果編譯沒有問題的話執行該測試程序：

java?-Djava.ext.dirs=lib?-cp?.?localhost.axis.Hello_jws.Main//運行結果：Response:你好罐頭，歡迎來到Web服務的世界！

在WSDL2Java工具自動產生的幾個類中，類HelloServiceLocator中保存這一些跟服務器相關的信息，例如URL地址等，當服務器的地址更改后但是服務并沒有改動的時候直接修改該文件中的字符串定義，而無需重新生成這幾個類。具體需要修改的內容，打開該文件便可一目了然。

1.2.2 VC客戶端
參見IBM的原貼。

2. Web服務的定義：
A Web service is a software system designed to support interoperable machine-to-machine interaction over a network. It has an interface described in a machine-processable format (specifically WSDL). Other systems interact with the Web service in a manner prescribed by its description using SOAP messages, typically conveyed using HTTP with an XML serialization in conjunction with other Web-related standards.
From:W3C 1.4 What is a Web service?

3. 閱讀Axis Developer's Guide（下載的Axis包內/docs/developers-guide.html）
讀到一條關于代理上網的信息，或許以后有用，先記一筆。
If you access the internet via a proxy server, you'll need to set an environment variable so that the Axis tests do the same. Set ANT_OPTS to, for example:

-Dhttp.proxyHost=proxy.somewhere.com?-Dhttp.proxyPort=80?-Dhttp.nonProxyHosts="localhost"

?