用Axis和SOAP开发基于JAX-RPC的Web服务（2）

清单1：Order类

package sample;

public class Order {

  // ID for order

  private String orderID = null;

  // date of order

  private String orderDate= null;

  // getter methodspublic String getOrderID() {

            return orderID;

  }

 public String getOrderID() {

        return orderID;

  }

  // setter methods

  public void setOrderID(String orderID) {

              this.orderID = orderID;

  } public void setOrderDate(String orderDate) {

                this. orderDate = orderDate;

  }

}

清单2：Order类相应的Holder类

// Note that holder class is in the holders package and its name

// is derived by adding Holder as a suffix to ''Order'', as per

// the JAX-RPC specification.

package sample.holders;

public class OrderHolder {

  // Order''s object

  public Order  value = null;

  // default constructor

  public void OrderHolder () { }

  // constructor, which takes value as a parameter

  public void OrderHolder (Order value) {

         this.value=value;

  }

}

现在，我们来开发具有上述功能的Web服务。清单3给出了相应的代码。

清单3：订单处理Web服务

package sample;

public class OrderProcessingService {

  // Method 1: processes a order given ID as input and

  // return status and Order object as an OUT parameter

  public String processOrder(String orderID,

                             OrderHolder orderHolder ) {

                             String status = "pending";

    // perform business logic here

    // for simplicity just filling the Order object

    Order order = new Order();

    order.setOrderID(orderID);

    order.setOrderDate("03 March 2003");

    // set the Holder value to the order.

    orderHolder.value = order;

    //set the status

    status = "complete" ;

    return status;

  }

  // Method 2: updates a order given Order as an INOUT

  // parameter and returns status.

  public String updateOrder(OrderHolder orderHolder) {

                            String status = "pending";

    // perform update here

    Order order = orderHolder.value;

    order.setOrderDate("03 April 2003");

    // Note that orderID is not changed.

    // It will be same as the passed one.

    // set the Holder value to the order.

    orderHolder.value = order;

    //set the status

     status = "complete" ;

    return status;

  }

}

至此，我们已经完成Web服务的开发，下一步就是编译，把它部署到Tomcat-Axis平台上去。编译后，我们需要用部署描述文件把上述的Web服务部署到Tomcat-Axis。

清单4：部署文件deploy.wsdd

  xmlns:java="http://xml.apache.org/Axis/wsdd/providers/java">

             value="sample.OrderProcessingService "/>

上述的部署描述文件实际上是让服务器知道有关该Web服务的一些信息，例如公开的方法，期望的参数以及返回值类型等。部署OrderProcessingService，我们需要传递参数“deploy.wsdd”，调用Axis admin服务。运行在同一服务器上的admin服务将处理描述文件，部署该Web服务，至此，它可以被客户端调用了。

在与deploy.wsdd文件相同的目录下运行下列命令：

java -cp %AxisCLASSPATH% org.apache.Axis.client.AdminClient

-lhttp://localhost:8080/Axis/services/AdminService deploy.wsdd

其中，AxisCLASSPATH用于设置Axis环境（详情请参考Axis/" target=new>Axis installation guide）。

可以通过下面的地址来访问OrderProcessing服务：http://://.

对我们的示例来说，地址如下：

Axis/services/OrderProcessing">http://localhost:8080/Axis/services/OrderProcessing

2. Web服务OrderProcessing的客户端

动态客户端

动态客户端类似于用反射APIs（reflection APIs）查找，调用Java类的方法.

这里，所有的信息，例如目标端点（target endpoint），方法参数等等都必须明确的设定。清单5所列出的代码展示了怎样编写一个调用Web服务OrderProcessing的updateOrder方法的动态客户端。

清单5：动态客户端

package sample.client;

import org.apache.Axis.client.Call;

import org.apache.Axis.client.Service;

import org.apache.Axis.encoding.XMLType;

import javax.xml.RPC.ParameterMode;

import javax.xml.RPC.encoding.*;

import javax.xml.namespace.QName;

import java.util.*;

import sample.*;

/**

 * This class illustrates how to use the JAX-RPC API to invoke

 * the Order Processing Web service dynamically

 */

public class DynamicClient {

  public static void main(String[] args) throws Exception {

  // create service factory

  ServiceFactory factory = ServiceFactory.newInstance();

  // define qnames

  String targetNamespace = "OrderProcessingService";

  QName serviceName = new QName(targetNamespace,

                                "OrderProcessingService");

  QName portName = new QName(targetNamespace,

                             "OrderProcessingService");

  QName operationName = new QName(targetNamespace, "updateOrder");

  // create service

  Service service = new Service();

  Call     call   = (Call) service.createCall();

   Qname qn       = new Qname(targetNamespace, "OrderHolder");

  call.registerTypeMapping(OrderHolder.class, qn,

  new org.apache.Axis.encoding.ser.BeanSerializerFactory

      (OrderHolder.class, qn),

  new org.apache.Axis.encoding.ser.BeanDeserializerFactory

      (TicketHolder.class, qn));

  // set port and operation name

  call.setPortTypeName(portName);

  call.setOperationName(operationName);

  // add parameters

  call.addParameter( "arg1", serviceName, ParameterMode.INOUT );

  call.setReturnType( XMLType.XSD_STRING );

  Order order = new Order ();

  order.setOrderID("Order001");

  order.setOrderDate("03 March 2003");

  // set end point address

  call.setTargetEndpointAddress(

       "http://localhost:8080/Axis/services/OrderProcessing");

  // Invoke the WebService

  String result = (String) call.invoke( new Object[] { order } );

  System.out.println("result : " +result);

  Map outparams = call.getOutputParams();

  System.out.println("Got the outparams");

}

3. 运行客户端

用下列命令运行客户端：

java -cp %AxisCLASSPATH% sample.client.DynamicClient

结果如下：

得到输出参数（如在开发客户端时所提到的一样）。

4. 结论

本文试图揭开Web服务的神秘面纱，表达一种使用Apache开放源代码的Axis工具开发基于JAX-RPC的Web服务是多么的简单和经济适用。该文还详细阐述了一种“怎样开发”基于JAX-RPC的Web服务的方式。这种开发方式给开发者充分的自由去编写Web服务和客户端，隐藏了以有线XML（on-the-wire XML）格式序列化对象的所有复杂细节。对开发人员来说，它看起来只不过是Java方法调用。本文系列的下一部分，我将讲解Web服务的其他方法和技术。

5. 参考资料

l http://jakarta.apache.org/tomcat/index.html

l Axis/" target=new>http://ws.apache.org/Axis/

l JAXRPC" target=new>http://java.sun.com/xml/JAXRPC