ESB-WEB service 企业服务总线-WEB服务V10用户手册

1、ezESB 企业服务总线用户手册 - 1 -ezESB 企业服务总线用户手册 - 2 -目目 录录1 引言.31.1 关于本用户手册.31.2 背景.31.3 系统简介.32、系统运行环境.52.1 硬件设备.52.2 软件需求.52.3 运行环境.53、使用说明.73.1 配置SERVICES.XML.73.2 配置 SERVLET.83.3 发布服务的示例.93.4 客户端访问服务的示例.123.4.1 根据服务的 wsdl 文件生成客户端.123.4.2 编写测试类.13ezESB 企业服务总线用户手册 - 3 -1 引言引言1.11.1 关于本用户手册关于本用户手册本手册是ezESB-

2、企业服务总线产品手册系列之ezESB-WebService V1.0 用户手册分册。手册介绍了ezESB-WebService V1.0 的相关开发背景，并针对其主要功能及使用进行了全面系统的讲解，是用户使用、维护ezESB-WebService V1.0 的操作指南。1.21.2 背景背景SOA（Service-Oriented Architecture，面向服务的架构）是一种 IT 基础架构方法模型(From Bea)，是一种设计模式(From IBM)，它可以把企业应用所包括的不同功能组织成基于标准的服务，这些服务可以迅速组合、配置及重用，以适应不断变化的业务环境。当前，部署 SOA 越

3、来越成为一种发展的趋势， “SOA 将改变整个 IT 产业格局”(引自IBM 软件集团总经理 Steve Mills)已不再是一句空话。今天我们看到 SOA 的大潮正引发新一轮的抢滩战：IBM、Microsoft、Bea、HP、Oracle、SAP 等众多厂商纷纷投身于 SOA 的战场中来。据 Forrester Research 估计，截止 2005 年年底，在美国 77%的大型企业、51%的中型企业以及 46%的小型企业部署了 SOA。此外，在部署或者计划部署 SOA 的大型企业当中，69%正把 SOA 用于内部集成，50%正把 SOA 用于与业务合作伙伴和客户之间的外部集成，而企业服务总

4、线是最受欢迎的实施 SOA 集成方式，大约三分之一的美国基础架构决策者计划在今后 12 个月里扩大 ESB 的部署范围。在中国，虽然 SOA 市场仍处于萌芽期，但据计世资讯调查发现，一些企业用户已表示出对 SOA 的关注，其中 15.9%的流通行业关注 SOA，而在制造行业也达到了 8.6%，相信2006-2007 年的中国软件业必是 SOA“大行其道”的时代。1.31.3 系统简介系统简介ezESB-WebService V1.0 是一个 java SOAP framework.。其核心是一个轻量级的，基ezESB 企业服务总线用户手册 - 4 -于 STAX 的，处理与 SOAP 消息交互

5、的消息处理模型。它支持多种绑定机制、容器和传输协议，支持 POJO 和 schema 开发。通过它所提供的 API 以及它所支持标准协议，可以方便地开发面向服务的程序。ezESB-WebService V1.0 的主要特征如下：支持重要的 Web Service 标准SOAP，WSDL，WS-I Basic Profile，WS-Addressing，WS-Security 等；高性能的 SOAP 堆栈；可插拔的绑定 POJO；（XMLBeans,JAXB1.1,JAXB2.0 和 Castor 支持） ；根据 JAVA5，通过 JSR181 API 配置服务；支持多种传输协议HTTP,JMS

6、,XMPP,内嵌 JAVA 于虚拟机等；可嵌入的 API；Spring，Pico，Plexus，和 Loom 的支持；JBI 的支持；客户端和服务端代理的支持；ezESB 企业服务总线用户手册 - 5 -2、系统运行环境、系统运行环境2.12.1 硬件设备硬件设备推荐使用主流的 PC 机或服务器。最低配置要求如下：CPU：Intel Pentium 1.5Ghz 内存：512M硬盘：40G2.2 软件需求软件需求操作系统：Windows 2000 Server +SP4， Windows XP SP2，Red Hat Linux 应用服务器：Tomcat5.X 及以上网络环境：10/100M

7、以太网2.3 运行环境运行环境1.Java Developer Kit (JDK) 1.5 或者更高版本；2.JAVA_HOME 环境变量必须设置为 JDK 的安装目录；3.所依赖的 Jar 文件：commons-codec-1.3.jarcommons-httpclient-3.0.jarcommons-logging-1.0.4.jargeronimo-jms_1.1_spec-1.0.1.jarjaxen-1.1-beta-9.jarjaxb-api-2.0.jarjdom-1.0.jarlog4j-1.2.14.jarstax-api-1.0.1.jarwsdl4j-1.6.1.jar

8、ezESB 企业服务总线用户手册 - 6 -wstx-asl-3.2.0.jarxbean-spring-2.8.jarxfire-jsr181-api-1.0-M1.jarXmlSchema-1.1.jarXalan-2.7.0.jarezESB 企业服务总线用户手册 - 7 -3、使用说明、使用说明ezESB-WebService V1.0 目前支持在 windows，这里将介绍在 windows 平台上的安装过程。将ezService.jar 和其他要使用到的辅助 jar 包加入到工程的 lib 文件目录下即可。将ezService.jar 加载到项目的 classpath 中。以下做详

9、细的介绍：3.13.1 配置配置 services.xmlweb 服务的配置都是在 services.xml 文件中进行的。Services.xml 的路径为:工程名称resourcesMETA-INFezservice Services.xml 的文件格式及格式说明以及配置步骤可以参考ezESB-WebService V1.0 二次开发使用手册的第 4 章“Services.xml 的使用和配置” 。 services.xml 示例：HelloServicecom.thtf.ezone.ezesb.webservice.example.hello.Hellocom.thtf.ezone.ez

10、esb.webservice.example.hello.impl.HelloImplezESB 企业服务总线用户手册 - 8 -该配置文件声明了一个名为 HelloService 的服务，该服务的类是一个接口，名为：com.thtf.ezone.ezesb.webservice.example.hello.Hello其实现类为：com.thtf.ezone.ezesb.webservice.example.hello.impl.HelloImpl注意：在该配置文件中根据 services.xml 的文件格式可以声明多个服务。3.23.2 配置配置 Servlet在完成 services.xm

11、l 文件配置后，如果不是通过 Spring 来配置 ezESB-WebService 那么可以使用 ezESB-WebService 的 servlet 来暴露服务。通过配置 web.xml 文件实现。web.xml 示例：ezService Hello ExampleezServiceServletcom.thtf.ezone.ezesb.webservice.transport.http.EzServiceConfigurableServletezServiceServlet/servlet/ezServiceServlet/*ezESB 企业服务总线用户手册 - 9 -ezService

12、Servlet/services/*通过 http:/host:port/CONTEXT/services/NAME 就可以访问服务。 例如:http:/localhost:8080/ezService-example-hello/services/HelloService。通过 http:/localhost:8080/ezService-example-hello/services/HelloService?wsdl，就可以访问该服务的 WSDL 文件。3.33.3 发布服务的示例发布服务的示例发布 web 服务，主要分 2 步：该示例主要是通过一个简单的 Hello 服务来演示。具体代码

13、可以参看 ezService-example-hello 中的代码。1创建服务。其接口：package com.thtf.ezone.ezesb.webservice.example.hello;public interface Hello public String hello(String name);其实现类：package com.thtf.ezone.ezesb.webservice.example.hello.impl;import com.thtf.ezone.ezesb.webservice.example.hello.Hello;public class HelloImpl

14、implements Hello public String hello(String name) if (null = name | .equals(name) name = world;ezESB 企业服务总线用户手册 - 10 -return hello, + name + , this is hello web service!;2发布 web 服务针对该示例，按照以上说的步骤配置 services.xml 和 web.xml，运行 tomcat5.5 应用服务器后，可以通过 http:/localhost:8080/ezService-example-hello/services/H

15、elloService?wsdl 访问该 web 服务的 wsdl 文件。如下： - - - - - - - - ezESB 企业服务总线用户手册 - 11 - - - - - - - - - ezESB 企业服务总线用户手册 - 12 - - - 3.43.4 客户端访问服务的示例客户端访问服务的示例3.4.1 根据服务的根据服务的 wsdl 文件生成客户端文件生成客户端采用 ant 任务实现，前提条件是 ezService-example-hello 应用已在 tomcat5.0 应用服务器中运行。具体代码可以参考 ezService-example-hello-client 中的代码。

16、description其生成的代码对应于项目 ezService-example-hello-client 中的 src 包中的代码。ezESB 企业服务总线用户手册 - 13 -文件结构如图 3.4-1 所示：图 3.4-1 文件结构图3.4.2 编写测试类编写测试类测试 hello 服务的 Hello()方法的示例代码：package com.thtf.ezone.ezesb.webservice.example.hello;import junit.framework.TestCase;public class HelloTest extends TestCase HelloServic

17、eClient client = null;HelloServicePortType portType = null;ezESB 企业服务总线用户手册 - 14 -protected void setUp() throws Exception super.setUp();this.client = new HelloServiceClient();this.portType = this.client.getHelloServiceHttpPort(http:/localhost:8080/ezService-example-hello/services/HelloService);protected void tearDown() throws Exception super.tearDown(