Axis Web Service开发之旅 （一）--配置发布

    Axis2是一套崭新的WebService引擎，该版本是对Axis1.x重新设计的产物。Axis2不仅支持SOAP1.1和SOAP1.2，还集成了非常流行的REST WebService，同时还支持Spring、JSON等技术。

   

   配置环境：

  

       axis2-1.5-bin.zip，axis2-1.5-war.zip，Tomcat5.5

axis2.war文件放到<Tomcat安装目录>/webapps，启动Tomcat，会自动解压出文件夹axis2, 在浏览器地址栏中输入如下的URL：

http://localhost:8080/axis2/  测试其安装成功

axis2实际上就是一个Web目录，在该目录中可以发布jsp、servlet，而webservice是依赖servlet来实现的，因此，也可以发布web service，当然，可以将axis2改成其他的名子，因此我们做项目时，可以复制出一个axis2并将其更改成你需要的名字，方便快捷。

Tomcat安装时曾经遇到过一个问题，就是其安装的路径如果有中文或空格 在某些项目上启动Tomcat会遇到“找不到系统目录”的问题，不是知道是不是Tomcat的bug。

 

    简单发布：

对于用Java实现的服务程序给人的印象就是需要进行大量的配置，不过这一点在Axis2中将被终结。在Axis2中不需要进行任何的配置，就可以直接将一个简单的POJO发布成WebService。其中POJO中所有的public方法将被发布成WebService方法。

 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：

http://localhost:8080/axis2/services/listServices

在编写、发布和测试0配置的WebService时应注意如下几点：

    1. POJO类不能使用package关键字声明包。

    2. Axis2在默认情况下可以热发布WebService，也就是说，将WebService的.class文件复制到pojo目录中时，Tomcat不需要重新启动就可以自动发布WebService。如果想取消Axis2的热发布功能，可以打开<Tomcat安装目录>/webapps/axis2/WEB-INF/conf/axis2.xml，找到如下的配置代码：

<parameter name="hotdeployment">true</parameter>

    将true改为false即可。要注意的是，Axis2在默认情况下虽然是热发布，但并不是热更新，也就是说，一旦成功发布了WebService，再想更新该WebService，就必须重启Tomcat。这对于开发人员调试WebService非常不方便，因此，在开发WebService时，可以将Axis2设为热更新。在axis2.xml文件中找到<parameter name="hotupdate">false</parameter>，将false改为true即可。

    3. 在浏览器中测试WebService时，如果WebService方法有参数，需要使用URL的请求参数来指定该WebService方法参数的值，请求参数名与方法参数名要一致，例如，要测试getGreeting方法，请求参数名应为name，如上面的URL所示。

    4. 发布WebService的pojo目录只是默认的，如果读者想在其他的目录发布WebService，可以打开axis2.xml文件，并在<axisconfig>元素中添加如下的子元素：

    <deployer extension=".class" directory="my" class="org.apache.axis2.deployment.POJODeployer"/>

    上面的配置允许在<Tomcat安装目录>/webapps/axis2/WEB-INF/my目录中发布WebService。例如，将本例中的SimpleService.class复制到my目录中也可以成功发布（但要删除pojo目录中的SimpleService.class，否则WebService会重名）。