Web Service基础篇（一）之AXIS2

一、AXIS2简介

       AXIS2是WebService/SOAP/WSDL的引擎，是Appache AXIS 1.x的衍生版。支持更强的模块化、更高的灵活性、更有效地体系结构，可以更容易地与其他 

Web Service 服务标准与协议（如 WS-Security、WS-ReliableMessaging 等）结合。 具有以下特点： 

• 采用AXIOM的XML处理模型，支持灵活定义对象模型。
•  支持不同的消息交换模式：In-Only、Robust-In和In-Out 。In-Only消息交换模式只有SOAP请求，而不需要应答；Robust-In消息交换模式发送SOAP请求，只有在出错的情况下才返回应答；In-Out消息交换模式总是存在SOAP请求和应答。
•  提供阻塞与非阻塞的API。< 内置的服务寻址（WebService-Addressing）。 
• 数据绑定与Web Service发布方式：支持POJO(Plain Old Java Object)、AXIOM、XMLBeans、JiBX、JAXB 2.0等。 
• 全新的部署模型，支持热部署、热更新。 
• 支持HTTP、SMTP、JMS、TCP传输协议。 
• 支持REST（Representational State Transfer）。 

 二、AXIS2的下载与部署      

1.首先，在客户机安装appache tomcat以及jdk基础环境。 

2.下载AXIS2的压缩包（ 目前，AXIS2的最新版本是1.6.3(2015.6.27)。本文下载1.6.2(2012.4.17)版本。）

下载列表: 

axis2-1.6.2-bin.zip               AXIS2完整版，支持WS-Addressing与SOAP-Moniter      

axis2-1.6.2-war.zip               AXIS2 Web容器部署版本  

3.解压axis2-1.6.2-war.zip文件，然后将axis2.war文件拷贝到<Tomcat安装目录>\webapps目录，启动Tomcat，在浏览器地址栏输入AXIS2的http://localhost:8080/axis2/，axis2.war会自动解压缩，如果，显示AXIS2的主页面则表示加载成功。

 三、编写与发布Web Service

(1) POJO方式(无需任何配置)

      无需任何配置，即可让POJO类部署成AXIS2中的Web Service。

      1.1  编写POJO类

<span style="font-family:Microsoft YaHei;font-size:12px;font-weight: normal;">public class AXISHelloService {
    public String sayHello(){
         return "Hello AXIS";
    }
    public String sayHelloToPerson(String name){
        if(name==null){
           name = "no body";
        }
        return "AXIS Hello,"+name;
    }
}</span>

         1.2  发布WebService

编译AXISHelloService类后，将AXISHelloService.class文件拷贝到<Tomcat安装目录>\webapps\axis2\WEB-INF\pojo目录中。现在，AXISHelloService已经发

布成服务。  

      在浏览器地址栏中输入如下的URL，查看服务列表：

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

      在浏览器中输入两个URL测试sayHello与sayHelloToPerson方法：

      http://localhost:8080/axis2/services/AXISHelloService/sayHello

      http://localhost:8080/axis2/services/AXISHelloService/sayHelloToPerson?name=Jack

      

<ns:sayHelloToPersonResponse xmlns:ns="http://ws.apache.org/axis2">
  <return>AXIS Hello,Jack</return>
</ns:sayHelloToPersonResponse>

   

        1.3  注意事项

       在编写POJO类、发布与测试AXIS2.0 Web Service时，注意以下方面：

• POJO不能使用package关键字声明包。

• AXIS2默认,热发布Web Service是启用。即只要将Web Service的.class文件复制到pojo目录时，tomcat无需重新启动，即可自动发布Web Service。Web Service热发布的配置项在<Tomcat安装目录>\webapps\axis2\WEB-INF\conf\axis2.xml文件中，找到如下配置项：

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

• AXIS2默认,热更新Web Service是关闭。即一旦发布Web Service，再更新Web Service，必须重启Tomcat。如果想设置AXIS2是热更新，则修改axis2.xml的以下配置项：

     <parameter name="hotupdate">false</parameter>

• 在Web浏览器测试WebService时，必须使用URL的请求参数来指定WebService方法的SOAP请求参数。

• 发布Web Service的默认路径是<Tomcat安装目录>\webapps\axis2\WEB-INF\pojo，可以添加其他路径，编辑axis2.xml文件，在<axisconfig name="AxisJava2.0">节点之间，添加如下配置项，即可让<Tomcat安装目录>\webapps\axis2\WEB-INF\deployPOJO路径成为发布Web Service的目录：

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

     (2) 使用services.xml文件发布WebService

       基于AXIS2引擎发布Web Service时，虽然 直接拷贝POJO类至axis2\WEB-INF\pojo目录，无需任何配置，已经完成Web Service发布，但这些POJO类无法

处于任何包内。因此，AXIS2提供支持处于包中的POJO类发布成Web Service的方式，即services.xml方式。services.xml方式发布Web Service可以采用两种方

式：(1) .aar压缩包格式；(2)非压缩格式。

     2.1 .aar压缩包格式

     2.1.1 编写POJO类

     编写计算服务类，实现decimal数据的四则运算。源代码如下：

       

package com.efo.service;

import java.text.DecimalFormat;

/**
 * Created by Jack Lee  on 2015/11/21.
 *
 */
public class CalculateService {
    /**
     * a plus b
     * @param a
     * @param b
     * @return   a + b
     */
    public float plus(float a,float b){
        return a+b;
    }

    /**
     * a minus b
     * @param a
     * @param b
     * @return   a - b
     */
    public float minus(float a,float b){
        return a -b;
    }

    /**
     * a multi b
     * @param a
     * @param b
     * @return   a * b
     */
    public float multi(float a,float b){
        return a * b;
    }

    /**
     * a divide b
     * @param a
     * @param b
     * @return   a / b
     */
    public float divide(float a, float b){
        if(b==0){
            return -1;
        }
        DecimalFormat decimalFormat = new DecimalFormat("#.##");
        return Float.parseFloat(decimalFormat.format(a/b));
    }
}

      2.1.2 编写services.xml文件

<!--Service Name-->
<service name="CalculateService">
    <!--Service Description-->
    <description>Calculate Service</description>
    <!--Service Class Name-->
    <param name="ServiceClass">com.efo.service.CalculateService</param>
    <!--Service Message Receiver-->
    <messageReceivers>
        <messageReceiver mep="http://www.w3.org/2004/08/wsdl/in-out" class="org.apache.axis2.rpc.receivers.RPCMessageReceiver" />
        <messageReceiver mep="http://www.w3.org/2004/08/wsdl/in-only" class="org.apache.axis2.rpc.receivers.RPCInOnlyMessageReceiver"/>
    </messageReceivers>
</service>

  2.1.3 发布Web Service

     编译源文件CalculateService.java文件，然后新建如下文件夹:

     d:\WS\com\efo\service\CalculateService.class

     d:\WS\META-INF\services.xml

     在Windows cmd命令行，进入d:\WS目录,运行命令行，生成.aar包： 

   jar cvf calcservice.aar 

      然后复制calcservice.aar包到<Tomcat安装目录>\webapps\axis2\WEB-INF\services目录，完成Web Service发布。