?一: 准备工作
??????1:JDK? MyEclipse Tomcat6的安装与配置(略过)
????? 2:安装Axis2
????????去http://axis.apache.org/axis2/java/core/download.cgi下载Axis2的应用包,源码包,文档,War包
????????推荐使用Axis2 1.4.1(本文中的内容都以Axis2 1.4.1版本作为演示)
???????
??????? 配置环境变量
??????? 例如我的机子上Axis的应用包位于:E:\axis2-1.4.1,那么我需要新增一个环境变量AXIS2_HOME,值为E:\axis2-1.4.1,并且在Path的最后面添加上:E:\axis2-1.4.1\bin
??????? 配置完成后试着进入命令行里输入axis2,java2wsdl(由于dos环境不区分大小写,这里大小写随意),如果没有报错并且能展示相应的Help信息,则标志你配置成功了。
??????3:安装Axis2的Eclipse插件
?????? (插件在我的附件里有提供)下载Axis2的Eclipse插件,可以在我本文的附件里直接下,或者去官方网站下载http://axis.apache.org/axis2/java/core/tools/index.html
??????? 我选择的是1.4.1的插件,注意官方给的插件包里的版本号还是写着1.3.0,所以需要你解压完成后手动修改文件目录名为1.4.1以及目录中plugin.xml为1.4.1
??????? 安装Eclipse插件因Eclipse版本的不同而有很多种方法,我机器上的MyEclipse的版本是5.5,我的安装方法是:
??????? 解压插件包,将其置于MyEclipse的E:\myeclipse\dropins下面(注意之前的版本号一定要改,不然后续做插件集成的时候会出错)。
??????? 解压完成后,需要做以下的修改操作.
??????? 第一步:从Axis2包的lib目录下拷贝2个文件到你插件Axis2_Codegen_Wizard_1.4.1位置的lib下。例如在我的机器上就需要执行:
??????? cp E:\axis2-1.4.1\lib\backport-util-concurrent-3.1.jar E:\myeclipse\dropins\Axis2_Codegen_Wizard_1.4.1\lib\backport-util-concurrent-3.1.jar
??????? cp E:\axis2-1.4.1\lib\geronimo-stax-api_1.0_spec-1.0.1 E:\myeclipse\dropins\Axis2_Codegen_Wizard_1.4.1\lib\geronimo-stax-api_1.0_spec-1.0.1
??????? 第二步:进入Axis2_Codegen_Wizard_1.4.1,打开plugin.xml,找到runtime文档元素节点末尾前面,加上:
????????
<library name="lib/backport-util-concurrent-3.1.jar"> <export name="*"/> </library> <library name="lib/geronimo-stax-api_1.0_spec-1.0.1"> <export name="*"/> </library>
?
?????? OK,Eclipse插件集成完成。打开你的MyEclipse,点击New->other查看是否出现了如下所示的界面:
??????
?
?
?
?
二:你可以开始快速开发Axis2的Webservice了
???? 1:?新建一个Java web工程,起名为SayHello,在classpath里导入Axis2的所有JAR包
?????2:在src目录下,新建一个SayHello.wsdl文件,并将其修改成如下样式:
?????
?
?
?
????
?
??? 3:开始利用它生成客户端代码
?????? 右键点击src,点击new->other->Axis2 Wizards->Axis2 Code Generator,点击下一步(next):
?????? 选中Generate Java?source from a WSDL file然后继续点击下一步
?????? 在如下所示的界面中,输入你的wsdl所在位置:
??????
?
??????
???????
????? 继续点击下一步,按照如下界面进行配置:
??????
?????
?
?
?? 点击下一步,按照如下所示界面进行配置:
??????
?
???? 然后点击finish即可
???????
????? 4:最后利用它生成服务器端代码
?????? 还是跟刚才一样,选中codeGenerator,一直下一步到如下界面修改下:
??????
?
?
???? 然后下一步直到完成。
???? 当你完成的时候,是不是发现有很多红叉叉?不要紧,那是因为你生成的包名有错误,也算是Axis2插件的问题吧。
????
?
?
??? 如图所示,你生成的文件应该是跟这里面的红叉叉文件一样。不要紧,只需要修改包名即可,去掉最开头的src,就像resources上面的那个包一样。
?
三:发布Webservice服务
??? 拷贝你刚才下的Axis2.war包到tomcat的webapps下面,并启动tomcat,启动后输入http://localhost:8080/axis2,可以看到axis2的欢迎界面。可以进入Administration里,查看当前可用的服务(默认用户名/密码是admin/axis2)
??? 点击new->other-Axis2 Wizards ,不过这里选择的是Service Archiver,点击下一步。
??? 在出现的界面中,安装如下图片配置:
???
?
???
?? 点击下一步:
???????
?
?
????? 配置OK后,继续下一步&下一步:
?????
?
?
??? 继续下一步,然后配置文件输出目录,我选择的是所在工程下新建一个dist目录,让文件输出到该目录下:
???
?????
?
?? 最后点击finish,即可。将工程目录dist文件夹下生成的SayHello.aar拷贝到tomcat的axis2的对应目录下。例如在我的机器上需要拷贝到:E:\apache-tomcat-6.0.28\webapps\axis2\WEB-INF\services目录下面
??? 启动Tomcat,进入Axis2的控制台,查看SayHello的服务是否可用。你会发现它提示你服务错误。这时你需要修改resources目录下面services.xml文件。将它修改成:
???
<parameter name="useOriginalwsdl">true</parameter> 修改成: <parameter name="useOriginalwsdl">false</parameter>
?
? 重新走一次发布流程。这回应该不会有错误了。
?
四:测试Webservice
??? 修改org.example.www.sayhello目录下SayHelloSkeleton类。将SayHello方法修改成这样:
???
public org.example.www.sayhello.SayHelloResponse SayHello( org.example.www.sayhello.SayHello sayHello) { try { SayHelloResponse response = new SayHelloResponse(); response.setOut("Hi," + sayHello.getIn() + ".How are you"); return response; } catch (Exception e) { throw new RuntimeException(e); } }
?
? 然后在org.example.www.sayhello下新建一个SayHelloTest,然后输入以下内容:
?
package org.example.www.sayhello; public class SayHelloTest extends junit.framework.TestCase { public void testSayHello() throws java.lang.Exception { org.example.www.sayhello.SayHelloStub stub = new org.example.www.sayhello.SayHelloStub( "http://localhost:8080/axis2/services/SayHello"); org.example.www.sayhello.SayHelloStub.SayHello sayHello2 = (org.example.www.sayhello.SayHelloStub.SayHello) getTestObject(org.example.www.sayhello.SayHelloStub.SayHello.class); sayHello2.setIn("sweet"); System.out.println(stub.SayHello(sayHello2).getOut()); assertNotNull(stub.SayHello(sayHello2)); } // Create an ADBBean and provide it as the test object public org.apache.axis2.databinding.ADBBean getTestObject( java.lang.Class type) throws java.lang.Exception { return (org.apache.axis2.databinding.ADBBean) type.newInstance(); } }
?
重新走一次发布流程,然后运行这个Junit类,就可以正确查看到结果了。
??????