在现今的 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对象。