jax-ws handler 的详解及简单实例

 jax-ws handler 的详解及简单实例

aop技术一般用于某个对象的函数调用的日志，认证等。

webservice是远程的函数调用，也需要类似的aop方法，举例jax-ws的webservice，handler就相当于aop。

举一例jax-ws handler例子

先写个webservice

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的内容

<?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的具体实现：

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中添加：

<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的内容为：

<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客户端测试的。

如有疑问请留言或者到本站社区交流讨论，感谢阅读，希望能帮助到大家，谢谢大家对本站的支持！