?作為CSDN JavaWebService的小斑竹，很久就想寫一些關于JWS的基礎文章，苦于公私繁忙，一直無心下筆，所以一拖再拖，今日看了我斑塊下有網友問及關于Java調用WebService之問題，遂下決心寫下此文以資共勉。
?裝備：
??JDK1.4.1_02，關于這方面的問題，沒必要說了吧。^_^
??Java Web Services Developer Pack 1.2 (http://java.sun.com/webservices/downloads/webservicespack.html)
??我的JWSDP安裝路徑為E:\miniTool\jwsdp-1.2\，文章中直接使用，就不重聲。
?平臺：
??Microsoft Windows 2000 [Version 5.00.2195]
?全文以Google的WebService為例，它提供了一個開發包，http://www.google.com/apis/download.html，但是很多的WebService不會這樣的，只是告訴你一個他們的WSDL(WebService Description Language)文件。但是這都沒有本質的區別的，在Google的開發包中也包含這么一個文件GoogleSearch.wsdl。大多數的WebService客戶端開發，知道了WSDL文件就已經可以了，但是Google呢還需要一個LicenseKey，因為只是測試用，所以這個限制了同一個賬號一天只能夠查詢1000還是2000次，我忘記了，我申請了兩個，在我這個C#的演示站點(http://63.210.240.215/rookieport/)就用到了這兩個LicenseKey(隨機使用)，關于這個C#演示站點的介紹及源文件見http://www10.brinkster.com/rookieport/default.aspx。非常遺憾的是，這兩個站點我都不能夠更新了，世界上從來沒有免費的午餐！！！
?好了，這篇文章的主題是JavaWebService而不是C#WebService，做好準備工作之后，我們稍微分析下WSDL文件，這個文件主要是描述WebService具體使用到了哪些數據結構(types中描述)，提供了哪些Web服務功能(operation中描述)，以及該服務的訪問地址(service中描述)，關于WSDL這里不詳述，找時間補上。在GoogleSearch.wsdl中，我們看到有一個doGoogleSearch的Operation，從名稱上我們可以看出，這個方法應該是提供搜索服務的，前面有一段描述了doGoogleSearch調用的參數：
? <message name="doGoogleSearch">
??? <part name="key"??????????? type="xsd:string"/>
??? <part name="q"????????????? type="xsd:string"/>
??? <part name="start"????????? type="xsd:int"/>
??? <part name="maxResults"???? type="xsd:int"/>
??? <part name="filter"???????? type="xsd:boolean"/>
??? <part name="restrict"?????? type="xsd:string"/>
??? <part name="safeSearch"???? type="xsd:boolean"/>
??? <part name="lr"???????????? type="xsd:string"/>
??? <part name="ie"???????????? type="xsd:string"/>
??? <part name="oe"???????????? type="xsd:string"/>
? </message>
第一個參數就是LicenseKey，第二個參數是要查詢的內容，第三個參數是起始結果頁，對于多頁的結果集合起翻頁作用，第四個參數是定義每頁最大記錄數，后面的參數不是很重要了，其中lr是定義查找的語言類型，假如查找簡體中文可以為lang_zh-CN，ie/oe是輸入和輸出的編碼類型，缺省都為UTF-8。
?再往后面我們看到關于doGoogleSearch的返回類型的描述：
? <message name="doGoogleSearchResponse">
??? <part name="return"???????? type="typens:GoogleSearchResult"/>??????????
? </message>
type="typens:GoogleSearchResult"說明了數據類型的命名空間，我們查找GoogleSearchResult，可以看到他是個復合類型，
????? <xsd:complexType name="GoogleSearchResult">
??????? <xsd:all>
????????? <xsd:element name="documentFiltering"?????????? type="xsd:boolean"/>
????????? <xsd:element name="searchComments"????????????? type="xsd:string"/>
????????? <xsd:element name="estimatedTotalResultsCount"? type="xsd:int"/>
????????? <xsd:element name="estimateIsExact"???????????? type="xsd:boolean"/>
????????? <xsd:element name="resultElements"????????????? type="typens:ResultElementArray"/>
????????? <xsd:element name="searchQuery"???????????????? type="xsd:string"/>
????????? <xsd:element name="startIndex"????????????????? type="xsd:int"/>
????????? <xsd:element name="endIndex"??????????????????? type="xsd:int"/>
????????? <xsd:element name="searchTips"????????????????? type="xsd:string"/>
????????? <xsd:element name="directoryCategories"???????? type="typens:DirectoryCategoryArray"/>
????????? <xsd:element name="searchTime"????????????????? type="xsd:double"/>
??????? </xsd:all>
????? </xsd:complexType>
?這里面用xml語言描述了GoogleSearchResult的數據結構，type="xsd:XXX"的屬性都是簡單數據類型，還用到了兩個復合類型ResultElementArray, DirectoryCategoryArray讀者可以繼續分析，這些數據類型，都會被JWS的解釋轉換工具生成相應的Java類。兩個Array結尾的復合類型，在JWSDP1.1以前也是生成了一個相應的ArrayOfXXXXX的類，現在1.2做得比較好了，，直接映射到java的數組。
?好了我們可以進入客戶端開發的實際性操作的第一步了，首先我們需要編輯一個xml格式的config文件，形式如下：
<?xml version="1.0" encoding="UTF-8"?>
<configuration xmlns="?<wsdl name="SearchService" location="GoogleSearch.wsdl" packageName="rook.searcher"/>
</configuration>
這里面指明了WebService描述文件的位置，可以是本地的也可以是遠程的。后面packageName說明了生成WebService客戶端文件的包名。把這個文件放到GoogleAPI的目錄下。
?
?第二步，啟動控制臺，進入GoogleAPI的目錄
C:\googleapi>dir/w
?Volume in drive C is WIN2K
?Volume Serial Number is 0B73-18E3
?Directory of C:\googleapi
[.]??????????????????????????????? [..]
README.txt???????????????????????? GoogleAPIDemo.java
GoogleSearch.wsdl????????????????? APIs_Reference.html
LICENSE.txt??????????????????????? googleapi.jar
[javadoc]????????????????????????? [dotnet]
[soap-samples]???????????????????? [licenses]
google.config
JavaWebService客戶端簡明攻略.txt
?建立一個client的目錄C:\>mkdir client
?執行WSCompile生成客戶端文件C:\googleapi>E:\miniTool\jwsdp-1.2\jaxrpc\bin\wscompile -gen -d client -keep google.config
?-gen參數告訴編譯器生成WebService客戶端文件，-d client將生成的文件保存的目錄，-keep指示保留中間文件。執行之后，進入client\rook\searcher目錄可以看到生成系列java和java類文件。
?第三步，我們創建客戶端調用文件。查找包含rookie的中文網頁前十條記錄，然后打印標題和Url。
import rook.searcher.*;
import java.rmi.*;
public class Searcher{
?public static void main(String[] args){
??try {
???GoogleSearchPort sport = new GoogleSearchService_Impl().getGoogleSearchPort();
???GoogleSearchResult result = sport.doGoogleSearch("OyGtVqM5YRRS7hFXHLWEodMSEbiZlmc9", "rookie", 0, 10, true, "lang_zh-CN", true, "lang_zh-CN", "UTF-8", "UTF-8");//第一個參數是LicenseKey
???
???ResultElement[] results = result.getResultElements();
???for ( int idx = 0; idx < results.length; idx ++) {
????System.out.println(idx + ": " + results[idx].getTitle() + "\r\n" + results[idx].getURL());
???}?
??} catch (Exception e) {
???e.printStackTrace();
??}
?}
}
?第四步，編譯。這里面用到了jaxrpc-impl包。
C:\googleapi\client>javac -classpath E:\miniTool\jwsdp-1.2\jaxrpc\lib\jaxrpc-impl.jar;. Searcher.java
?第五步，執行。
C:\googleapi\client>java -cp E:\miniTool\jwsdp-1.2\jaxrpc\lib\jaxrpc-impl.jar;E:\miniTool\jwsdp-1.2\jaxrpc\lib\jaxrpc-api.jar;E:\miniTool\jwsdp-1.2\jwsdp-shared\lib\jax-qname.jar;E:\miniTool\jwsdp-1.2\jwsdp-shared\lib\activation.jar;E:\miniTool\jwsdp-1.2\jwsdp-shared\lib\mail.jar;E:\miniTool\jwsdp-1.2\jwsdp-shared\lib\xsdlib.jar;E:\miniTool\jwsdp-1.2\saaj\lib\saaj-api.jar;E:\miniTool\jwsdp-1.2\saaj\lib\saaj-impl.jar;E:\miniTool\jwsdp-1.2\jwsdp-shared\lib\commons-logging.jar;E:\miniTool\jwsdp-1.2\jaxp\lib\endorsed\xercesImpl.jar;E:\miniTool\jwsdp-1.2\jaxp\lib\endorsed\dom.jar;. Searcher
?全文到此結束，講了作JavaWebService客戶端開發的基本步驟，希望能夠拋磚引玉！文中不詳之處，敬請指教：zlyperson@163.net
posted on 2006-03-19 12:11
xnabx 閱讀(409)
評論(0) 編輯 收藏 所屬分類:
1、Java