Soap消息内容被封装为<soap:Envelope...SOAP信封,在信封之间的内容就是SOAP消息正文,这个元素还有一个子元素<soap:Header...,如果你的某些注解的header=true,那么它将被放到<soap:Header...中传输,而不是SOAP消息正文。
package com.nantian.service; import javax.jws.WebParam; import javax.jws.WebService; @WebService public interface HelloService { Customer selectMaxAgeStudent(@WebParam(name="c1",header=true) Customer c1, Customer c2); Customer selectMaxLongNameStudent(Customer c1, Customer c2); }
输入输出参数与@OneWay注解:
在SOAP中方法的参数是有流向的,@WebParam的mode属性由javax.jws.WebParam.Mode枚举指定,表示参数的流向,默认是IN,也就是输入参数,还可以是OUT、INOUT类型。
如果是OUT、INOUT类型的参数类型,这样的方法参数将会被当做返回值在web服务调用完成后返回给你。客户端生成代码时会被转变为java.xml.ws.Holder<T>类型,注意不到导错包。
@javax.jws.OneWay注解是一个标识性注解,它表示公开的web服务的方法没有任何返回值,不允许有OUT类型的参数,不允许抛出非运行时异常,如果条件不符JAX-WS规范要求应该报告错误,但是CXF的策略是如果方法存在返回值,生成客户端时将被改为void;如果方法参数含有OUT类型,生成客户端时将被忽略;如果方法参数含有INOUT类型,生成客户端时将只作为IN类型参数被保留。
package com.nantian.service; import javax.jws.WebParam; import javax.jws.WebParam.Mode; import javax.jws.WebService; import javax.xml.ws.Holder; @WebService public interface HelloService { boolean selectMaxAgeStudent(@WebParam(name="c1") Customer c1, @WebParam(name="c2") Customer c2, @WebParam(name="c3",mode=Mode.OUT) Holder<Customer> c3); Customer selectMaxLongNameStudent(Customer c1, Customer c2); }
Web服务上下文:
javax.xml.ws.WebServiceContext接口用于在Web服务实现类中访问与服务请求有关的信息上下文和安全信息,只需要使用javax.annotation.Resource这个标准的注解标注即可使用这个接口。
这个接口的getMessageContext()方法返回javax.xml.ws.handlerMessageContext接口。
public void selectMaxAgeStudent(Customer c1, Customer c2, Holder<Customer> c3) { MessageContext mcontext = context.getMessageContext(); Set<String> set = mcontext.keySet(); for (String key : set) { System.out.println("*****************" + key + "\t" + mcontext.get(key)); try { System.out.println("+++++++++++++++++" + key + "\t" + mcontext.getScope(key)); } catch (Exception e) { System.out.println("+++++++++++++++++"+key+"不存在"); } } }
上面的方法会打印出消息上下文的所有属性集及其范围,因为getScope(String name)如果没有name存在会抛出异常。范围的可选值是javax.xml.ws.handler.MessageContextScope中的APPLICATION、HANDLER枚举。
使用客户端视图:
服务端发布Web服务可以使用javax.xml.ws.Endpoint接口发布Web服务,这样在开发JAX-WS的服务端时完全避开使用底层实现的API,统一使用标准的JAX-WS的接口、注解等。也可以使用标准的JAX-WS的API完成客户端调用。
package com.nantian.client; import java.net.MalformedURLException; import java.net.URL; import javax.xml.namespace.QName; import com.nantian.service.HelloServiceImpl; import com.nantian.service.HelloServiceImplService; public class SOAPClientApi { public static void main(String[] args) throws MalformedURLException { QName qName = new QName("http://service.nantian.com/", "HelloServiceImplService"); HelloServiceImplService helloServiceImplService = new HelloServiceImplService( new URL("http://10.11.13.83:8080/JAXWSdEMO/helloService?wsdl"), qName); HelloServiceImpl helloServiceImpl=helloServiceImplService.getPort(HelloServiceImpl.class); } }
首先使用Web服务的WSDL中的targetNamespace和<wsdl:service...中的name属性构建了javax.xml.namespace.QName接口,然后调用生成的客户端代码中的客户端视图类(这个类继承javax.xml.ws.Service)HelloServiceImplService的构造方法传入WSDL的URL和QName实例,在获得客户端视图实例之后调用T getPort(T t)这个泛型方法找到要使用的端点服务接口。
相关推荐
webService学习笔记
WebService学习笔记 比较经典
尚硅谷Webservice学习笔记,详情请参看文档,仅供个人学习
webservice学习笔记doc文档,喜欢或想要了解webservice的朋友可以下载学习一下。
Webservice学习笔记
OracleEBS-WebService开发笔记.pdf
122158-Webservice学习笔记.doc
122158_Webservice学习笔记.doc
分布式通信框架-webservice分析笔记1
SSH CXF webservice 开发笔记demo(包含步骤文档及所需war包)
SAP与其他外围系统交互使用的一种通讯方式,具体讲述了WSDL文件的发布与在SAP中的部署,以及接口的测试和配置方式
webservice学习笔记,对掌握和理解webservice有很好的帮助,特此分享
WebService笔记
webservice学习笔记1DTD是为了校验XML 2语法 3 schema
包括服务端配置工程和客户端配置工程。 是我这个周末的学习总结.. 已测试可运行。
什么是webservice? 从案例(便民查询网站)分析如何实现? 使用socket实现。 使用jaxws开发webservice。 Webservice三要素 Wsdl(webservice使用说明书)重点掌握 Soap(jaxws开发webservice的传输协议)重点掌握...
什么是 Web 服务? 2, 什么是SOAP?3, 什么是Axis? 4, Axis相比Soap v2的优点5, 什么是WSDL? 6, 什么是WSDD? 7, 什么是UDDI? 8, AXIS的几种服务类型二, 开发,部署Web服务: 三, 在IDE下开发Web服务:
webservice源码和笔记