Apache Web Services （Axis2 Version 1.4.1） SOA Demo.doc

Apache Web Services (Axis2 Version 1.4.1) SOA Demo

一． 目的 2
二． 准备 2
1. 安装JDK(我用的是1.5) 2
2. 安装Eclipse (略) 2
3. 安装Tomcat (略) 2
4. 下载Axis2 Eclipse Plug-in 2
5. 下载 Axis2 (Version 1.4.1) 2
三． 搭建开发环境 2
1. 安装Axis2 Eclipse Plug-in 2
四． 部署SOAP Server 3
五． 开发服务器端Web Service测试代码(供应商) 4
1. 建立一个Java Project :osmsoa 4
2. 新建一个服务类 6
六． 发布Web Service (供应商) 7
1. 打包 Web Service 7
2. 发布Web Service 14
3. 测试发布 16
七． 开发客户端调用Web Service测试代码(使用商) 19
1. 建立一个Java Project :osmsoalient 19
2. 获取Web Service的WSDL 26
3. 生成客户端代码 28
4. 编写测试 36
5. 测试Web Service 38
八． 帮助 38

一． 目的
使用 Apache Web Services (Axis2)做一个简单的例子。
二． 准备
1. 安装JDK(我用的是1.5)
2. 安装Eclipse (略)
3. 安装Tomcat (略)
4. 下载Axis2 Eclipse Plug-in
Code Generator Wizard - Eclipse Plug-in
Service Archive Wizard - Eclipse Plug-in

注意：发现下载的plug-in安装到eclipse后，使用axis2-eclipse-codegen-wizard时，最后老是报InvocationTargetException异常。经过网上查找，最后才解决问题。已经把修正的版本上传。可以从这里下载

5. 下载 Axis2 (Version 1.4.1)
Standard Binary Distribution
Source Distribution
WAR (Web Archive) Distribution
Documents Distribution

三． 搭建开发环境
1. 安装Axis2 Eclipse Plug-in
将下载( axis2-eclipse-codegen-wizard-1.4.1.zip和axis2-eclipse-service-archiver-wizard-1.4.1.zip 解压到 Eclipse\ plugins目录下

启动eclipse，File – New – Other 看到 Axis2 Wizards，说明安装成功

四． 部署SOAP Server
把下载的axis2-1.4.1-war.zip解压得到axis2.war，把axis2.war部署到tomcat下(复制到tomcat\webapps)。
启动tomcat，访问http://localhost:8080/axis2/，出现如下页面，说明成功

五． 开发服务器端Web Service测试代码(供应商)
1. 建立一个Java Project :osmsoa
启动Eclipse，File – New – Java Project

2. 新建一个服务类
HelloWorld

输入如下代码

六． 发布Web Service (供应商)
1. 打包 Web Service
使用Service Archive Wizard - Eclipse Plug-in ：
File – New – Other…

指定class的目录(注意不是src的目录)

(可略过这步，直接复制jar文件到services/lib下)

点击 Finish

在E:\eclipse\osmsoa目录下，生成了helloworld_service.aar
2. 发布Web Service
访问http://localhost:8080/axis2/，点击 Administration

Username : admin
Password: axis2

点击 Upload Service

选择E:\eclipse\osmsoa\ helloworld_service.aar，点击 Upload

3. 测试发布
访问http://localhost:8080/axis2/，点击 Services

You can also checkout the WSDL at:
http://localhost:8080/axis2/services/HelloWorld?wsdl

And the schema at:
http://localhost:8080/axis2/services/HelloWorld?xsd

输入如下地址http://localhost:8080/axis2/services/HelloWorld/getName
出现如下页面，说明发布成功

加入参数id，输入地址
http://localhost:8080/axis2/services/HelloWorld/getName?id=John Mark
出现如下页面，说明成功

Done

七． 开发客户端调用Web Service测试代码(使用商)
1. 建立一个Java Project :osmsoalient
File – New – Java Project

点击 Libraries

点击 Add Library…

选择User Library ，点击 Next

点击 User Libraries…

点击 New…

点出 OK

点击 Add JARs…
解压axis2.war如E:\jbproject\Axis\1.4.1\axis2-1.4.1-war\axis2选择 E:\jbproject\Axis\1.4.1\axis2-1.4.1-war\axis2\WEB-INF\lib下面的所有jar

点击 OK

点击 Finish

点击Finish

2. 获取Web Service的WSDL
访问http://localhost:8080/axis2/，点击 Services

点击 HelloWorld

点击 File – Save As ，保存到E:\eclipse\osmsoa\ HelloWorld.wsdl

3. 生成客户端代码
Eclipse中，File - New – Other

选择 Browse and select a project on current eclipse workspace，点击 Browse…

点击OK

点击Finish

在Eclipse中，选择osmsoaclient，右健，Refresh

已经自动生成客户端代码

Done

(
这里用到的是axis2的WSDL2Java，可以在命令行里运行
%AXIS2_HOME%\bin\WSDL2Java -uri HelloWorld.wsdl -p demo -o .
)

4. 编写测试
Eclipse 中 File – New - Class

输入以下代码

5. 测试Web Service
在Test.java右键 Run As… - 2 Java Application
运行结果如下：

(log4j配置文件没有添加到project中，所以出现红色的提示)

Done

八． 帮助
访问以下网站获取更多信息
http://ws.apache.org/axis2/
Implementation of WS-Addressing
WS-Security module for Axis2

附录资料：
Ehcache缓存配置

简介
Cache的配置很灵活，官方提供的Cache配置方式有好几种。你可以通过声明配置、在xml中配置、在程序里配置或者调用构造方法时传入不同的参数。
你可以将Cache的配置从代码中剥离出来，也可以在使用运行时配置，所谓的运行时配置无非也就是在代码中配置。以下是运行时配置的好处：
·   在同一个地方配置所有的Cache，这样很容易管理Cache的内存和磁盘消耗。
·   发布时可更改Cache配置。
·   可再安装阶段就检查出配置错误信息，而避免了运行时错误。
本文将会对ehcache.xml配置文件进行详细的阐述。在配置的时可以拷贝一个现有的ehcache.xml，如果没有请点击这里去下载。
ehcache-failsafe.xml

如果你调用了CacheManager默认构造方法去创建CacheManager的实例，此方法会到classpath中找ehcache.xml文件，否则它会到类路径下找ehcache-failsafe.xml文件。而ehcache-failsafe.xml被包含在jar包中，所有它肯定能找的到。

ehcache-failsafe.xml提供了一个非常简单的默认配置，这样可以使用户在没有创建ehcache.xml的情况下使用Ehcache。

不过这样做Ehcache会提醒用户创建一个正确的Ehcache配置。

ehcache.xml片段：
<ehcache>
    <diskStore path="java.io.tmpdir"/>
    <defaultCache
            maxElementsInMemory="10000"
            eternal="false"
            timeToIdleSeconds="120"
            timeToLiveSeconds="120"
            overflowToDisk="true"
            maxElementsOnDisk="10000000"
            diskPersistent="false"
            diskExpiryThreadIntervalSeconds="120"
            memoryStoreEvictionPolicy="LRU"
            />
</ehcache>
ehcache.xml和其他配置文件
在Ehcache-1.6之前的版本，只支持ASCII编码的ehcache.xml配置文件。在Ehcach-1.6之后版本中，支持UTF8编码的ehcache.xml配置文件。因为向后兼容，所有采用ASCII编码的配置文件完全没有必要转换为UTF8。
一个CacheManager必须要有一个XML配置。由于磁盘路径或是监听端口，多个CacheManager使用同一个配置文件时会出现错误。
下面是ehcache.xml具体实例以及配置指南
<ehcache xmlns:xsi=http://www.w3.org/2001/XMLSchema-instance
·   CacheManager配置
DmulticastGroupPort=4446，这样可以配置监听端口。
·   DiskStore配置
如果你使用的DiskStore（磁盘缓存），你必须要配置DiskStore配置项。如果不配置，Ehcache将会使用java.io.tmpdir。
diskStroe的“path”属性是用来配置磁盘缓存使用的物理路径的，Ehcache磁盘缓存使用的文件后缀名是.data和.index。
<disStore path=”java.io.tmpdir”/>
·   CacheManagerEventListener配置
我们通过CacheManagerEventListenerFactory可以实例化一个CacheManagerPeerProvider，当我们从CacheManager中added和removed Cache时，将通知CacheManagerPeerProvider，这样一来，我们就可以很方面的对CacheManager中的Cache做一些统计。
注册到CacheManager的事件监听类名有： adding a Cache和removing a Cache
<cacheManagerEventListenerFacotory class=”” properties=””/>
·   CacheManagerPeerProvider配置
在集群中CacheManager配置CacheManagerPeerProviderFactory创建CacheManagerPeerProvider。具体的实例如下：

<cacheManagerPeerProviderFactoryclass="net.sf.ehcache.distribution.

RMICacheManagerPeerProviderFactory"

properties="peerDiscovery=manual, rmiUrls=//server1:40000/sampleCache1|//server2:40000/sampleCache1| //server1:40000/sampleCache2|//server2:40000/sampleCache2"
propertySeparator="," />

·   CacheManagerPeerListener配置
CacheManagerPeerListener配置是用来监听集群中缓存消息的分发的。
<cacheManagerPeerListenerFactory
    class="net.sf.ehcache.distribution.RMICacheManagerPeerListenerFactory"
    properties="hostName=fully_qualified_hostname_or_ip,
                port=40001,
               socketTimeoutMillis=120000"
                propertySeparator="," />

·   Cache配置
·           name：Cache的唯一标识
·           maxElementsInMemory：内存中最大缓存对象数。
·           maxElementsOnDisk：磁盘中最大缓存对象数，若是0表示无穷大。
·           eternal：Element是否永久有效，一但设置了，timeout将不起作用。
·           overflowToDisk：配置此属性，当内存中Element数量达到maxElementsInMemory时，Ehcache将会Element写到磁盘中。
·           timeToIdleSeconds：设置Element在失效前的允许闲置时间。仅当element不是永久有效时使用，可选属性，默认值是0，也就是可闲置时间无穷大。
·           timeToLiveSeconds：设置Element在失效前允许存活时间。最大时间介于创建时间和失效时间之间。仅当element不是永久有效时使用，默认是0.，也就是element存活时间无穷大。
·           diskPersistent：是否缓存虚拟机重启期数据。（这个虚拟机是指什么虚拟机一直没看明白是什么,有高人还希望能指点一二）。
·           diskExpiryThreadIntervalSeconds：磁盘失效线程运行时间间隔，默认是120秒。
·           diskSpoolBufferSizeMB：这个参数设置DiskStore（磁盘缓存）的缓存区大小。默认是30MB。每个Cache都应该有自己的一个缓冲区。
·           memoryStoreEvictionPolicy：当达到maxElementsInMemory限制时，Ehcache将会根据指定的策略去清理内存。默认策略是LRU（最近最少使用）。你可以设置为FIFO（先进先出）或是LFU（较少使用）。这里比较遗憾，Ehcache并没有提供一个用户定制策略的接口，仅仅支持三种指定策略，感觉做的不够理想。
·   Cache Exception Handling配置

<cacheExceptionHandlerFactory class="com.example.ExampleExceptionHandlerFactory"                               properties="logLevel=FINE"/>

总结

这里只对通用缓存的配置做了详细的阐述，至于RMI缓存和集群缓存可以参考这里。

下面给出几个配置示例：
·   Ehcache默认Cache配置
<defaultCache
        maxElementsInMemory="10000"
        eternal="false"
        timeToIdleSeconds="120"
        timeToLiveSeconds="120"
        overflowToDisk="true"
        diskSpoolBufferSizeMB="30"
        maxElementsOnDisk="10000000"
        diskPersistent="false"
        diskExpiryThreadIntervalSeconds="120"
        memoryStoreEvictionPolicy="LRU"
        />
·   SampleCache1配置
简单配置，在ehcache.xml文件中有此配置，在使用Ehcache前最好将其删除掉，自己配置。
缓存名sampleCache1，内存中最多可缓存10000个Element，其中的element会在闲置5分钟或是存活10分钟之后失效。
超过10000element时，element将会输出到磁盘中，输出路径是java.io.tmpdir。
<cache name="sampleCache1"
       maxElementsInMemory="10000"
       maxElementsOnDisk="1000"
       eternal="false"
       overflowToDisk="true"
       diskSpoolBufferSizeMB="20"
       timeToIdleSeconds="300"
       timeToLiveSeconds="600"
       memoryStoreEvictionPolicy="LFU"
        />

·   SampleCache2配置
Cache名为SampleCache2，内存中最多可以缓存1000个element，超出1000不能输出到磁盘中。缓存是永久有效的。
<cache name="sampleCache2"
       maxElementsInMemory="1000"
       eternal="true"
       overflowToDisk="false"
       memoryStoreEvictionPolicy="FIFO"
        />
·   SampleCache3配置
Cache名为SampleCache3。可缓存到磁盘。磁盘缓存将会缓存虚拟机重启期的数据。磁盘缓存失效线程运行间隔时间是10分钟。
<cache name="sampleCache3"
       maxElementsInMemory="500"
       eternal="false"
       overflowToDisk="true"
       timeToIdleSeconds="300"
       timeToLiveSeconds="600"
       diskPersistent="true"
       diskExpiryThreadIntervalSeconds="1"
       memoryStoreEvictionPolicy="LFU"
        />

·   sampleDistributedCache1配置
Cache名为sampleDistributedCache1。
<cache name="sampleDistributedCache1"
       maxElementsInMemory="10"
       eternal="false"
       timeToIdleSeconds="100"
       timeToLiveSeconds="100"
       overflowToDisk="false">
    <cacheEventListenerFactory
            class="net.sf.ehcache.distribution.RMICacheReplicatorFactory"/>
    <bootstrapCacheLoaderFactory
            class="net.sf.ehcache.distribution.RMIBootstrapCacheLoaderFactory"/>
</cache>

·   sampleDistributedCache2配置
<cache name="sampleDistributedCache2"
       maxElementsInMemory="10"
       eternal="false"
       timeToIdleSeconds="100"
       timeToLiveSeconds="100"

       overflowToDisk="false">

    <cacheEventListenerFactory
            class="net.sf.ehcache.distribution.RMICacheReplicatorFactory"
            properties="replicateAsynchronously=false, replicatePuts=false,
                        replicateUpdates=true, replicateUpdatesViaCopy=true,
                       replicateRemovals=false"/>

</cache>
·   sampleDistributedCache3配置
<!--
Sample distributed cache named sampleDistributedCache3.
This cache replicates using defaults except that the asynchronous replication
interval is set to 200ms.
-->
<cache name="sampleDistributedCache3"
       maxElementsInMemory="10"
       eternal="false"
       timeToIdleSeconds="100"
       timeToLiveSeconds="100"
       overflowToDisk="false">
    <cacheEventListenerFactory
            class="net.sf.ehcache.distribution.RMICacheReplicatorFactory"
            properties="asynchronousReplicationIntervalMillis=200"/>
</cache>

51