WebService 注解的使用及解释

javax.jws.WebService:

当实现 Web Service时,@WebService 

注释标记 Java 类;实现 WebService 接口时,标记服务端点接口(SEI)

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

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

如果注释通过 

endpointInterface 属性引用了某个SEI,那么还必须使用 @WebService 注释来注释该 SEI。

  • 注释目标:类型
  • 属性:
- 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 地址可以是相对路径或绝对路径。(字符串)




javax.jws.WebMethod:

@WebMethod 

注释表示作为一项 Web Service操作的方法。

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

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


  • 注释目标:方法
  • 属性:
- operationName
指定与此方法相匹配的 wsdl:operation  的名称。缺省值为Java 方法的名称。(字符串
- action
定义此操作的行为。对于 SOAP 绑定,此值将确定 SOAPAction头的值。缺省值为 Java 方法的名称。(字符串)
- exclude
指定是否从 Web Service中排除某一方法。缺省值为  false





javax.jws.Oneway:

@Oneway 

注释将一个方法表示为只有输入消息而没有输出消息的Web Service 单向操作。

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







javax.jws.WebParam:

@WebParam 

注释用于定制从单个参数至 WebService 消息部件和 XML 元素的映射。

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

  • 注释目标:参数
  • 属性:
- name
参数的名称。如果操作是远程过程调用(RPC)类型并且未指定 partName  属性,那么这是用于表示参数的  wsdl:part  属性的名称。如果操作是文档类型或者参数映射至某个头,那么  -name  是用于表示该参数的XML 元素的局部名称。如果操作是文档类型、参数类型为  BARE  并且方式为  OUT  或  INOUT,那么必须指定此属性。(字符串)
- partName
定义用于表示此参数的  wsdl:part属性的名称。仅当操作类型为RPC 或者操作是文档类型并且参数类型为 BARE  时才使用此参数。(字符串
- targetNamespace
指定参数的 XML 元素的 XML 名称空间。当属性映射至 XML元素时,仅应用于文档绑定。缺省值为 Web Service 的  targetNamespace。(字符串)
- header
指定参数是在消息头还是消息体中。缺省值为  false。(布尔值)




  • 0
    点赞
  • 0
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值