本例是我在年前的项目中用到的一个小例子,使用Android自带的HttpURLConnection实现文件上传。网上的资料对这方面的讲解不太多,有两个实例也不太详细,我在开发中用到了,觉得挺实用的,分享出来,希望能对各位朋友有所帮助,受水平所限,实例中如有谬处,还望各位大神批评指正,这个实例个人认为适用于项目中的文件上传比较少的情况,当文件上传比较多的时候还是用框架吧(例如okhtp)。 本来想在刚放寒假就整理一下,由于年前回家比较晚了,年前年后的事有点多,直到现在才有时间整理。废话不多说 直接上代码:(代码是我从项目中剪出来的,可能会有报错,问题不会太大,很好改)
1import android.os.Handler;
2import android.os.Message;
3import android.util.Log;
4import org.json.JSONException;
5import org.json.JSONObject;
6
7import java.io.BufferedReader;
8import java.io.DataOutputStream;
9import java.io.FileInputStream;
10import java.io.IOException;
11import java.io.InputStreamReader;
12import java.net.HttpURLConnection;
13import java.net.MalformedURLException;
14import java.net.URL;
15public class ArrivateUpload extends Thread {
16
17 private final String BOUNDARYSTR = "--------aifudao7816510d1hq";
18 private final String END = "\r\n";
19 private final String LAST = "--";
20
21 private String data;//表单数据
22 private FileInputStream fis;//文件输入流
23 private Handler handler;
24
25 public ArrivateUpload(String data, FileInputStream fis, Handler handler) {
26 this.data = data;
27 this.handler = handler;
28 this.fis=fis;
29 }
30
31 @Override
32 public void run() {
33 try {
34 URL httpUrl=new URL(urlStr);
35 HttpURLConnection connection= (HttpURLConnection) httpUrl.openConnection();
36 connection.setRequestMethod("POST");//必须为post
37 connection.setDoInput(true);
38 connection.setDoOutput(true);
39 connection.setRequestProperty("Content-type", "multipart/form-data;boundary=" + BOUNDARYSTR);//固定格式
40 DataOutputStream dos=new DataOutputStream(connection.getOutputStream());
41 StringBuffer sb=new StringBuffer();
42 /**
43 * 写入文本数据
44 */
45
46 sb.append(LAST+BOUNDARYSTR+END);
47 sb.append("Content-Disposition: form-data; name=\"data\""+END+END);
48 sb.append(data+END);//内容
49 /**
50 * 循环写入文件
51 */
52sb.append(LAST+BOUNDARYSTR+END);
53sb.append("Content-Disposition:form-data;Content-Type:application/octet-stream;name=\"file\";");
54 sb.append("filename=\""+"map_image.png"+"\""+END+END);
55 dos.write(sb.toString().getBytes("utf-8"));
56 if (fis != null) {
57 byte[] b=new byte[1024];
58 int len;
59 while ((len=fis.read(b))!=-1){
60 dos.write(b,0,len);
61 }
62 dos.write(END.getBytes());
63 }
64 dos.write((LAST+BOUNDARYSTR+LAST+END).getBytes());
65 dos.flush();
66 sb=new StringBuffer();
67 if (connection.getResponseCode()==200) {//请求成功
68 BufferedReader br=new BufferedReader(new InputStreamReader(connection.getInputStream()));
69 String line;
70 while ((line=br.readLine())!=null){
71 sb.append(line);
72 }
73 Message msg=Message.obtain();
74 JSONObject object=new JSONObject(sb.toString());
75 handler.sendMessage(msg);
76 }
77 } catch (MalformedURLException e) {
78 e.printStackTrace();
79 } catch (IOException e) {
80 e.printStackTrace();
81 } catch (JSONException e) {
82 e.printStackTrace();
83 }
84 }
85}
说一下实现思路:用Android系统中提供的HttpURLConnection,利用http中的multipart协议实现文件上传。httpUrlConnection应该不用多说了(不太熟悉的同学去Google学习一下HttpURLConnection和http协议吧),就说几个注意点吧,请求模式设置为POST,打开输入输出流(这个好像默认是开启的,还是设置为true比较放心) 重点说一下multipart协议吧,因为普通的http post协议使用的分隔符太简单,上传文件会造成文件分割歧义,所以必须使用multipart协议。 写一个简单的HTML表单文件上传的例子,对照学习。
1<!DOCTYPE html>
2<html lang="en">
3<head>
4 <meta charset="UTF-8">
5 <title>upload</title>
6</head>
7<body>
8<form action="a.php" method="post" enctype="multipart/form-data">
9 <input type="text" name="data"/>
10 <input type="file" name="file">
11 <input type="submit">
12</form>
13</body>
14</html>
在浏览器中通过调试我们可以对照浏览器来拼出multipart协议,浏览器会报404,a.php 没有找到,不用管它,这不是我们关注的重点。下图就是浏览器中的详细信息
在1处定义了分隔符,分隔符尽量复杂一点,避免造成与文件中的字符产生冲突。注意了,前方有大坑,注意脚下油门,老司机一不留神也会翻车。仔细对比你会发现2,3,4处和1处是不同的,2,3,4处比1处多了两个“-”,一定要留神,这也就是为什么我们在使用boundary时要加上“–”的原因了。sb.append(LAST+BOUNDARYSTR+END); 在4处,整个body的结束处要加上一个“–”,没有why,协议就是这样规定的。
每一行结束都要有一个"\r\n",第二行结束时(数据文件开始前)要有两个"\r\n"。对比图中会发现数据文件前有一个空行。还有非常重要的一点,千万注意引号(“ ”)的转义问题,如果引号出问题就会导致上传失败,而且这个错误还不容易发现。文件写入需要用输入流循环写入
1sb.append("Content-Disposition:form-data;Content-Type:application/octet-stream;name=\"file\";"); //name 之前是固定写法, 这里的name是服务端接收时需要用到的,
2sb.append("filename=\""+"map_image.png"+"\""+END+END); // 这里的filename的值随便写,无所谓,但是一定要有,没有会导致上传失败。
3dos.write(sb.toString().getBytes("utf-8"));
4 if (fis != null) {
5 byte[] b=new byte[1024];
6 int len;
7 while ((len=fis.read(b))!=-1){
8 dos.write(b,0,len);
9 }
10 dos.write(END.getBytes());
11 }
12 dos.write((LAST+BOUNDARYSTR+LAST+END).getBytes());
13 dos.flush();
再分享一个调试技巧,我们的程序是跑在Android上的,我们是无法像在浏览器中那样调试的,所以开抓包是非常必要的(genymation自带抓包器,熟悉linux的可以直接使用),在模拟器上运行程序,电脑开启抓包器,每次上传都抓取一个数据包,分析数据包,如果出错了与浏览器的格式对比,这样调试不要太酸爽。有次上传的内容有点复杂,一直调试不正确,最后用抓包对比搞定了。我用的是wireshark,这个功能太强大了,直接在网卡安装驱动,只要经过网卡的数据都能抓到(想象力丰富的同学可以用它来干点坏事情 此处略去一千字……)。还有一个地方需要注意一下,wireshark不能抓ip为127.0.0.1的数据包(用本地电脑做服务器),因为这时的数据不经过网卡,所以无法抓取。 由于水平有限,加之时间匆忙,如有谬处,还请各位大神批评指正