WSDL（WebService描述语言）文件介绍

Posted 2020-11-21 纪煜楷

tags:

篇首语：本文由小常识网(cha138.com)小编为大家整理，主要介绍了WSDL（WebService描述语言）文件介绍相关的知识，希望对你有一定的参考价值。

一、WSDL　　

　　1、WSDL 文档的组成部分

　　<portType>：web service 执行的操作

　　<message>：web service 使用的消息

　　<types>：web service 使用的数据类型

　　<binding>：web service 使用的通信协议

　 2、WSDL元素介绍

WSDL规范为了不会产生歧义，定义了特有名词来表述功能与服务。

　　<portType> ：<portType>元素是最重要的 WSDL 元素。它可描述一个 Web Service、可被执行的操作，以及相关的消息。可以把 <portType> 元素比作传统编程语言中的一个函数库（或一个模块、或一个类）。

　　<operation>：<operation>是对服务中所支持的操作的抽象描述，一般单个Operation描述了一个访问入口的请求/响应消息对。

　　<message>： <message>元素定义一个操作的数据元素。每个消息均由一个或多个部件组成。可以把这些部件比作传统编程语言中一个函数调用的参数。通信消息的数据结构的抽象类型化定义。使用Types所定义的类型来定义整个消息的数据结构。

　　<types>： <types>元素定义WebService 使用的数据类型。为了最大程度的平台中立性，WSDL 使用 XML Schema 语法来定义数据类型。

　　<binding>： <binding>元素为每个端口定义消息格式和协议细节。

　　3、WSDL 文档的简化片段示例　

<message name="getTermRequest">
   <part name="term" type="xs:string"/>
</message>

<message name="getTermResponse">
   <part name="value" type="xs:string"/>
</message>

<portType name="glossaryTerms">
  <operation name="getTerm">
        <input message="getTermRequest"/>
        <output message="getTermResponse"/>
  </operation>
</portType>

　　A、在这个例子中，<portType> 元素把 "glossaryTerms" 定义为某个端口的名称，把 "getTerm" 定义为某个操作的名称。

　　B、操作 "getTerm" 拥有一个名为 "getTermRequest" 的输入消息，以及一个名为 "getTermResponse" 的输出消息。

　　C、<message> 元素可定义每个消息的部件，以及相关联的数据类型。

　　备注：具体的WSDL语法详见附件《WebService描述语言WSDL详解.pdf》

　 https://files.cnblogs.com/files/jiyukai/WebService描述语言WSDL详解.pdf

二、使用WebService注解来修改WSDL文件

　　1、 WebService注解概述

　　WSDL文件的内容，一般由服务默认生成，但为了更好的向开发人员提供使用说明书，一般应做一些简单的修改。至少不应该暴露我们的包结构。而targetNamespace默认情况下为倒置的包名，这已经暴露了我们的包结构。通过在类文件上添加以下注解，可以修改wsdl生成的各元素，而不是直接去修改wsdl文件，直接去修改wsdl文件是无效的。

　　WebService的注解包括：

　　A、 @WebService-定义服务 — 注解位置：类名

　　B、 @WebMethod-定义方法－注解位置：方法

　　C、 @WebResult-定义返回值 – 注解位置：返回值

　　D、@WebParam-定义参数 – 注解位置：方法参数

　　2、 WebService注解类型详解

　　（1）WebService注解

　　@WebService标注要暴露为Web Services的类或接口，用于修饰类或接口，包含的属性有：

　　targetNamespace属性：定义命名空间，默认为”http://”+”包名倒排”

　　name属性：Web Service 的名称，默认为发布服务的类名。

　　serviceName: ws服务的名词,默认在类名后面添加了service

　　endpointInterface属性：定义服务抽象 Web Service 协定的服务端点接口的完整名称,接口也必须声明WebService注解,包括方法的注解必须也要添加到接口中,否则会无效, 而且WS在没有注解的情况下.生成WS的时候会自动生成一个注解.所以可以不用指定接口。