java原生 webservice注解

最新推荐文章于 2024-07-13 13:58:54 发布

xsf18

最新推荐文章于 2024-07-13 13:58:54 发布

阅读量1.6k

点赞数

分类专栏： Java Web

本文链接：https://blog.csdn.net/xsf1840/article/details/71423245

版权

本文介绍了使用 Java 的 @WebService 注解在创建 Web 服务时的规则和注意事项，重点探讨适用于此类方法的详细规范。

摘要由CSDN通过智能技术生成

Web Service 元数据注释（JSR 181）

注释类：注释：属性：

javax.jws.WebService

当实现 Web Service 时，@WebService 注释标记 Java 类；实现 Web Service 接口时，标记服务端点接口（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 注释