webservice注解

javax.jws.WebService

要点：

??实现?Web?Service?的?Java?类必须指定?@WebService?或?@WebServiceProvider?注释。不能同时提供这两种注释。

此注释适用于客户机/服务器?SEI?或?JavaBeans?端点的服务器端点实现类。

??如果注释通过?endpointInterface?属性引用了某个?SEI，那么还必须使用?@WebService?注释来注释该?SEI。

??请参阅适用于使用?@WebService?注释的类的方法的规则，以了解更多信息。

属性：

-?name

wsdl:portType的名称。缺省值为?Java?类或接口的非限定名称。（字符串）

-?targetNamespace

指定从?Web?Service?生成的?WSDL?和?XML?元素的?XML?名称空间。缺省值为从包含该?Web?Service?的包名映射的名称空间。（字符串）

-?serviceName

指定?Web?Service?的服务名称：wsdl:service。缺省值为?Java?类的简单名称?+?Service。（字符串）

-?endpointInterface

指定用于定义服务的抽象?Web?Service?约定的服务端点接口的限定名。如果指定了此限定名，那么会使用该服务端点接口来确定抽象?WSDL?约定。（字符串）

-?portName

wsdl:portName。缺省值为?WebService.name+Port-?wsdlLocation

指定用于定义?Web?Service?的?WSDL?文档的?Web?地址。Web?地址可以是相对路径或绝对路径。（字符串）

将此注释应用于客户机或服务器服务端点接口（SEI）上的方法，或者应用于?JavaBeans?端点的服务器端点实现类。

??仅支持在使用?@WebService?注释来注释的类上使用?@WebMethod?注释。

-?operationName

指定与此方法相匹配的wsdl:operation?的名称。缺省值为?Java?方法的名称。（字符串）

-?action

定义此操作的行为。对于?SOAP?绑定，此值将确定?SOAPAction?头的值。缺省值为?Java?方法的名称。（字符串）

-?exclude

指定是否从?Web?Service?中排除某一方法。缺省值为?false。（布尔值）

将此注释应用于客户机或服务器服务端点接口（SEI）上的方法，或者应用于?JavaBeans?端点的服务器端点实现类。

注释目标：参数

参数的名称。如果操作是远程过程调用（RPC）类型并且未指定partName?属性，那么这是用于表示参数的?wsdl:part?属性的名称。如果操作是文档类型或者参数映射至某个头，那么?-name?是用于表示该参数的?XML?元素的局部名称。如果操作是文档类型、参数类型为?BARE?并且方式为?OUT?或?INOUT，那么必须指定此属性。（字符串）

-?partName

定义用于表示此参数的?属性的名称。仅当操作类型为?RPC?或者操作是文档类型并且参数类型为?时才使用此参数。（字符串）

指定参数的?XML?元素的?XML?名称空间。当属性映射至?XML?元素时，仅应用于文档绑定。缺省值为?Web?Service?的?targetNamespace-?mode

此值表示此方法的参数流的方向。有效值为?IN、?和?-?header

指定参数是在消息头还是消息体中。缺省值为?javax.jws.WebResult

当返回值列示在?WSDL?文件中并且在连接上的消息中找到该返回值时，指定该返回值的名称。对于?RPC?绑定，这是用于表示返回值的?属性的名称。对于文档绑定，参数是用于表示返回值的?XML?元素的局部名。对于?RPC?和?DOCUMENT/WRAPPED?绑定，缺省值为?return。对于?DOCUMENT/BARE?绑定，缺省值为方法名?+?Response指定返回值的?XML?名称空间。仅当操作类型为?RPC?或者操作是文档类型并且参数类型为?BARE?时才使用此参数。（字符串）

指定头中是否附带结果。缺省值为。（布尔值）

指定?RPC?或?DOCUMENT/BARE?操作的结果的部件名称。缺省值为@WebResult.name。（字符串）

只能通过对?SEI?或实现类使用?@HandlerChain?注释来配置服务器端的处理程序。

但是可以使用多种方法来配置客户端的处理程序。可以通过对生成的服务类或者?SEI?使用?@HandlerChain?注释来配置客户端的处理程序。此外，可以按程序在服务上注册您自己的?HandlerResolver?接口实现，或者按程序在绑定对象上设置处理程序链。

指定处理程序链文件所在的位置。文件位置可以是采用外部格式的绝对?java.net.URL，也可以是类文件中的相对路径。（字符串）

指定配置文件中处理程序链的名称。（字符串）

将此注释应用于客户机或服务器服务端点接口（SEI）上的类型或方法，或者应用于?JavaBeans?端点的服务器端点实现类。

方法级别的注释仅限于它可以指定的对象，仅当style?属性为?DOCUMENT?时才使用该注释。如果未指定方法级别的注释，那么将使用类型的?行为。

-?style

定义发送至?Web?Service?和来自?Web?Service?的消息的编码样式。有效值为RPC。缺省值为-?use

定义用于发送至?Web?Service?和来自?Web?Service?的消息的格式。缺省值为?LITERAL。ENCODED?在?Feature?Pack?for?Web?Services?中不受支持。（字符串）

-?parameterStyle

确定方法的参数是否表示整个消息体，或者参数是否是封装在执行操作之后命名的顶级元素中的元素。有效值为?WRAPPED。对于?类型的绑定只能使用?值。缺省值为?。（字符串）