当前位置：文档之家 › WSDL结构简单分析

WSDL结构简单分析

  • 格式：docx
  • 大小：46.79 KB
  • 文档页数：5

WSDL简单分析定义WSDL是网络服务描述语言Web Services Description Language的缩写，是一个用来描述Web服务和说明如何与Web服务通信的XML语言。

为用户提供详细的接口说明书。

∙WSDL 使用 XML 编写∙WSDL 是一种 XML 文档∙WSDL 用于描述网络服务∙WSDL 也可用于定位网络服务∙WSDL 还不是 W3C 标准功能WSDL既是机器可阅读的，又是人可阅读的。

一些最新的开发工具既能根据Web service生成WSDL文档，又能导入WSDL文档，生成调用相应Web service的代码。

（接口规范、系统概要设计说明书机器不可读）WSDL和SOAP：WSDL被设计成可以绑定除SOAP以外的其他协议，这里我们主要关注WSDL 在HTTP上和SOAP的关系。

∙业务之间将通过交换 WSDL 文件来理解对方的服务∙WSDL 绑定到SOAP以被调用∙通过HTTP（SMTP）进行传输WSDL元素WSDL 文件包含以下元素：Type：使用某种语法（如 XML 模式）的数据类型定义（string、int）Message：要传递的数据Part：消息参数Operation：服务支持的操作的抽象描述Port Type：一个或多个端点支持的操作的抽象集。

Binding：特定端口类型的具体协议和数据格式规范Port：绑定和网络地址的组合Service：相关端点的集合，包括其关联的接口、操作、消息等WSDL文档结构WSDL文档可以分为两部分。

顶部分由抽象定义组成，而底部分则由具体描述组成。

抽象部分以独立于平台和语言的方式定义SOAP消息，它们并不包含任何随机器或语言而变的元素。

这就定义了一系列服务，截然不同的网站都可以实现。

随网站而异的东西如序列化便归入底部分，因为它包含具体的定义。

l 抽象定义Types 独立与机器和语言的类型定义Messages包括函数参数（输入与输出分开）或文档描述PortTypes引用消息部分中消息定义来描述函数签名（操作名、输入参数、输出参数）2 具体定义Bindings PortTypes部分的每一操作在此绑定实现Services确定每一绑定的端口地址WSDL元素间的联系Messages栏使用Types栏的定义，PortTypes栏使用Messages栏的定义；Bindings栏引用了PortTypes栏，Services栏引用Bindings栏，PortTypes和Bindings栏包含了operation元素，而Services栏包含了port元素。

PortTypes 栏里的operation元素由Bindings栏里的operation元素进一步修改或描述。

可以借助传统编程语言来进行理解：<portType> 元素类似传统编程语言中的一个模块、或一个类，每个类包含很多方法∙<Operation> 相当于一个函数、或方法，每个方法有输入、输出值∙<Message> 输入、输出值在wsdl被称为消息Message∙<Type>输入、输出值的数据类型，如int、string实例URL：http://10.142.59.178:7001/sggis/services/CsConnectionService?wsdl <?xml version="1.0" encoding="UTF-8" ?>-<wsdl:definitions targetNamespace=""xmlns:tns=""xmlns:wsdlsoap="/wsdl/soap/"xmlns:soap12="/2003/05/soap-envelope"xmlns:xsd="/2001/XMLSchema"xmlns:soapenc11="/soap/encoding/"xmlns:soapenc12="/2003/05/soap-encoding"xmlns:soap11="/soap/envelope/"xmlns:wsdl="/wsdl/">-<wsdl:types>-<xsd:schema xmlns:xsd="/2001/XMLSchema"attributeFormDefault="qualified"elementFormDefault="qualified"targetNamespace="">-<xsd:element name="getCSConnection">-<xsd:complexType>-<xsd:sequence><xsd:element maxOccurs="1"minOccurs="1"name="username"nillable="true"type="xsd:string" /><xsd:element maxOccurs="1"minOccurs="1"name="password"nillable="true"type="xsd:string" /></xsd:sequence></xsd:complexType></xsd:element>-<xsd:element name="getCSConnectionResponse">-<xsd:complexType>-<xsd:sequence><xsd:element maxOccurs="1"minOccurs="1"name="out"nillable="true"type="xsd:string" /></xsd:sequence></xsd:complexType></xsd:element></xsd:schema></wsdl:types>-<wsdl:message name="getCSConnectionResponse"><wsdl:part name="parameters" element="tns:getCSConnectionResponse" /> </wsdl:message>-<wsdl:message name="getCSConnectionRequest"><wsdl:part name="parameters" element="tns:getCSConnection" /> </wsdl:message>-<wsdl:portType name="CsConnectionServicePortType">-<wsdl:operation name="getCSConnection"><wsdl:input name="getCSConnectionRequest"message="tns:getCSConnectionRequest" /><wsdl:output name="getCSConnectionResponse"message="tns:getCSConnectionResponse" /></wsdl:operation></wsdl:portType>-<wsdl:binding name="CsConnectionServiceHttpBinding"type="tns:CsConnectionServicePortType"><wsdlsoap:binding style="document"transport="/soap/http" />-<wsdl:operation name="getCSConnection"><wsdlsoap:operation soapAction="" />-<wsdl:input name="getCSConnectionRequest"><wsdlsoap:body use="literal" /></wsdl:input>-<wsdl:output name="getCSConnectionResponse"><wsdlsoap:body use="literal" /></wsdl:output></wsdl:operation></wsdl:binding>-<wsdl:service name="CsConnectionService">-<wsdl:port name="CsConnectionServiceHttpPort"binding="tns:CsConnectionServiceHttpBinding"><wsdlsoap:address location="http://10.142.59.178:7001/sggis/services/CsConnectionServic e" /></wsdl:port></wsdl:service></wsdl:definitions>。

合集下载

WSDL解析

WSDL解析

WSDL解析背景前⾯我们介绍过利⽤javassist动态⽣成webservice，这种⽅式可以使得我们系统通过页⾯配置动态发布webservice服务，做到0代码开发发布北向接⼝。

进⼀步思考，我们如何0代码开发调⽤第三⽅webservice服务呢？wsdl解析⾸先必然是理解第三⽅webservice的接⼝描述，也就是解析wsdl⽂件。

wsdl⽂件是webservice服务接⼝描述⽂档，⼀个wsdl⽂件可以包含多个接⼝，⼀个接⼝可以包含多个⽅法。

实际上，wsdl解析是⼗分困难的⼯作，⽹上也没有找到有效的解决办法，最终通过阅读SoapUI源码，找到了完美的解析⽅法。

代码1/**2 * WsdlInfo.java Create on 2013-5-4 下午12:56:143 *4 * 类功能说明: wsdl解析⼊⼝5 *6 * Copyright: Copyright(c) 20137 * Company: COSHAHO8 * @Version 1.09 * @Author 何科序10*/11public class WsdlInfo12 {13private String wsdlName;1415private List<InterfaceInfo> interfaces;1617/**18 * coshaho19 * @param path wsdl地址20 * @throws Exception21*/22public WsdlInfo(String path) throws Exception23 {24 WsdlProject project = new WsdlProject();25 WsdlInterface[] wsdlInterfaces = WsdlImporter.importWsdl( project, path );26this.wsdlName = path;27if(null != wsdlInterfaces)28 {29 List<InterfaceInfo> interfaces = new ArrayList<InterfaceInfo>();30for(WsdlInterface wsdlInterface : wsdlInterfaces)31 {32 InterfaceInfo interfaceInfo = new InterfaceInfo(wsdlInterface);33 interfaces.add(interfaceInfo);34 }35this.interfaces = interfaces;36 }37 }3839public String getWsdlName() {40return wsdlName;41 }4243public void setWsdlName(String wsdlName) {44this.wsdlName = wsdlName;45 }4647public List<InterfaceInfo> getInterfaces() {48return interfaces;49 }5051public void setInterfaces(List<InterfaceInfo> interfaces) {52this.interfaces = interfaces;54 }1/**2 *3 * InterfaceInfo.java Create on 2016年7⽉20⽇下午9:03:214 *5 * 类功能说明: 接⼝信息6 *7 * Copyright: Copyright(c) 20138 * Company: COSHAHO9 * @Version 1.010 * @Author 何科序11*/12public class InterfaceInfo13 {14private String interfaceName;1516private List<OperationInfo> operations;1718private String[] adrress;1920public InterfaceInfo(WsdlInterface wsdlInterface)21 {22this.interfaceName = wsdlInterface.getName();2324this.adrress = wsdlInterface.getEndpoints();2526int operationNum = wsdlInterface.getOperationCount();27 List<OperationInfo> operations = new ArrayList<OperationInfo>();2829for(int i = 0; i < operationNum; i++)30 {31 WsdlOperation operation = ( WsdlOperation )wsdlInterface.getOperationAt( i );32 OperationInfo operationInfo = new OperationInfo(operation);33 operations.add(operationInfo);34 }3536this.operations = operations;37 }3839public String getInterfaceName() {40return interfaceName;41 }4243public void setInterfaceName(String interfaceName) {44this.interfaceName = interfaceName;45 }4647public List<OperationInfo> getOperations() {48return operations;49 }5051public void setOperations(List<OperationInfo> operations) {52this.operations = operations;53 }5455public String[] getAdrress() {56return adrress;57 }5859public void setAdrress(String[] adrress) {60this.adrress = adrress;61 }62 }1/**2 *3 * OperationInfo.java Create on 2016年7⽉20⽇下午9:03:424 *5 * 类功能说明: ⽅法信息6 *7 * Copyright: Copyright(c) 20138 * Company: COSHAHO9 * @Version 1.010 * @Author 何科序11*/12public class OperationInfo13 {14private String operationName;1516private String requestXml;1718private String responseXml;20public OperationInfo(WsdlOperation operation)21 {22 operationName = operation.getName();23 requestXml = operation.createRequest( true );24 responseXml = operation.createResponse(true);25 }2627public String getOperationName() {28return operationName;29 }3031public void setOperationName(String operationName) {32this.operationName = operationName;33 }3435public String getRequestXml() {36return requestXml;37 }3839public void setRequestXml(String requestXml) {40this.requestXml = requestXml;41 }4243public String getResponseXml() {44return responseXml;45 }4647public void setResponseXml(String responseXml) {48this.responseXml = responseXml;49 }50 }测试代码1package com.coshaho.integration;23import com.coshaho.integration.wsdl.InterfaceInfo;4import com.coshaho.integration.wsdl.OperationInfo;5import com.coshaho.integration.wsdl.WsdlInfo;67/**8 *9 * WSDLParseTest.java Create on 2016年7⽉20⽇下午9:24:3610 *11 * 类功能说明: WSDL解析测试12 *13 * Copyright: Copyright(c) 201314 * Company: COSHAHO15 * @Version 1.016 * @Author 何科序17*/18public class WSDLParseTest19 {20public static void main(String[] args) throws Exception21 {22 String url = "/WebServices/ChinaOpenFundWS.asmx?wsdl";23 WsdlInfo wsdlInfo = new WsdlInfo(url);24 System.out.println("WSDL URL is " + wsdlInfo.getWsdlName());2526for(InterfaceInfo interfaceInfo : wsdlInfo.getInterfaces())27 {28 System.out.println("Interface name is " + interfaceInfo.getInterfaceName());29for(String ads : interfaceInfo.getAdrress())30 {31 System.out.println("Interface address is " + ads);32 }33for(OperationInfo operation : interfaceInfo.getOperations())34 {35 System.out.println("operation name is " + operation.getOperationName());36 System.out.println("operation request is ");37 System.out.println("operation request is " + operation.getRequestXml());38 System.out.println("operation response is ");39 System.out.println(operation.getResponseXml());40 }41 }42 }43 }测试结果1 WSDL URL is /WebServices/ChinaOpenFundWS.asmx?wsdl2 Interface name is ChinaOpenFundWSSoap123 Interface address is /WebServices/ChinaOpenFundWS.asmx4 operation name is getFundCodeNameDataSet5 operation request is6 operation request is <soap:Envelope xmlns:soap="/2003/05/soap-envelope" xmlns:web="/">7<soap:Header/>8<soap:Body>9<web:getFundCodeNameDataSet/>10</soap:Body>11</soap:Envelope>12 operation response is13<soap:Envelope xmlns:soap="/2003/05/soap-envelope" xmlns:web="/" xmlns:xs="/2001/XMLSchema"> 14<soap:Header/>15<soap:Body>16<web:getFundCodeNameDataSetResponse>17<!--Optional:-->18<web:getFundCodeNameDataSetResult>19<xs:schema>20<!--Ignoring type [{/2001/XMLSchema}schema]-->21</xs:schema>22<!--You may enter ANY elements at this point-->23</web:getFundCodeNameDataSetResult>24</web:getFundCodeNameDataSetResponse>25</soap:Body>26</soap:Envelope>27 operation name is getFundCodeNameString28 operation request is29 operation request is <soap:Envelope xmlns:soap="/2003/05/soap-envelope" xmlns:web="/">30<soap:Header/>31<soap:Body>32<web:getFundCodeNameString/>33</soap:Body>34</soap:Envelope>35 operation response is36<soap:Envelope xmlns:soap="/2003/05/soap-envelope" xmlns:web="/">37<soap:Header/>38<soap:Body>39<web:getFundCodeNameStringResponse>40<!--Optional:-->41<web:getFundCodeNameStringResult>42<!--Zero or more repetitions:-->43<web:string>?</web:string>44</web:getFundCodeNameStringResult>45</web:getFundCodeNameStringResponse>46</soap:Body>47</soap:Envelope>48 operation name is getOpenFundDataSet49 operation request is50 operation request is <soap:Envelope xmlns:soap="/2003/05/soap-envelope" xmlns:web="/">51<soap:Header/>52<soap:Body>53<web:getOpenFundDataSet>54<!--Optional:-->55<web:userID>?</web:userID>56</web:getOpenFundDataSet>57</soap:Body>58</soap:Envelope>59 operation response is60<soap:Envelope xmlns:soap="/2003/05/soap-envelope" xmlns:web="/" xmlns:xs="/2001/XMLSchema"> 61<soap:Header/>62<soap:Body>63<web:getOpenFundDataSetResponse>64<!--Optional:-->65<web:getOpenFundDataSetResult>66<xs:schema>67<!--Ignoring type [{/2001/XMLSchema}schema]-->68</xs:schema>69<!--You may enter ANY elements at this point-->70</web:getOpenFundDataSetResult>71</web:getOpenFundDataSetResponse>72</soap:Body>73</soap:Envelope>。

WSDL文件结构详解

WSDL文件结构详解

wsdl文件结构分析WSDL (Web Services Description Language,Web服务描述语言)是一种XML Application，他将Web服务描述定义为一组服务访问点，客户端可以通过这些服务访问点对包含面向文档信息或面向过程调用的服务进行访问(类似远程过程调用)。

WSDL首先对访问的操作和访问时使用的请求/响应消息进行抽象描述，然后将其绑定到具体的传输协议和消息格式上以最终定义具体部署的服务访问点。

相关的具体部署的服务访问点通过组合就成为抽象的Web服务。

本文将详细讲解WSDL文档的结构，并分析每个元素的作用。

一：WSDL定义WSDL是一个用于精确描述Web服务的文档，WSDL文档是一个遵循WSDL XML模式的XML文档。

WSDL 文档将Web服务定义为服务访问点或端口的集合。

在 WSDL 中，由于服务访问点和消息的抽象定义已从具体的服务部署或数据格式绑定中分离出来，因此可以对抽象定义进行再次使用：消息，指对交换数据的抽象描述；而端口类型，指操作的抽象集合。

用于特定端口类型的具体协议和数据格式规范构成了可以再次使用的绑定。

将Web访问地址与可再次使用的绑定相关联，可以定义一个端口，而端口的集合则定义为服务。

一个WSDL文档通常包含7个重要的元素，即types、import、message、portType、operation、binding、 service元素。

这些元素嵌套在definitions 元素中，definitions是WSDL文档的根元素。

文章的下一部分将会详细介绍WSDL 的基本结构。

二：WSDL的基本结构--概述如第一部分最后描述的那样，一个基本的WSDL文档包含7个重要的元素。

下面将分别介绍这几个元素以及他们的作用。

WSDL 文档在Web服务的定义中使用下列元素：· Types - 数据类型定义的容器，它使用某种类型系统(一般地使用XML Schema中的类型系统)。

WSDL文档结构

WSDL文档结构

WSDL文档结构WSDL文档可以分为两部分。

顶部分由抽象定义组成，而底部分则由具体描述组成。

抽象部分以独立于平台和语言的方式定义SOAP消息，它并不包含任何随机器或语言而变的元素。

这就定义了一系列服务，截然不同的网站都可以实现。

随网站而异的东西如序列化便归入底部分，因为它包含具体的定义。

l 抽象定义Types独立与机器和语言的类型定义Messages包括函数参数（输入与输出分开）或文档描述PortTypes引用消息部分中消息定义来描述函数签名（操作名、输入参数、输出参数）2 具体定义BindingsPortTypes部分的每一操作在此绑定实现Services确定每一绑定的端口地址图一：抽象定义和具体定义图中，箭头连接符代表文档不同栏之间的关系。

点和箭头代表了引用或使用关系。

双箭头代表"修改"关系。

3-D的箭头代表了包含关系。

这样，各Messages栏使用Types 栏的定义，PortTypes栏使用Messages栏的定义；Bindings栏引用了PortTypes栏，Services栏引用Bindings栏，PortTypes和Bindings栏包含了operation元素，而Services栏包含了port元素。

PortTypes栏里的operation元素由Bindings栏里的operation元素进一步修改或描述。

在此背景中，将使用标准的XML术语来描述WSDL文档。

Element是指XML的元素，而"attribute"指元素的属性。

于是：＜element attribute="attribute-value"＞contents＜/element＞内容也可能由一个或多个元素以递归的方式组成。

根元素是所有元素之中最高级的元素。

子元素总是从属于另一个元素，父元素。

注意，文档之中可能只有一个Types栏，或根本没有。

所有其他的栏可以只有零元素、单元素或是多元素。

WebService之WSDL文件讲解

WebService之WSDL文件讲解

WebService之WSD文件讲解原文地址：/tropica/archive/2008/11/02/3203892.aspx恩，我想说的是，是不是经常有人在开发的时候，特别是和第三方有接口的时候，走的是SOAP协议，然后用户给你一个WSDL文件，说按照上面的进行适配，嘿嘿，这个时候，要是你以前没有开发过，肯定会傻眼，那如果你想学习的话，就认真的看下面的讲解咯：一、WSDL概述WebServices Description Language(WSDL Web服务语言)是一个用于精确描述Web Service的文档格式。

WSDL非常适合于用作代码生成器，它能够读取WSDL文档，并且可以为访问Web 服务生成一个程序化的接口，大多数软件供应商和主要的标准机构（包括W3C、WS-I和OASIS）都支持WSDL。

例如：JAX-RPC provider（例如：BEA Weblogic）通过API用WSDL生成相应的占位程序；IBM WebSphere、以及Apache Axis都有自己的工具生成相关的代码。

下图是一个例子：上面的例子JAX-RPC通过读取WSDL文档，创建JAX-RPC RMI接口（endpoint接口）和实现此接口的网络占位程序（stub）。

客户端程序通过RMI接口，Stub和Web Service 服务端交换SAOP消息。

二、WSDL基本结构WSDL文档是一个遵循WSDL XML模式的XML文档（文档实例）；类似于：SOAP文档是一个遵循SOAP XML模式的XML文档（文档实例）；一个WSDL文档的根元素是definitions元素，WSDL文档包含7个重要的元素：types, import,message,portType,operations,binding和service元素。

三、WSDL声明3.1XML声明<?xml version="1.0"encoding="UTF-8"?>WSDL的声明必须定义成使用：UTF-8或者UTF-16编码。