WSDL(Web Services Description Language)即WEB服务描述语言,我们可以通过XML的格式定义了Java中方法的调用和SOAPMessage的对应关系,一般在开发中,我们都必须定义WSDL文件,作为规范,以便客户端和服务器达成一致,更加方便调用。
?
在WSDL文件中定义的几个重要元素分别是:
types(用来定义message的类型)
Message(定义Message的内容),
PortType(指定对应的接口),
binding(定义每个方法对于的Message),
service(定义服务类),
?
下面看下一个完整的WSDL文件的定义:
<?xml version="1.0" encoding="UTF-8" ?> <wsdl:definitions name="VoteImplService" targetNamespace="http://service.lyl.com/" xmlns:ns1="http://schemas.xmlsoap.org/soap/http" xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/" xmlns:tns="http://service.lyl.com/" xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/" xmlns:xsd="http://www.w3.org/2001/XMLSchema"> <!-- 定义消息类型 --> <wsdl:types> <xsd:schema targetNamespace="http://service.lyl.com/"> <xsd:element name="vote" type="tns:vote"></xsd:element> <xsd:element name="voteResponse" type="tns:voteResponse"></xsd:element> <xsd:complexType name="vote"> <xsd:sequence> <xsd:element name="uname" type="xsd:string"></xsd:element> <xsd:element name="point" type="xsd:string"></xsd:element> </xsd:sequence> </xsd:complexType> <xsd:complexType name="voteResponse"> <xsd:sequence> <xsd:element name="voteResult" type="xsd:string"></xsd:element> </xsd:sequence> </xsd:complexType> <!-- 当我的定义的类型多个时候,可以单独把类型在一个schema文件中定义好然后引入进来 具体实现有两种方式:import 引入或者include引入(在schema中加入 targetNamespace="http://service.lyl.com/") --> <!-- <xsd:import namespace="http://service.lyl.com/" schemaLocation="example.xsd"></xsd:import> --> <!--<xsd:include schemaLocation="example.xsd"></xsd:include> --> </xsd:schema> </wsdl:types> <!-- 定义消息,每一个方法对于两个消息:一个输入(请求)消息,一个输出(响应)消息 在part元素中引入前面定义的元素,name总是parameters --> <wsdl:message name="voteResponse"> <wsdl:part element="tns:voteResponse" name="parameters" /> </wsdl:message> <wsdl:message name="vote"> <wsdl:part element="tns:vote" name="parameters" /> </wsdl:message> <wsdl:portType name="IVote"> <wsdl:operation name="vote"> <wsdl:input message="tns:vote" name="vote" /> <wsdl:output message="tns:voteResponse" name="voteResponse" /> </wsdl:operation> </wsdl:portType> <!-- 定义绑定 方法的传播方式,基于soapMessage方式--> <wsdl:binding name="VoteImplPortBinding" type="tns:IVote"> <soap:binding style="document" transport="http://schemas.xmlsoap.org/soap/http" /> <wsdl:operation name="vote"> <soap:operation soapAction="" style="document" /> <wsdl:input name="vote"> <soap:body use="literal" /> </wsdl:input> <wsdl:output name="voteResponse"> <soap:body use="literal" /> </wsdl:output> </wsdl:operation> </wsdl:binding> <!-- 定义服务的名字和前面指定的名字一致--> <wsdl:service name="VoteImplService"> <wsdl:port binding="tns:VoteImplPortBinding" name="VoteImplPort"> <soap:address location="http://localhost:8080/TestCXF/services/Vote" /> </wsdl:port> </wsdl:service> </wsdl:definitions>
?
?
外部引入的example.xsd文件:
?
<?xml version="1.0" encoding="UTF-8"?> <xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema" targetNamespace="http://service.lyl.com/" xmlns:tns="http://service.lyl.com/" elementFormDefault="qualified"> <xsd:element name="vote" type="tns:vote"></xsd:element> <xsd:element name="voteResponse" type="tns:voteResponse"></xsd:element> <xsd:complexType name="vote"> <xsd:sequence> <xsd:element name="uname" type="xsd:string"></xsd:element> <xsd:element name="point" type="xsd:string"></xsd:element> </xsd:sequence> </xsd:complexType> <xsd:complexType name="voteResponse"> <xsd:sequence> <xsd:element name="voteResult" type="xsd:string"></xsd:element> </xsd:sequence> </xsd:complexType> </xsd:schema>
?