使用Axis开发WebService程序

 http://www.blogjava.net/jiangmin/articles/187596.html

一、Axis环境的安装

　　1、安装环境 J2SE SDK 1.4，Tomcat 5.0，eclipse 3.2。

　　2、到Apache网站 http://ws.apache.org/axis网站下载Axis安装包。我下载的是Axis 1.4 Final版，把下载的axis-bin-1_4.zip包解压缩到一个文件夹，可以是任意的，但如果文件夹包含有中文名时，在中间有些过程需要对中文进行一些处理，否则可能出错，我把axis-bin-1_4.zip解压到D:\AXIS_Study，解压后的目录结构式这样的：

             --D:\AXIS_Study

                ----axis-1_4

                     ------docs(文件夹)

                     ------lib(文件夹)

                     ------samples(文件夹)

                     ------webapps(文件夹)

                     ------xmls(文件夹)

                     ------LICENSE

                     ------NOTICES

                     ------README

                     ------release-notes.html

        3、将Axis 1.4安装到Tomcat  Web服务器上

              进入Tomcat目录，在conf目录下新建一个XML文件，命名为axis.xml，然后在文件中输入如下内容：

               <?xml  version="1.0"  encoding="gb2312"?>

               <!--

                    Axis学习工程

                -->

               <Context docBase="D:\AXIS_Study\axis-1_4\webapps\axis">

               </Context>     

               这个axis.xml文件是用来在Tomcat中配置一个Web应用的。

            启动Tomcat。

              进入到Tomcat安装目录下的bin目录，找到startup.bat并执行之

 

         将D:\AXIS_Study\axis-1_4\webapps\目录下的axis文件夹复制到Tomcat的webapps下，然后在浏览器中输入地址http://localhost:8081/axis/（我机子上修改了Tomacat的端口为8081，而默认的端口为8080，所以没有修改端口号的就要用8080），得到的页面为

       

　　3、将Axis相关包文件放在WEB-INF\lib目录下。

　　4、Axis可选的包：activation.jar； mail.jar； xmlsec-1.4.Beta1.jar拷贝到WEB-INF目录下，生成客户端时候需要使用。

　　Axis支持三种web service的部署和开发，分别为：

　　1、Dynamic Invocation Interface （DII）

　　2、Dynamic Proxy方式

　　3、Stubs方式

　　前两种方式我就不介绍了，同事告诉我他们自己都不使用前两种方式，他们建议我们使用Stubs方式，因此我就主要就介绍一下第三种方式。注意，我自己的Java源代码是放在D：\workspace\test\目录下，Axis相关包文件放在D：\workspace\test\WEB-INF目录下。

　　二、编写wsdd发布web服务，编写stub client访问web服务

　　1、编写服务端程序server，SayHello.java，编译server.SayHello.java

package server;
public class SayHello
{
    public String getName(String name)
    {
        return "hello "+name;
    }
}

　　2、编写wsdd文件

　　deploy.wsdd文件内容如下：

<deployment xmlns="http://xml.apache.org/axis/wsdd/" xmlns:java="http://xml.apache.org/axis/wsdd/providers/java">
 <service name="SayHello" provider="java:RPC">
  <parameter name="className" value="server.SayHello.getName"/>
  <parameter name="allowedMethods" value="*"/>
 </service>
</deployment>

　　3、发布服务：

　　编辑一个deploy.bat，Axis_Lib为axis.jar路径。内容如下：

set Axis_Lib=D:\workspace\test\WEB-INF\lib
set Java_Cmd=java -Djava.ext.dirs=%Axis_Lib%
set Axis_Servlet=http://localhost:8080/test/servlet/AxisServlet
%Java_Cmd% org.apache.axis.client.AdminClient -l%Axis_Servlet% deploy.wsdd

　　执行这个批处理文件，这时候，如果提示成功的话，访问http://localhost:8080/test/services 就会显示服务列表。

　　4、生成客户端client stub文件

　　在浏览器上访问服务器端的服务，可以下载到WSDL文件，通过Axis的相关工具，可以自动从WSDL文件中生成Web Service的客户端代码。

　　编写一个WSDL2Java.bat文件，其内容如下：

set Axis_Lib=D:\workspace\test\WEB-INF\lib
set Java_Cmd=java -Djava.ext.dirs=%Axis_Lib%
set Output_Path=D:\workspace\test\src
set Package=server.SayHello
%Java_Cmd% org.apache.axis.wsdl.WSDL2Java -o%Output_Path% -p%Package% SayHello.wsdl

　　执行这个批处理文件就可以生成client stub.

　　生成的stub client文件列表为：SayHello.java，SayHelloService.java，SayHelloServiceLocator.java，SayHelloSoapBindingStub.java .

　　5、编写客户端程序，编译并执行

　　下面是一段junit测试客户端代码。

import java.net.URL;
import junit.framework.Test;
import junit.framework.TestCase;
import junit.framework.TestSuite;

public class TestWSClient extends TestCase {

    public TestWSClient(String string) {
        super(string);
    }

    public void SayHelloClient() throws Exception {

        SayHelloService service = new SayHelloServiceLocator();
        SayHello_PortType client = service.getSayHello() ;
        String retValue = client.getName("clientname");
        System.out.println(retValue);

    }

    public static Test suite() {
        TestSuite suite = new TestSuite();
        suite.addTest(new TestWSClient("SayHelloClient"));
        return suite;
    }
}

　　至此，整个服务器端和客户端的Web Service框架代码就完成了，剩下的就是在里面加入你的业务代码了，怎么样，Web Service并不难开发吧。