在实际的应用中,不仅需要使用WebService来传递简单类型的数据,有时也需要传递更复杂的数据,这些数据可以被称为复合类型的数据。数组与类(接口)是比较常用的复合类型。在Axis2中可以直接使用将WebService方法的参数或返回值类型声明成数组或类(接口)。但要注意,在定义数组类型时只能使用一维数组,如果想传递多维数组,可以使用分隔符进行分隔,如下面的代码所示:
String[]strArray = new String[]{ "自行车,飞机,火箭","中国,美国,德国", "超人,蜘蛛侠,钢铁侠" } ;
上面的代码可以看作是一个3*3的二维数组。
在传递类的对象实例时,除了直接将数组类型声明成相应的类或接口,也可以将对象实例进行序列化,也就是说,将一个对象实例转换成字节数组进行传递,然后接收方再进行反序列化,还原这个对象实例。
下面的示例代码演示了如何传递数组与类(接口)类型的数据,并演示如何使用字节数组上传图像。本示例的客户端代码使用Java和C#编写。要完成这个例子需要如下几步:
一、实现服务端代码
ComplexTypeService是一个WebService类,该类的代码如下:
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();
}
}
二、实现DataForm类
DataForm是要返回的对象实例所对应的类,该类的实现代码如下:
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;
}
}
三、发布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的调用方式,代码如下:
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, new Object[]{},
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[]{}, new Class[]{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());
//
}
}
运行上面的程序,将输出如下的内容:
文件长度:3617
true
自行车 飞机 火箭
<自行车> <飞机> <火箭>
<中国> <美国> <德国>
<超人> <蜘蛛侠> <钢铁侠>
20
bill
五、使用C#编写调用WebService的客户端代码
在VisualStudio中使用WebService就简单得多。假设引用WebService时的引用名为complexType,则下面的代码调用了uploadImageWithByte方法来上传图像文件。在Visual Studio引用WebService时,uploadImageWithByte方法多了两个out参数,在使用时要注意。
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或其他类似的控件中,代码如下:
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方法来传递文件名等信息。这样有助于提高传输效率。
下一篇:WebService大讲堂之Axis2(3):使用services.xml文件发布WebService
国内最棒的Google Android技术社区(eoeandroid),欢迎访问!
《银河系列原创教程》发布
《Java Web开发速学宝典》出版,欢迎定购
postedon 2009-01-04 23:41 银河使者 阅读(7112) 评论(13) 编辑 收藏所属分类: java 、 原创、webservice
评论
# re: WebService大讲堂之Axis2(2):复合类型数据的传递[未登录] 2009-02-04 11:34 robin
请问一下,JAVA版的客户端代码中,调用getDataForm()方法时,data.DataForm 这个对象怎么获得?因为客户端 是有没有这个类的,是否需提前生成,如果生成的话,会根据不同的编程语言生成不同的类吗?谢谢。 回复 更多评论
# re: WebService大讲堂之Axis2(2):复合类型数据的传递 2009-02-04 12:24 银河使者
@robin
data.DataForm这个类在使用wsdl2java命令生成客户端的stub类时已自动生成了。我们只要使用就可以了,在内部,axis2会将data.DataForm转换成基于soap协议的请求和响应消息。这个我们一般不用去管他。就直接将data.DataForm当成本地的类使用即可。不过要注意,不能自己在本地建立个与data.DataForm的内容一样的类,stub只能使用自己生成的类。你可以看一下stub代码。
对于本文并未直接使用wsdl2java生成stub代码,是使用的RPC调用方式,对于这种方式,只要直接将服务端的data.DataForm复制给客户端即可。客户端的data.DataForm类就是服务端的data.DataForm类,只要将data.DataForm类同客户端一定发布即可。
你如果用过c#就会看到也是自动生成了相应的data.DataForm类。 回复 更多评论
# 用wsdl2java调用getDataFormBytes时,怎么转换? 2009-02-04 16:24 zb
ComplexTypeServiceStubst=new ComplexTypeServiceStub();
------st.getDataFormBytes().get_return();
画线的这行要怎么转换?谢谢 回复 更多评论
# re: WebService大讲堂之Axis2(2):复合类型数据的传递 2009-02-04 16:41 银河使者
@zb
你用wsdl2java试一下就知道了,wsdl2java的用法见《WebService大讲堂之Axis2(1):用POJO实现0配置的WebService》
如果是字节,wsdl2java会使用DataHandler类型处理,详见我的第四篇关于axis2的文章:
http://www.blogjava.net/nokiaguy/archive/2009/02/archive/2009/01/archive/2009/01/22/252305.html 回复 更多评论
# re: WebService大讲堂之Axis2(2):复合类型数据的传递 2009-05-18 13:34 Harold.Zhang
# re: WebService大讲堂之Axis2(2):复合类型数据的传递[未登录] 2009-07-19 10:14 frank
如果我要传入一个DataForm 的数组或者返回一个DataForm的数组
只能使用DataForm[]
不能使用List<DataForm>??
回复 更多评论
# re: WebService大讲堂之Axis2(2):复合类型数据的传递 2009-07-19 12:56 银河使者
@frank
可以使用DataForm,但不能使用List对象。soap协议不支持List对象。只支持一维数组。虽然DataForm对象可以发送,但客户端无法正确解析成List对象。
回复 更多评论
# re: WebService大讲堂之Axis2(2):复合类型数据的传递 2009-09-13 12:18 jackyrong
请教下,我只传了27K的图象,文件长度为71189就出错了,为什么呢?
回复 更多评论
# re: WebService大讲堂之Axis2(2):复合类型数据的传递 2009-09-14 17:18 Robber.fei
想问个问题,就是我在JAVA版的客户端代码中, 对象data.DataForm这个类在使用wsdl2java命令生成客户端的stub类时已自动生成成功了,但是还是不能识别data.DataForm,不太清楚是为什么,我使用wsdl2java命令生成的stub文件在放在c:\documents andsettings\chenf\stub...下面,是不是跟生成的stub class文件的路径也是有关系的? 回复 更多评论
# re: WebService大讲堂之Axis2(2):复合类型数据的传递[未登录] 2009-11-21 23:10 学习者
老师您好 ,我按照您说的步骤工作,都成功了,但是请问文件上传到哪里去了呢?在哪里可以看到?谢谢!!! 回复 更多评论
# re: WebService大讲堂之Axis2(2):复合类型数据的传递 2009-12-31 10:41 Mr.Blue
您好,请问WebService支持从客户端传递对象到服务器端嘛?根据你上面的例子 ,我想从本地构造一个DataForm对象,并在服务端有个接口接收,但当我运行的时候客户端会抛出一个异常如下:
org.apache.axis2.AxisFault: The input stream for an incoming message is null.
at org.apache.axis2.transport.TransportUtils.createSOAPMessage(TransportUtils.java:92)
atorg.apache.axis2.transport.TransportUtils.createSOAPMessage(TransportUtils.java:67)
atorg.apache.axis2.description.OutInAxisOperationClient.handleResponse(OutInAxisOperation.java:354)
at org.apache.axis2.description.OutInAxisOperationClient.send(OutInAxisOperation.java:417)
atorg.apache.axis2.description.OutInAxisOperationClient.executeImpl(OutInAxisOperation.java:229)
at org.apache.axis2.client.OperationClient.execute(OperationClient.java:165)
at org.apache.axis2.client.ServiceClient.sendReceive(ServiceClient.java:540)
at org.apache.axis2.client.ServiceClient.sendReceive(ServiceClient.java:521)
atorg.apache.axis2.rpc.client.RPCServiceClient.invokeBlocking(RPCServiceClient.java:76)
at webservice.complexType.object.ComplexTypeTest.testSetDataForm(ComplexTypeTest.java:192)
at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method)
at sun.reflect.NativeMethodAccessorImpl.invoke(Unknown Source)
at sun.reflect.DelegatingMethodAccessorImpl.invoke(Unknown Source)
at java.lang.reflect.Method.invoke(Unknown Source)
at junit.framework.TestCase.runTest(TestCase.java:154)
at junit.framework.TestCase.runBare(TestCase.java:127)
at junit.framework.TestResult$1.protect(TestResult.java:106)
at junit.framework.TestResult.runProtected(TestResult.java:124)
at junit.framework.TestResult.run(TestResult.java:109)
at junit.framework.TestCase.run(TestCase.java:118)
atorg.eclipse.jdt.internal.junit.runner.junit3.JUnit3TestReference.run(JUnit3TestReference.java:130)
atorg.eclipse.jdt.internal.junit.runner.TestExecution.run(TestExecution.java:38)
atorg.eclipse.jdt.internal.junit.runner.RemoteTestRunner.runTests(RemoteTestRunner.java:460)
at org.eclipse.jdt.internal.junit.runner.RemoteTestRunner.runTests(RemoteTestRunner.java:673)
atorg.eclipse.jdt.internal.junit.runner.RemoteTestRunner.run(RemoteTestRunner.java:386)
atorg.eclipse.jdt.internal.junit.runner.RemoteTestRunner.main(RemoteTestRunner.java:196)
从理论上来将,既然可以从客户端传递数组到服务器端(如上面的上传功能,已经实现),为什么上传对象时就不行呢?还是哪里需要特殊的配置,请指教,谢谢 回复 更多评论
# re: WebService大讲堂之Axis2(2):复合类型数据的传递 2009-12-31 10:49 Mr.Blue
@学习者
上传文件的位置是你在服务端代码指定了的,比如
fops = new FileOutputStream("E:\\project\\Axis\\uploadedImg.jpg");服务端程序代码是这样指定的那么你就要到E:\\project\\Axis\\找。 回复 更多评论
# re: WebService大讲堂之Axis2(2):复合类型数据的传递 2009-12-3111:33 Mr.Blue
您好,我又写了个从客户端向服务端传递对象的序列化数组的接口,结果从在客户端进行测试的时候,抛出一下异常,不知所云:
org.apache.axis2.AxisFault: java.lang.UnsupportedOperationException: An accessoccurred that is not valid.
atorg.apache.axis2.util.Utils.getInboundFaultFromMessageContext(Utils.java:435)
at org.apache.axis2.description.OutInAxisOperationClient.handleResponse(OutInAxisOperation.java:371)
atorg.apache.axis2.description.OutInAxisOperationClient.send(OutInAxisOperation.java:417)
atorg.apache.axis2.description.OutInAxisOperationClient.executeImpl(OutInAxisOperation.java:229)
at org.apache.axis2.client.OperationClient.execute(OperationClient.java:165)
at org.apache.axis2.client.ServiceClient.sendReceive(ServiceClient.java:540)
at org.apache.axis2.client.ServiceClient.sendReceive(ServiceClient.java:521)
at org.apache.axis2.rpc.client.RPCServiceClient.invokeBlocking(RPCServiceClient.java:76)
atwebservice.complexType.object.ComplexTypeTest.testSetDataFormBytes(ComplexTypeTest.java:214)
at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method)
at sun.reflect.NativeMethodAccessorImpl.invoke(Unknown Source)
at sun.reflect.DelegatingMethodAccessorImpl.invoke(Unknown Source)
at java.lang.reflect.Method.invoke(Unknown Source)
at junit.framework.TestCase.runTest(TestCase.java:154)
at junit.framework.TestCase.runBare(TestCase.java:127)
at junit.framework.TestResult$1.protect(TestResult.java:106)
at junit.framework.TestResult.runProtected(TestResult.java:124)
at junit.framework.TestResult.run(TestResult.java:109)
at junit.framework.TestCase.run(TestCase.java:118)
at org.eclipse.jdt.internal.junit.runner.junit3.JUnit3TestReference.run(JUnit3TestReference.java:130)
atorg.eclipse.jdt.internal.junit.runner.TestExecution.run(TestExecution.java:38)
atorg.eclipse.jdt.internal.junit.runner.RemoteTestRunner.runTests(RemoteTestRunner.java:460)
at org.eclipse.jdt.internal.junit.runner.RemoteTestRunner.runTests(RemoteTestRunner.java:673)
atorg.eclipse.jdt.internal.junit.runner.RemoteTestRunner.run(RemoteTestRunner.java:386)
atorg.eclipse.jdt.internal.junit.runner.RemoteTestRunner.main(RemoteTestRunner.java:196)
服务端抛出一下异常:
[ERROR] An access occurred that is not valid.
java.lang.UnsupportedOperationException: An access occurred that is not valid.
atorg.apache.axis2.description.InOnlyAxisOperation.getMessage(InOnlyAxisOperation.java:117)
at org.apache.axis2.util.MessageContextBuilder.createOutMessageContext(MessageContextBuilder.java:183)
atorg.apache.axis2.receivers.AbstractInOutMessageReceiver.invokeBusinessLogic(AbstractInOutMessageReceiver.java:37)
at org.apache.axis2.receivers.AbstractMessageReceiver.receive(AbstractMessageReceiver.java:114)
at org.apache.axis2.engine.AxisEngine.receive(AxisEngine.java:173)
atorg.apache.axis2.transport.http.HTTPTransportUtils.processHTTPPostRequest(HTTPTransportUtils.java:167)
at org.apache.axis2.transport.http.AxisServlet.doPost(AxisServlet.java:142)
at javax.servlet.http.HttpServlet.service(HttpServlet.java:710)
at javax.servlet.http.HttpServlet.service(HttpServlet.java:803)
atorg.apache.catalina.core.ApplicationFilterChain.internalDoFilter(ApplicationFilterChain.java:290)
atorg.apache.catalina.core.ApplicationFilterChain.doFilter(ApplicationFilterChain.java:206)
atorg.apache.catalina.core.StandardWrapperValve.invoke(StandardWrapperValve.java:230)
at org.apache.catalina.core.StandardContextValve.invoke(StandardContextValve.java:175)
atorg.apache.catalina.core.StandardHostValve.invoke(StandardHostValve.java:128)
atorg.apache.catalina.valves.ErrorReportValve.invoke(ErrorReportValve.java:104)
at org.apache.catalina.core.StandardEngineValve.invoke(StandardEngineValve.java:109)
at org.apache.catalina.connector.CoyoteAdapter.service(CoyoteAdapter.java:261)
at org.apache.coyote.http11.Http11Processor.process(Http11Processor.java:844)
at org.apache.coyote.http11.Http11Protocol$Http11ConnectionHandler.process(Http11Protocol.java:581)
at org.apache.tomcat.util.net.JIoEndpoint$Worker.run(JIoEndpoint.java:447)
at java.lang.Thread.run(Thread.java:619)