WebService大讲堂之Axis22：复合类型数据的传递

在实际的应用中，不仅需要使用 WebService 来传递简单类型的数据，有时也需要传递更复杂的数据，这些数据可以被称为复合类型的数据。数组与类（接口）是比较常用的复合类型。在 Axis2 中可以直接使用将 方法的参数或返回值类型声明成数组或类（接口）。但要注意，在定义数组类型时只能使用一维数组，如果想传递多维数组，可以使用分隔符进行分隔，如下面的代码所示：

String[] strArray = new String[] { " 自行车,飞机,火箭"," 中国,美国,德国"," 超人,蜘蛛侠,钢铁侠" } ;

     上面的代码可以看作是一个3*3 的二维数组。

     在传递类的对象实例时，除了直接将数组类型声明成相应的类或接口，也可以将对象实例进行序列化，也就是说，将一个对象实例转换成字节数组进行传递，然后接收方再进行反序列化，还原这个对象实例。

     下面的示例代码演示了如何传递数组与类（接口）类型的数据，并演示如何使用字节数组上传图像。本示例的客户端代码使用Java 和C# 编写。要完成这个例子需要如下几步：

一、实现服务端代码

    ComplexTypeService 是一个WebService 类，该类的代码如下：

import  java.io.FileOutputStream;
 data.DataForm;

public   class  ComplexTypeService
{
     //   上传图像，imageByte参数表示上传图像文件的字节，
       length参数表示图像文件的字节长度（该参数值可能小于imageByte的数组长度）
     boolean  uploadImageWithByte( byte [] imageByte,  int  length)
    {
        FileOutputStream fos  = null ;
         try
        {
               将上传的图像保存在D盘的test1.jpg文件中             fos  new  FileOutputStream( " d:\\test1.jpg );
               开始写入图像文件的字节             fos.write(imageByte,0)">0 , length);
            fos.close();
        }
         catch  (Exception e)
        {
             return false ;
        }
         finally if  (fos  != )
            {
                
                {
                    fos.close();
                }
                  (Exception e)
                {

                }
            }
        }
         true ;
    }
       返回一维字符串数组  String[] getArray()
    {
        String[] strArray   String[]{  自行车 飞机 火箭  };
          strArray;
    } 
       返回二维字符串数组  String[] getMDArray()
    {
        String[] strArray  自行车,飞机,火箭 中国,美国,德国 超人,蜘蛛侠,钢铁侠  } ;
          strArray;
    }
       返回DataForm类的对象实例  DataForm getDataForm()
    {
          DataForm();
    }
       将DataForm类的对象实例序列化，并返回序列化后的字节数组 [] getDataFormBytes()  throws  Exception 
    {
        java.io.ByteArrayOutputStream baos   java.io.ByteArrayOutputStream();
        java.io.ObjectOutputStream oos   java.io.ObjectOutputStream(baos);
        oos.writeObject(  DataForm());        
          baos.toByteArray();
    }    
}

 

二、实现DataForm类

    DataForm 是要返回的对象实例所对应的类，该类的实现代码如下： 

package  data;

 DataForm  implements  java.io.Serializable
{
     private  String name  bill ;
      age  20 ;

      String getName()
    {
          name;
    }
     void  setName(String name)
    {
         this .name   getAge()
    {
          age;
    }
      setAge(  age)
    {
         .age   age;
    }
}

三、发布WebService

     由于本示例的WebService 类使用了一个Java 类（DataForm 类），因此，在发布WebService 之前，需要先将DataForm.class 文件复制到<Tomcat 安装目录>\webapps\axis2\WEB-INF\classes\data 目录中，然后将ComplexTypeService.class 文件复制到<Tomcat 安装目录>\webapps\axis2\WEB-INF\pojo 目录中，最后启动Tomcat （如果Tomcat 已经启动，由于增加了一个DataForm 类，因此，需要重新启动Tomcat ）。

四、使用Java编写调用WebService的客户端代码

     在客户端仍然使用了RPC 的调用方式，代码如下：

 client;

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

 ComplexTypeRPcclient
{

     static  main(String[] args)   Exception
    {
        RPCServiceClient serviceClient   RPCServiceClient();
        Options options   serviceClient.getoptions();
        EndpointReference targetEPR   EndpointReference(
                 http://localhost:8080/axis2/services/ComplexTypeService );
        options.setTo(targetEPR);
          下面的代码调用uploadImageWithByte方法上传图像文件          //////////////////////////////////////// /
          打开图像文件，确定图像文件的大小         java.io.File file   java.io.File( f:\\images.jpg );
        java.io.FileInputStream fis   java.io.FileInputStream( );
          创建保存要上传的图像文件内容的字节数组 [] buffer  [( ) file.length()];
          将图像文件的内容读取buffer数组中  n   fis.read(buffer);
        System.out.println( 文件长度： +  file.length());
        Object[] opAddEntryArgs   Object[]{ buffer, n };
        Class[] classes   Class[]{ Boolean.  };
        QName opAddEntry   QName( http://ws.apache.org/axis2 uploadImageWithByte );
        fis.close();
          开始上传图像文件，并输出uploadImageWithByte方法的返回传         System.out.println(serviceClient.invokeBlocking(opAddEntry,opAddEntryArgs, classes)[ ]);
         /
        
          下面的代码调用了getArray方法，并返回一维String数组 /           opAddEntry  getArray );
        String[] strArray   (String[]) serviceClient.invokeBlocking(opAddEntry,255)">
                            new  Object[]{},0)"> Class[]{String[].  })[ ];
         for  (String s : strArray)
            System.out.print(s     );
        System.out.println();
         / 
        

          下面的代码调用了getMDArray方法，并返回一维String数组 getMDArray );
        strArray 
                                                          new })[  (String s : strArray)
        {
            String[] array   s.split( (String ss: array)
                System.out.print( <  ss  >  );
            System.out.println();
        }
        System.out.println();
         / 

          下面的代码调用了getDataForm方法，并返回DataForm对象实例 getDataForm );
        data.DataForm df   (data.DataForm) serviceClient.invokeBlocking(opAddEntry,
                                                                    Class[]{data.DataForm. ];
        System.out.println(df.getAge());
          下面的代码调用了getDataFormBytes方法，并返回字节数组，最后将返回的字节数组反序列化后，转换成DataForm对象实例 /           getDataFormBytes );
        buffer   ( []) serviceClient.invokeBlocking(opAddEntry,0)"> Class[]{ []. ];
        java.io.ObjectInputStream ois   java.io.ObjectInputStream(
                  java.io.ByteArrayInputStream(buffer));
        df   (data.DataForm) ois.readobject();
        System.out.println(df.getName());
         //////////////////////////////////////////
    }
}

     运行上面的程序，将输出如下的内容：

3617

true

自行车 飞机 火箭 

>

中国 美国 德国 超人 蜘蛛侠 钢铁侠

bill

五、使用C#编写调用WebService的客户端代码

     在Visual Studio 中使用WebService 就简单得多。假设引用WebService 时的引用名为complexType ，则下面的代码调用了uploadImageWithByte 方法来上传图像文件。在Visual Studio 引用WebService 时，uploadImageWithByte 方法多了两个out 参数，在使用时要注意。

complexType.ComplexTypeService cts   WSC.complexType.ComplexTypeService();
System.IO.FileStream fs   System.IO.FileStream( @" f:\images.jpg stem.IO.FileMode.Open);
[fs.Length];
fs.Read(buffer, ( )fs.Length);
bool  r;
 rs;
cts.uploadImageWithByte( buffer,0)">)fs.Length,255)">out  r,0)"> rs);

     在获得二维数组时，可以将数据加载到DataGridView 或其他类似的控件中，代码如下：

String[] strArray   cts.getMDArray();
 i  ; i   strArray.Length; i ++ )
{
       用正则表达式将带分隔符的字符串转换成String数组     String[] columns   strArray[i].Split( ' );
       如果DataGridView的表头不存在，向DataGridView控件添加三个带表头的列  (dataGridView1.Columns.Count  == )
          j  ; j   columns.Length; j )
            dataGridView1.Columns.Add( column  (j  1 ).ToString(),0)">列 ).ToString());
       添加行     dataGridView1.Rows.Add( ( )
    {
        dataGridView1.Rows[i].Cells[j].Value   columns[j];                       
    }                
}

     向DataGridView 控件添加数据后的效果如图1 所示。

图1  

     对于其他的WebService 方法的调用都非常简单，读者可以自己做这个实验。

     要注意的是，由于.net 和java 序列化和反序列化的差异，通过序列化的方式传递对象实例只使用于客户端与服务端为同一种语言或技术的情况，如客户端和服务端都使用Java 来编写。

    如果读者要上传大文件，应尽量使用FTP的方式来传递，而只通过WebService方法来传递文件名等信息。这样有助于提高传输效率。

本文出自 “李宁的极客世界” 博客，请务必保留此出处http://www.voidcn.com/article/p-fllmhdtr-bkp.html