XFire生火指南下半部，主要包括JSR181,Client API與測試部分。
作者：江南白衣
本文來自SpringSide WIki，請留意Wiki上的最新版本。(wiki于11.27更新)。
請先閱讀：XFire生火指南(上)
1. JSR181
JSR181式通過annotated POJO ，零配置文件的導(dǎo)出Web服務(wù)，是BEA倡導(dǎo)的，JavaEE5里的正規(guī)方式， XFire作了良好的支持。
但是，XFire關(guān)于JSR181方式的文檔還不夠清晰，請完整閱讀本節(jié)以避免其中的數(shù)個陷阱。
1.1 參考文章
- Spring, Hibernate and XFire
- Webservices with Spring, XFire and jsr181
- Basic Spring Web services with XFire and JSR 181
- XFire JSR181參考文檔
1.2 ApplicationContext.xml
因為配置都寫在annotation，applicationContext.xml文件的內(nèi)容比較固定。需要注意JSR181WebAnnotations與HandlerMapping不能lazy init.
<beans default-autowire="byName" default-lazy-init="true">
<!--引入XFire的預(yù)配置文件-->
<import resource="classpath:org/codehaus/xfire/spring/xfire.xml"/>
<!-- 獲得applicationContext中所有bean的JSR181 annotation -->
<bean id="webAnnotations" class="org.codehaus.xfire.annotations.jsr181.Jsr181WebAnnotations" lazy-init="false"/>
<!-- 定義handler mapping,將所有JSR181定義的bean導(dǎo)出為web service -->
<bean id="jsr181HandlerMapping" class="org.codehaus.xfire.spring.remoting.Jsr181HandlerMapping" lazy-init="false">
<property name="xfire" ref="xfire"/>
<property name="webAnnotations" ref="webAnnotations"/>
</bean>
</beans>
1.3 Interface+Impl模式
不同于XFire傳統(tǒng)模式，窄接口不是必須的，只是考慮到client如果也使用XFire時，有個接口好生成Client而已。
如果采用Interface，Interface將擔(dān)任主要的配置工作。
首先定義@WebService，可定義自己的NameSpace，如果不定義將采用NameSpace的默認(rèn)生成算法。
接口中的函數(shù)將默認(rèn)全部導(dǎo)出，不需要再用@WebMethod注釋，可以如下例般進(jìn)行更進(jìn)一步配置：
@WebService(targetNamespace = "http://www.springside.org.cn")
public interface BookService {
@WebResult(name = "SearchResult")
List<Book> findBooksByCategory(@WebParam(name = "category", header = true)String cateoryId);
}
Manager不是純粹的POJO，需要帶上@WebService注釋，指明InterFace。
@WebService(serviceName = "BookService",
endpointInterface = "org.springside.bookstore.components.xfire.server.jsr181.BookService")
public class BookManager implements BookService {...}
陷阱一：XFire JSR181參考文檔 中在Interface中以@WebService(name="BookService")來定義ServiceName，這個做法看起來也比較合理，但實際上需要在Manager中以@WebService(serviceName ="BookService") 來定義，比較古怪。
1.4 純POJO模式
參考文檔中的例子，需要配置@WebMethod 指定需要導(dǎo)出的服務(wù)
@WebService(name = "EchoService", targetNamespace = "http://www.openuri.org/2004/04/HelloWorld")
public class Jsr181EchoService
{
@WebMethod(operationName = "echoString", action = "urn:EchoString")
@WebResult(name = "echoResult")
public String echo(@WebParam(name = "echoParam", header = true) String input)
{
return input;
}
}
1.5 Client注意事項
陷阱二：和傳統(tǒng)模式的client有一點(diǎn)最大的區(qū)別，第3個參數(shù)需要是實際的Manager類，而不是接口類：
Service serviceModel = new AnnotationServiceFactory().create(BookManager.class);
2. Client
XFire的Client并不算強(qiáng)項，一共有三種模式：
2.1 Client開發(fā)者擁有Web服務(wù)端的class
Client與Server是同一個開發(fā)團(tuán)隊也好，Server端團(tuán)隊以jar形式提供開發(fā)包也好，反正如果能拿到服務(wù)端的接口Class和Entity類及aegis 配置文件的話。
傳統(tǒng)模式：
Service serviceModel = new ObjectServiceFactory().create(BookService.class);
BookService service = (BookService) new XFireProxyFactory().create(serviceModel, serviceURL);
service.findBooksByCategory(cateoryId);
JSR181模式，注意這里Server端開發(fā)組需要向Client提供BookService的實現(xiàn)類BookManager，而不止于接口類，有點(diǎn)危險：
Service serviceModel = new AnnotationServiceFactory().create(BookManager.class);
BookService = (BookService) new XFireProxyFactory().create(serviceModel, serviceURL);
service.findBooksByCategory(cateoryId);
SpringSide 用泛型封裝了一個XFireClientFactory，調(diào)用代碼如下：
BookService service = XFireClientFactory.getClient(serviceURL, BookService.class);
BookService service = XFireClientFactory.getJSR181Client(serviceURL, BookService.class, BookManager.class);
2.2 動態(tài)模式
動態(tài)模式不需要服務(wù)端的class，不過性能和復(fù)雜對象映射等估計做得不會太好。
Client client = new Client(new URL("http://www.webservicex.net/CurrencyConvertor.asmx?WSDL"));
Object[] results = client.invoke("ConversionRate", new Object[] {"BRL", "UGX"});
2.3 根據(jù)WSDL生成Client Stub
這才是Web Service Client的王道，可以訪問任意編寫下的Web Service，將在下一個版本中演示。
3. 測試
XFiire很重要的一個特性是提供了無須啟動Web容器也能進(jìn)行單元測試的能力。
原理就是利用XFire的JVM模式，以xfire.local://BookService channel而不是http://localhost/service/BookService來訪問服務(wù)。
測試的方式分兩種：
一種是純服務(wù)器角度，不編寫客戶端代碼，以SOAP XML形式發(fā)送請求，返回的也是SOAP XML字串，直接對XML進(jìn)行測試。
一種是編寫2.1 中Client代碼來進(jìn)行測試。
前一種的測試的隔離度較高，而后一種比較簡便。
3.1 測試基類
無論那種方式，都使用Xfire的AbstractXFireSpringTest基類，實現(xiàn)createContext()回調(diào)函數(shù)。
protected ApplicationContext createContext() {
return ClassPathXmlApplicationContext(new String[]{"classpath*:applicationContext*.xml"});
}
另外測試基類還要完成一個很重要的工作就是要解決Hibernate的LazyLoad問題，做到OpenSession In Test。因此，SpringSide專門封裝了一個XFireTestCase的基類。
3.2 用Client代碼直接測試
下文直接用client代碼調(diào)用findBooksByCategory方法，得到返回值后進(jìn)行各種Assert判斷。
注意和普通client code的兩處區(qū)別：servericeURL換成local，factory須加入getXFire()作參數(shù)。
Service serviceModel = new ObjectServiceFactory().create(BookService.class);
XFireProxyFactory factory = new XFireProxyFactory(getXFire());
BookService service = (BookService) factory.create(serviceModel, "xfire.local://BookService");
List list = service.findBooksByCategory("0");
assertNotNull(list);
...
3.3 純服務(wù)端測試
編寫一段SOAP XML，以任意命名保存，下文以"Java"作參數(shù)，調(diào)用findBooksByName方法。
<env:Envelope xmlns:env="http://schemas.xmlsoap.org/soap/envelope/">
<env:Header/>
<env:Body>
<findBooksByName xmlns="http://www.springside.org.cn">
<in1>Java</in1>
</findBooksByName>
</env:Body>
</env:Envelope>
測試代碼調(diào)用前面的XML，返回XML Document對象，再用基類提供的一些Assert方法檢查結(jié)果：
Document doc = invokeService("BookService","/org/springside/xfire/BookService.FindBooksByName.xml");
assertNoFault(doc);
addNamespace("ss", "http://domain.commons.bookstore.springside.org");
assertValid("//ss:Book/ss:category/ss:descn= "Java Book"", doc);