java ee5中开发web service

在java ee5之前，要使用java技术开发web service，需要借助第三方的框架xfire,axis,cxf等，现在借助最新的java ee5技术，不再需要向项目中引入大量第三方的jar文件，有jdk 6就够了。

 

使用步骤：

1.web service代码

package com.test;

import javax.jws.WebMethod;
import javax.jws.WebParam;
import javax.jws.WebService;
import javax.jws.soap.SOAPBinding;
import javax.jws.soap.SOAPBinding.Style;

@WebService(targetNamespace="http://demo.test.org/hello")
@SOAPBinding(style=Style.RPC)

public class TestService {

 

 @WebMethod(operationName="Hello")
 public String sayHello(@WebParam(name="name")String msg){
  return "Hello :"+msg;
 }

}

代码很简单，不需要实现什么接口，也不需要继承自什么特殊的超类，与普通的java类相比，最大的区别是大量的使用了注释技术。注意上面的@SOAPBinding(style=Style.RPC)不能省略，否则会报异常：

严重: StandardWrapper.Throwable
com.sun.xml.internal.ws.model.RuntimeModelerException: runtime modeler error: Wrapper class com.test.jaxws.SayHello is not found. Have you run APT to generate them?

 

严重: Servlet /m4 threw load() exception
com.sun.xml.internal.ws.model.RuntimeModelerException: runtime modeler error: Wrapper class com.test.jaxws.SayHello is not found. Have you run APT to generate them?

 

2.发布服务

   和以前的web service开发技术相比较，现在需要用程序代码发布一下自己开发的web serivce，新建一个serlvet，在init代码中写发布代码

 

package com.test;

import javax.servlet.ServletException;
import javax.servlet.http.HttpServlet;
import javax.xml.ws.Endpoint;

 

public class WebServiceLoader extends HttpServlet {

 

 private static final long serialVersionUID = 1L;

 public WebServiceLoader() {
  super();
 }

 public void destroy() {
  super.destroy();
 }

 public void init() throws ServletException {
  System.out.println("Web Service发布中......");
  Endpoint.publish("http://0.0.0.0:8081/Hello", new TestService());
  System.out.println("Web Service发布完成");
 }

}

注意端口号问题，上面的示例代码中使用的是8081端口，如果发布到已经被占用的端口将会失败(如tomcat本身工作在8080,如果再发布到8080就会失败！)

 

3.配置servlet自动加载

 

打开web.xml，配置servlet为自动加载

 

  <servlet>
    <servlet-name>WebServiceLoader</servlet-name>
    <servlet-class>com.test.WebServiceLoader</servlet-class>
    <load-on-startup>1</load-on-startup>
  </servlet>

4.访问wsdl

   部署程序，启动容器，如tomcat等，然后打开浏览器，访问 http://localhost:8081/Hello?wsdl  可以看到wsdl描述符。

 

  <?xml version="1.0" encoding="UTF-8" ?>

- <!--

 Published by JAX-WS RI at http://jax-ws.dev.java.net. RI's version is JAX-WS RI 2.1.1 in JDK 6. 

  -->

- <!--

 Generated by JAX-WS RI at http://jax-ws.dev.java.net. RI's version is JAX-WS RI 2.1.1 in JDK 6. 

  -->

- <definitions xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/" xmlns:tns="http://demo.test.org/hello" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns="http://schemas.xmlsoap.org/wsdl/" targetNamespace="http://demo.test.org/hello" name="TestServiceService">

  <types />

- <message name="Hello">

  <part name="name" type="xsd:string" />

  </message>

- <message name="HelloResponse">

  <part name="return" type="xsd:string" />

  </message>

- <portType name="TestService">

- <operation name="Hello" parameterOrder="name">

  <input message="tns:Hello" />

  <output message="tns:HelloResponse" />

  </operation>

  </portType>

- <binding name="TestServicePortBinding" type="tns:TestService">

  <soap:binding transport="http://schemas.xmlsoap.org/soap/http" style="rpc" />

- <operation name="Hello">

  <soap:operation soapAction="" />

- <input>

  <soap:body use="literal" namespace="http://demo.test.org/hello" />

  </input>

- <output>

  <soap:body use="literal" namespace="http://demo.test.org/hello" />

  </output>

  </operation>

  </binding>

- <service name="TestServiceService">

- <port name="TestServicePort" binding="tns:TestServicePortBinding">

  <soap:address location="http://localhost:8081/Hello" />

  </port>

  </service>

  </definitions>