在Android中实现文件上传

2022-05-15 21:50:52

本例是我在年前的项目中用到的一个小例子，使用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的数据包（用本地电脑做服务器），因为这时的数据不经过网卡，所以无法抓取。
由于水平有限，加之时间匆忙，如有谬处，还请各位大神批评指正

码农公寓

相关文章