JDK1.6的JAX-WS编写WebService【转】 生成客户端代码

 

使用JDK1.6的JAX-WS编写WebService

JAX-WS规范是一组XML web services的JAVA API。JAX-WS允许开发者可以选择RPC-oriented或者message-oriented 来实现自己的web services。下面我们就用JAX-WS实现简单的Web services吧。

AD：

一、Web services概念

Web services是客户端和服务端通过万维网的HTTP协议进行交互。

二、JAX-WS实现简单的Web services

2.1 建一个名为HelloServer的Web应用作为Webservice客户端

2.2 在HelloServer应用下新建一个类：

package helloservice.endpoint;
import javax.jws.WebMethod;
import javax.jws.WebService;
@WebService
public class Hello {
    private String message = new String("Hello, ");
    public void Hello() {
    }
    @WebMethod
    public String sayHello(String name) {
        return message + name + ".";
    }
}

2.3 在weblogic下发布HelloServer应用,应用名为WebRoot。

2.4 在IE里面打开http://localhost:7001/WebRoot/HelloService?wsdl

如果可以查看到wsdl的内容说明发布成功.比如：

  xml version="1.0" encoding="UTF-8" ?>
-
-
- <definitions xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/"
 xmlns:tns="http://endpoint.helloservice/"
 xmlns:xsd="http://www.w3.org/2001/XMLSchema"
 xmlns="http://schemas.xmlsoap.org/wsdl/"
 targetNamespace="http://endpoint.helloservice/"
 name="HelloService">
- <types>
- <xsd:schema>
  <xsd:import namespace="http://endpoint.helloservice/" schemaLocation="http://localhost:7001/WebRoot/HelloService?xsd=1" />
  xsd:schema>
  types>
- <message name="sayHello">
  <part name="parameters" element="tns:sayHello" />
  message>
- <message name="sayHelloResponse">
  <part name="parameters" element="tns:sayHelloResponse" />
  message>
- <portType name="Hello">
- <operation name="sayHello">
  <input message="tns:sayHello" />
  <output message="tns:sayHelloResponse" />
  operation>
  portType>
- <binding name="HelloPortBinding" type="tns:Hello">
  <soap:binding transport="http://schemas.xmlsoap.org/soap/http" style="document" />
- <operation name="sayHello">
  <soap:operation soapAction="" />
- <input>
  <soap:body use="literal" />
  input>
- <output>
  <soap:body use="literal" />
  output>
  operation>
  binding>
- <service name="HelloService">
- <port name="HelloPort" binding="tns:HelloPortBinding">
  <soap:address location="http://localhost:7001/WebRoot/HelloService" />
  port>
  service>
  definitions>

2.5 运行wsimport

wsimport是JDK1.6特有的,[JAVA_HOME]/bin下。

2.5.1 在E:\Program Files\PowerCmd>目录下,新建一个文件夹generate。

2.5.2 运行如下命令：

wsimport -s generate http://localhost:7001/WebRoot/HelloService?wsdl

如果返回

parsing WSDL...
generating code...

说明运行成功。

2.5.3 查看generate目录,可以看到生成了JAVA文件,与generate同级的目录下,还有class文件。(这里生成的JAVA文件,客户端需要用到)

生成的HelloService.java如下：

package helloservice.endpoint;
import java.net.MalformedURLException;
import java.net.URL;
import javax.xml.namespace.QName;
import javax.xml.ws.Service;
import javax.xml.ws.WebEndpoint;
import javax.xml.ws.WebServiceClient;
import javax.xml.ws.WebServiceFeature;
/**
 * This class was generated by the JAX-WS RI.
 * JAX-WS RI 2.1.1 in JDK 6
 * Generated source version: 2.1
 *
 */
@WebServiceClient(name = "HelloService", targetNamespace = "http://endpoint.helloservice/", wsdlLocation = "http://localhost:7001/WebRoot/HelloService?wsdl")
public class HelloService
    extends Service
{
    private final static URL HELLOSERVICE_WSDL_LOCATION;
    static {
        URL url = null;
        try {
            url = new URL("http://localhost:7001/WebRoot/HelloService?wsdl");
        } catch (MalformedURLException e) {
            e.printStackTrace();
        }
        HELLOSERVICE_WSDL_LOCATION = url;
    }

    public HelloService(URL wsdlLocation, QName serviceName) {
        super(wsdlLocation, serviceName);
    }

    public HelloService() {
        super(HELLOSERVICE_WSDL_LOCATION, new QName("http://endpoint.helloservice/", "HelloService"));
    }
    /**
     *
     * @return
     *     returns Hello
     */
    @WebEndpoint(name = "HelloPort")
    public Hello getHelloPort() {
        return (Hello)super.getPort(new QName("http://endpoint.helloservice/", "HelloPort"), Hello.class);
    }
    /**
     *
     * @param features
     *     A list of {@link javax.xml.ws.WebServiceFeature} to configure on the proxy.  Supported features not in the features parameter will have their default values.
     * @return
     *     returns Hello
     */
    @WebEndpoint(name = "HelloPort")
    public Hello getHelloPort(WebServiceFeature... features) {
        return (Hello)super.getPort(new QName("http://endpoint.helloservice/", "HelloPort"), Hello.class, features);
    }
}

2.6 建一个名为HelloClient的Web应用作为WebService客户端。

2.7 将3.5.3生成的JAVA文件复制到HelloClient的src下。

2.8 新建一个HelloServlet文件，如下：

package webclient;
import helloservice.endpoint.HelloService;
import java.io.IOException;
import java.io.PrintWriter;
import javax.servlet.ServletException;
import javax.servlet.annotation.WebServlet;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import javax.xml.ws.WebServiceRef;

@WebServlet(name = "HelloServlet", urlPatterns = { "/HelloServlet" })
public class HelloServlet extends HttpServlet {
    @WebServiceRef(wsdlLocation = "http://localhost:7001/WebRoot/HelloService?wsdl")
    private HelloService service;

    /**
     * Constructor of the object.
     */
    public HelloServlet() {
        super();
    }
    /**
     * Destruction of the servlet.
     */
    public void destroy() {
        super.destroy(); // Just puts "destroy" string in log
        // Put your code here
    }
    /**
     * The doGet method of the servlet.
     *
     * This method is called when a form has its tag value method equals to get.
     *
     * @param request the request send by the client to the server
     * @param response the response send by the server to the client
     * @throws ServletException if an error occurred
     * @throws IOException if an error occurred
     */
    public void doGet(HttpServletRequest request, HttpServletResponse response)
            throws ServletException, IOException {
        processRequest(request, response);
    }
    /**
     * The doPost method of the servlet.
     *
     * This method is called when a form has its tag value method equals to post.
     *
     * @param request the request send by the client to the server
     * @param response the response send by the server to the client
     * @throws ServletException if an error occurred
     * @throws IOException if an error occurred
     */
    public void doPost(HttpServletRequest request, HttpServletResponse response)
            throws ServletException, IOException {
        processRequest(request, response);
    }
    /**
     * Initialization of the servlet.
     *
     * @throws ServletException if an error occurs
     */
    public void init() throws ServletException {
        // Put your code here
    }

    /**
     * Processes requests for both HTTP GET and POST
     * methods.
     *
     * @param request
     *            servlet request
     * @param response
     *            servlet response
     * @throws ServletException
     *             if a servlet-specific error occurs
     * @throws IOException
     *             if an I/O error occurs
     */
    protected void processRequest(HttpServletRequest request,
            HttpServletResponse response) throws ServletException, IOException {
        response.setContentType("text/html;charset=UTF-8");
        PrintWriter out = response.getWriter();
        try {
            out.println("");
            out.println("");
            out.println("Servlet HelloServlet");
            out.println("");
            out.println("");
            out.println("Servlet HelloServlet at "
                    + request.getContextPath() + "");
            out.println("" + sayHello("world") + "");
            out.println("");
            out.println("");
        } finally {
            out.close();
        }
    }
    // doGet and doPost methods, which call processRequest, and
    // getServletInfo method
    private String sayHello(java.lang.String arg0) {
        helloservice.endpoint.Hello port = service.getHelloPort();
        return port.sayHello(arg0);
    }
}

2.9 配置HelloClient的Web.xml,增加如下代码：

<servlet>
    <description>HelloServletdescription>
    <display-name>HelloServletdisplay-name>
    <servlet-name>HelloServletservlet-name>
    <servlet-class>webclient.HelloServletservlet-class>
  servlet>
<servlet-mapping>
    <servlet-name>HelloServletservlet-name>
    <url-pattern>/servlet/HelloServleturl-pattern>
  servlet-mapping>

2.10 发布HelloClient应用。

2.11 在IE录入http://localhost:7111/servlet/HelloServlet

页面内容如下说明WebService调用成功!

原文链接：http://maymay.iteye.com/blog/1271139