axis2开发webservice之将Spring的安装JavaBean发布成WebService

axis2开发webservice之将Spring的装配JavaBean发布成WebService

        前些阵子刚好学会了spring,现在来把axis2和spring结合一下,这也是做企业开发的时候必须的,结合教程来学习一遍。     

        在现今的Web应用中经常使用Spring框架来装载JavaBean。如果要想将某些在Spring中装配的JavaBean发布成WebService,使用Axis2Spring感知功能是非常容易做到的。
   
    在本文的例子中,除了<Tomcat安装目录>\webapps\axis2目录及该目录中的相关库外,还需要Spring框架中的spring.jar文件(这里是基于spring2.X的,spring3.X没有此包,改名了),将该文件复制到<Tomcat安装目录>\webapps\axis2\WEB-INF\lib目录中。
   
   下面先建立一个JavaBean(该JavaBean最终要被发布成WebService),代码如下:

 

package springWS;

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 springWS;

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="shi" />
     <property name="job" value="payment" />
  </bean>   
</beans>

      applicationContext.xml文件中装配了service.SpringService类,并被始化了namejob属性。在配置完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参数指定要发布成WebServiceJava类,而是要指定在applicationContext.xml文件中的装配JavaBean的名称(SpringBeanName参数)。

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


     接下来就没什么难度了,就是我们熟悉的stub类了,编写客户端代码了。如下

package springWS;

import java.rmi.RemoteException;

public class SpringServiceClient {

	public static void main(String[] args) throws RemoteException {
		// TODO Auto-generated method stub
		SpringServiceStub sss = new SpringServiceStub();
		SpringServiceStub.Person person = new SpringServiceStub.Person();
		SpringServiceStub.GetPerson gp = new SpringServiceStub.GetPerson();
		SpringServiceStub.GetGreeting gg = new SpringServiceStub.GetGreeting();
		
		//spring注入赋值
		System.out.println("spring注入name:"+sss.getPerson(gp).get_return().getName());
		System.out.println("spring注入job:"+sss.getPerson(gp).get_return().getJob());
		System.out.println("-------------------------------------");
		
		//设置形参
		gg.setName("局部变量");
		System.out.println("greeting:"+sss.getGreeting(gg).get_return());
		System.out.println("-------------------------------------");
		
		//更新name和job
		person.setName("thinkpadshi");
		person.setJob("the third payment");
		System.out.println("更新之后name:"+person.getName());
		System.out.println("更新之后job:"+person.getJob());
		System.out.println("-------------------------------------");
		System.out.println("总入口name:"+sss.getPerson(gp).get_return().getName());
		System.out.println("总入口job:"+sss.getPerson(gp).get_return().getJob());
	}
}

运行结果

axis2开发webservice之将Spring的安装JavaBean发布成WebService
         

         这里就比较有意思了,咋一看,不对啊,我们已经更新了name和job了,为什么最后的输入还是spring注入赋值的状态呢。其实我们可以看到,这是由于访问的路径不同所造成的,虽说我们都是在访问发布在webservice上的getPerson()方法,但是访问的入口不对,sss是客户端类的成员变量,是全局结构,与spring联系紧密,spring注入的时候是从springService类的setter,getter方法注入到当前的name和job(即代码中的this),再把当前对象的变量当做参数传到person类的setter方法中。而用person访问的时候,没有见过spring注入到当前对象中这一环节,直接是从最底层的person类中用其setter方法设置变量值的,这时候name和job已经变成了person的设置值,如果这时候再用sss去获取name和job,这时候为了初始化sss这个对象,必然会加载stub类,这时候就相当于再次注入spring了,name和job的值再次改变。因此我们看上去才会觉得两次访问好像是访问了不同的地方似的。