非常多人在项目中使用Webservice,仅仅是知道怎样公布Webservice,怎样调用Webservice,但真要论其来龙去脉,还真不一定清楚。
一切一切还要从我们伟大的sun公司规范说起。
JAVA 中共同拥有三种WebService 规范,各自是JAXM&SAAJ、JAX-WS(JAX-RPC)、JAX-RS。
以下来分别简要的介绍一下这三个规范。针对JDK 1.6以下版本号,新的还没研究过
(1.)JAX-WS:
JAX-WS(Java API For XML-WebService),JDK1.6 自带的版本号为JAX-WS2.1,其底层支持为JAXB。早期的基于SOAP 的JAVA 的Web 服务规范JAX-RPC(Java API For XML-Remote Procedure Call)眼下已经被JAX-WS 规范代替,JAX-WS 是JAX-RPC
的演进版本号,但JAX-WS 并不全然向后兼容JAX-RPC,二者最大的差别就是RPC/encoded 样式的WSDL,JAX-WS 已经不提供这样的支持。JAX-RPC 的API 从JAVA EE5 開始已经移除,如果你使用J2EE1.4,其API
位于javax.xml.rpc.*包。JAX-WS(JSR 224)规范的API 位于javax.xml.ws.*包,当中大部分都是注解,提供API 操作Web 服务(通常在client使用的较多,因为client能够借助SDK 生成,因此这个包中的API
我们较少会直接使用)。WS-MetaData(JSR 181)是JAX-WS 的依赖规范,其API 位于javax.jws.*包,使用注解配置公开的Web 服务的相关信息和配置SOAP 消息的相关信息。
(2.)JAXM&SAAJ:
JAXM(JAVA API For XML Message)主要定义了包括了发送和接收消息所需的API,相当于Web 服务的server端,其API 位于javax.messaging.*包,它是JAVA EE 的可选包,因此你须要单独下载。
SAAJ(SOAP With Attachment API For Java,JSR 67)是与JAXM 搭配使用的API,为构建SOAP 包和解析SOAP 包提供了重要的支持,支持附件传输,它在server端、client都须要使用。这里还要提到的是SAAJ 规范,其API 位于javax.xml.soap.*包。
JAXM&SAAJ 与JAX-WS 都是基于SOAP 的Web 服务,相比之下JAXM&SAAJ 暴漏了SOAP很多其它的底层细节,编码比較麻烦,而JAX-WS 更加抽象,隐藏了很多其它的细节,更加面向对象,实现起来你基本上不须要关心SOAP 的不论什么细节。那么假设你想控制SOAP 消息的很多其它细节,能够使用JAXM&SAAJ。
(3.)JAX-RS:
JAX-RS 是JAVA 针对REST(Representation State Transfer)风格制定的一套Web 服务规范,因为推出的较晚,该规范(JSR)并未随JDK1.6 一起发行,你须要到JCP
(Java Community Process) 上单独下载JAX-RS 规范的接口,其API 位于javax.ws.rs.*包。
了解了这些规范,终究要落实到这些规范的实现上,然后用到我们的项目中。
我们做项目,一般不直接面向这些规范,而是使用实现这些规范的框架,如Axis,CXF。我个人比較喜欢CXF,由于我的开发主要是面向JAVA的,并且希望和Spring集成,甚至要和Mule ESB集成,这些方面CXF做的很好。AXIS2在多语言支持方面做得很好(这里的多语言是使用AXIS的语言)。
对AXIS没有太大发言权,由于用得少,这里还是说一点关于CXF的吧。(參考官方文档)
Apache CXF is an open source services framework.CXF helps you build and develop services
using frontend programming APIs, likeJAX-WS and JAX-RS. These services can speak a variety of protocols such asSOAP, XML/HTTP, RESTful HTTP, or CORBA and work over a variety of transportssuch as HTTP, JMS or JBI.
假设你想在maven中使用cxf,那么要在pom中声明maven依赖。
<dependency>
<groupId>org.apache.cxf</groupId>
<artifactId>cxf-distribution-manifest</artifactId>
<version>2.5.9</version>
<scope>provided</scope>
</dependency>
经測试,调用Webservice,仅仅须要引这一个就够了,它会间接引入一些其它jar
最后说下,Cxf_home 2.5.9版本号的lib下jar的作用:
The following jars are required for all CXFusage:
- cxf.jar
- commons-logging.jar
- geronimo-activation.jar (Or the Sunequivalent) [6]
- geronimo-annotation.jar (Or the Sunequivalent) [6]
- geronimo-javamail.jar (Or the Sunequivalent) [6]
(MAY be able to remove javamail if you don‘t use any MTOM/SAAJ typethings)
- geronimo-stax-api.jar (Or the Sunequivalent) [6]
- neethi.jar
- jaxb-api.jar [6]
- jaxb-impl.jar (this is a [6] for normalruntime, but is required for
tooling and the dynamicclients)
- XmlSchema.jar
- woodstox-core-asl.jar [6] or another StAX implementation
- stax2-api-3.0.1.jar [6] for woodstoxabove
- wsdl4j.jar
The following jars are required for XMLcatalog support:
- xml-resolver.jar
For Java2WSDL and WSDL2Java:
- The above jars
- jaxb-xjc.jar
- velocity.jar
- commons-collections.jar
- commons-lang.jar
- cxf-xjc*.jar (optional, these are xjcextensions for providing enhanced
JAXB code generation)
For JAX-WS support:
- geronimo-ws-metadata.jar [6]
- geronimo-jaxws_2.2_spec-1.0.jar (Or theSun equivalent) [6]
- saaj-api.jar [6]
- saaj-impl.jar [6]
- asm.jar (semi-optional, helps withperformance of wrapper types and is
required when adding JAXB annotations onto the SEI methods and
parameters.)
For XML Configuration support:
- aopalliance.jar
- spring-beans.jar
- spring-context.jar
- spring-core.jar
- spring.web.jar
- FastInfoset.jar
For standalone HTTP support:
- geronimo-servlet.jar
- jetty-*.jar
- sl4j.jar & sl4j-jdk14.jar (optional -but improves logging)
For Aegis support:
- jdom.jar (optional, if you want to mapxsd:anyType to JDOM)
For XmlBeans databinding support:
- xmlbeans.jar
For WS-Security support:
- bcprov-jdk15.jar
- xalan.jar
- serializer.jar
- wss4j.jar
- xmlsec.jar
- ehcache-core.jar
For SAML support in WS-Security
- joda-time.jar
- opensaml.jar
- openws.jar
- xmltooling.jar
For HTTP Binding support:
- jra.jar
- jettison.jar (Needed for JSON servicesonly)
For JAX-RS support:
- abdera* (optional: for AtomPub support, but also needed for the
Management log browser console)
- commons-codec.jar (Needed for Abdera)
- jaxen.jar (Needed for Abdera)
- axiom* (Needed for Abdera)
- jsr311-api.jar
- jettison.jar (Needed for JSON servicesonly)
- oauth*.jar (Needed for OAuth support)
For JMS transport
- geronimo-jms.jar (Or the Sun equivalent)
- spring-jms.jar
- spring-tx.jar
For CORBA support:
- antlr.jar
For JavaScript functionality:
- js.jar
For schema validation with the Aegis databinding.
-msv-core.jar (version 2010.1)
-xsdlib:jar (version 2010.1)
-isorelax.jar (version 20030108)
-relaxngDatatype.jar (version 20020414)
For the WS-Notification Service:
-cxf-services-wsn-api.jar
-cxf-services-wsn-core.jar
For the CXF Security Token Service:
- cxf-services-sts-core.jar
人家官方文档,写得那么好,我就不再嚼舌头了,大家去官网看吧。
了解了java Webservice这块的规范和实现,相信你再次在java中使用Webservice就不会那么糊涂了,该怎么做,出了问题怎么办,心中有数了吧。
你真的了解JAVA中与Webservice相关的规范和实现吗?