Axis2 教程
文章分类:Java编程
  Axis2是一套崭新的WebService引擎,该版本是对Axis1.x重新设计的产物。Axis2不仅支持SOAP1.1SOAP1.2,还集成了非常流行的REST WebService,同时还支持SpringJSON等技术。这些都将在后面的系列教程中讲解。在本文中主要介绍了如何使用Axis2开发一个不需要任何配置文件的WebService,并在客户端使用JavaC#调用这个WebService
一、Axis2的下载和安装
    读者可以从如下的网址下载Axis2的最新版本:
    /axis2/
    在本文使用了目前Axis2的最新版本1.4.1。读者可以下载如下两个zip包:
    axis2-1.4.1-bin.zip
    axis2-1.4.1-war.zip
    其中axis2-1.4.1-bin.zip文件中包含了Axis2中所有的jar文件, axis2-1.4.1-war.zip文件用于将WebService发布到Web容器中。
    axis2-1.4.1-war.zip文件解压到相应的目录,将目录中的axis2.war文件放到<Tomcat安装目录>\webapps目录中(本文使用的Tomcat的版本是6.x),并启动Tomcat
    在浏览器地址栏中输入如下的URL
    localhost:8080/axis2/
    如果在浏览器中显示出如图1所示的页面,则表示Axis2安装成功。


1


 
二、编写和发布WebService
  对于用Java实现的服务程序给人的印象就是需要进行大量的配置,不过这一点在Axis2中将被终结。在Axis2中不需要进行任何的配置,就可以直接将一个简单的POJO发布成WebService。其中POJO中所有的public方法将被发布成WebService方法。
    下面我们来实现一个简单的POJO,代码如下:
public class SimpleService
{
    public String getGreeting(String name)
    {
        return "你好 " + name;
    }   
    public int getPrice()
    {
        return new java.util.Random().nextInt(1000);
    }   
}
 
    SimpleService类中有两个方法,由于这两个方法都是public方法,因此,它们都将作为WebService方法被发布。
    编译SimpleService类后,将SimpleService.class文件放到<Tomcat安装目录>\webapps\axis2\WEB-INF\pojo目录中(如果没有pojo目录,则建立该目录)。现在我们已经成功将SimpleService类发布成了WebService。在浏览器地址栏中输入如下的URL
localhost:8080/axis2/services/listServices
    这时当前页面将显示所有在Axis2中发布的WebService,如图2所示。
 
    在浏览器地址栏中输入如下的两个URL来分别测试getGreetinggetPrice方法:
localhost:8080/axis2/services/SimpleService/getGreeting?name=bill
localhost:8080/axis2/services/SimpleService/getPrice

    3和图4分别显示了getGreeting调用webservice服务getPrice方法的测试结果。
 
3  getGreeting方法的测试结果


 
 
 
4  getPrice方法的测试结果


 
 
    在编写、发布和测试0配置的WebService时应注意如下几点:
    1. POJO类不能使用package关键字声明包。
    2. Axis2在默认情况下可以热发布WebService,也就是说,将WebService.class文件复制到pojo目录中时,Tomcat不需要重新启动就可以自动发布WebService。如果想取消Axis2的热发布功能,可以打开<Tomcat安装目录>\webapps\axis2\WEB-INF\l,到如下的配置代码:
<parameter name="hotdeployment">true</parameter>
 
 
 
    true改为false即可。要注意的是,Axis2在默认情况下虽然是热发布,但并不是热更新,也就是说,一旦成功发布了WebService,再想更新该WebService,就必须重启Tomcat。这对于开发人员调试WebService非常不方便,因此,在开发WebService时,可以将Axis2设为热更新。在l文件中到<parameter name="hotupdate">false</parameter>,将false改为true即可。
    3. 在浏览器中测试WebService时,如果WebService方法有参数,需要使用URL的请求参数来指定该WebService方法参数的值,请求参数名与方法参数名要一致,例如,要测试getGreeting方法,请求参数名应为name,如上面的URL所示。
    4. 发布WebServicepojo目录只是默认的,如果读者想在其他的目录发布WebService,可以打开l文件,并在<axisconfig>元素中添加如下的子元素:
 <deployer extension=".class" directory="my" class="org.apache.axis2.deployment.POJODeployer"/>

版权声明:本站内容均来自互联网,仅供演示用,请勿用于商业和其他非法用途。如果侵犯了您的权益请与我们联系QQ:729038198,我们将在24小时内删除。