Axis1.3技术文档

Axis1.3 技术文档
简介：Axis 本质上就是一个 SOAP 引擎，提供创建服务器端、客户端和网关 SOAP 操作的基本 简介 框架，Axis 目前版本是为 Java 编写的，不过为 C++的版本正在开发中。而在工作中我们可以方 便的通过 Axis 进行 Webservice 的开发。 下面我们就一步一步的来进行 Axis 的开发 1. 2. 从 Axis 的官方网站上下载(https://www.360docs.net/doc/e03352291.html,/axis/).解压缩 axis-bin-1_3.zip。在 lib 中包含 Axis 必须使用的 jar 包。 下载完成之后，安装 axis.( Axis 1.3,tomcat 5.028, jdk 1.42)，复制你的 Axis -bin-1_3 安装包 下 webapps 文件夹中的 axis 目录到 tomcat 的 webapps 下，发布你的 Axis 应用，启用你的 Tomcat，IE 地址栏中输入 http://localhost:8080/axis, 这时就会出现 axis 的欢迎画面.进入 Validation 链接以检查 axis 所使用的 jar 包是否全都存在,如果不存在，就下载那部分不存在 的，下载完后，把下载解压后文件夹中 lib 目录下的.jar 文件复制到 tomcat\webapps\ axis\WEB-INF\lib 目标下，重启 Tomcat，最终如果出现下面的界面，说明安装 axis 成功。 3. 测试 axis a) 新建一 web 项目，名称为 testServiceAxis，把 tomcat\webapps\ axis\WEB-INF\lib 目录 下的所有 jar 包全部复制到 testServiceAxis 项目的 web-inf\lib 目录中去。在 src 目录下 新建一文件去名称为 HelloWorld.jws,里面的代码很简单， 就是一个方法打印一句话， ”Hi, 你好，XXX,欢迎你来到精彩的 axis 世界上。” public class HelloWorld{ public String hello(String name) { if (name == null) { name = ""; } return "Hi,你好 " + name + ",欢迎你来到精彩的 axis 世界上！"; } } 让上面的代码做为服务器端来运行。也就是说，供别个调用的一个服务。 b) 另建一 web 项目，名称为 testClieatAxis，把把 tomcat\webapps\ axis\WEB-INF\lib 目录 下的所有 jar 包全部复制到 testServiceAxis 项目的 web-inf\lib 目录中去。现在我们编写 调用 web service 上的程序，也就是说，我们现在进行两个应用间的通信。在 src 目标 下新建一测试类，名称为 Test.java,代码如下： import https://www.360docs.net/doc/e03352291.html,.MalformedURLException; import java.rmi.RemoteException; import javax.xml.rpc.ServiceException; import org.apache.axis.client.Call; import org.apache.axis.client.Service; public class Test {

/** * @param args */ public static void main(String[] args) { String endpoint = "http://192.168.1.234:" + "8080" + "/testServiceAxis/HelloWorld.jws"; // 以定制发布方式， 如果是 jws 文件，则 endpoint 为相应的 jws 文件 Service service = new Service(); Call call; try { call = (Call) service.createCall(); String str="Fangtengfei"; call.setTargetEndpointAddress(new https://www.360docs.net/doc/e03352291.html,.URL(endpoint)); call.setOperationName("hello"); //object 数组为远程方法的参数 String res = (String) call.invoke(new Object[] { str }); System.out.println(res); } catch (ServiceException e) { e.printStackTrace(); } catch (MalformedURLException e) { e.printStackTrace(); } catch (RemoteException e) { e.printStackTrace(); } } } 最后如果能够进行正常的打印，就说明已经配置成功了，一个最简单的 web 服务,客户 端和服务器端就完成了通信了。 c) 以上的程序把它放到两个程序中的目的就是，为了让用户更容易明白，服务端和客户 端之间的通信，让两者间不混淆。所以把它放在两个项目中来处理，其实放到一个项 目中来测试也是可以的。 d) 4. 在实际 web service 开发中，是绝对没这么简单的，下面让我们来看一下，如何通过 WSDL 的方式进行通信，也即通过可配置的形式进行通信。 通过 WSDL 进行 webservice 的通信： a) 什么是 WSDL(Web Services Description Language): 是一个用来描述 Web 服务和说明 如何与 Web 服务通信的 XML 语言。具体详细内容请参考 https://www.360docs.net/doc/e03352291.html,/ftf_tengfei/archive/2007/09/20/1793221.aspx b) 另介绍一个 Eclispe 的插件，Wsdl 转 java 的插件 https://www.360docs.net/doc/e03352291.html,/wsdl2java.shtml，在此份文档中， 我们转换还是通过 java 命令 来完成。由于要用到相关的 java 命令，我们需要配置相关的系统环境变量： 1) 2) 先要保证 java 系统环境变量没问题，具体内容可参考网上教程。 另要配置 axis 的系统环境变量，主要有以下几个：

AXIS_LIB AXIS_HOME AXISCLASSPATH：%AXIS_LIB%\axis.jar;%AXIS_LIB%\commons-discover y-0.2.jar;%AXIS_LIB%\commons-logging-1.0.4.jar;%AXIS_LIB%\jaxrpc.jar;% AXIS_LIB%\saaj.jar;%AXIS_LIB%\log4j-1.2.8.jar; 注意此目录一定要配置正确，不然等下出现类找不到错误，也就是说，如果出现 classDefFine 的时候，就可来这里找下原因。 c) d) 新键一 web 工程，取名称为 testAxisWSDL,同样需要在项目的 classpath 中加入 axis 文 件夹下的 jar 包 在 src 目录编写一个和上面一样.java 文件，文件名称和内容如下： HelloWorld.java public class HelloWorld{ public String hello(String name) { if (name == null) { name = ""; } return "Hi,你好 " + name + ",欢迎你来到精彩的 axis 世界上！"; } } 编译上述文件，并把他 copy 到 tomcat\webapps\ axis\WEB-INF\classes e) 同在 src 目录下，新建一个 WSDL 文件，取名称 deploy.wsdd HelloWorld.java f) 在 DOS 下转换目录到%TOMCAT_HOME%\webapps\axis\WEB-INF\ classes，命令： java -cp %AXISCLASSPATH% org.apache.axis.client.AdminClient deploy.wsdd 注意执行这个命令的时候，一定要保证 Tomcat 是启动的，否则执行不成功。 g) 最后，回到 testAxisWSDL 项目中，新建一个测试类，名称和内容如下所示： HelloClient.java import org.apache.axis.client.Call; import org.apache.axis.client.Service; public class HelloClient {

public static void main(String[] args) throws Exception { String endpoint = "http://localhost:" + "8080" + "/axis/services/MyService";// 注意！差别仅仅在这里！！ Service service = new Service(); Call call = (Call) service.createCall(); call.setTargetEndpointAddress(new https://www.360docs.net/doc/e03352291.html,.URL(endpoint)); call.setOperationName("hello"); String res = (String) call.invoke(new Object[] {"Fangtengfei"}); System.out.println(res); } } h) 是不是这里的运行结果和刚才上面的运行结果是一样的呢，是的，是完全一样的，只 是我们采用了不同的实现方式，到这里一个入门级别的 axis 就算实现了，是的，确实 到这，就完全实现了。。