1. 配置 ant 环境
能看到这里的相信这都不是问题,实在不明白的请查阅我 ant 相关文档。
本例 ant 版本:Apache Ant(TM) version 1.9.3。
2. 下载 xfire 工具包
http://xfire.codehaus.org/Download,一般来说下载最新版本就是。
本例 xfire 版本:xfire-1.2.6。
3. 建立 eclipse 项目工程
创建最普通的 Java Project 项目工程即可。
a) 创建 test 测试源码包
b) 创建 lib 三方依赖 jar 目录,并将所有依赖 jar 引入 classpath,
大多数依赖的三方 jar 在 xfire 工具包里面都有。
c) 创建 build.xml,内容如下:
<?xml version="1.0" encoding="UTF-8"?> <project name="XFire-WsGen" basedir="." default="jar"> <property name="src.dir" value="${basedir}/src" /> <property name="lib.dir" value="${basedir}/lib" /> <property name="output.dir" value="${basedir}/output" /> <property name="wsdl.dir" value="http://127.0.0.1/MoneyCenter/services/User?wsdl"/> <property name="package.dir" value="moneycentry.client.usermoney" /> <property name="jar.file" value="${output.dir}/moneycentry-usermoney.jar" /> <path id="mypath"> <fileset file="${lib.dir}/*.jar"> <include name="*.jar" /> </fileset> </path> <target name="clean"> <delete includeEmptyDirs="true"> <fileset dir="${src.dir}" includes="**/*" defaultexcludes="no"/> </delete> <delete dir="${output.dir}"/> </target> <target name="init" depends="clean"> <mkdir dir="${output.dir}" /> </target> <taskdef name="wsgen" classname="org.codehaus.xfire.gen.WsGenTask" classpathref="mypath"></taskdef> <target name="wsgen" depends="init"> <taskdef name='WsGenTask' classname="org.codehaus.xfire.gen.WsGenTask" classpathref="mypath" /> <WsGenTask outputDirectory="${src.dir}" wsdl="${wsdl.dir}" package="${package.dir}" overwrite="true" /> </target> <target name="compile" depends="wsgen"> <copy todir="${output.dir}/classes/META-INF"> <fileset dir="${src.dir}/META-INF"/> </copy> <javac srcdir="${src.dir}" destdir="${output.dir}/classes" debug="true" failonerror="true" classpathref="mypath" /> </target> <target name="jar" depends="compile"> <jar destfile="${jar.file}" basedir="${output.dir}/classes"></jar> </target> </project>
经过整理后的 build.xml 可以做到多项目通用,只需稍作修改
i. wsdl.dir
不同的 webservice,肯定有不同的 wsdl 地址。
ii. package.dir
生成客户端默认 package 名称。
iii. jar.file
生成 jar 文件的 jar 包名称。
d) 项目目录截图
4. 利用 ant 生成客户端代码
右键 build.xml –> Run As –> Ant Build
当看到控制台显示 ant 构建成功的消息,src 下面也生成相关文件,则说明成功。
5. 测试客户端
在 test 源码包下面新建 com.xfire.lynch.MainTest 测试类,介于只是简单测试,就不
搭建 Junit 测试环境,而采用 main 函数测试,看到控制台正常打印出数据,说明调用成功。
6. 代码讲解
UserClient uc = new UserClient();
获取 User 客户端类。
UserPortType upt = uc.getUserHttpPort();
获取 User 服务器端的所有接口方法。
String test = upt.findUserById("123456","dab871c3-cad4-4d2f-846f-235c00a1bcc5");
远程调用 User 类里的 findUserById 方法。
7. 与 spring 集成
大多数应用都是要和 spring 集成,本例只需将每次运行 ant 后,output 目录下生成的
moneycentry-user.jar 和依赖的三方 jar 添加进你的 spring 环境中。在 spring 中定
义一个 bean,需要的时候注入就可以使用了。
<bean id="userClient" class="moneycentry.client.user.UserClient"></bean>
8. 后记感受
Maven:
最近和公司其他系统进行衔接,本来我是个 maven 党,还是个没经历过 ant 时代
的 maven 党。开始使用 eclipse 打包,对面系统的 wsdl 总是不断的变化,无奈之下
只好用 ant 来生成 jar,大大提升了效率。通过学习 ant 对 maven 中的一些理念也有
了新的理解,可见学习一个技术也可从同等技术对比中获益。
Webservice:
第一次使用 ws 技术,不过也不算太复杂。虽然很多大牛都说 ws 是过时的技术,
不过学习来说还是值得的。不知各位看官看到此处理解如何,介于本人文档写作水平有
限,还望多多谅解,也祝大家学习愉快。