- 浏览: 648615 次
- 性别:
- 来自: 广州
文章分类
最新评论
WebService大讲堂之Axis2(2):复合类型数据的传递
本文为原创,如需转载,请注明作者和出处,谢谢!
上一篇:WebService大讲堂之Axis2(1):用POJO实现0配置的WebService
在实际的应用中,不仅需要使用WebService来传递简单类型的数据,有时也需要传递更复杂的数据,这些数据可以被称为复合类型的数据。数组与类(接口)是比较常用的复合类型。在Axis2中可以直接使用将WebService方法的参数或返回值类型声明成数组或类(接口)。但要注意,在定义数组类型时只能使用一维数组,如果想传递多维数组,可以使用分隔符进行分隔,如下面的代码所示:
String[] strArray = new String[]{ "自行车,飞机,火箭","中国,美国,德国", "超人,蜘蛛侠,钢铁侠" } ;
上面的代码可以看作是一个3*3的二维数组。
在传递类的对象实例时,除了直接将数组类型声明成相应的类或接口,也可以将对象实例进行序列化,也就是说,将一个对象实例转换成字节数组进行传递,然后接收方再进行反序列化,还原这个对象实例。
下面的示例代码演示了如何传递数组与类(接口)类型的数据,并演示如何使用字节数组上传图像。本示例的客户端代码使用Java和C#编写。要完成这个例子需要如下几步:
一、实现服务端代码
<meta http-equiv="Content-Type" content="text/html; charset=utf-8"><meta name="ProgId" content="Word.Document"><meta name="Generator" content="Microsoft Word 11"><meta name="Originator" content="Microsoft Word 11"><link rel="File-List" href="file:///C:%5CDOCUME%7E1%5CADMINI%7E1%5CLOCALS%7E1%5CTemp%5Cmsohtml1%5C01%5Cclip_filelist.xml"><!--[if gte mso 9]><xml>
Normal
0
7.8 磅
0
2
false
false
false
MicrosoftInternetExplorer4
</xml><![endif]--><!--[if gte mso 9]><![endif]--><style>
<!--
/* Font Definitions */
@font-face
{font-family:宋体;
panose-1:2 1 6 0 3 1 1 1 1 1;}
@font-face
{font-family:""@宋体";
panose-1:2 1 6 0 3 1 1 1 1 1;}
/* Style Definitions */
p.MsoNormal, li.MsoNormal, div.MsoNormal
{mso-style-parent:"";
margin:0cm;
margin-bottom:.0001pt;
text-align:justify;
text-justify:inter-ideograph;
font-size:10.5pt;
font-family:"Times New Roman";}
/* Page Definitions */
@page
{}
@page Section1
{size:612.0pt 792.0pt;
margin:72.0pt 90.0pt 72.0pt 90.0pt;}
div.Section1
{page:Section1;}
-->
</style><!--[if gte mso 10]>
<style>
/* Style Definitions */
table.MsoNormalTable
{
mso-style-parent:"";
font-size:10.0pt;
font-family:"Times New Roman";
mso-fareast-font-family:"Times New Roman";}
</style>
<![endif]-->
ComplexTypeService是一个WebService类,该类的代码如下:
importdata.DataForm;
publicclassComplexTypeService
{
//上传图像,imageByte参数表示上传图像文件的字节,
//length参数表示图像文件的字节长度(该参数值可能小于imageByte的数组长度)
publicbooleanuploadImageWithByte(byte[]imageByte,intlength)
{
FileOutputStreamfos=null;
try
{
//将上传的图像保存在D盘的test1.jpg文件中
fos=newFileOutputStream("d:\\test1.jpg");
//开始写入图像文件的字节
fos.write(imageByte,0,length);
fos.close();
}
catch(Exceptione)
{
returnfalse;
}
finally
{
if(fos!=null)
{
try
{
fos.close();
}
catch(Exceptione)
{
}
}
}
returntrue;
}
//返回一维字符串数组
publicString[]getArray()
{
String[]strArray=newString[]{"自行车","飞机","火箭"};
returnstrArray;
}
//返回二维字符串数组
publicString[]getMDArray()
{
String[]strArray=newString[]{"自行车,飞机,火箭","中国,美国,德国","超人,蜘蛛侠,钢铁侠"};
returnstrArray;
}
//返回DataForm类的对象实例
publicDataFormgetDataForm()
{
returnnewDataForm();
}
//将DataForm类的对象实例序列化,并返回序列化后的字节数组
publicbyte[]getDataFormBytes()throwsException
{
java.io.ByteArrayOutputStreambaos=newjava.io.ByteArrayOutputStream();
java.io.ObjectOutputStreamoos=newjava.io.ObjectOutputStream(baos);
oos.writeObject(newDataForm());
returnbaos.toByteArray();
}
}
<meta http-equiv="Content-Type" content="text/html; charset=utf-8"><meta name="ProgId" content="Word.Document"><meta name="Generator" content="Microsoft Word 11"><meta name="Originator" content="Microsoft Word 11"><link rel="File-List" href="file:///C:%5CDOCUME%7E1%5CADMINI%7E1%5CLOCALS%7E1%5CTemp%5Cmsohtml1%5C01%5Cclip_filelist.xml"><!--[if gte mso 9]><xml> Normal 0 7.8 磅 0 2 false false false MicrosoftInternetExplorer4 </xml><![endif]--><!--[if gte mso 9]><![endif]--><style> <!-- /* Font Definitions */ @font-face {font-family:宋体; panose-1:2 1 6 0 3 1 1 1 1 1;} @font-face {font-family:""@宋体"; panose-1:2 1 6 0 3 1 1 1 1 1;} /* Style Definitions */ p.MsoNormal, li.MsoNormal, div.MsoNormal {mso-style-parent:""; margin:0cm; margin-bottom:.0001pt; text-align:justify; text-justify:inter-ideograph; font-size:10.5pt; font-family:"Times New Roman";} /* Page Definitions */ @page {} @page Section1 {size:612.0pt 792.0pt; margin:72.0pt 90.0pt 72.0pt 90.0pt;} div.Section1 {page:Section1;} --> </style><!--[if gte mso 10]> <style> /* Style Definitions */ table.MsoNormalTable { mso-style-parent:""; font-size:10.0pt; font-family:"Times New Roman"; mso-fareast-font-family:"Times New Roman";} </style> <![endif]-->
二、实现DataForm类
DataForm是要返回的对象实例所对应的类,该类的实现代码如下:
publicclassDataFormimplementsjava.io.Serializable
{
privateStringname="bill";
privateintage=20;
publicStringgetName()
{
returnname;
}
publicvoidsetName(Stringname)
{
this.name=name;
}
publicintgetAge()
{
returnage;
}
publicvoidsetAge(intage)
{
this.age=age;
}
}
<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> <meta name="ProgId" content="Word.Document"> <meta name="Generator" content="Microsoft Word 11"> <meta name="Originator" content="Microsoft Word 11"> <link rel="File-List" href="file:///C:%5CDOCUME%7E1%5CADMINI%7E1%5CLOCALS%7E1%5CTemp%5Cmsohtml1%5C01%5Cclip_filelist.xml"> <!--[if gte mso 9]><xml> Normal 0 7.8 磅 0 2 false false false MicrosoftInternetExplorer4 </xml><![endif]--><!--[if gte mso 9]><![endif]--><style> <!-- /* Font Definitions */ @font-face {font-family:宋体; panose-1:2 1 6 0 3 1 1 1 1 1;} @font-face {font-family:""@宋体"; panose-1:2 1 6 0 3 1 1 1 1 1;} /* Style Definitions */ p.MsoNormal, li.MsoNormal, div.MsoNormal {mso-style-parent:""; margin:0cm; margin-bottom:.0001pt; text-align:justify; text-justify:inter-ideograph; font-size:10.5pt; font-family:"Times New Roman";} /* Page Definitions */ @page {} @page Section1 {size:612.0pt 792.0pt; margin:72.0pt 90.0pt 72.0pt 90.0pt;} div.Section1 {page:Section1;} --> </style> <!--[if gte mso 10]> <style> /* Style Definitions */ table.MsoNormalTable { mso-style-parent:""; font-size:10.0pt; font-family:"Times New Roman"; mso-fareast-font-family:"Times New Roman";} </style> <![endif]-->
三、发布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的调用方式,代码如下:
importjavax.xml.namespace.QName;
importorg.apache.axis2.addressing.EndpointReference;
importorg.apache.axis2.client.Options;
importorg.apache.axis2.rpc.client.RPCServiceClient;
publicclassComplexTypeRPCClient
{
publicstaticvoidmain(String[]args)throwsException
{
RPCServiceClientserviceClient=newRPCServiceClient();
Optionsoptions=serviceClient.getOptions();
EndpointReferencetargetEPR=newEndpointReference(
"http://localhost:8080/axis2/services/ComplexTypeService");
options.setTo(targetEPR);
//下面的代码调用uploadImageWithByte方法上传图像文件
/////////////////////////////////////////
//打开图像文件,确定图像文件的大小
java.io.Filefile=newjava.io.File("f:\\images.jpg");
java.io.FileInputStreamfis=newjava.io.FileInputStream("f:\\images.jpg");
//创建保存要上传的图像文件内容的字节数组
byte[]buffer=newbyte[(int)file.length()];
//将图像文件的内容读取buffer数组中
intn=fis.read(buffer);
System.out.println("文件长度:"+file.length());
Object[]opAddEntryArgs=newObject[]{buffer,n};
Class[]classes=newClass[]{Boolean.class};
QNameopAddEntry=newQName("http://ws.apache.org/axis2","uploadImageWithByte");
fis.close();
//开始上传图像文件,并输出uploadImageWithByte方法的返回传
System.out.println(serviceClient.invokeBlocking(opAddEntry,opAddEntryArgs,classes)[0]);
/////////////////////////////////////////
//下面的代码调用了getArray方法,并返回一维String数组
/////////////////////////////////////////
opAddEntry=newQName("http://ws.apache.org/axis2","getArray");
String[]strArray=(String[])serviceClient.invokeBlocking(opAddEntry,
newObject[]{},newClass[]{String[].class})[0];
for(Strings:strArray)
System.out.print(s+"");
System.out.println();
/////////////////////////////////////////
//下面的代码调用了getMDArray方法,并返回一维String数组
/////////////////////////////////////////
opAddEntry=newQName("http://ws.apache.org/axis2","getMDArray");
strArray=(String[])serviceClient.invokeBlocking(opAddEntry, newObject[]{},
newClass[]{String[].class})[0];
for(Strings:strArray)
{
String[]array=s.split(",");
for(Stringss:array)
System.out.print("<"+ss+">");
System.out.println();
}
System.out.println();
/////////////////////////////////////////
//下面的代码调用了getDataForm方法,并返回DataForm对象实例
/////////////////////////////////////////
opAddEntry=newQName("http://ws.apache.org/axis2","getDataForm");
data.DataFormdf=(data.DataForm)serviceClient.invokeBlocking(opAddEntry,newObject[]{},
newClass[]{data.DataForm.class})[0];
System.out.println(df.getAge());
/////////////////////////////////////////
//下面的代码调用了getDataFormBytes方法,并返回字节数组,最后将返回的字节数组反序列化后,转换成DataForm对象实例
/////////////////////////////////////////
opAddEntry=newQName("http://ws.apache.org/axis2","getDataFormBytes");
buffer=(byte[])serviceClient.invokeBlocking(opAddEntry,newObject[]{},newClass[]{byte[].class})[0];
java.io.ObjectInputStreamois=newjava.io.ObjectInputStream(
newjava.io.ByteArrayInputStream(buffer));
df=(data.DataForm)ois.readObject();
System.out.println(df.getName());
//////////////////////////////////////////
}
}
<meta http-equiv="Content-Type" content="text/html; charset=utf-8"><meta name="ProgId" content="Word.Document"><meta name="Generator" content="Microsoft Word 11"><meta name="Originator" content="Microsoft Word 11"><link rel="File-List" href="file:///C:%5CDOCUME%7E1%5CADMINI%7E1%5CLOCALS%7E1%5CTemp%5Cmsohtml1%5C01%5Cclip_filelist.xml"><!--[if gte mso 9]><xml> Normal 0 7.8 磅 0 2 false false false MicrosoftInternetExplorer4 </xml><![endif]--><!--[if gte mso 9]><![endif]--><style> <!-- /* Font Definitions */ @font-face {font-family:宋体; panose-1:2 1 6 0 3 1 1 1 1 1;} @font-face {font-family:""@宋体"; panose-1:2 1 6 0 3 1 1 1 1 1;} /* Style Definitions */ p.MsoNormal, li.MsoNormal, div.MsoNormal {mso-style-parent:""; margin:0cm; margin-bottom:.0001pt; text-align:justify; text-justify:inter-ideograph; font-size:10.5pt; font-family:"Times New Roman";} /* Page Definitions */ @page {} @page Section1 {size:612.0pt 792.0pt; margin:72.0pt 90.0pt 72.0pt 90.0pt;} div.Section1 {page:Section1;} --> </style><!--[if gte mso 10]> <style> /* Style Definitions */ table.MsoNormalTable { mso-style-parent:""; font-size:10.0pt; font-family:"Times New Roman"; mso-fareast-font-family:"Times New Roman";} </style> <![endif]-->
运行上面的程序,将输出如下的内容:
true
自行车飞机火箭
<自行车><飞机><火箭>
<中国><美国><德国>
<超人><蜘蛛侠><钢铁侠>
20
bill
五、使用C#编写调用WebService的客户端代码
在Visual Studio中使用WebService就简单得多。假设引用WebService时的引用名为complexType,则下面的代码调用了uploadImageWithByte方法来上传图像文件。在Visual Studio引用WebService时,uploadImageWithByte方法多了两个out参数,在使用时要注意。
System.IO.FileStreamfs=newSystem.IO.FileStream(@"f:\images.jpg",System.IO.FileMode.Open);
byte[]buffer=newbyte[fs.Length];
fs.Read(buffer,0,(int)fs.Length);
boolr;
boolrs;
cts.uploadImageWithByte(buffer,(int)fs.Length,true,outr,outrs);
在获得二维数组时,可以将数据加载到DataGridView或其他类似的控件中,代码如下:
for(inti=0;i<strArray.Length;i++)
{
//用正则表达式将带分隔符的字符串转换成String数组
String[]columns=strArray[i].Split(',');
//如果DataGridView的表头不存在,向DataGridView控件添加三个带表头的列
if(dataGridView1.Columns.Count==0)
for(intj=0;j<columns.Length;j++)
dataGridView1.Columns.Add("column"+(j+1).ToString(),"列"+(j+1).ToString());
//添加行
dataGridView1.Rows.Add(1);
for(intj=0;j<columns.Length;j++)
{
dataGridView1.Rows[i].Cells[j].Value=columns[j];
}
}
<meta http-equiv="Content-Type" content="text/html; charset=utf-8"><meta name="ProgId" content="Word.Document"><meta name="Generator" content="Microsoft Word 11"><meta name="Originator" content="Microsoft Word 11"><link rel="File-List" href="file:///C:%5CDOCUME%7E1%5CADMINI%7E1%5CLOCALS%7E1%5CTemp%5Cmsohtml1%5C01%5Cclip_filelist.xml"><!--[if gte mso 9]><xml> Normal 0 7.8 磅 0 2 false false false MicrosoftInternetExplorer4 </xml><![endif]--><!--[if gte mso 9]><![endif]--><style> <!-- /* Font Definitions */ @font-face {font-family:宋体; panose-1:2 1 6 0 3 1 1 1 1 1;} @font-face {font-family:""@宋体"; panose-1:2 1 6 0 3 1 1 1 1 1;} /* Style Definitions */ p.MsoNormal, li.MsoNormal, div.MsoNormal {mso-style-parent:""; margin:0cm; margin-bottom:.0001pt; text-align:justify; text-justify:inter-ideograph; font-size:10.5pt; font-family:"Times New Roman";} /* Page Definitions */ @page {} @page Section1 {size:612.0pt 792.0pt; margin:72.0pt 90.0pt 72.0pt 90.0pt;} div.Section1 {page:Section1;} --> </style><!--[if gte mso 10]> <style> /* Style Definitions */ table.MsoNormalTable { mso-style-parent:""; font-size:10.0pt; font-family:"Times New Roman"; mso-fareast-font-family:"Times New Roman";} </style> <![endif]-->
向DataGridView控件添加数据后的效果如图1所示。
图1
<meta http-equiv="Content-Type" content="text/html; charset=utf-8"><meta name="ProgId" content="Word.Document"><meta name="Generator" content="Microsoft Word 11"><meta name="Originator" content="Microsoft Word 11"><link rel="File-List" href="file:///C:%5CDOCUME%7E1%5CADMINI%7E1%5CLOCALS%7E1%5CTemp%5Cmsohtml1%5C01%5Cclip_filelist.xml"><!--[if gte mso 9]><xml> Normal 0 7.8 磅 0 2 false false false MicrosoftInternetExplorer4 </xml><![endif]--><!--[if gte mso 9]><![endif]--><style> <!-- /* Font Definitions */ @font-face {font-family:宋体; panose-1:2 1 6 0 3 1 1 1 1 1;} @font-face {font-family:""@宋体"; panose-1:2 1 6 0 3 1 1 1 1 1;} /* Style Definitions */ p.MsoNormal, li.MsoNormal, div.MsoNormal {mso-style-parent:""; margin:0cm; margin-bottom:.0001pt; text-align:justify; text-justify:inter-ideograph; font-size:10.5pt; font-family:"Times New Roman";} /* Page Definitions */ @page {} @page Section1 {size:595.3pt 841.9pt; margin:72.0pt 90.0pt 72.0pt 90.0pt; layout-grid:15.6pt;} div.Section1 {page:Section1;} --> </style><!--[if gte mso 10]> <style> /* Style Definitions */ table.MsoNormalTable { mso-style-parent:""; font-size:10.0pt; font-family:"Times New Roman"; mso-fareast-font-family:"Times New Roman";} </style> <![endif]-->
对于其他的WebService方法的调用都非常简单,读者可以自己做这个实验。
要注意的是,由于.net和java序列化和反序列化的差异,通过序列化的方式传递对象实例只使用于客户端与服务端为同一种语言或技术的情况,如客户端和服务端都使用Java来编写。
如果读者要上传大文件,应尽量使用FTP的方式来传递,而只通过WebService方法来传递文件名等信息。这样有助于提高传输效率。下一篇:WebService大讲堂之Axis2(3):使用services.xml文件发布WebService
国内最棒的Google Android技术社区(eoeandroid),欢迎访问!
《银河系列原创教程》发布
《Java Web开发速学宝典》出版,欢迎定购
相关推荐
### WebService大讲堂之Axis2:深入了解零配置的WebService开发 #### 一、Axis2简介及下载安装 Axis2是Apache软件基金会提供的一款高性能、轻量级的WebService引擎,它是在Axis1.x的基础上重新设计的产物,不仅...
总结,本篇内容主要讲解了如何在 Axis2 中处理复合类型数据的传递,包括数组(一维和二维)以及自定义类对象。通过 Axis2,开发者可以直接使用 Java 类型作为 WebService 方法的参数和返回值,简化了开发过程。同时...
在处理复合类型数据传递时,Axis2同样提供了强大的支持。可以通过服务端代码实现服务逻辑,并定义一个DataForm类来表示传输的数据结构。然后通过发布WebService,并使用Java或C#编写相应的客户端代码调用此...
4. **WebService大讲堂之Axis2(2):复合类型数据的传递** 这一章深入探讨了如何在Web服务中传递复杂的数据结构,如对象图或数组,这对于处理结构化的业务数据至关重要。 5. **WebService大讲堂之Axis2(6):跨...
2. **复合类型数据的传递**:在“WebService大讲堂之Axis2(2):复合类型数据的传递.doc”中,可能详细解释了如何处理复杂的数据结构,如自定义对象或数组,以及如何在Web服务请求和响应中传递这些数据。...
Java WebService大讲堂是一个全面深入讲解Web服务技术的系列教程,涵盖了从基础概念到实际应用的各个环节。这个完整版包括了1-10集的内容,旨在帮助开发者全面理解和掌握Java WebService的开发与实现。 首先,让...