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 文档的简化片段示例

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的时候会自动生成一个注解.所以可以不用指定接口。