在Eclipse中创建基于Axis2的web services
本实验的目的是让你尽可能快的创建使用 Axis2 的服务和客户端,我们将使用一个简单的 SayHello 服务并显示给你一些创建和部署它的不同方式,以及了解 Axis2 自带的一些工具,然后我们将看看创建访问这些服务的客户端。
一 . 做好准备
在我们使用 Axis2 构建任何东西之前,我们将需要关注一些家务事。现在你将需要准备好你使用 Axis2 的环境,幸运的是,它只包括一些简单的步骤 :
1. 软件下载准备
Tomcat 下载地址 : http://www.apache.org/dist/tomcat/tomcat-5/v5.5.26/bin/apache-tomcat-5.5.26.zip
Axis2 War 包:
http://apache.mirror.phpchina.com/ws/axis2/1_4/axis2-1.4-war.zip
Axis2 Eclipse plug-in( 代码生成工具和打包工具 ):
http://apache.mirror.phpchina.com/ws/axis2/tools/1_4/axis2-eclipse-service-archiver-wizard-1.4.zip http://apache.mirror.phpchina.com/ws/axis2/tools/1_4/axis2-eclipse-codegen-wizard-1.4.zip
Eclipse+MyEclipse :
可以到官方网站下载 ( 本文为 3.2 + 5.0GA)
2. 安装
1) 首先搭建开发环境,需要将下载到的 Eclipse 解压缩到一个目录 , 然后安装好 MyEclipse
2) 将下载到的 Axis2 的两个插件解压缩到 Eclipse 安装目录下的 plug-in 子目录。
3)然后启动 Eclipse ,并选择“ File->New->Other ”可以找到下面的这些 Wizards, 这些将是本文中用到的很重要的工具。
4) 下面开始搭建 Web Services 的部署环境。将下载的 tomcat 报解压缩到一个目录。完成 web container 的安装。
5) 将 axis2.war 包拷贝到 tomcat 安装目录下的 webapps 目录中。
6) 启动 Tomcat(windows 下为 TOMCA_HOME/bin 中的 startup.bat ; Linux , unix 环境为 startup.sh 文件 ) ,打开浏览器输入并访问 :http://ip:8080/axis2 (或 2 http://localhost:8080/axis 2 )来查看 , 如果能看到下面的页面则说明已经安装完成。
二、进入开发
在开发环境及 Axis2 环境搭建好后,我们便可着手 Web Services 服务以及客户端的开发:
1. 建立要发布的 Web Services
1) 在 Eclispse 中添加一个用户库命名为 axis2 ,将 axis2\lib 下的包均添加进来。
在 “Package Explorer” 窗口空白中单击右键,从右键快捷菜单中选择“ Properties” 菜单,然后在弹出的窗口中如下图示操作,最后在图中 6 所示位置处填入 axis2 中 lib 位置的路径即可;
这一步操作的目的是为了以后工程添加 axis2 所需的 jar 文件方便;
2) 建立一个 JavaProject 命名为 ws ,将 axis2 用户库加入到 build path 中。
3) 现在开始编写要发布的 WebSevice ,在 src 中建包 briup ,建立 Hello 类如下
package briup;
public class Hello {
public String sayHello(String user) {
return "Hello, " + user;
}
}
2. 发布 Web Services
打包要发布的 Service , Eclipse 中 New --> File --> Other --> Axis2 wizards --> Axis2 Services Archiver ,按照向导选择刚建立的类编译后的 class 文件
1) 选择 class 文件目录,注意,不是 java 源文件,而是 classes 目录。
2) 连按两次 “Next>” ,选中 “Generate the service xml automatically” ;
3) 按下一步,输入 service 名称和类名;
4) 按下一步,输入 service 文件的保存路径和文件名,完成。
这里将保存路径设为 C 盘,文件名为 ws ,按完成保存成功。这时侯切换到保存路径会发现新增一文件为 ws.aar ,将其拷贝到 Tomcat 5.5\webapps\axis2\WEB-INF\services 目录下,重新打开 http://localhost:8080/axis2/services/listService 就会发现 AccountService 已经发布成功,现在就可以应用这个 Web 服务了
3. 测试
通过 WSDL 文件生成 CallbackHandler.java 和 AccountServiceStub.java :
1) New --> File --> Other --> Axis2 wizards --> Axis2 Code Generator
2) 选择 Generate Java source code from a WSDL file ,按下一步
3) 按 Browse 选择或输入 wsdl 文件位置,按下一步
到现在为止,我们并未自行编写以及生成 WSDL 文件。当 web service 发布后即可通过访问 http://localhost:8080/axis2/services/ws?wsdl 就可以得到 wsdl 文件。既然如此,我们可以在地址栏中直接输入 URL :
4) 使用默认的配置,按下一步。在弹出的新窗口中,然后选择生成文件的存放路径,完成两个 Java 文件的生成。
5) 在工程目录按 F5 刷新,就可以看到刚生成的文件。如图:
6) 编写服务测试程序 WsTest.java 如下:
package briup;
public class WsTest {
public static void main(String[] args) throws Exception {
WsStub stub= new WsStub( "http://localhost:8080/axis2/services/ws" );
WsStub.SayHello sayHello= new WsStub.SayHello();
sayHello.setUser(