Web开发中，图片上传是一种极其常见的功能。但是呢，每次做上传，都花费了不少时间。
一个“小功能”花费我这么多时间，真心不愉快。
So，要得认真分析下原因。
1.在最初学习Java Web开发的时候，经验不足，属于能力问题，比如对技术认识不到位。
2.图片上传是一类问题，而不是一个问题。
比如，大家都会做饭，但每个人自己做饭是有不同的。做了一个人吃、一家人吃、喜事待客做好几桌，是不同的问题。
同样的，图片上传，是上传一张还是多张，前端的用户体验如何，后端逻辑处理是否正确，图片存储是否可靠。
本文主要探讨这个问题。
3. 有些情况，真不是我的问题。
比如，前端上传组件是别人写的，一会这样做，一会那样做，后端不断改。
比如，代码本来都不是我写的，是因为需求变化了，我接手了，然后自己改。
-------------------------------------------------------------------------
下面，重点探讨第2个原因，技术问题。
a.上传单个图片
html写个file类型的input，form设置一下，enctype="multipart/form-data"。
后端写个方法处理下就好，简要2点，1是用@RequestParam MultipartFile 接收一个文件，2是用FileUtils复制临时文件到目标文件。
@RequestMapping(value = "oneFileUpload", method = RequestMethod.POST)
public String uploadLoginSplash(HttpServletRequest request, @RequestParam("file") MultipartFile file)
throws IOException {
if (!file.isEmpty()) {
String realPath = request.getSession().getServletContext().getRealPath(SPLASH);
// 这里不必处理IO流关闭的问题，因为FileUtils.copyInputStreamToFile()方法内部会自动把用到的IO流关掉，我是看它的源码才知道的
FileUtils.copyInputStreamToFile(file.getInputStream(), new File(realPath, SPLASH_JPG));
} return "manager/setting/settingManager";
}
b. 上传多个图片。
方法一：
定义多个file，后端用数组接收@RequestParam("file") CommonsMultipartFile[] files。
一种比较灵活的方式是，写JS方法，点击“添加”和“删除”，可以选择增加上传图片的“上传框”。
这种方式，我没有去实践，在CSDN上看到了一篇不错的帖子，属于看了但没有去实践。
方法二：
使用图片上传组件，相比方法一，更加灵活，但也有缺点，后端接收不能直接使用数组CommonsMultipartFile[] files，我尝试了不太行。
前端上传组件，尝试的有webuploader，可以一次性选择多张图片，但是分批上传的。
尼玛，百度了下，原来是百度团队搞的，怪不得看起来用起来，好高端大气的样子。
官网：http://fex-team.github.io/webuploader/
最先用的是，dropzone，感觉还行，但是没有百度的看起来美观，一次性可以选择多张图片，但一次性全部上传。
官网：http://www.dropzonejs.com/
最先的最先，某个同事用的是jquery的上传组件，印象中是的。
后端处理多张图片的代码，比较通用的。
@RequestMapping("/idCardImageUpload")
public void idCardImageUpload(HttpServletRequest request,
HttpServletResponse response) throws IllegalStateException,
IOException {
// 创建一个通用的多部分解析器
CommonsMultipartResolver multipartResolver = new CommonsMultipartResolver(
request.getSession().getServletContext());
String finalFileName="";
// 判断 request 是否有文件上传,即多部分请求
if (multipartResolver.isMultipart(request)) {
// 转换成多部分request
MultipartHttpServletRequest multiRequest = (MultipartHttpServletRequest) request;
// 取得request中的所有文件名
Iterator<String> iter = multiRequest.getFileNames();
while (iter.hasNext()) {
// 取得上传文件
MultipartFile file = multiRequest.getFile(iter.next());
if (file != null) {
// 取得当前上传文件的文件名称
String fileName = file.getOriginalFilename();
// 如果名称不为“”,说明该文件存在，否则说明该文件不存在
if (StringUtils.isNotEmpty(fileName)) {
String[] strs = fileName.split("\\.");
String fileExtention="png";
// 重命名上传后的文件名
if(strs.length >=2){
fileExtention=strs[strs.length-1];
}
try {
fileName = AES.Encrypt(fileName, DateFormatUtil
.format(new Date(), "yyyyMMddHHmmssSSS")
.substring(1))+"."+fileExtention;
finalFileName +=fileName+",";
// 定义上传路径
String imagePath = (String) BasePropertyConfigurer
.getContextProperty("idCardImageUploadPath");
String path = imagePath + fileName;
File localFile = new File(path);
file.transferTo(localFile);
} catch (Exception e) {
e.printStackTrace();
}
}
}
}
JSONObject jsonObj = new JSONObject();
response.setContentType("text/html;charset=UTF-8");
jsonObj.put("success", true);
jsonObj.put("fileName",finalFileName);
returnJsonObject(response, jsonObj);
}
}
--------------------------------------------------------------------------------------------
上面介绍了原因，然后重点阐述了前后端的组件和实践方法，下面回归“图片上传问题”的本质，即流程问题。
图片上传流程
第一步：通过上传组件，选择一张或多张图片。
第二步：确定上传，把图片传到后端，后端接收图片，保存到某个位置。
第三步：前端提交表单，包括图片的名字等。
这个问题有点复杂，再补充几点：
第一：上传是可以同步的，也可以是异步的。
比如通过form提交到后端，也可以是通过jquery等插件AJAX提交。
异步提交的时候，需要后端“回显图片信息”，比如图片的名字、图片的URL。
第二：是否允许图片存储位置，有“脏数据”，即没有实际价值的图片。
比如，一个用户选择了图片，上传到了后端，但是表单可能没有提交。
如果，直接把用户的图片，放到实际的存储位置，就有脏数据了，但不影响图片的展示。
另外一种方式是，用户上传的图片，先存到一个特定的临时位置，用户确定上传图片后，把这里的图片移动到，实际的存储位置。
第三：图片信息存到数据库。
个人觉得，只存储图片的名字比较好，至于路径，存到数据库之后，会非常不灵活。
前端展示图片，自定义url路径，比如/image/a.jpg，后端把/image路径映射到实际的图片位置。
第四：图片的名字。
把用户上传时的名字，作为实际存储的图片名字不好，一是中文容易出问题，二是不能保证唯一性，会存在覆盖的可能性。
个人觉得，图片的名字用时间+随机数等方式生成唯一的名字，比如abcd.jpg。
这个时候需要注意，图片的后缀，需要从用户上传的图片名字解析出来，比如从“小雷FansUnion.png”解析出后缀".png"，把
“小雷FansUnion.gif”存为“abcd.png”可能无法正常显示。
第五：图片上传也可以使用云服务。
2014年春，做ITFriend的时候，用的是“美图秀秀的图片上传组件”。云服务用着还是不错的，上传之后，可以立即进行“美化”“涂鸦”等操作。
最终，再保存到数据库。
第六：图片存储也可以使用云服务。。
个人觉得，图片一定要存储到Tomcat等服务器的外部。有的人为了方便，把图片存储到Tomcat的webapps目录，这样比较危险，tomcat重启-重新部署，可能会把图片给搞丢了。
存储到硬盘等外部，做个图片请求映射就好。
还有一种方式，图片存储也使用“云存储”，又拍云用着还凑合。
-------------------------------------------------
总结，图片上传其实是个很复杂的问题。
没有足够经验，不懂实际需求的开发者，进度会估计不准。
参考资料
http://fex-team.github.io/webuploader/
http://www.dropzonejs.com/
http://blog.csdn.net/a1314517love/article/details/24183273
秒针工作时，BrandCenter项目积累
朋来谷工作时，ITFriend项目积累
一起好工作时，p2p项目积累