很久沒(méi)寫(xiě)原創(chuàng )文章了。今天奉獻給大家的是關(guān)于 Web Service 方面的文章。說(shuō)起來(lái)慚愧，關(guān)于 Web Service，我從大二的時(shí)候就開(kāi)始關(guān)注了，那時(shí)在做一套學(xué)生管理系統，可能是好奇，可能是圖新鮮，可能是被跨平臺所吸引，在還沒(méi)弄得很清楚的情況下就迷戀上了這種技術(shù)，抱著(zhù)李維的《Delphi 6/Kylix 2 SOAP/Web Service程序設計篇》狂啃，到了大三也沒(méi)作出個(gè)像樣的東西:(。大四上學(xué)期，簽到 AUO 實(shí)習，并在 AUO 做畢設，畢設選題還是 Web Service 方面，論文洋洋灑灑寫(xiě)了一大篇，結果，到了最后的程序實(shí)現時(shí)，僅僅是以 XML 格式進(jìn)行數據庫和 Web 頁(yè)面的交互而已。（再慚愧一次）
重新?lián)炱?Web Service 是去年的事情，當時(shí)評估了多種開(kāi)源 SSO 實(shí)現，總覺(jué)得不是很方便，遂打算自己實(shí)現。為了使通用性更高，決定讓 Web Service 完成。并很自然的選到了 Axis。
SOAP、WSDL、UDDI，這些名詞相信只要了解過(guò) Web Service 的都不陌生，根據 Apache 的定義，Axis 是一種 W3C SOAP 實(shí)現，國內有些介紹還特別注明了：Axis 并不完全是 SOAP 引擎，它還包括獨立的 SOAP 服務(wù)器、嵌入 Servlet 引擎的服務(wù)器、支持 WSDL 并提供轉化 WSDL 為 Java 類(lèi)的工具、例子程序、TCP/IP 數據包監視工具，等等。Axis 部署 Web Serive 有兩種方式，最簡(jiǎn)單的是拷貝 java 源代碼文件到 web 文件夾下把擴展名改為 .jws 直接調用，可參考這篇文章：
用Axis 1.1 for Java進(jìn)行Web Services開(kāi)發(fā)(1)。另一種方式是通過(guò) WSDD（Web Services描述文檔）部署，可參考：
使用Axis發(fā)布簡(jiǎn)單的Web服務(wù)。在我的應用中，使用的是后者，以便 Axis 進(jìn)行自動(dòng)序列化/反序列化處理。
實(shí)現一次 SSO 登陸驗證，最少要傳入用戶(hù)名、密碼。為了達到這種目的，在客戶(hù)端我們構造 User 對象（本文中 User 對象僅包含用戶(hù)名和密碼），并通過(guò) Axis 自動(dòng)序列化傳遞出去；到了 SSO 端，Axis 自動(dòng)反序列化之后還原成 User 對象；最后返回給客戶(hù)端說(shuō)明本次登陸的結果，返回的結果不僅僅包含例如“登陸成功”之類(lèi)的簡(jiǎn)單信息，也許還有很多其他信息，看來(lái)創(chuàng )建一個(gè)叫做 Respond 的對象（本文中 Respond 對象僅包含登陸 ID 和結果描述）很有必要了，把 Respond 傳回給客戶(hù)端說(shuō)明登陸結果。
暴露給客戶(hù)端供登陸驗證的服務(wù)類(lèi)是 AuthService。該類(lèi)代碼簡(jiǎn)單表示如下：
public class AuthService {
/**
* 驗證用戶(hù)名和密碼
* @param String userName 用戶(hù)名
* @param String passWord 密碼
* @return Respond 登陸驗證后返回
*/
public Respond login(User user){
String name = user.getName();
String password = user.password();
//進(jìn)行數據庫驗證
//..
//
Respond respond = new Respond();
respond.setId("123");
respond.setDesc("登陸成功");
return respond;
}
} User 和 Respond 以及服務(wù)類(lèi)都寫(xiě)好了。通過(guò)命令行方式，我生成了 server-config.wsdd，內容如下：
<?xml version="1.0" encoding="UTF-8"?>
<deployment xmlns="http://xml.apache.org/axis/wsdd/" xmlns:java="http://xml.apache.org/axis/wsdd/providers/java">
<globalConfiguration>
<parameter name="sendMultiRefs" value="true"/>
<parameter name="disablePrettyXML" value="true"/>
<parameter name="adminPassword" value="admin"/>
<parameter name="attachments.Directory" value="D:\workspace\SSO\web\WEB-INF\attachments"/>
<parameter name="dotNetSoapEncFix" value="true"/>
<parameter name="enableNamespacePrefixOptimization" value="true"/>
<parameter name="sendXMLDeclaration" value="true"/>
<parameter name="sendXsiTypes" value="true"/>
<parameter name="attachments.implementation" value="org.apache.axis.attachments.AttachmentsImpl"/>
<requestFlow>
<handler type="java:org.apache.axis.handlers.JWSHandler">
<parameter name="scope" value="session"/>
</handler>
<handler type="java:org.apache.axis.handlers.JWSHandler">
<parameter name="scope" value="request"/>
<parameter name="extension" value=".jwr"/>
</handler>
</requestFlow>
</globalConfiguration>
<handler name="LocalResponder" type="java:org.apache.axis.transport.local.LocalResponder"/>
<handler name="URLMapper" type="java:org.apache.axis.handlers.http.URLMapper"/>
<handler name="Authenticate" type="java:org.apache.axis.handlers.SimpleAuthenticationHandler"/>
<service name="AuthService" provider="java:RPC">
<parameter name="allowedMethods" value="*"/>
<parameter name="className" value="com.cdmcs.sso.AuthService"/>
<beanMapping languageSpecificType="java:sso.Respond" qname="ns:resp" xmlns:ns="urn:BeanService"/>
<beanMapping languageSpecificType="java:sso.User" qname="ns:user" xmlns:ns="urn:BeanService"/>
</service>
<service name="AdminService" provider="java:MSG">
<parameter name="allowedMethods" value="AdminService"/>
<parameter name="enableRemoteAdmin" value="false"/>
<parameter name="className" value="org.apache.axis.utils.Admin"/>
<namespace>http://xml.apache.org/axis/wsdd/</namespace>
</service>
<service name="Version" provider="java:RPC">
<parameter name="allowedMethods" value="getVersion"/>
<parameter name="className" value="org.apache.axis.Version"/>
</service>
<transport name="http">
<requestFlow>
<handler type="URLMapper"/>
<handler type="java:org.apache.axis.handlers.http.HTTPAuthHandler"/>
</requestFlow>
<parameter name="qs:list" value="org.apache.axis.transport.http.QSListHandler"/>
<parameter name="qs:wsdl" value="org.apache.axis.transport.http.QSWSDLHandler"/>
<parameter name="qs.list" value="org.apache.axis.transport.http.QSListHandler"/>
<parameter name="qs.method" value="org.apache.axis.transport.http.QSMethodHandler"/>
<parameter name="qs:method" value="org.apache.axis.transport.http.QSMethodHandler"/>
<parameter name="qs.wsdl" value="org.apache.axis.transport.http.QSWSDLHandler"/>
</transport>
<transport name="local">
<responseFlow>
<handler type="LocalResponder"/>
</responseFlow>
</transport>
</deployment>
要說(shuō)明的是，深究上述配置文件具體含義不是本文的目的，要對其具體了解，請參考 Axis 文檔。其中，只有下面的 XML 才是我們感興趣的：
<service name="AuthService" provider="java:RPC">
<parameter name="allowedMethods" value="*"/>
<parameter name="className" value="com.cdmcs.sso.AuthService"/>
<beanMapping languageSpecificType="java:sso.Respond" qname="ns:resp" xmlns:ns="urn:BeanService"/>
<beanMapping languageSpecificType="java:sso.bo.User" qname="ns:user" xmlns:ns="urn:BeanService"/>
</service>
為了完成自動(dòng)序列化/反序列化，我們使用“beanMapping”元素指定要進(jìn)行處理的 bean 文件。只有在 WSDD 中定義了這些，才能享受到 Axis 帶來(lái)的自動(dòng)序列化/反序列化優(yōu)勢。
客戶(hù)端代碼：
public class TestClient {
public static void main(String[] args) {
try {
String endpoint = "http://127.0.0.1:8080/services/AuthService?wsdl";
Service service = new Service();
Call call = (Call) service.createCall();
QName qn = new QName("urn:BeanService","resp");
QName qx = new QName("urn:BeanService","user");
//注冊 bean
call.registerTypeMapping(Respond.class,qn,new BeanSerializerFactory(Respond.class, qn),new BeanDeserializerFactory(Respond.class, qn));
call.registerTypeMapping(User.class,qx,new BeanSerializerFactory(User.class, qx),new BeanDeserializerFactory(User.class, qx));
call.setTargetEndpointAddress(new java.net.URL(endpoint));
call.setOperationName(new QName("http://soapinterop.org/","login"));
User user = new User();
mul.setName("test");
mul.setPassword("test");
Respond respond = (Reopond) call.invoke(new Object[] {user});
System.out.println("登陸，返回‘" + respond.getDesc() + "‘。");
} catch (Exception e) {
e.printStackTrace();
}
}
}
正如我們期望的，打印出“登陸成功”。通過(guò)上面的范例，我們發(fā)現，Axis 的自動(dòng)序列化/反序列化機制還是很方便的，除了 bean 以外，其他類(lèi)型的對象也可以讓 Axis 來(lái)完成，具體參考 Axis 文檔，如果要傳遞的對象 Axis 未提供自動(dòng)序列化/反序列化支持，請考慮人工實(shí)現，參考：
深度編程Axis序列化/反序列化器開(kāi)發(fā)指南。
