axis2 1.5

WebService的开发模版（Axis2 1.5环境）

今天在做apache-cxf-2.2.2整合Spring时候，出现了包版本与JDK1.5包冲突的问题，折腾了不少时间，还是没解决。于是改为Axis2开发，暂时绕过问题，完成任务要紧。

Axis2已经升级到1.5了，下载地址：
http://apache.etoak.com/ws/axis2/1_5/axis2-1.5-bin.zip
http://apache.etoak.com/ws/axis2/1_5/axis2-1.5-war.zip

两个包，bin是开发包，war是部署包，实际上，如果只用jar包，两个里面的jar都一样用。

在IDEA环境下，Axis2的开发环境稍微麻烦些，毕竟没CXF或XFire方便。每次写build.xml脚本也挺麻烦的。这次写个项目模版，方便以后使用。

环境：
axis2-1.5
jdk1.5
idea-8.13
apache-tomcat-6.0.20
ant-1.6以上即可

一、创建项目

使用idea向导创建一个Java项目，项目结构如下图：
testaxis2
├─lib
├─resources
│    └─META-INF
└─src
        └─mytest

二、导入axis2的包

解压缩axis2-1.5-bin.zip到一个目录下，然后直接在idea中引入axis2的包即可。也可以讲axis2的包复制到lib下。

三、创建服务

axis2服务的创建过程就是写Java类，不要求有接口，有也不会错。
这里创建一个最简单的Service，作为发布对象。

package mytest;

/**
* 测试Service
*
* @author leizhimin 2009-8-4 15:46:39
*/
public interface MyService {
        String doSomething(String taskname);
}

package mytest;

/**
* 测试Service
*
* @author leizhimin 2009-8-4 15:48:13
*/
public class MyServiceImpl implements MyService {
        public String doSomething(String taskname) {
                System.out.println("MyServiceImpl is calling doSomething with " + taskname + "!");
                return taskname + "is finished!";
        }
}

四、描述服务

在项目的resources\META-INF文件夹下面，创建services.xml，内容如下：
<service name="myws" scope="application" targetNamespace="http://lavasoft.blog.51cto.com/">
        <messageReceivers>
                <messageReceiver mep="http://www.w3.org/2004/08/wsdl/in-only"
                                                 class="org.apache.axis2.rpc.receivers.RPCInOnlyMessageReceiver"/>
                <messageReceiver mep="http://www.w3.org/2004/08/wsdl/in-out"
                                                 class="org.apache.axis2.rpc.receivers.RPCMessageReceiver"/>
        </messageReceivers>
        <schema schemaNamespace="http://lavasoft.blog.51cto.com/xsd"/>
        <parameter name="ServiceClass">mytest.MyServiceImpl</parameter>
</service>

服务名：myws
命名空间：http://lavasoft.blog.51cto.com
服务实现类：mytest.MyServiceImpl

五、编写构建脚本

用Ant编写build.xml，放到项目根文件夹下。
<?xml version="1.0" encoding="UTF-8"?>
<project name="ccmws" basedir="." default="generate.service">

        <property environment="env"/>
        <property name="AXIS2_HOME" value="F:/axis2-1.5"/>
        <property name="wsdl.uri" value="./build/myws.wsdl"/>

        <property name="build.dir" value="build"/>

        <path id="axis2.classpath">
                <fileset dir="${AXIS2_HOME}/lib">
                        <include name="*.jar"/>
                </fileset>
                <fileset dir="./lib">
                        <include name="*.jar"/>
                </fileset>
        </path>

        <target name="compile.service">
                <mkdir dir="${build.dir}"/>
                <mkdir dir="${build.dir}/classes"/>
                <javac debug="on"
                             fork="true"
                             encoding="UTF-8"
                             destdir="${build.dir}/classes"
                             srcdir="${basedir}/src"
                             extdirs="**/test/**"
                             classpathref="axis2.classpath">
                </javac>
        </target>

        <target name="generate.wsdl" depends="compile.service">
                <taskdef name="java2wsdl"
                                 classname="org.apache.ws.java2wsdl.Java2WSDLTask"
                                 classpathref="axis2.classpath"/>
                <java2wsdl className="mytest.MyServiceImpl"
                                     outputLocation="${build.dir}"
                                     targetNamespace="http://lavasoft.blog.51cto.com/"
                                     schemaTargetNamespace="http://lavasoft.blog.51cto.com/xsd">
                        <classpath>
                                <pathelement path="${axis2.classpath}"/>
                                <pathelement location="${build.dir}/classes"/>
                        </classpath>
                </java2wsdl>
        </target>

        <target name="generate.service" depends="compile.service">
                <copy toDir="${build.dir}/classes" failonerror="false">
                        <fileset dir="${basedir}/resources">
                                <include name="**/*.xml"/>
                        </fileset>
                </copy>
                <jar destfile="${build.dir}/myws.aar">
                        <fileset excludes="**/Test.class" dir="${build.dir}/classes"/>
                        <fileset includes="lib/*.jar" dir="${basedir}"/>
                </jar>
        </target>

        <target name="clean">
                <delete dir="${build.dir}" />
        </target>
</project>

注意设定一些环境参数，Axis2的目录、发布服务的aar包名字，生成wsdl时候所用的服务实现类，以及命名空间等等。

六、运行build脚本打包



运行后：



七、部署服务

将下载的axis2-1.5-war.zip解开，得到一个axis2.war，将其解压缩到tomcat的默认的web发布目录webapp下面，比如，在我机器上会产生C:\apache-tomcat-6.0.20\webapps\axis2的目录，目录下面就是axis2.war里面的内容。

然后，将生成的my.aar复制到C:\apache-tomcat-6.0.20\webapps\axis2\WEB-INF\services下面。

八、启动tomcat，查看发布服务



浏览axis2的服务


点Services，查看所有的服务


在点击服务连接，就可以查看wsdl了：


经过这样的测试后，服务发布算成功了。