28
WebService——通過契約優先開發webservice
一、基本概念
有代碼優先和契約優先兩種開發webService的方式，本例介紹契約優先的webService。編寫WSDL有三種方式：基於document的Wrapper方式，基於document的Bare方式，基於RPC方式。本例介紹Wraper方式，也是默認方式和推薦方式。Wrapper有包起來的意思，將所有對象通過element封裝。
二、編寫步驟
①服務端
1、編寫WSDL
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<wsdl:definitions xmlns:soap="https://schemas.xmlsoap.org/wsdl/soap/"
xmlns:tns="https://www.example.org/hello/" xmlns:wsdl="https://schemas.xmlsoap.org/wsdl/"
xmlns:xsd="https://www.w3.org/2001/XMLSchema"
name="HelloService"
targetNamespace="https://www.example.org/hello/">
<wsdl:types>
<xsd:schema targetNamespace="https://www.example.org/hello/">
<xsd:element name="add" type="tns:add"></xsd:element>
<xsd:element name="addResponse" type="tns:addResponse"></xsd:element>
<xsd:element name="licenceInfo" type="tns:licenceInfo"></xsd:element>
<xsd:complexType name="add">
<xsd:sequence>
<xsd:element name="a" type="xsd:int"></xsd:element>
<xsd:element name="b" type="xsd:int"></xsd:element>
</xsd:sequence>
</xsd:complexType>
<xsd:complexType name="addResponse">
<xsd:sequence>
<xsd:element name="addResponse" type="xsd:int"></xsd:element>
</xsd:sequence>
</xsd:complexType>
<xsd:complexType name="licenceInfo">
<xsd:sequence>
<xsd:element name="licenceInfo" type="xsd:string"></xsd:element>
</xsd:sequence>
</xsd:complexType>
</xsd:schema>
</wsdl:types>
<wsdl:message name="add">
<wsdl:part name="add" element="tns:add"></wsdl:part>
</wsdl:message>
<wsdl:message name="addResponse">
<wsdl:part name="addResponse" element="tns:addResponse"></wsdl:part>
</wsdl:message>
<wsdl:message name="licenceInfo">
<wsdl:part name="licenceInfo" element="tns:licenceInfo"></wsdl:part>
</wsdl:message>
<wsdl:portType name="IHelloService">
<wsdl:operation name="add">
<wsdl:input message="tns:add"></wsdl:input>
<wsdl:output message="tns:addResponse"></wsdl:output>
</wsdl:operation>
</wsdl:portType>
<wsdl:binding name="HelloServiceSOAP" type="tns:IHelloService">
<soap:binding transport="https://schemas.xmlsoap.org/soap/http" />
<wsdl:operation name="add">
<wsdl:input>
<soap:body use="literal" />
<soap:header use="literal" part="licenceInfo" message="tns:licenceInfo"></soap:header>
</wsdl:input>
<wsdl:output>
<soap:body use="literal" />
</wsdl:output>
</wsdl:operation>
</wsdl:binding>
<wsdl:service name="HelloService">
<wsdl:port binding="tns:HelloServiceSOAP" name="HelloServicePort">
<soap:address location="https://localhost:8080/hello" />
</wsdl:port>
</wsdl:service>
</wsdl:definitions>
2、通過wsimport生成java文件，將生成的java類文件複製到項目中一般在src下新建MATE-INF/WSDL兩層文件夾，將文件放進去。
3、刪除生成的java文件，隻保留生成的接口的.java文件，刪除該文件中不需要的代碼。注意不要拷貝.class文件進去，因為將來如果要在tomcat裏麵部署，多餘的.class文件會讓程序報錯。
import javax.jws.WebMethod;
import javax.jws.WebParam;
import javax.jws.WebResult;
import javax.jws.WebService;
import javax.xml.bind.annotation.XmlSeeAlso;
import javax.xml.ws.RequestWrapper;
import javax.xml.ws.ResponseWrapper;
/**
* This class was generated by the JAX-WS RI.
* JAX-WS RI 2.1.1 in JDK 6
* Generated source version: 2.1
*
*/
@WebService(name = "Hello", targetNamespace = "https://www.example.org/hello/")
public interface IHelloService {
@WebMethod
@WebResult(name = "addResponse", targetNamespace = "")
@RequestWrapper(localName = "add", targetNamespace = "https://www.example.org/hello/", className = "org.example.hello.Add")
@ResponseWrapper(localName = "addResponse", targetNamespace = "https://www.example.org/hello/", className = "org.example.hello.AddResponse")
public int add(
@WebParam(name = "a", targetNamespace = "")
int a,
@WebParam(name = "b", targetNamespace = "")
int b ,
@WebParam(name="licenceInfo" , header=true) String licenceInfo);
}
4、編寫HelloServiceImpl類
@WebService(endpointInterface = "org.example.hello.Hello",
serviceName = "HelloService" , wsdlLocation = "META-INF/wsdl/hello.wsdl" ,
targetNamespace = "https://www.example.org/hello/", portName="HelloServicePort")
public class HelloServiceImpl implements IHelloService {
public int add(int a, int b, String licenceInfo) {
System.out.println(a+b);
System.out.println("licenceInfo:" + licenceInfo );
return a + b;
}
}
5、發布service
import javax.xml.ws.Endpoint;
import org.example.hello.HelloServiceImpl;
public class ServiceTest {
public static void main(String[] args) {
Endpoint.publish("https://localhost:8080/mywebservice", new HelloServiceImpl());
}
}
②編寫客戶端
將wsimort生成的java類添加到客戶端。
1、普通方式訪問（無法傳遞頭信息，當然可以通過另外編寫Handler添加頭信息）
import java.net.URL;
import javax.xml.namespace.QName;
import javax.xml.ws.Service;
import org.example.hello.Hello;
public class Client01 {
public static void main(String[] args) throws Exception{
URL url = new URL("https://localhost:8080/mywebservice?wsdl");
String namespace = "https://www.example.org/hello/";
QName sname = new QName(namespace, "HelloService");
Service service = Service.create(url, sname);
IHelloService hello = service.getPort(IHelloService.class);
int result = hello.add(1, 100);
System.out.println(result);
// 或直接調用生成的方法(這是另一個例子，可以仿照寫)
// MyServiceImplService mis = new MyServiceImplService();
// IMyService ms = mis.getMyServiceImplPort();
// System.out.println(ms.add(29, 3));
}
}
2、拚裝SOAPMessage方式訪問 （有頭信息）
import java.net.URL;
import javax.xml.namespace.QName;
import javax.xml.soap.MessageFactory;
import javax.xml.soap.SOAPBody;
import javax.xml.soap.SOAPBodyElement;
import javax.xml.soap.SOAPEnvelope;
import javax.xml.soap.SOAPHeader;
import javax.xml.soap.SOAPMessage;
import javax.xml.ws.Dispatch;
import javax.xml.ws.Service;
public class Client02 {
/**
* 帶Header的請求
*/
public static void main(String[] args) throws Exception{
URL url = new URL("https://localhost:8080/mywebservice?wsdl");
String namespace = "https://www.example.org/hello/";
QName sname = new QName(namespace , "HelloService");
Service service = Service.create(url, sname);
QName protName = new QName(namespace, "HelloServicePort");
Dispatch<SOAPMessage> dispatch = service.createDispatch(protName,SOAPMessage.class, Service.Mode.MESSAGE);
SOAPMessage msg = MessageFactory.newInstance().createMessage() ;
SOAPEnvelope env = msg.getSOAPPart().getEnvelope() ;
SOAPBody body = env.getBody() ;
SOAPHeader header = env.getHeader() ;
if(header == null) header = env.addHeader() ;
// 一定要加ns前綴
QName addName = new QName(namespace , "add" , "myprefix");
// 添加Body信息
SOAPBodyElement bodyEle = body.addBodyElement(addName);
bodyEle.addChildElement("a").setValue("1");
bodyEle.addChildElement("b").setValue("2");
// 添加頭信息
QName headerName = new QName(namespace , "licenceInfo");
// 設置頭信息的值
header.addHeaderElement(headerName).setTextContent("admin");
// 發送前將soap消息打印出來
msg.writeTo(System.out);
System.out.println("----------------relult---------------");
SOAPMessage resultMsg = dispatch.invoke(msg);
// 將返回的soap消息打印出來
resultMsg.writeTo(System.out) ;
}
}
原帖地址：https://blog.csdn.net/is_zhoufeng/article/details/8365723
最後更新：2017-04-03 14:54:00