JAX-WS 的简单使用

1、定义Service

Jax-ws的WebService定义是通过注解进行的，我们必须在其WebService类的接口上使用@WebService注解进行标记

@WebService
@SOAPBinding(style = SOAPBinding.Style.RPC)
public interface IWebService {

	@WebMethod
	public void calData(@WebParam(name = "num") int num);

	@WebMethod
	public String getString(@WebParam(name = "message") String message);
}

@WebService的其它注解属性可以获取默认值，@WebParam 可以使XML生成的参数名更直观，此处加了@WebParam之后，在客户端写接口的时候也需要加上。

实现webService的接口：

@WebService(endpointInterface = "test.interfaces.IWebService")
public class WebServiceImpl implements IWebService {

	@Override
	public void calData(int num) {
		int data = 0;
		for (int i = 0; i < num + 1; i++) {
			data = num + data;
		}
		System.err.println("运行结果为  " + data);

	}

	@Override
	public String getString(String message) {
		if (message == null || "".equals(message)) {
			return null;
		} else {
			return "the message is :" + message;
		}
	}
}

实现类中需要指定实现接口的路径 @WebService(endpointInterface = "test.interfaces.IWebService")

2、服务端发布WebService

	private final static String ADDRESS = "http://127.0.0.1:8899/test/webservice";

	public static void main(String[] args) {

		IWebService service = new WebServiceImpl();
		Endpoint.publish(ADDRESS, service);
	}

发布完之后访问路径 http://127.0.0.1:8899/test/webservice?wsdl，可以看到

       <definitions targetNamespace="http://impl.test/" name="WebServiceImplService">
            <import namespace="http://interfaces.test/"
                location="http://127.0.0.1:8899/test/webservice?wsdl=1" />
            <binding name="WebServiceImplPortBinding" type="ns1:IWebService">
                <soap:binding transport="http://schemas.xmlsoap.org/soap/http"
                    style="rpc" />
                <operation name="getString">
                    <soap:operation soapAction="" />
                    <input>
                        <soap:body use="literal" namespace="http://interfaces.test/" />
                    </input>
                    <output>
                        <soap:body use="literal" namespace="http://interfaces.test/" />
                    </output>
                </operation>
                <operation name="calData">
                    <soap:operation soapAction="" />
                    <input>
                        <soap:body use="literal" namespace="http://interfaces.test/" />
                    </input>
                    <output>
                        <soap:body use="literal" namespace="http://interfaces.test/" />
                    </output>
                </operation>
            </binding>
            <service name="WebServiceImplService">
                <port name="WebServiceImplPort" binding="tns:WebServiceImplPortBinding">
                    <soap:address location="http://127.0.0.1:8899/test/webservice" />
                </port>
            </service>
        </definitions>

因为是实现的接口，所以继续访问http://127.0.0.1:8899/test/webservice?wsdl=1,可以看到具体的方法和方法的参数
 

         <definitions targetNamespace="http://interfaces.test/">
            <types />
            <message name="getString">
                <part name="message" type="xsd:string" />
            </message>
            <message name="getStringResponse">
                <part name="return" type="xsd:string" />
            </message>
            <message name="calData">
                <part name="num" type="xsd:int" />
            </message>
            <message name="calDataResponse" />
            <portType name="IWebService">
                <operation name="getString" parameterOrder="message">
                    <input message="tns:getString" />
                    <output message="tns:getStringResponse" />
                </operation>
                <operation name="calData" parameterOrder="num">
                    <input message="tns:calData" />
                    <output message="tns:calDataResponse" />
                </operation>
            </portType>
        </definitions>

3、客户端访问WebService

  对于非本服务访问该WebService,需要重新定义一个接口，此处注解的@WebService 需要指定 targetNamespace，为http://127.0.0.1:8899/test/webservice?wsdl=1中生成的XML的targetNamespace，targetNamespace也可以在服务端指定；

@WebService(targetNamespace = "http://interfaces.test/")
public interface ILocalWebService {

	@WebMethod
	public void calData(@WebParam(name = "num") int num);

	@WebMethod
	public String getString(@WebParam(name = "message") String message);

}

 在使用Jax-ws时我们可以通过JaxWsProxyFactoryBean来访问服务

	public static void main(String[] args) {
		JaxWsProxyFactoryBean jwpFactory = new JaxWsProxyFactoryBean();
		jwpFactory.setAddress("http://127.0.0.1:8899/test/webservice?wsdl");
		jwpFactory.setServiceClass(ILocalWebService.class);
		ILocalWebService hw = (ILocalWebService) jwpFactory.create();
		hw.calData(29);
	}

  也可以使用Service来访问服务

    public static void main(String[] args) {
        try {
            URL url= new URL("http://127.0.0.1:8899/test/webservice?wsdl");
            // Qname qname是qualified name 的简写
            // 2.构成：由名字空间(namespace)前缀(prefix)以及冒号(:),还有一个元素名称构成
            // 由发布的wsdl可知namespace为  http://impl.test/
            QName sname = new QName("http://impl.test/","WebServiceImplService");
            Service service = Service.create(url, sname);
            // 获取Service对应的port,从wsdl中获取的
            QName pname = new QName("http://impl.test/", "WebServiceImplPort");
            ILocalWebService pservice = service.getPort(pname, ILocalWebService.class);
            pservice.calData(29);
        } catch (MalformedURLException e) {
            e.printStackTrace();
        }
    }

4、异常处理

 (1)、服务端发布WebService时报错 runtime modeler error: Wrapper class test.interfaces.jaxws.GetString is not found. Have you run APT to generate them?

   需要在WebService注解下加上 @SOAPBinding(style = SOAPBinding.Style.RPC)

 (2)、客户端访问WebService时报错 java.lang.NoClassDefFoundError: org/apache/ws/commons/schema/utils/NamespacePrefixList

    客户端使用 JaxWsProxyFactoryBean 访问远程WebService时，需要添加额外的jar包，XmlSchema-1.4.7.jar和 wsdl4j-1.6.2.jar。