在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 没有找到,不用管它,这不是我们关注的重点。下图就是浏览器中的详细信息

在Android中实现文件上传
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的数据包(用本地电脑做服务器),因为这时的数据不经过网卡,所以无法抓取。
由于水平有限,加之时间匆忙,如有谬处,还请各位大神批评指正

上一篇:给SAP Spartacus开源项目提交代码时的注意事项


下一篇:【双11背后的技术】17.5W秒级交易峰值下的混合云弹性架构之路