前面几篇
- JAX-WS:创建简单的webservice
- JAX-WS:背后的技术JAXB及传递Map
- JAX-WS:异步与Handler机制
接下来介绍下JAX-WS与其他容器的整合:servlet容器、spring等整合
1、与tomcat整合
JAX-WS与tomcat等servlet容器的整合,我能想到最简单的可能是直接用servlet将发布的代码写在起init方法内,如:
public void init(ServletConfig servletConfig) throws ServletException { super.init(servletConfig); Endpoint.publish("http://localhost:8080/service/jaxWsService", new JaxWsServiceImpl()); }
当然有更好的做法,在JAX-RT有提供与servlet集成的代理类,只需要在你项目中加上相应的依赖。下面是maven的依赖:
com.sun.xml.ws jaxws-rt 2.1.4
接下里按照之前的流程编写服务端代码:
@WebService public class JaxWsWebServiceImpl implements JaxWsWebService { @WebMethod public @WebResult String getMessage() { return "Hello"; } }
由于默认是document-style需要生成返回的代理类:
F:\git\webservice\sws\sws-server\target\classes>wsgen -verbose -keep -cp . -wsdl org.ws.server.ws.chap8.impl.JaxWsWebServiceImpl
接下来是对web.xml的配置:需要加入一个监听器和servlet实例:
com.sun.xml.ws.transport.http.servlet.WSServletContextListener helloJaxWs com.sun.xml.ws.transport.http.servlet.WSServlet 1 helloJaxWs /helloJaxWsWeb
还需要一个指定名为sun-jaxws.xml位于/WEB-INF/下:
在tomcat下运行该工程,访问即可:
http://localhost/sws-server/helloJaxWsWeb?wsdl
这样就完成了与web容器的集成,但是这样会引进很多依赖的包,见jaxws-rt-2.1.3.jar的MANIFEST.MF:
Major-Version: 2.1.3 Class-Path: jaxws-api.jar jsr181-api.jar jsr250-api.jar saaj-api.jar s aaj-impl.jar jsr173_api.jar sjsxp.jar resolver.jar jaxb-api.jar jaxb- impl.jar activation.jar stax-ex.jar streambuffer.jar stax-utils.jar
2、与spring的整合
这里主要考虑spring原生提供的对JAX-WS的支持,位于spring-web-xxx.jar下,分别是SimpleJaxWsServiceExporter和 SimpleHttpServerJaxWsServiceExporter
1、SimpleJaxWsServiceExporter
继承自AbstractJaxWsServiceExporter,在bean的初始化方法发布
@Override protected void publishEndpoint(Endpoint endpoint, WebService annotation) { endpoint.publish(calculateEndpointAddress(endpoint, annotation.serviceName())); }与我们之前介绍的
Endpoint.publish("http://localhost:8080/service/helloJaxWs", new HelloJAXWSImpl());类似,下面是一个配置:
@WebService(serviceName = "jaxWsSpringService") public class JaxWsSpringServiceImpl implements JaxWsSpringService { @WebMethod public String sayHello() { return "Hello JaxWs-Spring"; } }注意这里serviceName需要指定,见上面的annotation.serviceName(),作为访问的方法。下面是spring的配置文件:
在web容器或其他方式运行,这里在main方法测试:
ClassPathXmlApplicationContext xmlApplication = new ClassPathXmlApplicationContext("jaxws-spring.xml");
页面访问http://localhost:8888/service/jaxWsSpringService?wsdl即可
2、SimpleHttpServerJaxWsServiceExporter
同样继承自AbstractJaxWsServiceExporter,在bean的初始化方法发布于SimpleJaxWsServiceExporter类似,只是采用的自定义的HttpServer:
@Override protected void publishEndpoint(Endpoint endpoint, WebService annotation) { endpoint.publish(buildHttpContext(endpoint, annotation.serviceName())); }其中
protected HttpContext buildHttpContext(Endpoint endpoint, String serviceName) { String fullPath = calculateEndpointPath(endpoint, serviceName); HttpContext httpContext = this.server.createContext(fullPath); if (this.filters != null) { httpContext.getFilters().addAll(this.filters); } if (this.authenticator != null) { httpContext.setAuthenticator(this.authenticator); } return httpContext; }因此采用这种配置需要制定server实例,当然也可以配置filters,authenticator等更多的扩展。如一个典型的制定ip访问
public class AuthHandler extends Authenticator { @Override public Result authenticate(HttpExchange httpexchange) { String ip = httpexchange.getRemoteAddress().getAddress().getHostAddress(); if (!("127.0.0.1".equals(ip))) { return new Authenticator.Failure(403); } return new Authenticator.Success(null); } }
具体配置如下:
页面访问http://localhost:8890/ws/jaxWsSpringService?wsdl如果host正确即可见到wsdl文档,否则HTTP 错误 403(Forbidden):服务器拒绝执行该请求
另外spring对JAX-WS的支持还有JAX-WS RI,具体见 http://static.springsource.org/spring/docs/2.5.x/reference/remoting.html#remoting-web-services-jaxws-export-standalone