在Android中实现文件上传

作者: QxQx | 来源:发表于2017-02-15 09:50 被阅读6308次

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

    相关文章

      网友评论

      • jzhung:要点讲解的不错啊,讲清楚了使用HttpURLConnection上传文件的流程以及容易遇到的问题,BOUNDARYSTR 可以设置成随机字符串,避免和表单域的字段或者值出现冲突。 另外,可以直接使用Socket写字节流的方式模拟提交。对于练手学习来讲,可以直接试试用Socket模拟发送带附件的邮件,来更好的了解类似HTTP/SMTP/XMPP等应用层协议。
        QxQx: @jzhung 谢谢您的建议,BOUNDARYSTR使用随机字符串的问题我的老师跟我说过 我忘脑后了 您一说我想起来了😁
      • b358cd7c9fb8:老司机666

      本文标题:在Android中实现文件上传

      本文链接:https://www.haomeiwen.com/subject/lwafwttx.html