WSDL文件是什么 Web服务描述语言WSDL文件结构详解

WSDL文件是Web服务的机器可读接口契约，含definitions、types、message、portType、binding、port、service七个关键元素，用于描述服务功能、调用方式及地址等。

WSDL文件是Web服务的“说明书”，用XML格式写成，告诉客户端这个服务能做什么、怎么调用、参数和返回值长什么样、走什么协议、地址在哪。它不是代码，也不是配置文件，而是一份机器可读的接口契约。

WSDL核心作用

它让不同系统之间能自动对接：工具（比如wsimport、SoapUI、Visual Studio）读取WSDL后，就能自动生成客户端代码、测试请求、校验消息结构。没有它，调用Web服务就得靠人工猜接口、拼SOAP、试错调试。

WSDL七个关键元素（从上到下逻辑顺序）

types：定义所有用到的数据类型，通常内嵌或引用XSD Schema。比如手机号字段是string、返回码是int、结果对象有name和code两个子项——这些都在这里声明。

message：把types里的类型组装成“一次通信单元”。一个message代表一个输入参数包，另一个代表一个返回结果包。注意：request和response必须分开定义。

portType：相当于服务的“接口类”。它用operation列出所有可用方法，并为每个方法指定对应的input message和output message。还可定义fault message处理异常。

binding：说明某个portType具体怎么落地。比如用SOAP 1.1还是1.2、走HTTP还是HTTPS、是document/literal还是rpc/encoded风格、soapAction头怎么填——这些协议细节全在这里绑定。

port：把binding和真实网络地址连起来。一个port = 一个binding + 一个soap:address location（就是你实际发请求的URL）。

标签： 工具 配置文件