2 XFire基础(2007年之后XFire发布1.2.6后停止开发,后续转为CXF项目)
3 CXF基础(基于XFire和Celtix项目整合而来,与Spring融合好)
4 AXIS1基础(Axis 1.4 Final 2006年后停止开发,转而AXIS2)
5 AXIS2基础(有AXIS1转换而来,有Java和C版)
1 WebSerice基础
1.WebService的主要标准和技术:
SOAP:简单对象访问协议。
UDDI:通用描述、发现和集成。
WSDL:Web服务定义语言。
ebXML:电子商务XML。
2.WebService基本操作模型:
3.SOAP简介:
SOAP:是一种基于XML的轻量级消息交换协议,利用SOAP可以在两个或多个对等实体之间进行信息交换。
(1).SOAP消息基本结构:
<xml version=”1.0” ?>
<soap:Envelopexmlns:soap=”http://www.w3.org/2001/12/soap-envelope”
soap:encodingStyle=”http://www.w3.org/2001/12/soap-encoding”> ——>SOAP信封
<soap:Header> ——>SOAP消息头
......
</soap:Header>
<soap:Body> ——>SOAP消息体,包含所有的调用和响应信息
……
<soap:Fault> ——>可选的,处理错误消息
</soap:Fault>
</soap:Body>
<soap:Attachment/>——>SOAP消息附件
</soap:Envelope>——>SOAP信封
(2).SOAP消息组成元素:
SOAP Envelope:SOAP信封,用于描述消息,标识SOAP内容和信封的处理信息。
SOAP Transport:定义HTTP和SMTP等底层传输协议的绑定。
SOAP Encoding:定义将应用程序特定数据类型的实例映射为XML元素的一组编码规则。
SOAP RPC:定义RPC请求和响应的表现形式,这些SOAP请求和响应被作为一种数据类型编码传递到SOAP消息正文中。
一个SOAP消息包括一个SOAP信封,带有0个到多个附件,SOAP信封包含消息头和消息主体。
(3).SOAP通信两种模式:
a.SOAP RPC:同步通信,请求/响应方式发送和接收消息
b.SOAP Messaging:文档驱动的同步和异步消息交换模式。
4.SOAP消息交换模式:
(1).单向消息:只请求,无需响应(客户端只向服务器端发出请求,服务器端无需响应)。
(2).请求/响应交换。
(3).单请求多响应模式。
(4).通知模式:服务器端向客户端发送请求,无需客户端响应,和单向消息类似。
(5).征求/响应模式:服务器端向客户端发送请求,客户端向服务器端返回响应。
5.WSDL文档结构:
<definitions> ——>WSDL文档的根元素,定义Webservice的名称和命名空间
<types> ——>WebService使用的数据类型
</types>
<message> ——>WebService使用的请求和响应消息,即输入输出参数
<part> ——>WebServicer的请求参数或者响应返回值
……
</part>
</message>
<portType> ——>WebService使用的操作,即调用的接口,接口中的每个方法映射为operation,方法参数和返回值用message表示
</portType>
<binding> ——>WebService使用的通信协议,用于指定特定元素<portType>定义的操作和消息的具体协议和数据格式
</binding>
<port> ——>指定WebService的绑定地址
……
</port>
<service> ——>聚集一组相关的<port>元素,指定对外发布的Web服务
</service>
</definitions>
6.UDDI是一种用于存储有关Web服务信息的目录,是一种由WSDL描述的Web服务界面的目录,经由SOAP进行通信。
三种级别的UDDI注册表:
(1).白页级别:只注册公司的基本信息。
(2).黄页级别:根据公司业务类别来划分信息类别。
(3).绿页级别:发布描述其Web服务的行为和所支持的功能。
7.UDDI编程API:
(1).查询API:
<find_business>、<find_relatedBusiness>、<find_service>、<find_binding>、<find_tModel>等。
若要获取更详细的信息,可以使用如下的API:
<get_businessDetail>、<get_businessDetailExt>、<get_serviceDetail>、<get_bindingDetail>、<get_tModelDetail>等。
(2).发布API:
<save_business>、<save_publisherAssertions>、<add_publisherAssertions>、<save_service>、<save_binding>、<save_tModel>等。
(3).删除API:
<delete_business>、<delete_publisherAssertions>、<delete_service>、<delete_binding>、<delete_tModel>等。
(4).身份鉴别API:
<get_authToken>、<discard_authToken>等。
8.UDDI的数据结构:
(1).<businessEntity>:表示公司的主要信息。
(2).<publisherAssertion>:用于建立两个<businessEntity>之间的关系,注意:除非两个<businessEntity>都进行了相同的声明,否则这一关系无法建立。
(3).<businessService>:表示公司的服务,这些服务可以是Web服务或任何其他类型的服务。
(4).<bindingTemplate>:由指向技术说明的指针和服务的接入URL构成,即Web服务的技术说明。
(5).<tModel>:提供特定规范或服务行为的描述,是UDDI中最基本的结构。
(6).<identifierBag>:<businessEntity>或<tModel>的标识信息。
(7).<categoryBag>:根据任何分类机制对<businessEntity>、<businessService>和<tModel>结构进行分类。
9.通过使用Web服务,可以将应用程序转换为网络应用程序,向全世界发布信息,提供某些功能的服务,基本的web服务平台:XML+HTTP。
Web服务两种类型的应用:
(1).可重复使用的应用程序组件。
(2).连接集成现有的软件系统。
10. Web服务的工作流程:
11.jax-ws是java开发webservice的标准API:
(1).javax.jws中常用的注解:
a.@Webservice:将一个类声明为webservice。
b.@Webparam:指定webservice的参数。
c.@WebResul:指定webservice的返回值。
d.@WebMethod:指定某个方法为webservice对外提供的方法。
(2).javax.jws.soap中常用的注解:
@SOAPBinding:将某个接口绑定为webservice。
12.WebService的调用过程:
由图可以看出,webservice交互过程中需要XML和程序对象进行相互转换,Java中提供了一种新的API——JAXB专门处理java对象和XML数据的相互转换。
13.JAXB(java API for XML Bing):
JAXB是一种java对象和xml数据格式之间相互转换的API。
(1).JAXB的作用:
Java Object ——> JAXB ——> XML
(2).JAXB的工作原理:
(3).JAXB的常用注解:
a.@XmlRootElement:将Java类映射为XML的根节点。
b.@XmlElement:将属性或方法映射为XML的节点。
c.@XmlAccessorType:指明映射那些方法或者字段。
d.@XmlTransient:指明那些方法或者字段不需要和xml进行映射。
e.@XmlJavaTypeAdapter:Xml和Java对象的转换。
2 XFire基础(基于XFire和Celtix项目整合而来,与Spring融合好)
1.XFire是codehaus推出的下一代的java SOAP框架,通过提供的简单的API和支持标准协议,可以方面地开发webservice程序。XFire最大的特点就是支持将POJO通过非常简单的方式发布为WebService,同时还拥有很高的性能。
2.XFire将 POJO 发布成 Web 服务的基本步骤:
(1).创建 Web 服务接口,声明该 Web 服务对外暴露的接口;
(2).创建 Web 服务实现类,为 Web 服务接口提供实现;
(3).修改 XFire 框架的服务发布文件 ---- services.xml,将 POJO 发布成 Web 服务。
3.简单的XFire开发过程:
(1).在web.xml中加入如下配置:
- <servlet>
- <servlet-name>XFireServlet</servlet-name>
- <servlet-class>org.codehaus.xfire.transport.http.XFireConfigurableServlet</servlet-class>
- </servlet>
- <servlet-mapping>
- <servlet-name>XFireServlet</servlet-name>
- <url-pattern>/services/*</url-pattern>
- </servlet-mapping>
(2).创建services.xml文件,加入如下配置:
(1).service:service 标签和它所包含的 xml 内容为发布成 Web 服务的 POJO 提供完整的描述。
(2).name:Web 服务被发布时所采用的唯一名称。
(3).namespace:Web 服务发布时所使用的命名空间。
(4).serviceClass:Web 服务接口类的全名,包括包名和类名。
(5).impleMetationClass:Web 服务实现类的全名,包括包名和类名。
5.XFire传递复杂对象:
分两种情况:
(1).客户端创建一个实现Remote接口的类,方法名、参数类型和返回值类型均与WebService服务相同,则传递自定义的复杂对象参数和返回值时不用特殊配置和处理。
注意:只适用于在自定义对象中传递List、Map、数组等的复杂对象。
(2).服务器端实现一个接口(非Remote接口),客户端通过该接口来调用WebService对象,则必须在服务器端接口同一目录下建立一个名为“服务端接口名.aegis.xml”文件,添加如下配置:
6.XFire的Handler:
一个Handler可以看成是XFire的一个加工套件,XFire通过它们定义SOAP发送和接收之前的各种加工处理逻辑。如Handler可以对SOAP体的内容进行加工处理,或者SOAP头进行处理。
(1).编写自定义Handler:
继承AbstractHandler类。
(2).服务器配置Handler:
在services.xml文件中加入如下配置:
在<scope>元素标签之下加入:
(1).将文件用DataHandler包装后传递到服务器端。
(2).服务器端根据得到的DataHandler对象.getInputStream()得到文件输入流,将其写到服务器端。
(3).对SOAP消息进行MTOM编码。
(1).在web.xml中指定XFire和Spring的配置文件如下:
9.XFire与Spring的集成(服务器端不使用XFire导出器方式):
和服务器端使用XFire导出器类似,不同之处在于配置发布的服务:
1.CXF是基于JAX-WS实现的,JAX-WS规范(JAVA API XML-WEB SERVICE)是一组XML web services的JAVA API,它使用户无需编写复杂的SOAP ENV,WSDL。在 JAX-WS中,一个远程调用可以转换为一个基于XML的协议例如SOAP。在使用JAX-WS过程中,开发者不需要编写任何生成和处理SOAP消息的代码。JAX-WS的运行时实现会将这些API的调用转换成为对于SOAP消息。
在服务器端,用户只需要通过Java语言定义远程调用所需要实现的接口SEI (service endpoint interface),并提供相关的实现,通过调用JAX-WS的服务发布接口就可以将其发布为WebService接口。
在客户端,用户可以通过JAX-WS的API创建一个代理(用本地对象来替代远程的服务)来实现对于远程服务器端的调用。
2.使用CXF开发Webservice工程步骤:
1).为CXF设置编译和开发环境
在http://cxf.apache.org/download.html下载相应的CXF包,/lib目录下的jar 文件引入工程
2).创建基于XCF的Webservice服务端工程。
3).编写Webservice的客户端程序,调用服务端服务。
3.CXF中的Factory:
CXF不但可以使用JAX-WS开发web服务,也可以将POJO发布为web服务,对于这两种不同的方式,对应的factory如下:
服务端 客户端
JAX-WS JaxWsServerfactorybean JaxWsProxyfactorybean
POJO Servicefactorybean ClientProxyfactorybean
4.CXF使用JAX-WS开发服务端:
(1).定义服务接口:
在接口上添加Webservice注解:@WebService。如:
- package service;
- import javax.jws.WebService;
- @WebService
- public interface OrderProcess {
- String processOrder(Order order);
- }
(2).实现服务接口:
在实现类上也添加Webservice注解:@WebService(endpointInterface = 服务接口全路径, serviceName= 对外发布的服务名)。如:
和JAX-WS方式除了代理工厂不同以外,其他均相同:
8.CXF与Spring的集成:
(1).对工程引入spring支持。
(2).在web.xml文件中添加spring和CXF相应的配置如下:
- <web-app>
- <context-param>
- <param-name>contextConfigLocation</param-name>
- <param-value>spring配置文件路径</param-value>
- </context-param>
- <listener>
- <listener-class>
- org.springframework.web.context.ContextLoaderListener
- </listener-class>
- </listener>
- <servlet>
- <servlet-name>CXFServlet</servlet-name>
- <display-name>CXF Servlet</display-name>
- <servlet-class>
- org.apache.cxf.transport.servlet.CXFServlet
- </servlet-class>
- <load-on-startup>1</load-on-startup>
- </servlet>
- <servlet-mapping>
- <servlet-name>CXFServlet</servlet-name>
- <url-pattern>/service/*</url-pattern>
- </servlet-mapping>
- </web-app>