webservice之axis介绍1

Axis全称Apache eXtensible Interaction System，是apache组织下的一个开源项目，用来做webservice开发的，有java版的实现，也有c++版的实现，其前身最早是IBM的SOAP4J，后来捐给Apache后改名Apache SOAP，也就是支持SOAP1.1的那个版本，到现在的AXIS已经是第三代了，AXIS对Apache SOAP的改进有很多，比如用SAX代替以前的DOM，增加对WSDL的支持，支持SOAP1.2等等

使用axis很easy，在apache网站上把axis下载了后（最新版本1.2.1)，把%AXIS_HOME%\webapps\axis整个目录copy到tomcat的webapps目录下面，启动tomcat，浏览器中输入http://localhost:8080/axis就可以了

上面说的只是axis运行起来了，要想布置自己的webservice，axis支持两种方法：一种是用JWS（Java Web Service)，好处是只要有源码比如说Hello.java,把他改成Hello.jws后放到%TOMCAT_HOME%\webapps\axis目录下面就搞定，浏览器里面输入http://localhost:8080/axis/Hello.jws就可以了，不足的地方是能配置的地方有限（比如说Hello.java里面的所有public非static方法都会暴露），很多东西没办法弄；第二种方法就是使用wsdd(web service deploy description)，这个就是在TOMCAT_HOME%\webapps\axis\WEB-INF目录下写一个deploy.wsdd和undeploy.wsdd文件，然后通过java org.apache.axis.client.AdminClient deploy.wsdd就搞定了，卸载这个webservice就用org.apache.axis.client.AdminClient undeploy.wsdd，客户端输入http://localhost:8080/axis/services/Hello就可以了

介绍了部署webservice的两种方法后，下面说说客户端的访问方式，也有两种，一种是通过axis实现的java里面的JAX-RPC进行动态调用，另外一种就是通过服务器端产生的wsdl文件利用WSDL2Java工具生成Client Stub后访问。通过JAX-RPC的比较简单，需要提供的有SOAP router URL，service namespace，operation name，operation parameter types，operation return types，看看下面这个例子就明白了：

    public SOAPWrapper() {
        String location = "http://localhost:8080/axis/services/BookService";
        try {
            Service service = new Service();
            call = (Call)service.createCall();
            call.setTargetEndpointAddress(new url(/location));
        } catch (Throwable t) {
            handleError("SOAPWrapper (constructor) had an Exception.",t);
        }
    }

    public void create(Book book) {
        try {
            call.removeAllParameters();
            call.setOperationName("create");
            call.addParameter("arg1",qn,ParameterMode.IN);
            call.setReturnType(XMLType.AXIS_VOID);
            call.invoke(new Object[] {book});
            return;
        } catch (Throwable t) {
            handleError("SOAPWrapper (create) had an Exception.",t);
            return;
        }
       
    }

程序中的Call和Service是对JAX-RPC中Call和Service的具体实现：org.apache.axis.client.Call implements javax.xml.rpc.Call，org.apache.axis.client.Service implements javax.xml.rpc.Service

第二种客户端的方法就是利用WSDL2Java产生Client stub后通过stub调用，WSDL2Java的操作对象是service所对应的wsdl文件，这个文件怎么产生呢？一种方法前面是由axis自动产生，如前面服务器端的配置所说，无论通过jws或是wsdd的方式，axis都会产生相应的wsdl；还有一种方式就是利用Java2WSDL对java源文件进行操作也可以产生相应的wsdl文件。

Trackback: http://tb.blog.csdn.net/TrackBack.aspx?PostId=1546269