关闭

Web Service基础篇(一)之AXIS2

标签: web serviceAXIS2
186人阅读 评论(0) 收藏 举报
分类:

一、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发布。


1
0

查看评论
* 以上用户言论只代表其个人观点,不代表CSDN网站的观点或立场
    个人资料
    • 访问:16618次
    • 积分:328
    • 等级:
    • 排名:千里之外
    • 原创:14篇
    • 转载:14篇
    • 译文:1篇
    • 评论:0条
    文章分类