HTTP POST不仅可以通过键值对传递参数,还可以携带更为复杂的参数,例如文件。HTTP Post支持携带body,content-type为multipart。本次我们将尝试通过http post上传一个小文件。
建立测试环境
上传文件的测试环境很难找,下载了Tomcat,想装一个环境,打开后,发现忘得也差不多,要看帮助,比较麻烦,下面是我上传文件到189网盘抓的包,上传一个图片文件,整个content长度为39K。网盘很难作为测试环境的原因是,我们必须完成登录等一系列操作。我们只是需要验证一下小例子,可以简单通过抓包来判断,预计web server会返回4xx或5xx的错误,但这不影响我们的实验。
开发环境:导入第三方JAR
但是目前Andriod的HttpClient并不直接支持multipart,我们需要三个额外的jar来支持:Apache Commons IO,Mime4j,以及HttpMime。可以通过下面地址来下载,也会附到我们所提供的小例子源代码中。http://commons.apache.org/proper/commons-io/,http://james.apache.org/mime4j/,以及http://hc.apache.org/index.html。这些jar要最终打包在apk中,应用才能在设备中运行。
在以前的ADT版本中,可以在相应的Project按右键,参见Android学习笔记(四四):第三方Java库的使用。选择Properties,进去后选择Java Build Path,然后选择Libaraies,点击Add External JARs就添加。但是在最新的版本中,采用这种方式在编译中正常,在运行时会报NoClassDefFoundError,如下。
原因是,这些Jar包并没有真正打入apk中。在新的ADT,我们直接将相应的jar包拷贝到project下面的libs/的目录,然后在Eclipse中点击libs/,按右键,选择刷新即可。我们在libs/和Android Private Libraries/中都可以看到相应的jar,如下图所示:
如果我们导入的是最新httpmime-4.3.1.jar,需要将httpcore-4.3.jar同时导入,在接下来的代码编写使用到InputStreamBody数据类型,InputStreamBody会使用到httpcore的类,否者运行时会报org.apache.http.entity.ContentType cannot be resolved的错误。
HTTP Post Multipart小例子
HTTP Post Multipart也是HTTP Post的例子,和之前的小例子相比,只是设置HTTP参数不同,本例子将设置multipart参数。下面截去例子中的部分,如何读response与之前的相同,不再重复。
private HttpResponse multiPartTest() throws Exception{
try{
HttpClient client = new DefaultHttpClient();
HttpPost request = new HttpPost("http://upload.cloud.189.cn/v5/v5webUploadSmallFileActionl");
//设置HTTP参数,本例设置Multipart参数
//(1)上传文件readme.txt已经放在asset/下,获取该文件的ContentBody。如果是在存贮中某个目录下,可以用FileBody fb = new FileBody(File f)来得到该ContentBody。
InputStream is = this.getAssets().open("readme.txt");
byte[] data = IOUtils.toByteArray(is);
InputStreamBody isb = new InputStreamBody(new ByteArrayInputStream(data), "myUpload");
//(2)除了文件外,我们再附加两个参数,生成这两个参数的ContentBody
StringBody sb1 = new StringBody("some text goes here");
StringBody sb2 = new StringBody("some text goes here, too");
//(3)作为multipart参数,加入到request中
MultipartEntity multiEntity = new MultipartEntity();
multiEntity.addPart("myUpload", isb);
multiEntity.addPart("one",sb1);
multiEntity.addPart("two",sb2);
request.setEntity(multiEntity); //在上个例子中setEntity()里的参数是UrlEncodedFormEntity本次是MultiPartEntity
return client.execute(request);
}catch(Exception e){
throw e;
}
}
回头说说调测环境,我们在网上找来一个http server,本例是189网盘,向其发送http post multipart请求,由于我们没有进行网盘用户登录的过程,而参数也非189所指定,因此收到到404消息的reponse。但我们可以通过抓包工具来查看各参数的填入情况,来了解如何在Android中填构multipart。本例我们在multipart entity中加了三个参数,让我们看看request包。
如果我们在机器上状态tomcat apache来搭建测试环境,需要注意的是在模拟器中不能使用127.0.0.1来指向机器的tomcat server,那会指向模拟器本身,要使用网卡的地址。
本博文涉及的例子代码,可以在Pro Android学习:Http service小例子中下载。
相关链接: 我的Android开发相关文章