内容jax-ws使用教程

JAX-WSJAX-WS 运行 修改生成的Java代 生成并修改后的Java代 结 调用Web SOAP 客户端添加SOAP headers 附 JAX-WSJAX-WSPAGEPAGE10/概文档内JAX-WSJAX-WS2.0JavaAPIforXML-BasedWebservices(JAX-WS)2.0。JAX-2.0是对JAX-RPC1.0规范的扩展，是JAX-RPC1.1的后续版本，JAX-RPC2.0标准发布不久后便被重新命名为JAX-WS2.0JAX-WS2.0Java5Webservices的编程标准，它提供了新的编程模型和对以往的JAX-RPC方式的Webservices进行JAX-WS2.0JSR224)Sunwebservices协议栈，是一个完全基于标准的实现。在binding层，使用的是theJavaArchitectureforXMLBinding(JAXBJSR222)parsing层，theStreamingAPIforXML(StAX,JSR173)，同时它还完全支持schema规范。JAX-WS2.1支持XML/HTTP支持WS-缩略语JAX-WS参考资《利用WAS6.1WebService功能部件包开发JAX-WS2.0Webservices MetroUsersJavaAPIforXMLWebServices(JAX-WS)JAX-WSRI"JAX-WSRI2.1.1inJDK6JAX-WS2.0WSDL文件来创建WebService，自底向上是从Java类出发创建WebService。两种开发过程最终WSDLXSD开发步开发WebService SEIpackage*演示从JavaWebService*publicclassopublicStringsay(Stringname,intage)returnString.format("o,%s,youare%dyearsold",name,}}运行 o-wsdl-ssrc-dbin-rbin是生成的class生成的Javapackageimportjavax.xml.bind.annotation.XmlAccessType;importjavax.xml.bind.annotation.XmlElement;importjavax.xml.bind.annotation.XmlRoo importjavax.xml.bind.annotation.XmlType;@XmlType(name="say",namespace="",propOrder={"arg0","arg1"publicclassSay@XmlElement(name="arg0",namespace=privateString@XmlElement(name="arg1",namespace=privateint*@returnreturnspublicStringgetArg0()return}*@paramthevalueforthearg0publicvoidsetArg0(Stringarg0)this.arg0=}@returnreturnspublicintgetArg1()return}@paramthevalueforthearg1publicvoidsetArg1(intarg1)this.arg1=}}packageimportjavax.xml.bind.annotation.XmlAccessType;importjavax.xml.bind.annotation.XmlElement;importjavax.xml.bind.annotation.XmlRooement;importjavax.xml.bind.annotation.XmlType;@XmlRooement(name="sayResponse",namespace="")@XmlType(name="sayResponse",namespace="publicclassSayResponse@XmlElement(name="return",namespace=privateString*publicStringgetReturn()return}@paramthevalueforthe_returnthis._return=}}生成WSDLGeneratedbyJAX-WSRIat.RI'sversionisJAX-WSRI2.1.1inJDK6. <message<message<operation "<operation 结开发步wsimport生成Java运行使用上面生成的WSDL来反向生成Javawsimport-keep-dbin-ssrcwsdl/bin是生成的class生成的Javapackageimportjavax.jws.W importjavax.jws.WebResult;importjavax.jws.WebService;ThisclasswasgeneratedbytheJAX-WSRI.JAX-WSRI2.1.1inJDK6sourceversion:@WebService(name=" o",targetNamespace="")@XmlSeeAlso({ObjectFactory.class})publicinterfaceo*@param@param@returnreturns@RequestWrapper(localName="say",targetNamespace="",className="ws.server.fromjava.Say") "",className="ws.server.fromjava.SayResponse")publicString@Wram(name="arg0",targetNamespace="")Stringarg0,@Wram(name="arg1",targetNamespace="")intarg1);}packageimportjavax.xml.ws.WebEndpoint;importjavax.xml.ws.WebService ThisclasswasgeneratedbytheJAX-WSRI.JAX-WSRI2.1.1inJDK6sourceversion: (name=" oService",targetNamespace="",wsdlLocation="file:/D:/jax-ws-server-fromwsdl/wsdl/ public oServiceextendsServiceprivatefinalstatic staticURLurl=null;try{url=new{}} }publicoService() QName(""}*@return o return( o)super.getPort(newQName("", }*@paramon .Supportedfeaturesnotin@returnreturns o return( o)super.getPort(newQName("", o.class,features);}}packageimportjavax.xml.bind.annotation.XmlRegistry;importspace.QName;ThisobjectcontainsfactorymethodsforeachJavacontentinterfaceandAnObjectFactoryallowsyoutoprogramaticallyconstructnewinstancesofJavarepresentationforXMLcontent.TheJavarepresentationofXMLcanconsistofschemaderivedinterfacesandclassesrepresentingtheofschematypedefinitions,elementdeclarationsandmodelgroups.methodsforeachoftheseareprovidedinthisprivatefinalstaticQNameSayQNAME=QName("",privatefinalstaticQName_SayResponse_QNAME=QName("",CreateanewObjectFactorythatcanbeusedtocreatenewinstancesschemaderivedclassesforpackage:}Createaninstanceof{@linkSaypublicSaycreateSay()returnnew}Createaninstanceof{@linkSayResponsereturnnew}Createaninstanceof{@linkJAXBElement}{@code<}{@linkSay}{@code}Createaninstanceof{@linkJAXBElement}{@code<}{@linkSayResponse{@codeSayResponse.class,null,value);}}package-packagepackageimportjavax.xml.bind.annotation.XmlAccessType;importjavax.xml.bind.annotation.XmlType;*Javaclassforsaycomplex*ThefollowingschemafragmentspecifiestheexpectedcontentcontainedthisplexType @XmlType(name="say",propOrder={"arg0","arg1"publicclassSayprotectedStringprotectedintGetsthevalueofthearg0*@returnpossibleobjectis{@linkStringpublicStringgetArg0()return}Setsthevalueofthearg0@paramallowedobjectis{@linkStringthis.arg0=}Getsthevalueofthearg1publicintgetArg1()return}Setsthevalueofthearg1publicvoidsetArg1(intvalue)this.arg1=}}packageimportjavax.xml.bind.annotation.XmlAccessType;importjavax.xml.bind.annotation.XmlElement;importjavax.xml.bind.annotation.XmlType;*JavaclassforsayResponsecomplex*ThefollowingschemafragmentspecifiestheexpectedcontentcontainedthisplexType @XmlType(name="sayResponse",propOrder={"_return"publicclassSayResponseprotectedStringGetsthevalueofthereturn*@returnpossibleobjectis{@linkStringpublicStringgetReturn()return}Setsthevalueofthereturn@paramallowedobjectis{@linkStringthis._return=}}package@WebService(serviceName="oService",portName="oPort",endpointInterface="ws.server.fromjava.o",targetNamespace="")publicclassoSEIimplementsopublicStringsay(Stringarg0,intarg1)return}}结在应用程序中发布JDK6提供了发布WebService的简便方法：Endpoint.publish("",newo());如果是从WSDL生成的WebService，则为，Endpoint.publish("",new在Web应用程序中发布依赖发布步骤 <endpoints url- oService"<endpoints <endpoint url- oService"开发步修改生成的Java代码中的WSDL运行wsimport-keep-dbin-ssrcwsdl/bin是生成的class修改生成的Java代码编辑oService.java，@WebService(name="oService",targetNamespace="",wsdlLocation="file:/D:/jax-ws-/wsdl/oService.wsdl")publicclassoServiceextendsServiceprivatefinalstatic staticURLurl=null;try{url=new{}} } oService() QName(" } public oServiceextendsService super(wsdlLocation,newQName("", }生成并修改后的Java代码packageimportjavax.jws.W importjavax.jws.WebResult;importjavax.jws.WebService;ThisclasswasgeneratedbytheJAX-WSRI.JAX-WSRI2.1.1inJDK6sourceversion: o",targetNamespace= public o*@param@param@returnreturns@RequestWrapper(localName="say",targetNamespace="",className="ws.server.fromjava.Say") "",className="ws.server.fromjava.SayResponse")publicString ram(name="arg0",targetNamespace="")Stringarg0, ram(name="arg1",targetNamespace="")intarg1);}packageimportjavax.xml.ws.WebEndpoint;importjavax.xml.ws.WebService;ThisclasswasgeneratedbytheJAX-WSRI.JAX-WSRI2.1.1inJDK6sourceversion:publicclassoServiceextendsServicesuper(wsdlLocation,newQName("",}*@returnreturns o return( o)super.getPort(newQName("", }*@paramon .Supportedfeaturesnotin@returnreturns@WebEndpoint(name=" return( o)super.getPort(newQName("","oPort"),o.class,features);}}packageimportjavax.xml.bind.annotation.XmlRegistry;importspace.QName;ThisobjectcontainsfactorymethodsforeachJavacontentinterfaceandAnObjectFactoryallowsyoutoprogramaticallyconstructnewinstancesofJavarepresentationforXMLcontent.TheJavarepresentationofXMLcanconsistofschemaderivedinterfacesandclassesrepresentingtheofschematypedefinitions,elementdeclarationsandmodelgroups.methodsforeachoftheseareprovidedinthisprivatefinalstaticQNameSayQNAME=QName("",privatefinalstaticQName_SayResponse_QNAME=QName("",CreateanewObjectFactorythatcanbeusedtocreatenewinstancesschemaderivedclassesforpackage:}Createaninstanceof{@linkSaypublicSaycreateSay()returnnew}Createaninstanceof{@linkSayResponsereturnnew}Createaninstanceof{@linkJAXBElement}{@code<}{@linkSay}{@code}Createaninstanceof{@linkJAXBElement}{@code<}{@linkSayResponse{@codeSayResponse.class,null,value);}}package-packagepackageimportjavax.xml.bind.annotation.XmlAccessType;importjavax.xml.bind.annotation.XmlType;*Javaclassforsaycomplex*ThefollowingschemafragmentspecifiestheexpectedcontentcontainedthisplexType @XmlType(name="say",propOrder={"arg0","arg1"publicclassSayprotectedStringprotectedintGetsthevalueofthearg0*@returnpossibleobjectis{@linkStringpublicStringgetArg0()return}Setsthevalueofthearg0@paramallowedobjectis{@linkStringthis.arg0=}Getsthevalueofthearg1publicintgetArg1()return}Setsthevalueofthearg1publicvoidsetArg1(intvalue)this.arg1=}}packageimportjavax.xml.bind.annotation.XmlAccessType;importjavax.xml.bind.annotation.XmlElement;importjavax.xml.bind.annotation.XmlType;*JavaclassforsayResponsecomplex*ThefollowingschemafragmentspecifiestheexpectedcontentcontainedthisplexType @XmlType(name="sayResponse",propOrder={"_return"publicclassSayResponseprotectedStringGetsthevalueofthereturn*@returnpossibleobjectis{@linkStringpublicStringgetReturn()return}Setsthevalueofthereturn@paramallowedobjectis{@linkStringthis._return=}}结调用WebWebServiceURLurl=newURL("//oServiceservice=new//WebServiceSOAPWhentheWSDLyouarecompilingspecifiesthatsomepartsofamessageareboundtoSOAPheaders,wsimportgeneratestherightstuff(@Wram(header=true)),soyoucanpassheadersasargumentstothemethodinvocation.WhenstartingfromJava,youcanusethissameannotationtoindicatethatsomeparametersbesentasheaders.Thatsaid,therearemanyWSDLsouttherethatdonotspecifySOAPheadersexplicitly,yettheprotocolstillrequiressuchheaderstobesent,sotheJAX-WSRIoffersconvenientwaysforyoutosend/receiveadditionalheadersatruntime.非标准方法客户端添加SOAPTheportablewayofngthisisthatyoucreaateaSOAPHandlerandmesswithSAAJ,buttheRIprovidesabetterwayofngthis.Whenyoucreatea ordispatchobject,theyimplementBindingProviderinterface.WhenyouusetheJAX-WSRI,youcandowncasttoWSBindingProviderwhichdefinesafewmoremethodsprovidedonlybytheJAX-WSRI.ThisinterfaceletsyousetanarbitrarynumberofHeaderobject,eachrepresentingaSOAPheader.Youcanimplementitonyourownifyouwant,butmostlikelyyou'duseoneofthefactorymethodsdefinedonHeadersclasstocreateone.WebServiceURLurl=newURL("//oServiceservice=newoService(url);ooPort=service.getoPort();WSBindingProviderbp=(