没有合适的资源?快使用搜索试试~ 我知道了~
cxf实现webservice 常用注解总结
5星 · 超过95%的资源 需积分: 44 167 下载量 133 浏览量
2012-11-15
15:13:06
上传
评论 6
收藏 32KB DOCX 举报
温馨提示
试读
11页
cxf实现webservice 常用注解总结,本文档包括cxf实现webservice是用到所有注解,请大家参考
资源推荐
资源详情
资源评论
JAX-WS 注释
“基于 XML 的 Web Service 的 Java API”(JAX-WS)通过使用注释来指定与 Web Service 实
现相关联的元数据以及简化 Web Service 的开发。注释描述如何将服务器端的服务实现作为 Web
Service 来访问或者客户端的 Java 类如何访问 Web Service。
JAX-WS 编程标准支持将具有用于定义服务端点应用程序的元数据的 Java 类作为 Web
Service 来注释以及注释客户机可以如何访问 Web Service。JAX-WS 支持使用基于 Metadata
Facility for the Java Programming Language(Java 规范请求(JSR)175)规范和“用于 Java 平台
的 Web Service 元数据”(JSR 181)规范的注释,还可以使用由 JAX-WS 2.0(JSR 224)规范定
义的注释(包括 JAXB 注释)。通过使用符合 JSR 181 标准的注释,可以简单地注释服务实现类或
服务接口,并且现在将应用程序作为 Web Service 来启用。通过在 Java 源代码中使用注释可以简
化 Web Service 的开发和部署,因为会定义一些通常从部署描述符文件和 WSDL 文件中获得的附加
信息,或者会将元数据从 XML 和 WSDL 映射至源工件中。
使用注释来配置绑定、处理程序链、端口类型的集合名称、服务以及其他 WSDL 参数。注释用
于将 Java 映射至 WSDL 和模式,以及在运行时控制 JAX-WS 运行时处理和响应 Web Service 调
用的方式。
下表中列示了 JAX-WS 支持的注释。注释的目标适用于下列 Java 对象:
诸如 Java 类、枚举或接口等类型
方法
用于表示 Java 类中局部实例变量的字段
Java 方法中的参数
Web Service 元数据注释(JSR 181)
注释类: 注释: 属性:
javax.jws.WebService
当实现 Web Service 时,
@WebService 注释标记
Java 类 ; 实 现 Web
Service 接口时,标记服
务端点接口(SEI)。
要点:
• 实 现 Web Service 的
Java 类 必 须 指 定
@WebService 或
@WebServiceProvider 注
注释目标:类型
属性:
- name
wsdl:portType 的名
称。缺省值为 Java 类
或 接 口 的 非 限 定 名
称。(字符串)
- targetNamespace
指 定 从 Web Service
生成的 WSDL 和 XML
注释类: 注释: 属性:
释。不能同时提供这两
种注释。
此注释适用于客户机/服
务器 SEI 或 JavaBeans 端
点 的 服 务 器 端 点 实 现
类。
• 如 果 注 释 通 过
endpointInterface 属
性引用了某个 SEI,那么
还 必 须 使 用
@WebService 注 释 来 注
释该 SEI。
• 请 参 阅 适 用 于 使 用
@WebService 注释的类的
方法的规则,以了解更多
信息。
元素 的 XML 名 称 空
间。缺省值为从包含
该 Web Service 的 包
名映射的名称空间。
(字符串)
- serviceName
指定 Web Service 的
服 务 名 称 :
wsdl:service。缺省
值为 Java 类的简单名
称 + Service。(字符
串)
- endpointInterface
指定用于定义服务的
抽象 Web Service 约
定的服务端点接口的
限定名。如果指定了
此限定名,那么会使
用该服务端点接口来
确 定 抽 象 WSDL 约
定。(字符串)
- portName
wsdl:portName 。
缺 省 值 为
WebService.name+Por
t。(字符串)
- wsdlLocation
指 定 用 于 定 义 Web
Service 的 WSDL 文档
的 Web 地 址 。 Web
地址可以是相对路径
或绝对路径。(字符
串)
javax.jws.WebMethod
@WebMethod 注释表示
作为一项 Web Service 操
作的方法。
将此注释应用于客户机
或服务器服务端点接口
(SEI)上的方法,或者
应 用 于 JavaBeans 端 点
注释目标:方法
属性:
- operationName
指定与此方法相匹配
的 wsdl:operation
的 名 称 。 缺 省 值 为
Java 方 法 的 名 称 。
注释类: 注释: 属性:
的服务器端点实现类。
要点:
• 仅 支 持 在 使 用
@WebService 注 释 来 注
释 的 类 上 使 用
@WebMethod 注释。
(字符串)
- action
定义此操作的行为。
对于 SOAP 绑定,此
值将确定 SOAPAc"on
头 的 值 。 缺 省 值 为
Java 方 法 的 名 称 。
(字符串)
- exclude
指 定 是 否 从 Web
Service 中排除某一方
法 。 缺 省 值 为
false。(布尔值)
javax.jws.Oneway
@Oneway 注释将一个方
法表示为只有输入消息
而没有输出消息的 Web
Service 单向操作。
将此注释应用于客户机
或服务器服务端点接口
(SEI)上的方法,或者
应 用 于 JavaBeans 端 点
的服务器端点实现类。
注释目标:方法
没有 适 用于 Oneway
注释的属性。
javax.jws.WebParam
@WebParam 注 释 用 于
定制从单个参数至 Web
Service 消息部件和 XML
元素的映射。
将此注释应用于客户机
或服务器服务端点接口
(SEI)上的方法,或者
应 用 于 JavaBeans 端 点
的服务器端点实现类。
注释目标:参数
属性:
- name
参数的名称。如果操
作 是 远 程 过 程 调 用
(RPC)类型并且未
指 定 partName 属
性,那么这是用于表
示参数的 wsdl:part
属性的名称。如果操
作是文档类型或者参
数映射至某个头,那
么 -name 是用于表
示该参数的 XML 元素
的局部名称。如果操
作是文档类型、参数
类型为 BARE 并且方
式 为 OUT 或
剩余10页未读,继续阅读
zhangwxsoftbrain
- 粉丝: 2
- 资源: 11
上传资源 快速赚钱
- 我的内容管理 展开
- 我的资源 快来上传第一个资源
- 我的收益 登录查看自己的收益
- 我的积分 登录查看自己的积分
- 我的C币 登录后查看C币余额
- 我的收藏
- 我的下载
- 下载帮助
安全验证
文档复制为VIP权益,开通VIP直接复制
信息提交成功
- 1
- 2
- 3
- 4
- 5
前往页