Java实现调用WebService的客户端程序

WebService是为程序服务的，只在浏览器中访问WebService是没有意义的。因此，在本节使用Java实现了一个控制台程序来调用上一节发布的WebService。调用WebService的客户端代码如下：

package client;

import javax.xml.namespace.QName;
import org.apache.axis2.addressing.EndpointReference;
import org.apache.axis2.client.Options;
import org.apache.axis2.rpc.client.RPCServiceClient;

public class RPCClient
{
    public static void main(String[] args) throws Exception  
     {
        // 使用RPC方式调用WebService        
        RPCServiceClient serviceClient = new RPCServiceClient();
        Options options = serviceClient.getOptions();

        // 指定调用WebService的URL
        EndpointReference targetEPR = new EndpointReference( "http://localhost:8080/Service/services/Hello");
        options.setTo(targetEPR);

        // 指定example方法的参数值；传递给服务器的参数，来设定需要传送的值
        Object[] opAddEntryArgs = new Object[] {"Clarck"};

        // 指定example方法返回值的数据类型的Class对象；服务器返回给客户端的值的类型
        Class[] classes = new Class[] {String.class};


        // 指定要调用的example方法及WSDL文件的命名空间
        QName opAddEntry = new QName("http://test.clarck.org/axis2", "example");
        // 调用example方法并输出该方法的返回值；获取返回结果[qName,values,returnType]
        System.out.println(serviceClient.invokeBlocking(opAddEntry, opAddEntryArgs, classes)[0]);
          




        // 下面是调用getUser方法的代码，这些代码与调用example方法的代码类似
        classes = new Class[] {Users.class};
        opAddEntry = new QName("http://test.clarck.org/axis2", "getUser");
        
        Users users = (Users)serviceClient.invokeBlocking(opAddEntry, new Object[]{}, classes)[0];
        System.out.println(users.getName());

}

运行上面的程序后，将在控制台输出如下的信息：

你好 Clarck
clarck

    在编写客户端代码时应注意如下几点：

    1. 客户端代码需要引用很多Axis2的jar包，如果读者不太清楚要引用哪个jar包，可以在Eclipse的工程中引用Axis2发行包的lib目录中的所有jar包。

    2. 在本例中使用了RPCServiceClient类的invokeBlocking方法调用了WebService中的方法。invokeBlocking方法有三个参数，其中第一个参数的类型是QName对象，表示要调用的方法名；第二个参数表示要调用的WebService方法的参数值，参数类型为Object[]；第三个参数表示WebService方法的返回值类型的Class对象，参数类型为Class[]。当方法没有参数时，invokeBlocking方法的第二个参数值不能是null，而要使用new Object[]{}。

    3. 如果被调用的WebService方法没有返回值，应使用RPCServiceClient类的invokeRobust方法，该方法只有两个参数，它们的含义与invokeBlocking方法的前两个参数的含义相同。

    4. 在创建QName对象时，QName类的构造方法的第一个参数表示WSDL文件的命名空间名，也就是<wsdl:definitions>元素的targetNamespace属性值，下面是SimpleService类生成的WSDL文件的代码片段：