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

笛里谁知壮士心，沙头空照征人骨。这篇文章主要讲述Android项目——HttpUrlConnection上传文件（图片）相关的知识，希望能为你提供帮助。
UI界面设计：

文章图片

文章图片

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

1 POST /api/feed/ HTTP/1.1 2 Accept-Encoding: gzip 3 Content-Length: 225873 4 Content-Type: multipart/form-data; boundary=OCqxMF6-JxtxoMDHmoG5W5eY9MGRsTBp 5 Host: www.myhost.com 6 Connection: Keep-Alive 7 8 --OCqxMF6-JxtxoMDHmoG5W5eY9MGRsTBp 9 Content-Disposition: form-data; name="lng" 10 Content-Type: text/plain; charset=UTF-8 11 Content-Transfer-Encoding: 8bit 12 13 116.361545 14 --OCqxMF6-JxtxoMDHmoG5W5eY9MGRsTBp 15 Content-Disposition: form-data; name="lat" 16 Content-Type: text/plain; charset=UTF-8 17 Content-Transfer-Encoding: 8bit 18 19 39.979006 20 --OCqxMF6-JxtxoMDHmoG5W5eY9MGRsTBp 21 Content-Disposition: form-data; name="images"; filename="/storage/emulated/0/Camera/jdimage/1xh0e3yyfmpr2e35tdowbavrx.jpg" 22 Content-Type: application/octet-stream 23 Content-Transfer-Encoding: binary 24 25 这里是图片的二进制数据 26 --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。例如下面这个参数。

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

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

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

【Android项目——HttpUrlConnection上传文件（图片）】文件参数：

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

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

具体代码如下：

1 public static void sendPostImg(String actionUrl, Map< String, File> files) throws IOException { 2 3String BOUNDARY = java.util.UUID.randomUUID().toString(); //利用系统工具类生成界限符 4String PREFIX = "--", LINEND = "\\r\\n"; 5String MULTIPART_FROM_DATA = "https://www.songbingjia.com/android/multipart/form-data"; 6String CHARSET = "UTF-8"; 7 8URL uri = new URL(actionUrl); 9HttpURLConnection conn = (HttpURLConnection) uri.openConnection(); 10conn.setReadTimeout(5 * 1000); // 缓存的最长时间 11conn.setDoInput(true); // 允许输入 12conn.setDoOutput(true); // 允许输出 13conn.setUseCaches(false); // 不允许使用缓存 14conn.setRequestMethod("POST"); 15conn.setRequestProperty("connection", "keep-alive"); 16conn.setRequestProperty("Charsert", "UTF-8"); 17conn.setRequestProperty("Content-Type", MULTIPART_FROM_DATA + "; boundary=" + BOUNDARY); 18 19 //// 首先组拼文本类型的参数 20 //StringBuilder sb = new StringBuilder(); 21 //for (Map.Entry< String, String> entry : params.entrySet()) 22 //{ 23 //sb.append(PREFIX); 24 //sb.append(BOUNDARY); 25 //sb.append(LINEND); 26 //sb.append("Content-Disposition: form-data; name=\\"" + entry.getKey() + "\\"" + LINEND); 27 //sb.append("Content-Type: text/plain; charset=" + CHARSET + LINEND); 28 //sb.append("Content-Transfer-Encoding: 8bit" + LINEND); 29 //sb.append(LINEND); 30 //sb.append(entry.getValue()); 31 //sb.append(LINEND); 32 //} 33 34DataOutputStream outStream = new DataOutputStream(conn.getOutputStream()); 35 //outStream.write(sb.toString().getBytes()); 36InputStream in = null; 37// 发送文件数据 38if (files != null) 39{ 40for (Map.Entry< String, File> file : files.entrySet()) 41{ 42StringBuilder sb1 = new StringBuilder(); 43sb1.append(PREFIX); 44sb1.append(BOUNDARY); 45sb1.append(LINEND); 46// name是post中传参的键 filename是文件的名称 47sb1.append("Content-Disposition: form-data; name=\\"file\\"; filename=\\"" + file.getValue().getName() + "\\"" + LINEND); 48sb1.append("Content-Type: application/octet-stream; charset=" + CHARSET + LINEND); 49sb1.append("Content-Transfer-Encoding: binary"+LINEND); 50sb1.append(LINEND); 51outStream.write(sb1.toString().getBytes()); 52Log.d("file",sb1.toString()); 53InputStream is = new FileInputStream(file.getValue()); 54byte[] buffer = new byte[1024]; 55int len = 0; 56while ((len = is.read(buffer)) != -1) 57{ 58outStream.write(buffer, 0, len); 59} 60 61is.close(); 62outStream.write(LINEND.getBytes()); 63} 64 65// 请求结束标志 66byte[] end_data = https://www.songbingjia.com/android/(PREFIX + BOUNDARY + PREFIX + LINEND).getBytes(); 67outStream.write(end_data); 68outStream.flush(); 69// 得到响应码 70int res = conn.getResponseCode(); 71if (res == 200) 72{ 73in = conn.getInputStream(); 74int ch; 75StringBuilder sb2 = new StringBuilder(); 76while ((ch = in.read()) != -1) 77{ 78sb2.append((char) ch); 79} 80Log.d(TAG,"状态码："+res); 81}else{ 82Log.d(TAG,"状态码："+res); 83} 84outStream.close(); 85conn.disconnect(); 86} 87// return in.toString(); 88}

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

1 String temppath="C:/Program Files/apache-tomcat-9.0.31-windows-x64/apache-tomcat-9.0.31/tempfile"; 2String path="C:/Program Files/apache-tomcat-9.0.31-windows-x64/apache-tomcat-9.0.31/webapps/STDEverything/images/blog"; 3 4String userid=request.getParameter("userid"); 5String blogid=request.getParameter("blogid"); 6 7DiskFileItemFactory disk = new DiskFileItemFactory(1024*10,new File(temppath)); 8ServletFileUpload up = new ServletFileUpload(disk); 9List< FileItem> list; 10try { 11list=up.parseRequest(request); 12for(FileItem item:list) { 13if(!item.isFormField()) { 14InputStream inputStream=item.getInputStream(); 15String filename=item.getName(); 16String imgname=userid+"_"+DBUtil.getIdentifier()+"_"+filename; 17OutputStream outputStream=new FileOutputStream(path+"/"+imgname); 18System.out.println(imgname); 19int len=0; 20byte buff[]=new byte[1024]; 21while((len=inputStream.read(buff))!=-1) { 22outputStream.write(buff,0,len); 23} 24outputStream.flush(); 25outputStream.close(); 26inputStream.close(); 27DBUtil.writeBlogImg(request.getRequestURL().substring(0,request.getRequestURL().lastIndexOf("/")) 28+"/images/blog/"+imgname, blogid); 29}else { 30System.out.println(item.getFieldName()); 31} 32} 33} catch (FileUploadException e) { 34// TODO Auto-generated catch block 35e.printStackTrace(); 36response.getWriter().write("no"); 37} 38response.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插件异步加载图片。