jax-ws handler 的详解及简单实例
aop技术一般用于某个对象的函数调用的日志,认证等。
webservice是远程的函数调用,也需要类似的aop方法,举例jax-ws的webservice,handler就相当于aop。
举一例jax-ws handler例子
先写个webservice
1
2
3
4
5
6
7
8
9
10
11
12
13
14
|
import javax.jws.HandlerChain; import javax.jws.WebMethod; import javax.jws.WebService; @WebService @HandlerChain (file= "handlers.xml" ) public class Hello { @WebMethod () public String sayHello(String name) { return "Hello " + name + "." ; } } |
超级傻瓜的webservice,唯一特别的就是@HandlerChain标注,其中的handlers.xml是一个描述jax-ws 的handler链的xml文件,这个文件可以放在与此源文件同一目录下。
来看一下handlers.xml的内容
1
2
3
4
5
6
7
8
9
|
<?xml version= "1.0" encoding= "UTF-8" ?> <handler-chains xmlns= "http://java.sun.com/xml/ns/javaee" > <handler-chain> <handler> <handler-name>ServiceSOAPHandler</handler-name> <handler- class >com.ws.handler.HelloHandler</handler- class > </handler> </handler-chain> </handler-chains> |
其中定义了handler链,链里只有一个handler,也可以包括多个handler
再看看handler的具体实现:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
|
import java.util.Set; import javax.xml.namespace.QName; import javax.xml.ws.handler.MessageContext; import javax.xml.ws.handler.soap.SOAPHandler; import javax.xml.ws.handler.soap.SOAPMessageContext; public class HelloHandler implements SOAPHandler<SOAPMessageContext> { @Override public boolean handleMessage(SOAPMessageContext context) { System.out.println(context.get(MessageContext.WSDL_SERVICE).toString()); return true ; } @Override public boolean handleFault(SOAPMessageContext context) { // TODO Auto-generated method stub return true ; } @Override public void close(MessageContext context) { // TODO Auto-generated method stub } @Override public Set<QName> getHeaders() { // TODO Auto-generated method stub return null ; } } |
一个handler必须实现SOAPHandler或LogicalHandler接口,至于他们两者的区别,与Handler接口的关系,以及<>中的XXXContext的意义,请参考jaxws的spec,这里只是helloworld例子。
所有接口定义的方法实际上我就实现了一个,打印了被调用的webservice的名字,实际上可以在这里做很多事情,比如修改soap中的内容,添加或删除xml的标签,添加删除soap附件,获取soap相关的字段,更形象的功能可以有加解密,日志等等。
最后还要做一些相关配置文件修改:
在web.xml中添加:
1
2
3
4
5
6
7
8
9
10
11
12
13
|
< listener > < listener-class >com.sun.xml.ws.transport.http.servlet.WSServletContextListener</ listener-class > </ listener > < servlet > < servlet-name >wsservlet</ servlet-name > < servlet-class >com.sun.xml.ws.transport.http.servlet.WSServlet</ servlet-class > < load-on-startup >1</ load-on-startup > </ servlet > < servlet-mapping > < servlet-name >wsservlet</ servlet-name > < url-pattern >/helloservice</ url-pattern > </ servlet-mapping > |
实际上当有类标有@webservice的标注,容器会自动把他变成一个webservice,但是我试过这里必须要用上面这种方法,也就是利用jaxws的运行时以wsservlet来匹配请求,并且在之前就通过wsservletcontextlistener在初始上下文时就指定加载某个类作为webservice,这个listener会自动检测webroot下(和web.xml同一目录)的名为sun-jaxws.xml的文件,其中包含了webservice具体实现的表述。
在这里sun-jaxws.xml的内容为:
1
2
3
4
5
6
7
8
9
10
|
< endpoints xmlns = "http://java.sun.com/xml/ns/jax-ws/ri/runtime" version = "2.0" > < endpoint name = "helloservice" implementation = "com.ws.service.Hello" url-pattern = "/helloservice" /> </ endpoints > |
这其中指定的那个实现可以是一个有@Webservice的类,也可以是实现Provider接口的类,相关Provider可以查看官方spec,它是jax-rs的基础。
打包,部署,我是部署在glassfish里的,找个webservice的测试工具,eclipse jee套装里有自带的webservice客户端测试的。
如有疑问请留言或者到本站社区交流讨论,感谢阅读,希望能帮助到大家,谢谢大家对本站的支持!
原文链接:http://blog.csdn.net/chyroger/article/details/6387871