在《
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
類的代碼如下:
package?service;
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文件的配置代碼如下:
<service?name="fileService">
????<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類的對象實例,代碼如下:
DataHandler?dh?=?new?DataHandler(new?FileDataSource(imagePath));
wsdl2java命令會為每一個方法生成一個封裝方法參數的類,類名為方法名(第一個字符大寫),如uploadWithByte方法生成的類名為UploadWithByte。如果要設置file參數的值,可以使用UploadWithByte類的setFile方法,代碼如下:
UploadWithByte?uwb?=?new?UPloadWithByte();
uwb.setFile(dh);
最后是調用uploadWithByte方法,代碼如下(FileServiceStub為wsdl2java生成的stub類名):
FileServiceStub?fss?=?new?FileServiceStub();
fss.uploadWithByte(uwb);
如果使用C#調用FileService,則file參數類型均為byte[],代碼如下:
MemoryStream?ms?=?new?MemoryStream();
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控件。