XFire 最新生火指南(下)
1. JSR181
JSR181式通过annotated POJO ,零配置文件的导出Web服务,是BEA倡导的,JavaEE5里的正规方式, XFire作了良好的支持。
但是,XFire关于JSR181方式的文档还不够清晰,请完整阅读本节以避免其中的数个陷阱。
1.1 参考文章
1.2 ApplicationContext.xml
因为配置都写在annotation,applicationContext.xml文件的内容比较固定。需要注意JSR181WebAnnotations与HandlerMapping不能lazy init.
< beans default-autowire ="byName" default-lazy-init ="true" >
<!-- 引入XFire的预配置文件 -->
< 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导出为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传统模式,窄接口不是必须的,只是考虑到client如果也使用XFire时,有个接口好生成Client而已。
如果采用Interface,Interface将担任主要的配置工作。
首先定义@WebService,可定义自己的NameSpace,如果不定义将采用NameSpace的默认生成算法。
接口中的函数将默认全部导出,不需要再用@WebMethod注释,可以如下例般进行更进一步配置:
@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
陷阱一: 中在Interface中以@WebService(name="BookService")来定义ServiceName,这个做法看起来也比较合理,但实际上需要在Manager中以@WebService(serviceName ="BookService") 来定义,比较古怪。
1.4 纯POJO模式
参考文档中的例子,需要配置@WebMethod 指定需要导出的服务
@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注意事项
陷阱二:和传统模式的client有一点最大的区别,第3个参数需要是实际的Manager类,而不是接口类:
Service serviceModel = new AnnotationServiceFactory().create(BookManager. class );
2. Client
XFire的Client并不算强项,一共有三种模式:
2.1 Client开发者拥有Web服务端的class
Client与Server是同一个开发团队也好,Server端团队以jar形式提供开发包也好,反正如果能拿到服务端的接口Class和Entity类及aegis 配置文件的话。
传统模式:
Service serviceModel = new ObjectServiceFactory().create(BookService. class );
BookService service = (BookService) new XFireProxyFactory().create(serviceModel, serviceURL);
service.findBooksByCategory(cateoryId);
JSR181模式,注意这里Server端开发组需要向Client提供BookService的实现类BookManager,而不止于接口类,有点危险:
SpringSide 用泛型封装了一个XFireClientFactory,调用代码如下:
Service serviceModel = new AnnotationServiceFactory().create(BookManager. class );
BookService = (BookService) new XFireProxyFactory().create(serviceModel, serviceURL);
service.findBooksByCategory(cateoryId);
BookService service = XFireClientFactory.getClient(serviceURL, BookService. class );
BookService service = XFireClientFactory.getJSR181Client(serviceURL, BookService. class , BookManager. class );
2.2 动态模式
动态模式不需要服务端的class,不过性能和复杂对象映射等估计做得不会太好。
Client client = new Client(new URL("http://www.webservicex.net/CurrencyConvertor.asmx?WSDL"));
Object[] results = client.invoke("ConversionRate", new Object[] {"BRL", "UGX"});
2.3 根据WSDL生成Client Stub
这才是Web Service Client的王道,可以访问任意编写下的Web Service,将在下一个版本中演示。
3. 测试
XFiire很重要的一个特性是提供了无须启动Web容器也能进行单元测试的能力。
原理就是利用XFire的JVM模式,以xfire.local://BookService channel而不是来访问服务。
测试的方式分两种:
一种是纯服务器角度,不编写客户端代码,以SOAP XML形式发送请求,返回的也是SOAP XML字串,直接对XML进行测试。
一种是编写2.1 中Client代码来进行测试。
前一种的测试的隔离度较高,而后一种比较简便。
3.1 测试基类
无论那种方式,都使用Xfire的AbstractXFireSpringTest基类,实现createContext()回调函数。
protected ApplicationContext createContext() {
return ClassPathXmlApplicationContext( new String[]{ " classpath*:applicationContext*.xml " });
}
另外测试基类还要完成一个很重要的工作就是要解决Hibernate的LazyLoad问题,做到OpenSession In Test。因此,SpringSide专门封装了一个XFireTestCase的基类。
3.2 用Client代码直接测试
下文直接用client代码调用findBooksByCategory方法,得到返回值后进行各种Assert判断。
注意和普通client code的两处区别:servericeURL换成local,factory须加入getXFire()作参数。
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 纯服务端测试
编写一段SOAP XML,以任意命名保存,下文以"Java"作参数,调用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 >
测试代码调用前面的XML,返回XML Document对象,再用基类提供的一些Assert方法检查结果:
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);
1. JSR181
JSR181式通过annotated POJO ,零配置文件的导出Web服务,是BEA倡导的,JavaEE5里的正规方式, XFire作了良好的支持。
但是,XFire关于JSR181方式的文档还不够清晰,请完整阅读本节以避免其中的数个陷阱。
1.1 参考文章
1.2 ApplicationContext.xml
因为配置都写在annotation,applicationContext.xml文件的内容比较固定。需要注意JSR181WebAnnotations与HandlerMapping不能lazy init.
1.3 Interface Impl模式
< beans default-autowire ="byName" default-lazy-init ="true" >
<!-- 引入XFire的预配置文件 -->
< 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导出为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 >
不同于XFire传统模式,窄接口不是必须的,只是考虑到client如果也使用XFire时,有个接口好生成Client而已。
如果采用Interface,Interface将担任主要的配置工作。
首先定义@WebService,可定义自己的NameSpace,如果不定义将采用NameSpace的默认生成算法。
接口中的函数将默认全部导出,不需要再用@WebMethod注释,可以如下例般进行更进一步配置:
@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
陷阱一: 中在Interface中以@WebService(name="BookService")来定义ServiceName,这个做法看起来也比较合理,但实际上需要在Manager中以@WebService(serviceName ="BookService") 来定义,比较古怪。
1.4 纯POJO模式
参考文档中的例子,需要配置@WebMethod 指定需要导出的服务
@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注意事项
陷阱二:和传统模式的client有一点最大的区别,第3个参数需要是实际的Manager类,而不是接口类:
Service serviceModel = new AnnotationServiceFactory().create(BookManager. class );
2. Client
XFire的Client并不算强项,一共有三种模式:
2.1 Client开发者拥有Web服务端的class
Client与Server是同一个开发团队也好,Server端团队以jar形式提供开发包也好,反正如果能拿到服务端的接口Class和Entity类及aegis 配置文件的话。
传统模式:
Service serviceModel = new ObjectServiceFactory().create(BookService. class );
BookService service = (BookService) new XFireProxyFactory().create(serviceModel, serviceURL);
service.findBooksByCategory(cateoryId);
JSR181模式,注意这里Server端开发组需要向Client提供BookService的实现类BookManager,而不止于接口类,有点危险:
Service serviceModel = new AnnotationServiceFactory().create(BookManager. class );
BookService = (BookService) new XFireProxyFactory().create(serviceModel, serviceURL);
service.findBooksByCategory(cateoryId);
SpringSide 用泛型封装了一个XFireClientFactory,调用代码如下:
BookService service = XFireClientFactory.getClient(serviceURL, BookService. class );
BookService service = XFireClientFactory.getJSR181Client(serviceURL, BookService. class , BookManager. class );
2.2 动态模式
动态模式不需要服务端的class,不过性能和复杂对象映射等估计做得不会太好。
Client client = new Client(new URL("http://www.webservicex.net/CurrencyConvertor.asmx?WSDL"));
Object[] results = client.invoke("ConversionRate", new Object[] {"BRL", "UGX"});
2.3 根据WSDL生成Client Stub
这才是Web Service Client的王道,可以访问任意编写下的Web Service,将在下一个版本中演示。
3. 测试
XFiire很重要的一个特性是提供了无须启动Web容器也能进行单元测试的能力。
原理就是利用XFire的JVM模式,以xfire.local://BookService channel而不是来访问服务。
测试的方式分两种:
一种是纯服务器角度,不编写客户端代码,以SOAP XML形式发送请求,返回的也是SOAP XML字串,直接对XML进行测试。
一种是编写2.1 中Client代码来进行测试。
前一种的测试的隔离度较高,而后一种比较简便。
3.1 测试基类
无论那种方式,都使用Xfire的AbstractXFireSpringTest基类,实现createContext()回调函数。
protected ApplicationContext createContext() {
return ClassPathXmlApplicationContext( new String[]{ " classpath*:applicationContext*.xml " });
}
另外测试基类还要完成一个很重要的工作就是要解决Hibernate的LazyLoad问题,做到OpenSession In Test。因此,SpringSide专门封装了一个XFireTestCase的基类。
3.2 用Client代码直接测试
下文直接用client代码调用findBooksByCategory方法,得到返回值后进行各种Assert判断。
注意和普通client code的两处区别:servericeURL换成local,factory须加入getXFire()作参数。
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 纯服务端测试
编写一段SOAP XML,以任意命名保存,下文以"Java"作参数,调用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 >
测试代码调用前面的XML,返回XML Document对象,再用基类提供的一些Assert方法检查结果:
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);
————————————————
这篇好文章是转载于:学新通技术网
- 版权申明: 本站部分内容来自互联网,仅供学习及演示用,请勿用于商业和其他非法用途。如果侵犯了您的权益请与我们联系,请提供相关证据及您的身份证明,我们将在收到邮件后48小时内删除。
- 本站站名: 学新通技术网
- 本文地址: /boutique/detail/tanhibggca
-
photoshop保存的图片太大微信发不了怎么办
PHP中文网 06-15 -
word里面弄一个表格后上面的标题会跑到下面怎么办
PHP中文网 06-20 -
photoshop扩展功能面板显示灰色怎么办
PHP中文网 06-14 -
《学习通》视频自动暂停处理方法
HelloWorld317 07-05 -
TikTok加速器哪个好免费的TK加速器推荐
TK小达人 10-01 -
Android 11 保存文件到外部存储,并分享文件
Luke 10-12 -
微信公众号没有声音提示怎么办
PHP中文网 03-31 -
excel下划线不显示怎么办
PHP中文网 06-23 -
微信运动停用后别人还能看到步数吗
PHP中文网 07-22 -
excel打印预览压线压字怎么办
PHP中文网 06-22