TOMCAT+AXIS进行WEBSERVICE开发的配置和HELLOWORLD程序.doc

TOMCAT+AXIS进行WEBSERVICE开发的配置和HELLOWORLD程序Axis框架来自 Apache 开放源代码组织，它是基于JAVA语言的最新的 SOAP 规范（SOAP 1.2）和 SOAP with Attachments 规范（来自 Apache Group ）的开放源代码实现。有很多流行的开发工具都使用AXIS作为其实现支持Web服务的功能，例如JBuilder以及著名的Eclipse J2EE插件Lomboz。它能与众多服务器如TOMCAT、WEBLOGIC等相集成。它是以Servlet的方式运行的，而服务器的作用相当于Servlet容器(Container)，因此只要配置得当，就可以使Axis在支持servelet2.2以上的环境中运行。AXIS的最新版本是1.2，可以从/axis/index.html下载软件包。1.TOMCAT+AXIS的安装配置首先机子上应该安装JDK1.4版本以上（带有XML解析包）。我这里是1.4.2从APACHE的官方网站（）下载TOMCAT安装软件。下载版本要在4.0以上。这里用的是4.1.30版本。安装完后，启动TOMCAT,访问http:/localhost:port/(port为端口号)，安装成功应该出现Apache启动页面。以下用TOMCAT_HOME表示TOMCAT的安装主目录。解压缩AXIS软件包（这里为1.2版本）。我这里是解压缩到C：axis-bin-1_2_1。把C：axis-bin-1_2_1axis-1_2_1webappsaxis文件夹复制到TOMCAT_HOMEwebapps文件夹下面。重新启动TOMCAT，访问http:/localhost:port/axis/，出现Apache-Axis启动页面。点击链接Validation进入页面。上面会显示已经找到的jar包和未找到的jar包。对于未找到的jar包。可以从它提示的链接中下载。我这里在可选组件（optional components）中提示缺少xml-security包。从它提示的地址下载软件包后，解压缩后在lib文件夹下，将xalan.jar和xmlsec-1.2.1.jar复制到TOMCAT_HOMEwebappsaxisWEB-INFlib下。重新启动TOMCAT，再点击链接Validation进入页面后。将没有未找到包的提示了。接下来配置类路径。右键点击我的电脑属性高级环境变量。在系统变量中选择ClassPath进行编辑。增加下列类路径（以“;”我间隔符）。TOMCAT_HOMEwebappsaxisWEB-INFlibaxis.jarTOMCAT_HOMEwebappsaxisWEB-INFlibcommons-discovery-0.2.jarTOMCAT_HOMEwebappsaxisWEB-INFlibjaxrpc.jarTOMCAT_HOMEwebappsaxisWEB-INFlibsaaj.jarTOMCAT_HOMEwebappsaxisWEB-INFlibwsdl4j-1.5.1.jarTOMCAT_HOMEwebappsaxisWEB-INFlibcommons-logging-1.0.4.jar以上几个为 必须设置的类路径。否则不能运行web service。以下几个可以选择设置。TOMCAT_HOMEwebappsaxisWEB-INFlibaxis-ant.jar（使用ANT）TOMCAT_HOMEwebappsaxisWEB-INFliblog4j-1.2.8.jar(使用log4j)TOMCAT_HOMEwebappsaxisWEB-INFlibxalan.jar（对XML进行加密）TOMCAT_HOMEwebappsaxisWEB-INFlib xmlsec-1.2.1.jar（对XML进行加密）TOMCAT_HOME commonlibmail.jar（带附件的soap消息）TOMCAT_HOME commonlibactivation.jar（带附件的soap消息）到此为止基本设置完成。下面介绍和分析HelloWorld程序。HelloWorld程序下面以一个HelloWorld程序试验一下配置是否成功，同时也了解一下web service的程序。SOAP分为两种通信模型，一种是SOAP RPC（远程过程调用），一种SOAP MESSAGING（消息交换）。HelloWorld程序是属于SOAP RPC。即由客户端发出请求，调用服务器端的程序。并返回结果。首先编写HelloWorldService.jws文件保存到TOMCAT_HOMEwebappsaxis下。public class HelloWorldService private final static String sGreeting= Hello World! ;public String getMessage() return(sGreeting) ; 启动TOMCAT，浏览器输入http:/localhost:8080/axis/HelloWorldService.jws?wsdl会出现wsdl页面。说明可以提供正常服务了。现在可以制作客户端了程序了，请先在你的C:下建一个资料夹叫做 prj 或是任何名称也可以，然后打开你的MS-DOS模式 , 先进入c:prj下面输入 ：java org.apache.axis.wsdl.WSDL2Java verbose http:/localhost:8080/axis/HelloWorldService.jws?wsdl如果你看到这样的画面就表示正常运作并自动产生四个的档案了,如果出现org/apache/.CLASS NOT FOUND之类的话可能你的ClASSPATH设置的有问题。在C:prjlocalhostaxisHelloWorldService_jws下面产生以下四个文件HelloWorldService.javaHelloWorldServiceService.javaHelloWorldServiceServiceLocator.javaHelloWorldServiceSoapBindingStub.java接下来我们就要写一个client.java简单的程序来存取这个WebService,当然这只是一个范例,可以用Swing等作更漂亮的图形接口用editor写如下的程序代码,文件名为client.javapackage localhost.axis.HelloWorldService_jws;import java.lang.*;public class client public static void main(String args) throws Exception HelloWorldServiceServiceLocator Service=new HelloWorldServiceServiceLocator(); HelloWorldService port=Service.getHelloWorldService(); String response=port.getMessage(); System.out.println(response); 写好之后放在C:prjlocalhostaxisHelloWorldService_jws下面。启动服务器。然后在C:prjlocalhostaxisHelloWorldService_jws下面执行 javac *.java 将其编译成class文件之后退到 c:prj 下面执行 ：java localhost.axis.HelloWorldService_jws.client正常的话将出现Hello World!通过分析可以看出HelloWorldService.java和HelloWorldServiceService.java是两个接口文件。负责调用远程方法的是HelloWorldServiceSoapBindingStub.java文件。编程的时候不用涉及SOAP消息的封装。Axis软件包中自带的例子的运行Axis软件包中samples文件夹下面有一些应用的例子。分析这些例子能较快熟悉Axis的应用。同时docs文件夹下的apidoc文件夹下有API文档。以jaxprc为例说明运行过程。1 设置类路径。（见第一节）2 启动服务器，这里采用上面配置好的TOMCAT（说明中采用Axis包中自带的服务器，这样得重新设置类路径）。3 在MS-DOS窗口中进入samples的子目录。这里是。samp