WebService的开发模版（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了：

 

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