Axis Web Service开发之旅 （三） --将Spring的装配JavaBean发布成WebService

    在现今的Web应用中经常使用Spring框架来装载JavaBean。如果要想将某些在Spring中装配的JavaBean发布成WebService，使用Axis2的Spring感知功能是非常容易做到的。
    在本文的例子中，除了<Tomcat安装目录>/webapps/axis2目录及该目录中的相关库外，还需要Spring框架中的spring.jar文件，将该文件复制到<Tomcat安装目录>/webapps/axis2/WEB-INF/lib目录中。
    下面先建立一个JavaBean（该JavaBean最终要被发布成WebService），代码如下：

 

package service; import entity.Person; public class SpringService { private String name; private String job; public void setName(String name) { this.name = name; } public void setJob(String job) { this.job = job; } public Person getPerson() { Person person = new Person(); person.setName(name); person.setJob(job); return person; } public String getGreeting(String name) { return "hello " + name; } }

 其中Person也是一个JavaBean，代码如下：

package entity; public class Person { private String name; private String job; public String getName() { return name; } public void setName(String name) { this.name = name; } public String getJob() { return job; } public void setJob(String job) { this.job = job; } }

  将上面两个Java源文件编译后，放到<Tomcat安装目录>/webapps/axis2/WEB-INF/classes目录中。

如果项目中有jpa的配置 META-INF/persistence.xml,同样将这个目录复制到<Tomcat安装目录>/webapps/axis2/WEB-INF/classes目录中。

    在<Tomcat安装目录>/webapps/axis2/WEB-INF/web.xml文件中加入下面的内容：

<listener> <listener-class>org.springframework.web.context.ContextLoaderListener</listener-class> </listener> <context-param> <param-name>contextConfigLocation</param-name> <param-value>/WEB-INF/applicationContext.xml</param-value> </context-param>

  在<Tomcat安装目录>/webapps/axis2/WEB-INF目录中建立一个applicationContext.xml文件，该文件是Spring框架用于装配JavaBean的配置文件，内容如下：

<?xml version="1.0" encoding="UTF-8"?> <beans xmlns="http://www.springframework.org/schema/beans" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:aop="http://www.springframework.org/schema/aop" xmlns:tx="http://www.springframework.org/schema/tx" xsi:schemaLocation=" http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-2.5.xsd http://www.springframework.org/schema/aop http://www.springframework.org/schema/aop/spring-aop-2.5.xsd http://www.springframework.org/schema/tx http://www.springframework.org/schema/tx/spring-tx-2.5.xsd"> <bean id="springService" class="service.SpringService"> <property name="name" value="姚明" /> <property name="job" value="职业男篮" /> </bean> </beans>

  在applicationContext.xml文件中装配了service.SpringService类，并被始化了name和job属性。在配置完SpringService类后，就可以直接在程序中FileSystemXmlApplicationContext类或其他类似功能的类读取applicationContext.xml文件中的内容，并获得SpringService类的对象实例。但现在我们并不这样做，而是将SpringService类发布成WebService。

    在<Tomcat安装目录>/webapps/axis2/WEB-INF/lib目录中有一个axis2-spring-1.4.1.jar文件，该文件用于将被装配JavaBean的发布成WebService。在D盘建立一个axi2-spring-ws目录，并在该目录中建立一个META-INF子目录。在META-INF目录中建立一个services.xml文件，内容如下：

<service name="springService"> <description> Spring aware </description> <parameter name="ServiceObjectSupplier"> org.apache.axis2.extensions.spring.receivers.SpringServletContextObjectSupplier </parameter> <parameter name="SpringBeanName"> springService </parameter> <messageReceivers> <messageReceiver mep="http://www.w3.org/2004/08/wsdl/in-out" class="org.apache.axis2.rpc.receivers.RPCMessageReceiver" /> </messageReceivers> </service>

在Windows控制台进入axi2-spring-ws目录，并使用jar命令将axi2-spring-ws目录中的内容打包成axi2-spring-ws.aar（jar cf axi2-spring-ws.aar META-INF ），然后将该文件复制到<Tomcat安装目录>/webapps/axis2/WEB-INF/services目录中，启动Tomcat后，就可以访问该WebService了，访问方式与前面几篇文章的访问方式相同。获得wsdl内容的URL如下：
http://localhost:8080/axis2/services/springService?wsdl

    在将Spring中的装配JavaBean发布成WebService需要注意以下几点：

    1. 由JavaBean编译生成的.class文件需要放在WEB-INF/classes目录中，或打成.jar包后放在WEB-INF/lib目录中，而WEB-INF/services目录中的.aar包中不需要包含.class文件，而只需要包含一个META-INF目录，并在该目录中包含一个services.xml文件即可。

    2. services.xml的配置方法与前几篇文章的配置方法类似，只是并不需要使用ServiceClass参数指定要发布成WebService的Java类，而是要指定在applicationContext.xml文件中的装配JavaBean的名称（SpringBeanName参数）。

    3. 在services.xml文件中需要通过ServiceObjectSupplier参数指定SpringServletContextObjectSupplier类来获得Spring的ApplicationContext对象。

项目中可能会经常添加服务或添加方法，如此麻烦的打包、复制真的是让人头疼，批处理可以解决这种状况，内容如下：

 @echo jar cf axi2-spring-ws.aar META-INF move axi2-spring-ws.aar C:/Tomcat5.5/webapps/axis2/WEB-INF/services cd.. cd bin rem delete.svn @for /r . %%a in (.) do @if exist "%%a/.svn" rd /s /q "%%a/.svn" xcopy applicationContext.xml C:/Tomcat5.5/webapps/axis2/WEB-INF /y xcopy PackageName C:/Tomcat5.5/webapps/axis2/WEB-INF/classes/PackageName/ /e/y/q xcopy META-INF C:/Tomcat5.5/webapps/axis2/WEB-INF/classes/META-INF/ /e/y