在上一篇文章中我们介绍了WebService的简单调用方式。通过这种调用方式可以传递一般的数据。例如,服务端可以返回一个对象,并在客户端取出对象中的属性值。也可以向服务端传递一个简单的值(String、int、boolean等)作为WebService方法的参数值。但如果某些读者对WebService提出了更高的要求,那么本文以及下一篇文章中的内容正好可满足这类读者的需求。
在本文先来提出对WebService的第一个苛刻要求。有很多情况下,需要在数据库或以文件形式将图像保存在服务端。虽然上传图像可以通过FTP方式很容易解决。但这就需要将数据分成两部分或更多部分上传,在处理上可能会消耗更多的服务端资源,程序也不易维护。OK,那么我们期望的最佳结果是在使用WebService上传数据的同时就把图像传到服务端。好,现在我们提出了关于WebService的第一个复杂问题,利用WebService上传和下载图像。
上传和下载图像的原理
不管是什么格式的图像(当然,其他类型的文件也是一样)都是由二进制数据组成的,因此,我们很自然地想到通过byte数组进行数据传递。但由于服务端的WebService可能由非Java语言来编写,对于byte数组的处理可能和Java不同。因此,我们可以通过编码的方式将byte数组转换成字符串。一般会选择Base64编码。
也就是说,在上传图像时会从本地将图像文件以字节的形式读到内存中,然后再通过相应的API将byte数组转换成Base64字符串。当下载图像时,过程正好相反。我们下载的是被转换成base64编码的byte数组。在客户端需要对其进行解码,还原成byte数组,然后再做进一步处理。在接下来的内容中读者将会看到具体的实现过程。
可以上传和下载的服务端WebService
为了完成本文的例子,首先需要编写一个可以上传和下载的图像文件的WebService。为了方便起见,在本程序中使用了固定的图像位置。将原图像放到了E盘根目录(my.jpg),服务端从该位置下载文件。上传文件后将文件保存在D盘根目录的my.jpg文件中。
下面看一下上传和下载文件的完整的WebService代码。
- package service;
- import java.io.ByteArrayOutputStream;
- import java.io.FileInputStream;
- import java.io.FileOutputStream;
- public class MyImage
- {
- // 上传文件
- public boolean updateImage(String image)
- {
- try
- {
- byte[] buffer = new sun.misc.BASE64Decoder().decodeBuffer(image);
- FileOutputStream fos = new FileOutputStream("d:\\my.jpg");
- fos.write(buffer);
- fos.close();
- return true;
- }
- catch (Exception e)
- {
- // TODO: handle exception
- }
- return false;
- }
- // 下载文件
- public String downloadImage()
- {
- String base64 = "";
- try
- {
- FileInputStream fis = new FileInputStream("e:\\my.jpg");
- ByteArrayOutputStream baos = new ByteArrayOutputStream();
- byte[] buffer = new byte[8192];
- int count = 0;
- while ((count = fis.read(buffer)) >= 0)
- {
- baos.write(buffer, 0, count);
- }
- base64 = new sun.misc.BASE64Encoder().encode(baos.toByteArray());
- fis.close();
- }
- catch (Exception e)
- {
- // TODO: handle exception
- }
- return base64;
- }
- }
在上面的代码中使用了sun.misc.BASE64Decoder类中的相应方法对表示图像的字节数组进行Base64编码和解码。
updateImage方法复制上传图像,通过image参数传递一个被编码成Base64字符串的字节数组。该字节数组就是客户端上传的图像数据。然后通过decodeBuffer方法将其还原成byte数组。并保存在D:\my.jpg文件中。
downloadImage是updateImage方法的逆过程。从E:\my.jpg文件中读取数据,并将这些数据保存在byte数组中,最后使用encode方法将byte数组转换成Base64格式的字符串,并返回这个字符串。
现在将这个WebService部署到Tomcat中,并启动Tomcat,下面将编写调用这个WebService的OPhone客户端。
在OPhone 2.0中上传和下载图像
本文的例子接着上一篇文章的例子来实现。首先需要在main.xml布局文件中增加两个按钮和一个ImageView组件,用来显示从服务端下载的图像。增加的布局代码如下:
- <LinearLayout android:orientation="horizontal"
- android:layout_width="fill_parent" android:layout_height="wrap_content">
- <Button android:id="@+id/btnUploadImage" android:layout_width="wrap_content"
- android:layout_height="wrap_content" android:text="上传图像"
- android:onClick="onClick_UploadImage" />
- <Button android:id="@+id/btnDownloadImage"
- android:layout_width="wrap_content" android:layout_height="wrap_content"
- android:text="下载图像" android:onClick="onClick_DownloadImage" />
- </LinearLayout>
- <ImageView android:id="@+id/imageview" android:layout_width="fill_parent"
- android:layout_height="fill_parent" />
其中onClick_UploadImage和onClick_DownloadImage方法分别用来处理上传和下载按钮的单击事件。设计完的界面如图1所示。
图1 增加了上传和下载按钮的界面
下面先来看看onClick_UploadImage方法的实现,代码如下:
- public void onClick_UploadImage(View view)
- {
- try
- {
- FileInputStream fis = new FileInputStream("/sdcard/test.jpg");
- ByteArrayOutputStream baos = new ByteArrayOutputStream();
- byte[] buffer = new byte[8192];
- int count = 0;
- while ((count = fis.read(buffer)) >= 0)
- {
- baos.write(buffer, 0, count);
- }
- String imageBase64 = new String(Base64.encodeBase64(baos
- .toByteArray()));
- fis.close();
- String serviceUrl = "http://192.168.17.82:8080/axis2/services/MyImageService?wsdl";
- String methodName = "updateImage";
- SoapObject request = new SoapObject("http://service", methodName);
- request.addProperty("image", imageBase64);
- SoapSerializationEnvelope envelope = new SoapSerializationEnvelope(
- SoapEnvelope.VER11);
- envelope.bodyOut = request;
- HttpTransportSE ht = new HttpTransportSE(serviceUrl);
- ht.call(null, envelope);
- if (envelope.getResponse() != null)
- {
- org.ksoap2.serialization.SoapPrimitive soapPrimitive = (SoapPrimitive) envelope
- .getResponse();
- boolean result = Boolean.parseBoolean(soapPrimitive.toString());
- if (result)
- Toast.makeText(this, "成功上传图像.", Toast.LENGTH_LONG).show();
- else
- Toast.makeText(this, "上传图像失败.", Toast.LENGTH_LONG).show();
- }
- }
- catch (Exception e)
- {
- Log.d("updateImage_exception", String.valueOf(e));
- }
- }
在上面的代码中使用了一个第三方的jar包:commons-codec-1.4.jar,该包可以从www.apacle.org下免费下载。本例主要通过该包中的相应API对字节数组进行Base64编码和解码。
在本例中我们上传了SD卡根目录的一个叫test.jpg的文件。那么onClick_UploadImage方法首先要做的就是读取这个图像文件,并将数据保存在byte数组中。然后对byte数组进行Base64编码。
在接下来的实现过程就需要调用WebService上。WebService的WSDL地址如下:
http://192.168.17.82:8080/axis2/services/MyImageService?wsdl
方法名是updateImage。在这里只需要传递一个image参数,参数值就是经过编码的byte数组(一个字符串)。
服务端的updateImage方法如果上传成功,返回true,否则返回false。因此,客户端需要获得服务端的返回结果。代码如下:
- org.ksoap2.serialization.SoapPrimitive soapPrimitive = (SoapPrimitive) envelope
- .getResponse();
由于服务端返回的是简单类型(boolean),因此,在这里需要将返回值转换成SoapPrimitive对象,而不是SoapObject对象。服务端的updateImage方法如果上传成功,返回true,否则返回false。如果成功上传图像,会显示如图2所示的提示信息。我们会在D盘根目录看到一个my.jpg文件。
图2 成功上传图像文件后的提示信息
下面来看看如何下载图像文件,代码如下:
- public void onClick_DownloadImage(View view)
- {
- try
- {
- String serviceUrl = "http://192.168.17.82:8080/axis2/services/MyImageService?wsdl";
- String methodName = "downloadImage";
- SoapObject request = new SoapObject("http://service", methodName);
- SoapSerializationEnvelope envelope = new SoapSerializationEnvelope(
- SoapEnvelope.VER11);
- envelope.bodyOut = request;
- HttpTransportSE ht = new HttpTransportSE(serviceUrl);
- ht.call(null, envelope);
- if (envelope.getResponse() != null)
- {
- SoapPrimitive soapPrimitive = (SoapPrimitive) envelope
- .getResponse();
- byte[] buffer = org.kobjects.base64.Base64.decode(soapPrimitive
- .toString());
- Bitmap bitmap = BitmapFactory.decodeByteArray(buffer, 0,
- buffer.length);
- ImageView imageView = (ImageView) findViewById(R.id.imageview);
- imageView.setImageBitmap(bitmap);
- }
- }
- catch (Exception e)
- {
- Log.d("downloadImage_exception", String.valueOf(e));
- }
- }
在上面的代码中首先从调用了WebService的downloadImage方法,并返回了一个Base64格式的字符串。然后利用decode方法将字符串还原成byte数组。最后在ImageView中显示了这个下载的图像。如图3所示。
图3 下载并显示图像
总结
本文介绍了如何利用WebService上传和下载图像。利用本节的技术,不光能上传图像文件,也可以上传任意的文件。但如果文件非常大的话,并不建议采用这种方式来传递。对于大文件可以采用后面几篇文章所介绍的方式与服务端进行交互。
相关文章:客户端和服务端通讯的N种方式(一)
作者介绍
李宁,东北大学计算机专业硕士,拥有超过10年的软件开发经验。曾任国内某知名企业项目经理;目前担任eoeandroid和ophonesdn版主;中国移动开发者社区OPhone专家;51CTO客作专家;CSDN博客专家。曾领导并参与开发了多个大中型项目。目前主要从事Android及其相关产品的研发。从2005年进入写作领域以来,为《程序员》、《电脑编程技巧与维护》、《电脑报》、IT168、天极网等平面媒体和网络媒体撰写了一百多篇原创技术和评论文章。并在个人blog(http://nokiaguy.blogjava.net)上发表了大量的原创技术文章。2007年获《电脑编程技巧与维护》优秀作者。2009年获得OPhone征文大赛二等奖。个人著作:《Android/OPhone开发完全讲义》、《人人都玩开心网:Ext JS+Android+SSH整合开发Web与移动SNS》、《Java Web开发速学宝典》。
(声明:本网的新闻及文章版权均属OPhone SDN网站所有,如需转载请与我们编辑团队联系。任何媒体、网站或个人未经本网书面协议授权,不得进行任何形式的转载。已经取得本网协议授权的媒体、网站,在转载使用时请注明稿件来源。)