WebService(3) 常见标签详解

@WebService标签

使用@WebService标签，需要配置在类上，代表这是一个提供WS的服务类。

endpointInterface：定义服务抽象WebService 协定的服务端点接口的完整名称。不允许在端点上使用此成员值，该元素的值必须有WebService标签。默认情况下，服务器自动生成服务端接口。

name：服务接口名称（对应wsdl: portType的name属性，用在服务接口上）；

serviceName：服务类名称。默认为，实现类名+Service（对应service的name和definition上的name属性对应，用在实现类上）。

portName：Web Service的端口名称。此名称被用作wsdl:port的名称。

targetNamespace：目标命名空间，描述服务的预定义WSDL的位置（同时用在实现类和服务接口上，需统一）。

wsdlLocation：WSDL地址（服务端除了WSDL优先的情况外可不写，客户端代理接口上必须配置此属性，指向web端WSDL文件地址）

@WebMethod标签

使用@WebMethod标签，需要把他配置到方法上。

operationName：指定暴露服务方法的别名。

exclude：是否暴露此标记的方法。

@WebResult标签

使用@WebResult标签，需要把他标记在方法上或者方法返回类型定义之前。

name：定义返回值的名称。

header：布尔类型，是否把值放到header元素中进行传递。

@WebParam标签

使用@WebParam标签，需要把他标记在形参声明之前。

name：定义传递时参数的名称（默认参数以arg0，arg1…）。

header：布尔类型，是否把值放到header元素中进行传递。

@SOAPBinding

使用@ SOAPBinding标签，需要把他标记在类上。

SOAPBinding.ParameterStyleparameterStyle 确定方法参数是否表示整个消息正文，或者参数是否是包装在以操作命名的顶层元素中的元素。

SOAPBinding.ParameterStyle.WRAPPED,默认，使用对参数进行包装

SOAPBinding.ParameterStyle.BARE，不对参数进行包装

SOAPBinding.Style style 定义发 送到Web Service 的消息 和从Web Service发送的消息的编码样式。

SOAPBinding.Style.RPC：面向RPC

SOAPBinding.Style.DOCUMENT 默认，面向文档

SOAPBinding.Useuse 定义发送到WebService的消息和从WebService发送的消息的格式样式。

SOAPBinding.Use.LITERAL,默认，字面量风格，若服务端和客户端不在一起开发，就应该使用这个

SOAPBinding.Use.ENCODED使用SOAP编码风格，可能导致WS互操作方面失败问题，尽量避免使用。