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