WebService之Axis2快速入门(2): 传递复合类型的数据

时间  2019-11-11
标签 webservice axis2 axis 快速 入门 传递 复合 类型 数据 栏目 WebService 繁體版
原文   原文链接

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

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

上面的代码能够看做是一个3*3的二维数组。 web

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

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

1、实现服务端代码 数组

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

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
import java.io.FileOutputStream;
import data.DataForm;
public class ComplexTypeService {
    //  上传图像，imageByte参数表示上传图像文件的字节，
    //  length参数表示图像文件的字节长度（该参数值可能小于imageByte的数组长度）
    public boolean uploadImageWithByte(byte[] imageByte, int length) {
        FileOutputStream fos = null;
        try {
            //  将上传的图像保存在D盘的test1.jpg文件中
            fos = new FileOutputStream("d:\\test1.jpg");
            //  开始写入图像文件的字节
            fos.write(imageByte, 0, length);
            fos.close();
        } catch (Exception e) {
            return false;
        } finally {
            if (fos != null) {
                try {
                    fos.close();
                } catch (Exception e) {
                }
            }
        }
        return true;
    }
    //  返回一维字符串数组
    public String[] getArray() {
        String[] strArray = new String[]{"自行车", "飞机", "火箭"};
        return strArray;
    }
    //  返回二维字符串数组
    public String[] getMDArray() {
        String[] strArray = new String[]{"自行车,飞机,火箭", "中国,美国,德国", "超人,蜘蛛侠,钢铁侠"};
        return strArray;
    }
    //  返回DataForm类的对象实例
    public DataForm getDataForm() {
        return new DataForm();
    }
    //  将DataForm类的对象实例序列化，并返回序列化后的字节数组
    public byte[] getDataFormBytes() throws Exception {
        java.io.ByteArrayOutputStream baos = new java.io.ByteArrayOutputStream();
        java.io.ObjectOutputStream oos = new java.io.ObjectOutputStream(baos);
        oos.writeObject(new DataForm());
        return baos.toByteArray();
    }
}

2、实现DataForm类 webapp

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

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
package data;
public class DataForm implements java.io.Serializable {
    private String name = "bill";
    private int age = 20;
    public String getName() {
        return name;
    }
    public void setName(String name) {
        this.name = name;
    }
    public int getAge() {
        return age;
    }
    public void setAge(int age) {
        this.age = age;
    }
}

3、发布WebService spa

因为本示例的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）。 .net

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

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

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
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 ComplexTypeRPCClient {
    public static void main(String[] args) throws Exception {
        RPCServiceClient serviceClient = new RPCServiceClient();
        Options options = serviceClient.getOptions();
        EndpointReference targetEPR = new EndpointReference(
                "http://localhost:8080/axis2/services/ComplexTypeService");
        options.setTo(targetEPR);
        // 下面的代码调用uploadImageWithByte方法上传图像文件
        /////////////////////////////////////////
        // 打开图像文件，肯定图像文件的大小
        java.io.File file = new java.io.File("f:\\images.jpg");
        java.io.FileInputStream fis = new java.io.FileInputStream("f:\\images.jpg");
        // 建立保存要上传的图像文件内容的字节数组
        byte[] buffer = new byte[(int) file.length()];
        // 将图像文件的内容读取buffer数组中
        int n = fis.read(buffer);
        System.out.println("文件长度：" + file.length());
        Object[] opAddEntryArgs = new Object[]{buffer, n};
        Class[] classes = new Class[]{Boolean.class};
        QName opAddEntry = new QName("http://ws.apache.org/axis2","uploadImageWithByte");
        fis.close();
        // 开始上传图像文件，并输出uploadImageWithByte方法的返回传
        System.out.println(serviceClient.invokeBlocking(opAddEntry, opAddEntryArgs, classes)[0]);
        /////////////////////////////////////////
        // 下面的代码调用了getArray方法，并返回一维String数组
        /////////////////////////////////////////
        opAddEntry = new QName("http://ws.apache.org/axis2", "getArray");
        String[] strArray = (String[]) serviceClient.invokeBlocking(opAddEntry,
                new Object[]{}, new Class[]{String[].class})[0];
        for (String s : strArray)
            System.out.print(s + "  ");
        System.out.println();
        /////////////////////////////////////////
        // 下面的代码调用了getMDArray方法，并返回一维String数组
        /////////////////////////////////////////
        opAddEntry = new QName("http://ws.apache.org/axis2", "getMDArray");
        strArray = (String[]) serviceClient.invokeBlocking(opAddEntry, new Object[]{},
                new Class[]{String[].class})[0];
        for (String s : strArray) {
            String[] array = s.split(",");
            for (String ss : array)
                System.out.print("<" + ss + "> ");
            System.out.println();
        }
        System.out.println();
        /////////////////////////////////////////
        // 下面的代码调用了getDataForm方法，并返回DataForm对象实例
        /////////////////////////////////////////
        opAddEntry = new QName("http://ws.apache.org/axis2", "getDataForm");
        data.DataForm df = (data.DataForm) serviceClient.invokeBlocking(opAddEntry, newObject[]{},
                new Class[]{data.DataForm.class})[0];
        System.out.println(df.getAge());
        /////////////////////////////////////////
        // 下面的代码调用了getDataFormBytes方法，并返回字节数组，最后将返回的字节数组反序列化后，转换成DataForm对象实例
        /////////////////////////////////////////     
        opAddEntry = new QName("http://ws.apache.org/axis2", "getDataFormBytes");
        buffer = (byte[]) serviceClient.invokeBlocking(opAddEntry, new Object[]{}, newClass[]{byte[].class})[0];
        java.io.ObjectInputStream ois = new java.io.ObjectInputStream(
                new java.io.ByteArrayInputStream(buffer));
        df = (data.DataForm) ois.readObject();
        System.out.println(df.getName());
        //////////////////////////////////////////
    }
}

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

1
2
3
4
5
6
7
8
文件长度：3617
true
自行车 飞机 火箭
<自行车> <飞机> <火箭>
<中国> <美国> <德国>
<超人> <蜘蛛侠> <钢铁侠>
20
bill

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

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

1
2
3
4
5
6
7
complexType.ComplexTypeService cts = new WSC.complexType.ComplexTypeService();
System.IO.FileStream fs = new System.IO.FileStream(@"f:\images.jpg", System.IO.FileMode.Open);
byte[] buffer = new byte[fs.Length];
fs.Read(buffer, 0, (int)fs.Length);
bool r;
bool rs;
cts.uploadImageWithByte( buffer, (int)fs.Length, true, out r, out rs);

在得到二维数组时，能够将数据加载到DataGridView或其余相似的控件中，代码以下：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
String[] strArray = cts.getMDArray();
for (int i = 0; i < strArray.Length; i++)
{
    //  用正则表达式将带分隔符的字符串转换成String数组
    String[] columns = strArray[i].Split(',');
    //  若是DataGridView的表头不存在，向DataGridView控件添加三个带表头的列
    if (dataGridView1.Columns.Count == 0)
        for (int j = 0; j < columns.Length; j++)
            dataGridView1.Columns.Add("column" + (j + 1).ToString(), "列" + (j + 1).ToString());
    //  添加行
    dataGridView1.Rows.Add(1);
    for(int j = 0; j < columns.Length; j++)
    {
        dataGridView1.Rows[i].Cells[j].Value = columns[j];                  
    }           
}

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

图1  

对于其余的WebService方法的调用都很是简单，读者能够本身作这个实验。

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

若是读者要上传大文件，应尽可能使用FTP的方式来传递，而只经过WebService方法来传递文件名等信息。这样有助于提升传输效率。

相关文章
相关标签/搜索
每日一句
    每一个你不满意的现在，都有一个你没有努力的曾经。
本站公众号
   欢迎关注本站公众号,获取更多信息
联系我们 最近搜索 最新文章 沪ICP备13005482号-10 MyBatis教程 SQL 教程 MySQL教程 Java 教程 Thymeleaf 教程 Hibernate教程 Spring教程 Redis教程