webservice技术之-axis2（服务端ADB）

前言：
近期研究webservice技术，各类文章很多，但对于第一次接触这个技术的人来讲，学习成本还是较高，记录下我学习的历程，希望对你有所帮助。
Apache官网的对于axis2的教程很详细，大家可以耐心读完。
Apache官网教程（点击这里）
一、什么是axis2
其实就是一种流行的开源webservice框架，现在流行的框架有Axis1,Axis2,Xfire,CXF,JWS等。
二、服务器、客户端
要么利用webservice技术写服务端，要么写客户端，当然一个项目也可以同时具备服务器端和客户端的功能（这个是我的猜测，正在验证）；
三、如何发布服务端
官网教程中的发布服务器端，实际上是下载war包后，放到tomcat的webapp目录中（通过启动tomcat后解压出的项目），对该项目进行修改即可完成发布。
而我的需求是要将已经开发完成的项目发布为webservice服务端，所以只需把关键axis2项目的关键文件拷贝至自己的项目中即可（这是另一种偷懒方式）。
我们这里使用官网给的StockQuoteService这个类进行说明。

package samples.quickstart.service.pojo;

import java.util.HashMap;

public class StockQuoteService {
    private HashMap map = new HashMap();

    public double getPrice(String symbol) {
        Double price = (Double) map.get(symbol);
        if(price != null){
            return price.doubleValue();
        }
        return 42.00;
    }

    public void update(String symbol,double price) {
        map.put(symbol,new Double(price));
    }
}

1.编译
首先将java文件编译成class文件
通过使用命令

javac StockQuoteService.java

2.使用java2wsdl命令，将class文件转为wsdl文件（需要注意的是，这里是进行服务器端的wsdl的生成）
具体命令为：

(Windows)
%AXIS2_HOME%binjava2wsdl -cp . -cn samples.quickstart.service.pojo.StockQuoteService -of StockQuoteService.wsdl

(Linux)
$AXIS2_HOME/bin/java2wsdl -cp . -cn samples.quickstart.service.pojo.StockQuoteService -of StockQuoteService.wsdl

命令的具体意思可以参照官网教程，理不理解都无所谓，我没看具体什么意思。
3.下一步是把从war包解压的axis2项目中的主要文件拷贝到自己的项目中
axis2项目的原结构为

这个项目中的src是没有java代码的
需要拷贝的文件包括
①axis2-web，这个是已经写好的一些jsp页面，很多都没有用，日后可以自己精简，也可以删掉。刚开始最好拷贝过去。
②org包是我生成的calss文件，在我测试的时用的，服务器端不需要考虑，忽略即可。
③拷贝conf包和文件（有人说需要删除modules的配置文件，我没删，也没遇到问题）
④modules文件夹不需要拷贝
⑤把lib包中的jar包拷贝一下
⑥service文件拷贝过去，包含version-1.6.3.arr和service.list（其实就是我们发布服务的地方）
⑦由于我的是springmvc+spring+mybatis项目，所以需要拷贝web.xml文件中的配置到我的web.xml中

<servlet>
        <servlet-name>AxisServlet</servlet-name>
        <display-name>Apache-Axis Servlet</display-name>
        <servlet-class>org.apache.axis2.transport.http.AxisServlet</servlet-class>
        <!--<init-param>-->
        <!--<param-name>axis2.xml.path</param-name>-->
        <!--<param-value>/WEB-INF/conf/axis2.xml</param-value>-->
        <!--<param-name>axis2.xml.url</param-name>-->
        <!--<param-value>http://localhost/myrepo/axis2.xml</param-value>-->
        <!--<param-name>axis2.repository.path</param-name>-->
        <!--<param-value>/WEB-INF</param-value>-->
        <!--<param-name>axis2.repository.url</param-name>-->
        <!--<param-value>http://localhost/myrepo</param-value>-->
        <!--</init-param>-->
        <load-on-startup>1</load-on-startup>
    </servlet>
    <servlet>
        <servlet-name>AxisAdminServlet</servlet-name>
        <display-name>Apache-Axis AxisAdmin Servlet (Web Admin)</display-name>
        <servlet-class>
            org.apache.axis2.webapp.AxisAdminServlet</servlet-class>
    </servlet>

    <!-- servlet> <servlet-name>SOAPMonitorService</servlet-name> <display-name>SOAPMonitorService</display-name> <servlet-class>org.apache.axis2.soapmonitor.servlet.SOAPMonitorService</servlet-class> <init-param> <param-name>SOAPMonitorPort</param-name> <param-value>5001</param-value> </init-param> <init-param> <param-name>SOAPMonitorHostName</param-name> <param-value>localhost</param-value> </init-param> <load-on-startup>1</load-on-startup> </servlet -->

    <servlet-mapping>
        <servlet-name>AxisServlet</servlet-name>
        <url-pattern>/servlet/AxisServlet</url-pattern>
    </servlet-mapping>

    <servlet-mapping>
        <servlet-name>AxisServlet</servlet-name>
        <url-pattern>*.jws</url-pattern>
    </servlet-mapping>

    <servlet-mapping>
        <servlet-name>AxisServlet</servlet-name>
        <url-pattern>/services/*</url-pattern>
    </servlet-mapping>

    <servlet-mapping>
        <servlet-name>AxisAdminServlet</servlet-name>
        <url-pattern>/axis2-admin/*</url-pattern>
    </servlet-mapping>

    <!-- servlet-mapping> <servlet-name>SOAPMonitorService</servlet-name> <url-pattern>/SOAPMonitor</url-pattern> </servlet-mapping -->

    <mime-mapping>
        <extension>inc</extension>
        <mime-type>text/plain</mime-type>
    </mime-mapping>

4.关键一步，通过wsdl文件生成相关的服务端代码
axis2生成服务端代码有4中方式，包括Deploying POJOs、Building the service using AXIOM、Generating the service using ADB、Generating the service using XMLBeans、Generating the service using JiBX，区别可以去百度。
对于一般需求，使用ADB方式即可，方便、快捷。
①跳转到Axis2_HOME/samples/quickstartadb目录中
把之前生成的wsdl文件放到resourcesMETA-INF中
执行下面命令

(Windows)
%AXIS2_HOME%binwsdl2java -uri resourcesMETA-INFStockQuoteService.wsdl -p samples.quickstart.service.adb -d adb -s -ss -sd -ssi -o buildservice

(Linux)
$AXIS2_HOME/bin/wsdl2java -uri resources/META-INF/StockQuoteService.wsdl -p samples.quickstart.service.adb -d adb -s -ss -sd -ssi -o build/service

会生成budild文件夹，
找到
build/service/src/samples/quickstart/adb/service/StockQuoteServiceSkeleton.java
这个类是服务端实现接口后，需要我们重写逻辑的类，我们要在接受到客户端传过来的参数后要进行的操作在这里进行写。

package samples.quickstart.service.adb;

import samples.quickstart.service.adb.xsd.GetPriceResponse;
import samples.quickstart.service.adb.xsd.Update;
import samples.quickstart.service.adb.xsd.GetPrice;

import java.util.HashMap;

public class StockQuoteServiceSkeleton {

    private static HashMap map;

    static{ map = new HashMap(); }

    public void update(Update param0) {
        map.put(param0.getSymbol(),new Double(param0.getPrice()));
    }

    public GetPriceResponse getPrice(GetPrice param1) {
        Double price = (Double) map.get(param1.getSymbol());
        double ret = 42;
        if(price != null){
            ret = price.doubleValue();
        }
        GetPriceResponse res =
                new GetPriceResponse();
        res.set_return(ret);
        return res;
    }
}

转跳到build/service文件夹（这个目录中有一个build.xml文件，是ant命令的配置文件）
执行命令

ant jar.server

在这一步遇到乱码问题，暂时没有解决。

执行命令成功以后，我们得到目录build/service/build/lib中的StockQuoteService.aar 文件
这个文件就是我们最终需要的东西，可以理解为我们服务器端的编码最终打包到类似于jar包中
5.最后，我们只需将StockQuoteService.aar文件拷贝到项目的services文件夹中

验证
查看服务列表
http://localhost:8080/axis2/services/listServices

查看wsdl文件
http://localhost:8080/axis2/services/StockQuoteService?wsdl

查看xsd文件
http://localhost:8080/axis2/services/StockQuoteService?xsd