基于JAX的WebService实现demo（一）

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

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

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

      

       以下给出一种简单的实现方式：

        一、服务端代码

      1.服务端接口PersonService.java

import javax.jws.WebService;
import javax.jws.soap.SOAPBinding;
import javax.jws.soap.SOAPBinding.*;

@WebService(name = "myPersonService",//指定WSDL契约中的portType（定义服务的接口）元素的name属性的值，默认为实现类的类名
targetNamespace = "http://www.test.com",//指定目标命名空间在哪个服务下定义，默认由包名得到
wsdlLocation = "http://www.test.com/person?wsdl")//指定服务契约存储的URI，默认为部署的URI
@SOAPBinding(style= Style.RPC, //指定SOAP消息的样式：RPC，DOCUMENT(默认)
use = Use.LITERAL,//指定SOAP消息数据如何传输
parameterStyle = ParameterStyle.WRAPPED)//指定方法参数在SOAP消息体中的显示方式（如果style使用RPC，那么必须使用WRAPPED）
public interface PersonService {
public void eat();
public void sleep();
}

      2.服务端接口实现类PersonServiceImpl.java

import com.dj.demo.ws.jax.PersonService;

import javax.jws.WebService;

@WebService(endpointInterface = "com.dj.demo.ws.jax.PersonService",//指定服务接口实现类全路径名
targetNamespace = "http://www.test.com",//指定服务在哪个命名空间下定义
portName = "person",//指定服务发布端的名称，即WSDL中port元素，默认为实现类名称
serviceName = "PersonService")//指定被发布的服务的名称，即WSDL中service元素，默认为实现类名称
public class PersonServiceImpl implements PersonService {
@Override
public void eat() {
System.out.println("person eat");
}
@Override
public void sleep() {
System.out.println("person sleep");
}
}

      3.发布服务PersonServer.java

import com.dj.demo.ws.jax.impl.PersonServiceImpl;

import javax.xml.ws.Endpoint;

public class PersonServer {
public static void main(String[] args){
String address = "http://localhost:8888/person";
Endpoint.publish(address, new PersonServiceImpl());
}
}

     

      运行服务端，在浏览器中输入http://localhost:8888/person?wsdl，会出现以下的结果：

<definitions targetNamespace="http://www.test.com" name="PersonService">
<types/>
<message name="eat"/>
<message name="eatResponse"/>
<message name="sleep"/>
<message name="sleepResponse"/>
<portType name="myPersonService">
<operation name="eat">
<input message="tns:eat"/>
<output message="tns:eatResponse"/>
</operation>
<operation name="sleep">
<input message="tns:sleep"/>
<output message="tns:sleepResponse"/>
</operation>
</portType>
<binding name="personBinding" type="tns:myPersonService">
<soap:binding transport="http://schemas.xmlsoap.org/soap/http" style="rpc"/>
<operation name="eat">
<soap:operation soapAction=""/>
<input>
<soap:body use="literal" namespace="http://www.test.com"/>
</input>
<output>
<soap:body use="literal" namespace="http://www.test.com"/>
</output>
</operation>
<operation name="sleep">
<soap:operation soapAction=""/>
<input>
<soap:body use="literal" namespace="http://www.test.com"/>
</input>
<output>
<soap:body use="literal" namespace="http://www.test.com"/>
</output>
</operation>
</binding>
<service name="PersonService">
<port name="person" binding="tns:personBinding">
<soap:address location="http://localhost:8888/person"/>
</port>
</service>
</definitions>

      二、客户端代码

      1.客户端接口（和服务端相同）PersonService.java

import javax.jws.WebService;
import javax.jws.soap.SOAPBinding;
import javax.jws.soap.SOAPBinding.*;

@WebService(name = "myPersonService",//指定WSDL契约中的portType（定义服务的接口）元素的name属性的值，默认为实现类的类名
targetNamespace = "http://www.test.com",//指定目标命名空间在哪个服务下定义，默认由包名得到
wsdlLocation = "http://www.test.com/person?wsdl")//指定服务契约存储的URI，默认为部署的URI
@SOAPBinding(style= Style.RPC, //指定SOAP消息的样式：RPC，DOCUMENT(默认)
use = Use.LITERAL,//指定SOAP消息数据如何传输
parameterStyle = ParameterStyle.WRAPPED)//指定方法参数在SOAP消息体中的显示方式（如果style使用RPC，那么必须使用WRAPPED）
public interface PersonService {
public void eat();
public void sleep();
}

      2.客户端调用服务端测试类PersonClient.java

import javax.xml.namespace.QName;
import javax.xml.ws.Service;
import java.net.MalformedURLException;
import java.net.URL;

public class PersonClient {
public static void main(String[] args){
URL url = null;
try {
url = new URL("http://localhost:8888/person?wsdl");
} catch (MalformedURLException e) {
e.printStackTrace();  //To change body of catch statement use File | Settings | File Templates.
}
if(null != url){
QName qName = new QName("http://www.test.com", "PersonService");
Service service = Service.create(url, qName);
PersonService personService = service.getPort(PersonService.class);
while(true){
//调用了Server端提供的服务
personService.eat();
personService.sleep();
try {
Thread.sleep(3000);
} catch (Exception e){
e.printStackTrace();
}
}
}

}
}

      运行后，我们发现，客户端调用服务端发布的服务成功了！

      以上实例中，细心一点，我们会发现，客户端的调用仍然依赖于服务端的接口（必须定义和服务端相同的接口才能访问）。我们将在后续的学习中，对该程序进行改进。