Android项目——HttpUrlConnection上传文件（图片）

UI界面设计：

　　   

由于博客发布可能附加图片，但是图片（或者任何文件）信息必须放在http请求体的正文之中，这就需要我们使用HttpUrlConnection的时候构建Http正文。

我们先来看一下Http正文格式：

POST /api/feed/ HTTP/1.1  
Accept-Encoding: gzip  
Content-Length: 225873  
Content-Type: multipart/form-data; boundary=OCqxMF6-JxtxoMDHmoG5W5eY9MGRsTBp  
Host: www.myhost.com  
Connection: Keep-Alive  
  
--OCqxMF6-JxtxoMDHmoG5W5eY9MGRsTBp  
Content-Disposition: form-data; name="lng"  
Content-Type: text/plain; charset=UTF-8  
Content-Transfer-Encoding: 8bit  
  
116.361545  
--OCqxMF6-JxtxoMDHmoG5W5eY9MGRsTBp  
Content-Disposition: form-data; name="lat"  
Content-Type: text/plain; charset=UTF-8  
Content-Transfer-Encoding: 8bit  
  
39.979006  
--OCqxMF6-JxtxoMDHmoG5W5eY9MGRsTBp  
Content-Disposition: form-data; name="images"; filename="/storage/emulated/0/Camera/jdimage/1xh0e3yyfmpr2e35tdowbavrx.jpg"  
Content-Type: application/octet-stream  
Content-Transfer-Encoding: binary  
  
这里是图片的二进制数据  
--OCqxMF6-JxtxoMDHmoG5W5eY9MGRsTBp--  

格式分析

请求头分析

我们先看报文格式中的第一行：

POST /api/feed/ HTTP/1.1 

这一行就说明了这个请求的请求方式，即为POST方式，要请求的子路径为/api/feed/,例如我们的服务器地址为www.myhost.com,然后我们的这个请求的完整路径就是www.myhost.com/api/feed/，最后说明了HTTP协议的版本号为1.1。

Accept-Encoding: gzip  
Content-Length: 225873  
Content-Type: multipart/form-data; boundary=OCqxMF6-JxtxoMDHmoG5W5eY9MGRsTBp  
Host: www.myhost.com  
Connection: Keep-Alive  

这几个header的意思分别为服务器返回的数据需要使用gzip压缩、请求的内容长度为225873、内容的类型为"multipart/form-data"、请求参数分隔符(boundary)为OCqxMF6-JxtxoMDHmoG5W5eY9MGRsTBp、请求的根域名为www.myhost.com、HTTP连接方式为持久连接( Keep-Alive)。

 

其中这里需要注意的一点是分隔符，即boundary。boundary用于作为请求参数之间的界限标识，例如参数1和参数2之间需要有一个明确的界限，这样服务器才能正确的解析到参数1和参数2。但是分隔符并不仅仅是boundary，而是下面这样的格式：-- + boundary。例如这里的boundary为OCqxMF6-JxtxoMDHmoG5W5eY9MGRsTBp，那么参数分隔符则为:

--OCqxMF6-JxtxoMDHmoG5W5eY9MGRsTBp 

不管boundary本身有没有这个"--"，这个"--"都是不能省略的。

我们知道HTTP协议采用“请求-应答”模式，当使用普通模式，即非KeepAlive模式时，每个请求/应答客户和服务器都要新建一个连接，完成之后立即断开连接（HTTP协议为无连接的协议）；当使用Keep-Alive模式（又称持久连接、连接重用）时，Keep-Alive功能使客户端到服务器端的连接持续有效，当出现对服务器的后续请求时，Keep-Alive功能避免了建立或者重新建立连接。

请求实体分析

请求实体其实就是HTTP POST请求的参数列表，每个参数以请求分隔符开始，即-- + boundary。例如下面这个参数。

--OCqxMF6-JxtxoMDHmoG5W5eY9MGRsTBp  
Content-Disposition: form-data; name="lng"  
Content-Type: text/plain; charset=UTF-8  
Content-Transfer-Encoding: 8bit  
  
116.361545 

上面第一行为--OCqxMF6-JxtxoMDHmoG5W5eY9MGRsTBp，也就是--加上boundary内容，最后加上一个换行 （这个换行不能省略），换行的字符串表示为" "。第二行为Content-Disposition和参数名,这里的参数名为lng，即经度。Content-Disposition就是当用户想把请求所得的内容存为一个文件的时候提供一个默认的文件名，这里我们不过多关注。第三行为Content-Type，即WEB 服务器告诉浏览器自己响应的对象的类型，还有指定字符编码为UTF-8。第四行是描述的是消息请求(request)和响应(response)所附带的实体对象(entity)的传输形式，简单文本数据我们设置为8bit，文件参数我们设置为binary就行。然后添加两个换行之后才是参数的具体内容。例如这里的参数内容为116.361545。

注意这里的每行之间都是使用“ ”来换行的，最后一行和参数内容之间是两个换行。文件参数也是一样的格式，只是文件参数的内容是字节流。

这里要注意一下，普通文本参数和文件参数有如下两个地方的不同，因为其内容本身的格式是不一样的。

普通参数：

Content-Type: text/plain; charset=UTF-8  
Content-Transfer-Encoding: 8bit  

文件参数：

Content-Type: application/octet-stream  
Content-Transfer-Encoding: binary  

参数实体的最后一行是: --加上boundary加上--，最后换行，这里的 格式即为: --OCqxMF6-JxtxoMDHmoG5W5eY9MGRsTBp--。

具体代码如下：

public static void sendPostImg(String actionUrl, Map<String, File> files) throws IOException {

        String BOUNDARY = java.util.UUID.randomUUID().toString();   //利用系统工具类生成界限符
        String PREFIX = "--", LINEND = "
";
        String MULTIPART_FROM_DATA = "multipart/form-data";
        String CHARSET = "UTF-8";

        URL uri = new URL(actionUrl);
        HttpURLConnection conn = (HttpURLConnection) uri.openConnection();
        conn.setReadTimeout(5 * 1000); // 缓存的最长时间
        conn.setDoInput(true);// 允许输入
        conn.setDoOutput(true);// 允许输出
        conn.setUseCaches(false); // 不允许使用缓存
        conn.setRequestMethod("POST");
        conn.setRequestProperty("connection", "keep-alive");
        conn.setRequestProperty("Charsert", "UTF-8");
        conn.setRequestProperty("Content-Type", MULTIPART_FROM_DATA + ";boundary=" + BOUNDARY);

//        // 首先组拼文本类型的参数
//        StringBuilder sb = new StringBuilder();
//        for (Map.Entry<String, String> entry : params.entrySet())
//        {
//            sb.append(PREFIX);
//            sb.append(BOUNDARY);
//            sb.append(LINEND);
//            sb.append("Content-Disposition: form-data; name="" + entry.getKey() + """ + LINEND);
//            sb.append("Content-Type: text/plain; charset=" + CHARSET + LINEND);
//            sb.append("Content-Transfer-Encoding: 8bit" + LINEND);
//            sb.append(LINEND);
//            sb.append(entry.getValue());
//            sb.append(LINEND);
//        }

        DataOutputStream outStream = new DataOutputStream(conn.getOutputStream());
//        outStream.write(sb.toString().getBytes());
        InputStream in = null;
        // 发送文件数据
        if (files != null)
        {
            for (Map.Entry<String, File> file : files.entrySet())
            {
                StringBuilder sb1 = new StringBuilder();
                sb1.append(PREFIX);
                sb1.append(BOUNDARY);
                sb1.append(LINEND);
                // name是post中传参的键 filename是文件的名称
                sb1.append("Content-Disposition: form-data; name="file"; filename="" + file.getValue().getName() + """ + LINEND);
                sb1.append("Content-Type: application/octet-stream; charset=" + CHARSET + LINEND);
                sb1.append("Content-Transfer-Encoding: binary"+LINEND);
                sb1.append(LINEND);
                outStream.write(sb1.toString().getBytes());
                Log.d("file",sb1.toString());
                InputStream is = new FileInputStream(file.getValue());
                byte[] buffer = new byte[1024];
                int len = 0;
                while ((len = is.read(buffer)) != -1)
                {
                    outStream.write(buffer, 0, len);
                }

                is.close();
                outStream.write(LINEND.getBytes());
            }

            // 请求结束标志
            byte[] end_data = (PREFIX + BOUNDARY + PREFIX + LINEND).getBytes();
            outStream.write(end_data);
            outStream.flush();
            // 得到响应码
            int res = conn.getResponseCode();
            if (res == 200)
            {
                in = conn.getInputStream();
                int ch;
                StringBuilder sb2 = new StringBuilder();
                while ((ch = in.read()) != -1)
                {
                    sb2.append((char) ch);
                }
                Log.d(TAG,"状态码："+res);
            }else{
                Log.d(TAG,"状态码："+res);
            }
            outStream.close();
            conn.disconnect();
        }
        // return in.toString();
    }

代码是我参考其他博客改的，按照我自己的需求，将一些参数附加到URL后传输，Http正文只传输文件，因为我的参数决定了文件的命名格式，这样后台不用遍历查找参数后在遍历一次寻找文件了，当然，如果你的参数比较重要的话还是将参数写到Http正文中，这样较为安全。

后台文件接收代码：

String temppath="C:/Program Files/apache-tomcat-9.0.31-windows-x64/apache-tomcat-9.0.31/tempfile";
        String path="C:/Program Files/apache-tomcat-9.0.31-windows-x64/apache-tomcat-9.0.31/webapps/STDEverything/images/blog";
        
        String userid=request.getParameter("userid");
        String blogid=request.getParameter("blogid");
        
        DiskFileItemFactory disk = new DiskFileItemFactory(1024*10,new File(temppath));
        ServletFileUpload up = new ServletFileUpload(disk);
        List<FileItem> list;
        try {
            list=up.parseRequest(request);
            for(FileItem item:list) {
                if(!item.isFormField()) {
                    InputStream inputStream=item.getInputStream();
                    String filename=item.getName();
                    String imgname=userid+"_"+DBUtil.getIdentifier()+"_"+filename;
                    OutputStream outputStream=new FileOutputStream(path+"/"+imgname);
                    System.out.println(imgname);
                    int len=0;
                    byte buff[]=new byte[1024];
                    while((len=inputStream.read(buff))!=-1) {
                        outputStream.write(buff,0,len);
                    }
                    outputStream.flush();
                    outputStream.close();
                    inputStream.close();
                    DBUtil.writeBlogImg(request.getRequestURL().substring(0,request.getRequestURL().lastIndexOf("/"))
                            +"/images/blog/"+imgname, blogid);
                }else {
                    System.out.println(item.getFieldName());
                }
            }
        } catch (FileUploadException e) {
            // TODO Auto-generated catch block
            e.printStackTrace();
            response.getWriter().write("no");
        }
        response.getWriter().write("yes");

要想运行上文中的代码接收文件，需要导入两个jar包，

链接：http://pan.baidu.com/s/1jIbyn5s 密码：84se

关于后台接收文件的学习可以参考这篇博客：

https://blog.csdn.net/linghuainian/article/details/82253247?depth_1-utm_source=distribute.pc_relevant.none-task-blog-BlogCommendFromBaidu-3&utm_source=distribute.pc_relevant.none-task-blog-BlogCommendFromBaidu-3

值得一提的是，当传输文件时，你的Http正文编码格式必须改为"multipart/form-data"，然而改为这种格式之后，普通的request.getParameter方式就无法获取参数了，但可以获取fileitem.InputStream来进行转换，这也就是上文中说的为什么要遍历获取参数的原因。

至于Android项目的后期设想，因为博客图片是和博客id进行绑定的，而且我存进去的是该图片的网址，当后期显示博文的具体内容时，可以先请求下来博客网址信息，用Android的Glide插件异步加载图片。