WebService介绍(WebService基础知识、XFire、CXF（基于XFire和Ce

发布时间：2020-12-16 21:55:37 所属栏目：安全来源：网络整理

导读：1 WebSerice基础 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

1 WebSerice基础
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消息基本结构：

<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中加入如下配置：

[xhtml]? view plain copy

<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文件，加入如下配置：

4.XFire配置文件元素：

(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”文件，添加如下配置：

注意：适用于Map等传递自定义对象这种情况。

6.XFire的Handler：

一个Handler可以看成是XFire的一个加工套件，XFire通过它们定义SOAP发送和接收之前的各种加工处理逻辑。如Handler可以对SOAP体的内容进行加工处理，或者SOAP头进行处理。

(1).编写自定义Handler：

继承AbstractHandler类。

(2).服务器配置Handler：

在services.xml文件中加入如下配置：

在<scope>元素标签之下加入：

(3).客户端Handler的配置：

[java]? copy

Client?client?=?Client.getInstance(客户端得到的服务对象);??
client.addInHandler(new?自定义Handler());??
client.addOutHandler(new?自定义Handler());??

7.文件上传处理：

(1).将文件用DataHandler包装后传递到服务器端。

(2).服务器端根据得到的DataHandler对象.getInputStream()得到文件输入流，将其写到服务器端。

(3).对SOAP消息进行MTOM编码。

(4).对输入输出流指定UTF-8字符集：

(5).在对应的services.xml文件中，上传文件的Service必须添加如下的Property：

8.XFire与Spring的集成(服务器端使用XFire导出器方式)：

(1).在web.xml中指定XFire和Spring的配置文件如下：

(2).在Spring配置文件中导入XFire配置文件，配置要发布的服务：

(3).在Spring中配置XFire导出器：

(4).客户端Spring配置：

在客户端就可以像使用普通java对象一样使用被spring管理起来的web服务了。

9.XFire与Spring的集成(服务器端不使用XFire导出器方式)：

和服务器端使用XFire导出器类似，不同之处在于配置发布的服务：

3 CXF基础（基于XFire和Celtix项目基础开发）

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。如：

[java]? view plain copy

package?service;??
import?javax.jws.WebService;??
@WebService??
public?interface?OrderProcess?{??
????String?processOrder(Order?order);??
}??

(2).实现服务接口：

在实现类上也添加Webservice注解：@WebService(endpointInterface = 服务接口全路径,???serviceName= 对外发布的服务名)。如：

(3).对外发布服务：

5.CXF使用JAX-WS开发客户端：

7.CXF使用POJO开发客户端：

和JAX-WS方式除了代理工厂不同以外，其他均相同：

通过对象调用web服务的方法

8.CXF与Spring的集成：

(1).对工程引入spring支持。

(2).在web.xml文件中添加spring和CXF相应的配置如下：

[xhtml]? copy

<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>??

(3).在spring配置文件中导入CXF的相关配置如下：

(4).在spring配置文件中配置要发布的web服务如下：