Axis2(7)：将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目录中。

在<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，然后将该文件复制到<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对象。