本文为原创,如需转载,请注明作者和出处,谢谢!
在现今的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
对象。