Android端通过HttpURLConnection上传文件到服务器
一：实现原理
最近在做Android客户端的应用开发，涉及到要把图片上传到后台服务器中，自己选择了做Spring3 MVC HTTP API作为后台上传接口，android客户端我选择用HttpURLConnection来通过form提交文件数据实现上传功能，本来想网上搜搜拷贝一下改改代码就好啦，发现根本没有现成的例子，多数的例子都是基于HttpClient的或者是基于Base64编码以后作为字符串来传输图像数据，于是我不得不自己动手，参考了网上一些资料，最终实现基于HttpURLConnection上传文件的android客户端代码，废话少说，其实基于HttpURLConnection实现文件上传最关键的在于要熟悉Http协议相关知识，知道MIME文件块在Http协议中的格式表示，基本的传输数据格式如下：
其中boundary表示form的边界，只要按照格式把内容字节数写到HttpURLConnection的对象输出流中，服务器端的Spring Controller 就会自动响应接受，跟从浏览器页面上上传文件是一样的。
服务器端HTTP API， 我是基于Spring3 MVC实现的Controller，代码如下：
1 @RequestMapping(value = "/uploadMyImage/{token}", method = RequestMethod.POST) 2 public @ResponseBody String getUploadFile(HttpServletRequest request, HttpServletResponse response, 3 @PathVariable String token) { 4 logger.info("spring3 MVC upload file with Multipart form"); 5 logger.info("servlet context path : " + request.getSession().getServletContext().getRealPath("/")); 6 UserDto profileDto = userService.getUserByToken(token); 7 String imgUUID = ""; 8 try { 9 if (request instanceof MultipartHttpServletRequest && profileDto.getToken() != null) { 10 MultipartHttpServletRequest multipartRequest = (MultipartHttpServletRequest) request; 11 logger.info("spring3 MVC upload file with Multipart form"); 12 // does not work, oh my god!! 13 MultipartFile file = multipartRequest.getFiles("myfile").get(0); 14 InputStream input = file.getInputStream(); 15 long fileSize = file.getSize(); 16 BufferedImage image = ImageIO.read(input); 17 // create data transfer object 18 ImageDto dto = new ImageDto(); 19 dto.setCreateDate(new Date()); 20 dto.setFileName(file.getOriginalFilename()); 21 dto.setImage(image); 22 dto.setCreator(profileDto.getUserName()); 23 dto.setFileSize(fileSize); 24 dto.setType(ImageAttachmentType.CLIENT_TYPE.getTitle()); 25 dto.setUuid(UUID.randomUUID().toString()); 26 27 /// save to DB 28 imgUUID = imageService.createImage(dto); 29 input.close(); 30 } 31 } catch (Exception e) { 32 e.printStackTrace(); 33 logger.error("upload image error", e); 34 } 35 36 return imgUUID; 37 }
Android客户端基于HttpURLConnection实现上传的代码，我把它封装成一个单独的类文件，这样大家可以直接使用，只要传入上传的URL等参数即可。代码如下：
package com.demo.http; import java.io.BufferedInputStream; import java.io.DataOutputStream; import java.io.File; import java.io.FileInputStream; import java.io.IOException; import java.io.InputStream; import java.net.HttpURLConnection; import java.net.URL; import java.util.Random; import android.os.Handler; import android.util.Base64; import android.util.Log; public class UploadImageTask implements APIURLConstants { private String requestURL = DOMAIN_ADDRESS + UPLOAD_DESIGN_IMAGE_URL; // default private final String CRLF = " "; private Handler handler; private String token; public UploadImageTask(String token, Handler handler) { this.handler = handler; this.token = token; } public String execute(File...files) { InputStream inputStream = null; HttpURLConnection urlConnection = null; FileInputStream fileInput = null; DataOutputStream requestStream = null; handler.sendEmptyMessage(50); try { // open connection URL url = new URL(requestURL.replace("{token}", this.token)); urlConnection = (HttpURLConnection) url.openConnection(); // create random boundary Random random = new Random(); byte[] randomBytes = new byte[16]; random.nextBytes(randomBytes); String boundary = Base64.encodeToString(randomBytes, Base64.NO_WRAP); /* for POST request */ urlConnection.setDoOutput(true); urlConnection.setDoInput(true); urlConnection.setUseCaches(false); urlConnection.setRequestMethod("POST"); long size = (files[0].length() / 1024); if(size >= 1000) { handler.sendEmptyMessage(-150); return "error"; } // 构建Entity form urlConnection.setRequestProperty("Connection", "Keep-Alive"); urlConnection.setRequestProperty("Content-Type", "multipart/form-data;boundary=" + boundary); urlConnection.setRequestProperty("Cache-Control", "no-cache"); // never try to chunked mode, you need to set a lot of things // if(size > 400) { // urlConnection.setChunkedStreamingMode(0); // } // else { // urlConnection.setFixedLengthStreamingMode((int)files[0].length()); // } // end comment by zhigang on 2016-01-19 /* upload file stream */ fileInput = new FileInputStream(files[0]); requestStream = new DataOutputStream(urlConnection.getOutputStream()); String nikeName = "myfile"; requestStream = new DataOutputStream(urlConnection.getOutputStream()); requestStream.writeBytes("--" + boundary + CRLF); requestStream.writeBytes("Content-Disposition: form-data; name="" + nikeName + ""; filename="" + files[0].getName() + """+ CRLF); requestStream.writeBytes("Content-Type: " + getMIMEType(files[0]) + CRLF); requestStream.writeBytes(CRLF); // 写图像字节内容 int bytesRead; byte[] buffer = new byte[8192]; handler.sendEmptyMessage(50); while((bytesRead = fileInput.read(buffer)) != -1) { requestStream.write(buffer, 0, bytesRead); } requestStream.flush(); requestStream.writeBytes(CRLF); requestStream.flush(); requestStream.writeBytes("--" + boundary + "--" + CRLF); requestStream.flush(); fileInput.close(); // try to get response int statusCode = urlConnection.getResponseCode(); if (statusCode == 200) { inputStream = new BufferedInputStream(urlConnection.getInputStream()); String imageuuId = HttpUtil.convertInputStreamToString(inputStream); Log.i("image-uuid", "uploaded image uuid : " + imageuuId); handler.sendEmptyMessage(50); return imageuuId; } } catch (Exception e) { e.printStackTrace(); } finally { if (inputStream != null) { try { inputStream.close(); } catch (IOException e) { e.printStackTrace(); } } if(requestStream != null) { try { requestStream.close(); } catch (IOException e) { e.printStackTrace(); } } if(fileInput != null) { try { fileInput.close(); } catch (IOException e) { e.printStackTrace(); } } if (urlConnection != null) { urlConnection.disconnect(); } } handler.sendEmptyMessage(50); return null; } private String getMIMEType(File file) { String fileName = file.getName(); if(fileName.endsWith("png") || fileName.endsWith("PNG")) { return "image/png"; } else { return "image/jpg"; } } }