Web Service进阶 四 WebService注解

@WebService

1、serviceName: 对外发布的服务名,指定 Web Service 的服务名称:wsdl:service。缺省值为 Java 类的简单名称 + Service。(字符串)

2、endpointInterface: 服务接口全路径, 指定做SEI(Service EndPoint Interface)服务端点接口

3、name:此属性的值包含XML Web Service的名称。在默认情况下,该值是实现XML Web Service的类的名称,wsdl:portType 的名称。缺省值为 Java 类或接口的非限定名称。(字符串)

4、portName:  wsdl:portName。缺省值为 WebService.name+Port。

5、targetNamespace:指定你想要的名称空间,默认是使用接口实现类的包名的反缀。

6、wsdlLocation:指定用于定义 Web Service 的 WSDL 文档的 Web 地址。Web 地址可以是相对路径或绝对路径。(字符串)

注意:实现类上可以不添加Webservice注解

@WebMethod

注释表示作为一项 Web Service 操作的方法,将此注释应用于客户机或服务器服务端点接口(SEI)上的方法,或者应用于 JavaBeans 端点的服务器端点实现类。

要点:

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

1、operationName:指定与此方法相匹配的wsdl:operation 的名称。缺省值为 Java 方法的名称。(字符串)

2、action:定义此操作的行为。对于 SOAP 绑定,此值将确定 SOAPAction 头的值。缺省值为 Java 方法的名称。(字符串)

3、exclude:指定是否从 Web Service 中排除某一方法。缺省值为 false。(布尔值)

@Oneway

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

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

@WebParam

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

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

1、name :参数的名称。如果操作是远程过程调用(RPC)类型并且未指定partName 属性,那么这是用于表示参数的 wsdl:part 属性的名称。

如果操作是文档类型或者参数映射至某个头,那么 -name 是用于表示该参数的 XML 元素的局部名称。如果操作是文档类型、

参数类型为 BARE 并且方式为 OUT 或 INOUT,那么必须指定此属性。(字符串)

2、partName:定义用于表示此参数的 wsdl:part属性的名称。仅当操作类型为 RPC 或者操作是文档类型并且参数类型为BARE 时才使用此参数。(字符串)

3、targetNamespace:指定参数的 XML 元素的 XML 名称空间。当属性映射至 XML 元素时,仅应用于文档绑定。缺省值为 Web Service 的 targetNamespace。(字符串)

4、mode:此值表示此方法的参数流的方向。有效值为 IN、INOUT 和 OUT。(字符串)

5、header:指定参数是在消息头还是消息体中。缺省值为 false。(布尔值)

@WebResult

注释用于定制从返回值至 WSDL 部件或 XML 元素的映射。将此注释应用于客户机或服务器服务端点接口(SEI)上的方法,或者应用于 JavaBeans 端点的服务器端点实现类。

1、name:当返回值列示在 WSDL 文件中并且在连接上的消息中找到该返回值时,指定该返回值的名称。对于 RPC 绑定,这是用于表示返回值的 wsdl:part属性的名称。对于文档绑定,-name参数是用于表示返回值的 XML 元素的局部名。对于 RPC 和 DOCUMENT/WRAPPED 绑定,缺省值为 return。对于 DOCUMENT/BARE 绑定,缺省值为方法名 + Response。(字符串)

2、targetNamespace:指定返回值的 XML 名称空间。仅当操作类型为 RPC 或者操作是文档类型并且参数类型为 BARE 时才使用此参数。(字符串)

3、header:指定头中是否附带结果。缺省值为false。(布尔值)

4、partName:指定 RPC 或 DOCUMENT/BARE 操作的结果的部件名称。缺省值为@WebResult.name。(字符串)

@HandlerChain

注释用于使 Web Service 与外部定义的处理程序链相关联。只能通过对 SEI 或实现类使用 @HandlerChain 注释来配置服务器端的处理程序。

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

1、file:指定处理程序链文件所在的位置。文件位置可以是采用外部格式的绝对 java.net.URL,也可以是类文件中的相对路径。(字符串)

2、name:指定配置文件中处理程序链的名称。

以下为一段代码示例:

package cn.itcast.service;
 2
 3 import javax.jws.WebMethod;
 4 import javax.jws.WebParam;
 5 import javax.jws.WebResult;
 6 import javax.jws.WebService;
 7 import javax.xml.ws.Endpoint;
 8 /**
 9  * 将 Java 类标记为实现 Web Service,或者将 Java 接口标记为定义 Web Service 接口
10  * @author
11  *
12  */
13 //修改目标空间   ,修改服务名         在wsdl那里的xml文件显示对应的修改信息
14 @WebService(targetNamespace="http://www.itcast.cn",serviceName="MyService")
15 public class HelloService {
16     //修改方法名  返回值的名字
17     @WebMethod(operationName="hello")
18     @WebResult(name="ret")
19     public String sayHello(
20             //修改参数名字
21             @WebParam(name="name")
22             String name,
23             @WebParam(name="age")
24             int age){
25         System.out.println("sayHello called...");
26         return "hello " + name;
27     }
28     //此方法 本系统测试 不对外发布
29     @WebMethod(exclude=true)
30     public String sayHello2(String name){
31         System.out.println("sayHello called...");
32         return "hello " + name;
33     }
34
35     public static void main(String[] args) {
36         //参数1:绑定服务的地址   参数2:提供服务的实例
37         Endpoint.publish("http://192.168.1.101:5678/hello", new HelloService());
38         System.out.println("server ready...");
39     }
40 }

再分享一下我老师大神的人工智能教程吧。零基础!通俗易懂!风趣幽默!希望你也加入到我们人工智能的队伍中来!https://www.cnblogs.com/captainbed

原文地址:https://www.cnblogs.com/shaoye007/p/10159959.html

时间: 2024-10-12 16:31:14

Web Service进阶 四 WebService注解的相关文章

Web Service进阶(七)浅谈SOAP Webservice和RESTful Webservice

浅谈SOAP Webservice和RESTful Webservice REST是一种架构风格,其核心是面向资源,REST专门针对网络应用设计和开发方式,以降低开发的复杂性,提高系统的可伸缩性.REST提出设计概念和准则为: 1.网络上的所有事物都可以被抽象为资源(resource) 2.每一个资源都有唯一的资源标识(resource identifier),对资源的操作不会改变这些标识 3.所有的操作都是无状态的 REST简化开发,其架构遵循CRUD原则,该原则告诉我们对于资源(包括网络资源

Web Service进阶(六)SOAPBinding绑定方式异常 is not found. Have you run APT to generate them

当在类中填充相应方法时,提示如下错误: 出现以上错误的原因就是在注解中没有添加@SOAPBinding(style=SOAPBinding.Style.RPC)这句话.估计也与JDK的版本相关,这方面的知识有时间时再深究. 出现以上错误的原因是源代码中存在throws Exception @WebMethod public int add(String userStr) throws Exception{ return 1; } 解决办法就是将throws Exception删除,或者利用消息处

Web Service 实现之CXF

Web Service一座服务端与客户端进行通讯的桥梁,通过Web Service可以处理数据量大,需要java后台服务端进行操作的业务需求. 通过CXF(Web Service的框架)发布接口,CXF可以很好的与Spring进行集成 1.下载CXF版本的相关jar包,Spring的包也包括在其中.2.在web.xml中进行CXF的核心配置: <servlet> <servlet-name>CXFService</servlet-name> <servlet-cl

java6 原生webService注解应用

以前用过axis,xfire,不同地方用的不一样,又要重新学!这下只要搞定java原生的,就方便就不用再搞那么多东东了! 一个最简单的应用, package org.rui.web; import javax.jws.WebMethod; import javax.jws.WebParam; import javax.jws.WebService; import javax.jws.soap.SOAPBinding; /** * 1.用Jdk1.6.0_21以后的版本发布一个WebService

测试Remoting三种信道Http,Tcp,Ipc和Web Service的访问速度 (转)

Remoting和Web Service是.net中的重要技术,都可用来实现分布式系统开发,如果是不同的平台就只能选择Web Service,但如果是同一平台,就都可以选择了.到底选择那种,当然还有访问效率上的考虑,同时在Remoting中又有三中信道Http,Tcp,Ipc,它们又各有差别.HTTP方式的信道在跨越防火墙上有优势:TCP方式的信道常用在局域网内通信,速度比HTTP快很多:IPC信道用于同一台机器的进程间通信,通信不占用网络资源,速度又比TCP快很多.为了能够实际的比较一下这四者

SAP Web Service简介与配置方法

p.MsoNormal { margin: 0pt; margin-bottom: .0001pt; text-align: justify; font-family: Calibri; font-size: 10.5000pt } h1 { margin-top: 17.0000pt; margin-bottom: 16.5000pt; margin-left: 0.0000pt; text-indent: 21.0000pt; page-break-after: avoid; text-al

使用SoapUI调用Vsphere Web Service

项目中经常需要调用Webservice进行验证测试,下面就介绍下如何使用测试工具SoapUI调用Vsphere vcenter的 Web Service VSphere的Webservice地址默认为 https://vcenterip/sdk/vimService 1 首先要进行认证.使用Login方法,获取合法Cookie Request内容如下: <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/enve

Web Service(1.8)

“基于 XMLWeb Service 的 Java API”(JAX-WS)通过使用注释来指定与 Web Service 实现相关联的元数据以及简化 Web Service 的开发.注释描述如何将服务器端的服务实现作为 Web Service 来访问或者客户端的 Java 类如何访问 Web Service. JAX-WS 编程标准支持将具有用于定义服务端点应用程序的元数据的 Java 类作为 Web Service 来注释以及注释客户机可以如何访问 Web Service.JAX-WS 支持使

Web Service (四) 手动发布Web Service接口-CXF与Spring集成

当我们发布完Web Service接口之后有两种方式可以调用Web service服务,一种是通过动态客户端方式,另一种是引用服务端的接口,引用服务端接口的方式对于客户端同服务器端耦合比较大,而使用WSDL的方式客户端不知道服务端的存在就可以调用服务器的方法. 下面是项目的结构图: 1.Web Service发布项目 2.编写服务端接口类以及实现类,如下,同上一篇自动发布接口,多了一个注解@WebService package com.test.webservice; import javax.