原文地址:WebService大讲堂之Axis2(4):二进制文件传输
上一篇:WebService大讲堂之Axis2(3):使用services.xml文件发布WebServic
下一篇:WebService大讲堂之Axis2(5):会话(Session)管理
在《 WebService大讲堂之Axis2(2):复合类型数据的传递 》中讲过,如果要传递二进制文件(如图像、音频文件等),可以使用 byte[]作为数据类型进行传递,然后客户端使用 RPC方式进行调用。这样做只是其中的一种方法,除此之外,在客户端还可以使用 wsdl2java命令生成相应的 stub类来调用 WebService, wsdl2java命令的用法详见《 WebService大讲堂之Axis2(1):用POJO实现0配置的WebService 》。
WebService类中包含 byte[]类型参数的方法在 wsdl2java生成的 stub类中对应的数据类型不再是 byte[]类型,而是 javax.activation.DataHandler。 DataHandler类是专门用来映射 WebService二进制类型的。
在 WebService类中除了可以使用 byte[]作为传输二进制的数据类型外,也可以使用 javax.activation.DataHandler作为数据类型。 不管是使用 byte[],还是使用 javax.activation.DataHandler作为 WebService方法的数据类型,使用 wsdl2java命令生成的 stub类中相应方法的类型都是 javax.activation.DataHandler。而象使用 .net、 delphi生成的 stub类的相应方法类型都是 byte[]。这是由于 javax.activation.DataHandler类是 Java特有的,对于其他语言和技术来说,并不认识 javax.activation.DataHandler类,因此,也只有使用最原始的 byte[]了。
下面是一个上传二进制文件的例子, WebService类的代码如下:
import java.io.InputStream;
import java.io.OutputStream;
import java.io.FileOutputStream;
import javax.activation.DataHandler;
public class FileService
{
// 使用byte[]类型参数上传二进制文件
public boolean uploadWithByte( byte [] file, String filename)
{
FileOutputStream fos = null ;
try
{
fos = new FileOutputStream(filename);
fos.write(file);
fos.close();
}
catch (Exception e)
{
return false ;
}
finally
{
if (fos != null )
{
try
{
fos.close();
}
catch (Exception e)
{
}
}
}
return true ;
}
private void writeInputStreamToFile(InputStream is, OutputStream os) throws Exception
{
int n = 0 ;
byte [] buffer = new byte [ 8192 ];
while ((n = is.read(buffer)) > 0 )
{
os.write(buffer, 0 , n);
}
}
// 使用DataHandler类型参数上传文件
public boolean uploadWithDataHandler(DataHandler file, String filename)
{
FileOutputStream fos = null ;
try
{
fos = new FileOutputStream(filename);
// 可通过DataHandler类的getInputStream方法读取上传数据
writeInputStreamToFile(file.getInputStream(), fos);
fos.close();
}
catch (Exception e)
{
return false ;
}
finally
{
if (fos != null )
{
try
{
fos.close();
}
catch (Exception e)
{
}
}
}
return true ;
}
}
上面代码在 services.xml文件的配置代码如下:
< description >
文件服务
</ description >
< parameter name ="ServiceClass" >
service.FileService
</ parameter >
< messageReceivers >
< messageReceiver mep ="http://www.w3.org/2004/08/wsdl/in-out"
class ="org.apache.axis2.rpc.receivers.RPCMessageReceiver" />
</ messageReceivers >
</ service >
如果使用 wsdl2java 命令生成调用 Java 客户端代码,则需要创建 DataHandler 类的对象实例,代码如下:
wsdl2java命令会为每一个方法生成一个封装方法参数的类,类名为方法名(第一个字符大写),如 uploadWithByte方法生成的类名为 UploadWithByte。如果要设置 file参数的值,可以使用 UploadWithByte类的 setFile方法,代码如下:
uwb.setFile(dh);
最后是调用 uploadWithByte方法,代码如下( FileServiceStub为 wsdl2java生成的 stub类名):
fss.uploadWithByte(uwb);
如果使用 C#调用 FileService,则 file参数类型均为 byte[],代码如下:
Bitmap bitmap = new Bitmap(picUpdateImage.Image);
bitmap.Save(ms, System.Drawing.Imaging.ImageFormat.Jpeg);
service.fileService fs = new WSC.service.fileService();
fs.uploadWithDataHandler(ms.ToArray());
fs.uploadWithByte(ms.ToArray());
其中 picUpdateImage为 c#中加载图像文件的 picturebox控件。