JAX-WS服务端及客户端

一、概述

　　Java API for XML Web Services (JAX-WS)是Java程序设计语言一个用来创建Web服务的API。

　　在服务器端，用户只需要通过Java语言定义远程调用所需要实现的接口SEI（service endpoint interface），并提供相关的实现，通过调用JAX-WS的服务发布接口就可以将其发布为WebService接口。

　　在客户端，用户可以通过JAX-WS的API创建一个代理（用本地对象来替代远程的服务）来实现对于远程服务器端的调用。

二、使用jdk的JAX-WS发布服务

1.写服务端的接口

package com.webservice.jaxws;

public interface Hello {
    public String sayHello(String name);
}

2.写服务端的实现（使用注解@WebService）这个必须在实现类写，不然报错（class com.webservice.jaxws.HelloImpl has neither @WebService nor @WebServiceProvider annotation）

package com.webservice.jaxws;

import javax.jws.WebService;
@WebService
public class HelloImpl implements Hello{

    @Override
    public String sayHello(String name) {
        return "hi, "+name;
    }

}

3.使用jdk中Endpoint发布服务

package com.webservice.jaxws;

import javax.xml.ws.Endpoint;

public class HelloServerPub {
    public static void main(String[] args) {
        Hello hello = new HelloImpl();
        Endpoint.publish("http://localhost:8080/hello", hello);
        System.out.println("发布成功！");
    }
}

4.在浏览器地址栏输入服务发布的地址查看wsdl及schema文件

<?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.2.4-b01. --><!-- Generated by JAX-WS RI at http://jax-ws.dev.java.net. RI's version is JAX-WS RI 2.2.4-b01. --><definitions xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd" xmlns:wsp="http://www.w3.org/ns/ws-policy" xmlns:wsp1_2="http://schemas.xmlsoap.org/ws/2004/09/policy" xmlns:wsam="http://www.w3.org/2007/05/addressing/metadata" xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/" xmlns:tns="http://jaxws.webservice.com/" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns="http://schemas.xmlsoap.org/wsdl/" targetNamespace="http://jaxws.webservice.com/" name="HelloImplService">
<types>
<xsd:schema>
<xsd:import namespace="http://jaxws.webservice.com/" schemaLocation="http://localhost:8080/hello?xsd=1"></xsd:import>
</xsd:schema>
</types>
<message name="sayHello">
<part name="parameters" element="tns:sayHello"></part>
</message>
<message name="sayHelloResponse">
<part name="parameters" element="tns:sayHelloResponse"></part>
</message>
<portType name="HelloImpl">
<operation name="sayHello">
<input wsam:Action="http://jaxws.webservice.com/HelloImpl/sayHelloRequest" message="tns:sayHello"></input>
<output wsam:Action="http://jaxws.webservice.com/HelloImpl/sayHelloResponse" message="tns:sayHelloResponse"></output>
</operation>
</portType>
<binding name="HelloImplPortBinding" type="tns:HelloImpl">
<soap:binding transport="http://schemas.xmlsoap.org/soap/http" style="document"></soap:binding>
<operation name="sayHello">
<soap:operation soapAction=""></soap:operation>
<input>
<soap:body use="literal"></soap:body>
</input>
<output>
<soap:body use="literal"></soap:body>
</output>
</operation>
</binding>
<service name="HelloImplService">
<port name="HelloImplPort" binding="tns:HelloImplPortBinding">
<soap:address location="http://localhost:8080/hello"></soap:address>
</port>
</service>
</definitions>

<?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.2.4-b01. --><xs:schema xmlns:tns="http://jaxws.webservice.com/" xmlns:xs="http://www.w3.org/2001/XMLSchema" version="1.0" targetNamespace="http://jaxws.webservice.com/">

<xs:element name="sayHello" type="tns:sayHello"></xs:element>

<xs:element name="sayHelloResponse" type="tns:sayHelloResponse"></xs:element>

<xs:complexType name="sayHello">
<xs:sequence>
<xs:element name="arg0" type="xs:string" minOccurs="0"></xs:element>
</xs:sequence>
</xs:complexType>

<xs:complexType name="sayHelloResponse">
<xs:sequence>
<xs:element name="return" type="xs:string" minOccurs="0"></xs:element>
</xs:sequence>
</xs:complexType>
</xs:schema>

三、客户端

1.根据wsdl生成客户端（打开命令行窗口，切换到src目录，执行"wsimport -keep http://localhost:8080/hello?wsdl"生成客户端代码，如下图所示：）

2、 借助生成的代码编写调用WebService对外提供的方法

　　wsimport工具帮我们生成了好几个java类，但我们只需要关心HelloImplService类和HelloImpl接口的使用即可

package com.webservice;

import com.webservice.jaxws.HelloImpl;
import com.webservice.jaxws.HelloImplService;

public class ClientTest {
    public static void main(String[] args) {
        //创建一个用于产生HelloImpl实例的工厂，HelloImplService类是wsimport工具生成的
        HelloImplService service = new HelloImplService();
        //通过工厂生成HelloImpl一个实例
        HelloImpl hello = service.getHelloImplPort();
        //调用HelloImpl接口的方法
        String value = hello.sayHello("Tom");
        System.out.println(value);
    }
}

打印的结果：hi, Tom