webservice系统学习笔记9-使用契约优先的方式的一个服务端demo(隐式传Header信息)
服务器端：
1、编写wsdl文件
<?xml version="1.0" encoding="UTF-8" standalone="no"?> <wsdl:definitions xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/" xmlns:tns="http://www.example.org/mywsdl/" xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/" xmlns:xsd="http://www.w3.org/2001/XMLSchema" name="MyServiceImplService" targetNamespace="http://www.example.org/mywsdl/"> <!-- 定义类型 --> <wsdl:types> <xsd:schema targetNamespace="http://www.example.org/mywsdl/"> <xsd:element name="add" type="tns:add"/> <xsd:element name="addResponse" type="tns:addResponse"/> <xsd:element name="divide" type="tns:divide"/> <xsd:element name="divideResponse" type="tns:divideResponse"/> <xsd:element name="licenseInfo" type="xsd:string"/> <xsd:complexType name="add"> <xsd:sequence> <xsd:element name="a" type="xsd:int"/> <xsd:element name="b" type="xsd:int"/> </xsd:sequence> </xsd:complexType> <xsd:complexType name="addResponse"> <xsd:sequence> <xsd:element name="addResult" type="xsd:int"/> </xsd:sequence> </xsd:complexType> <xsd:complexType name="divide"> <xsd:sequence> <xsd:element name="num1" type="xsd:int"/> <xsd:element name="num2" type="xsd:int"/> </xsd:sequence> </xsd:complexType> <xsd:complexType name="divideResponse"> <xsd:sequence> <xsd:element name="divideResult" type="xsd:int"/> </xsd:sequence> </xsd:complexType> </xsd:schema> </wsdl:types> <!-- 定义消息 --> <wsdl:message name="add"> <wsdl:part name="add" element="tns:add"/> </wsdl:message> <wsdl:message name="addResponse"> <wsdl:part name="addResponse" element="tns:addResponse"></wsdl:part> </wsdl:message> <wsdl:message name="divide"> <wsdl:part name="divide" element="tns:divide"/> </wsdl:message> <wsdl:message name="divideResponse"> <wsdl:part name="divideResponse" element="tns:divideResponse"/> </wsdl:message> <!-- 头消息 --> <wsdl:message name="licenseInfo"> <wsdl:part name="licenseInfo" element="tns:licenseInfo"></wsdl:part> </wsdl:message> <!-- 定义port --> <wsdl:portType name="IMyService"> <wsdl:operation name="add"> <wsdl:input message="tns:add"/> <wsdl:output message="tns:addResponse"/> </wsdl:operation> <wsdl:operation name="divide"> <wsdl:input message="tns:divide"/> <wsdl:output message="tns:divideResponse"/> </wsdl:operation> </wsdl:portType> <!-- 绑定服务 --> <wsdl:binding name="myServiceSOAP" type="tns:IMyService"> <soap:binding style="document" transport="http://schemas.xmlsoap.org/soap/http"/> <wsdl:operation name="add"> <wsdl:input> <soap:body use="literal"/> <!-- 为add添加隐式的头信息 --> <soap:header use="literal" part="licenseInfo" message="tns:licenseInfo"/> </wsdl:input> <wsdl:output> <soap:body use="literal"/> </wsdl:output> </wsdl:operation> <wsdl:operation name="divide"> <wsdl:input> <soap:body use="literal"/> </wsdl:input> <wsdl:output> <soap:body use="literal"/> </wsdl:output> </wsdl:operation> </wsdl:binding> <!-- 发布服务 --> <wsdl:service name="MyServiceImplService"><!-- 这里的名字必须和<wsdl:definitions里的name一致 --> <wsdl:port binding="tns:myServiceSOAP" name="MyServiceImplPort"> <soap:address location="http://localhost:8989/ms"/> </wsdl:port> </wsdl:service> </wsdl:definitions>
2、使用wsimport命令生成服务端接口类（IMyService.java）
备注:生成的其他文件都可以删除
在add方法的参数定义上加上
@WebParam(name="licenseInfo")String licenseInfo
3、编写服务接口的实现类MyServiceImpl.java
package org.example.mywsdl; import javax.jws.WebService; //这里必须制定wsdlLocation来约定参数等名称等 //endpointInterface可写也可不写，写它主要是用到自动生成的一些注解信息 @WebService(endpointInterface="org.example.mywsdl.IMyService", targetNamespace="http://www.example.org/mywsdl/", wsdlLocation="META-INF/wsdl/mywsdl.wsdl", name="MyServiceImpl" ) public class MyServiceImpl implements IMyService { @Override public int add(int a, int b, String licenseInfo) { return a+b; } @Override public int divide(int num1, int num2) { return num1/num2; } }
4、服务启动类
package org.example.mywsdl; import javax.xml.ws.Endpoint; public class RunService { public static void main(String[] args) { //这里的发布地址必须和wsdl中定义的一样 Endpoint.publish("http://localhost:8989/ms", new MyServiceImpl()); } }
访问服务：http://localhost:8989/ms?wsdl
客户端直接用上面的地址生成即可，生成的wsdl文件即是我们编写的那个wsdl文件
<?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.1.6 in JDK 6. --><wsdl:definitions xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/" xmlns:tns="http://www.example.org/mywsdl/" xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/" xmlns:xsd="http://www.w3.org/2001/XMLSchema" name="MyServiceImplService" targetNamespace="http://www.example.org/mywsdl/"> <!-- 定义类型 --> <wsdl:types> <xsd:schema targetNamespace="http://www.example.org/mywsdl/"> <xsd:element name="add" type="tns:add"></xsd:element> <xsd:element name="addResponse" type="tns:addResponse"></xsd:element> <xsd:element name="divide" type="tns:divide"></xsd:element> <xsd:element name="divideResponse" type="tns:divideResponse"></xsd:element> <xsd:element name="licenseInfo" type="xsd:string"></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="addResult" type="xsd:int"></xsd:element> </xsd:sequence> </xsd:complexType> <xsd:complexType name="divide"> <xsd:sequence> <xsd:element name="num1" type="xsd:int"></xsd:element> <xsd:element name="num2" type="xsd:int"></xsd:element> </xsd:sequence> </xsd:complexType> <xsd:complexType name="divideResponse"> <xsd:sequence> <xsd:element name="divideResult" type="xsd:int"></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="divide"> <wsdl:part name="divide" element="tns:divide"></wsdl:part> </wsdl:message> <wsdl:message name="divideResponse"> <wsdl:part name="divideResponse" element="tns:divideResponse"></wsdl:part> </wsdl:message> <!-- 头消息 --> <wsdl:message name="licenseInfo"> <wsdl:part name="licenseInfo" element="tns:licenseInfo"></wsdl:part> </wsdl:message> <!-- 定义port --> <wsdl:portType name="IMyService"> <wsdl:operation name="add"> <wsdl:input message="tns:add"></wsdl:input> <wsdl:output message="tns:addResponse"></wsdl:output> </wsdl:operation> <wsdl:operation name="divide"> <wsdl:input message="tns:divide"></wsdl:input> <wsdl:output message="tns:divideResponse"></wsdl:output> </wsdl:operation> </wsdl:portType> <!-- 绑定服务 --> <wsdl:binding name="myServiceSOAP" type="tns:IMyService"> <soap:binding style="document" transport="http://schemas.xmlsoap.org/soap/http"></soap:binding> <wsdl:operation name="add"> <wsdl:input> <soap:body use="literal"></soap:body> <!-- 为add添加隐式的头信息 --> <soap:header use="literal" part="licenseInfo" message="tns:licenseInfo"></soap:header> </wsdl:input> <wsdl:output> <soap:body use="literal"></soap:body> </wsdl:output> </wsdl:operation> <wsdl:operation name="divide"> <wsdl:input> <soap:body use="literal"></soap:body> </wsdl:input> <wsdl:output> <soap:body use="literal"></soap:body> </wsdl:output> </wsdl:operation> </wsdl:binding> <!-- 发布服务 --> <wsdl:service name="MyServiceImplService"><!-- 这里的名字必须和<wsdl:definitions里的name一致 --> <wsdl:port binding="tns:myServiceSOAP" name="MyServiceImplPort"> <soap:address location="http://localhost:8989/ms"></soap:address> </wsdl:port> </wsdl:service> </wsdl:definitions>
使用该wsdl生成客户端java代码后的add方法如下：
@WebMethod @WebResult(name = "addResult", targetNamespace = "") @RequestWrapper(localName = "add", targetNamespace = "http://www.example.org/mywsdl/", className = "com.ws04.Add") @ResponseWrapper(localName = "addResponse", targetNamespace = "http://www.example.org/mywsdl/", className = "com.ws04.AddResponse") public int add(@WebParam(name = "a", targetNamespace = "") int a, @WebParam(name = "b", targetNamespace = "") int b);
此时方法的参数里没有看到有头信息参数的定义，调用该方法可以使用handler或者soap来编码传递头信息
