springMVC框架下——通用接口之图片上传接口

　　我所想要的图片上传接口是指服务器端在完成图片上传后，返回一个可访问的图片地址。

spring mvc框架下图片上传非常简单，如下　

@RequestMapping(value="/uploadImg", method=RequestMethod.POST)
@ResponseBody
public String uploadImg(@RequestParam(value="img")MultipartFile img){
    File f = new File("/data/images");
    try{
        FileUtils.copyInputStreamToFile(img.getInputStream(), f);
    }catch(Exception e){
        e.printStackTrace();
    }
    return "上传成功";
}

非常简单吧！

<form action="http://localhost/component/common/uploadImg" method="post" enctype="multipart/form-data">
    头像：<input type="file" name="img" /><br/>
    <input type="image" src="./images/img_submit.gif" />
</form>

以上仅仅只是能够上传文件而已，而我们还要能返回一个图片地址，这个图片地址要能在浏览器中直接访问，如下：

直接代码吧！

controller层

@RequestMapping(value="/uploadImg", method=RequestMethod.POST)
@ResponseBody
public String uploadImg(@RequestParam(value="img")MultipartFile img, HttpServletResponse response){
    JSONObject result = new JSONObject();
    boolean flag = true;
    try {
        flag = pictureUploadService.upload(img, result);
    } catch (Exception e) {
        result.put("mess", "调用失败");
        flag = false;
        e.printStackTrace();
    }
    result.put("flag", flag);
    
    response.setContentType("text/html;charset=UTF-8");
    //解决跨域名访问问题
    response.setHeader("Access-Control-Allow-Origin", "*");
    
    return result.toString();
}

service层

/**
 * 上传图片
 * @param file
 * @param params
 * @return
 * @throws Exception
 */
public boolean upload(MultipartFile file, JSONObject params) throws Exception{
    //过滤合法的文件类型
    String fileName = file.getOriginalFilename();
    String suffix = fileName.substring(fileName.lastIndexOf(".")+1);
    String allowSuffixs = "gif,jpg,jpeg,bmp,png,ico";
    if(allowSuffixs.indexOf(suffix) == -1){
        params.put("resultStr", "not support the file type!");
        return false;
    }
    
    //获取网络地址、本地地址头部
    Properties config = new Properties();
    config.load(this.getClass().getClassLoader().getResourceAsStream("config.properties"));
    String urlPath = config.getProperty("urlRoot");
    String localPath = config.getProperty("localRoot");
    
    //创建新目录
    String uri = File.separator + DateUtil.getNowDateStr(File.separator);
    File dir = new File(localPath + uri);
    if(!dir.exists()){
        dir.mkdirs();
    }
    
    //创建新文件
    String newFileName = StringUtil.getUniqueFileName();
    File f = new File(dir.getPath() + File.separator + newFileName + "." + suffix);
    
    //将输入流中的数据复制到新文件
    FileUtils.copyInputStreamToFile(file.getInputStream(), f);
    
    //创建Picture对象
    Picture pic = new Picture();
    pic.setLocalPath(f.getAbsolutePath());
    pic.setName(f.getName());
    pic.setUrl(urlPath + uri.replace("\", "/") + "/" + newFileName + "." + suffix);
    pic.setAddTime(new Date());
    
    //插入到数据库
    //...
    
    params.put("resultStr", pic.getUrl());
    
    return true;
}

（暂时没有dao层，我在properties中配置网络地址的域名以及本地文件存储目录）

上传文件有几个地方需要注意：

• 上传文件的中文乱码（这个暂不考虑，毕竟要实现的是图片上传）
• 限制上传文件大小（文件过大，会导致服务器不堪重负），这个我们在spring mvc的配置文件中进行限制

  <beans:bean id="multipartResolver" class="org.springframework.web.multipart.commons.CommonsMultipartResolver">
      <beans:property name="defaultEncoding" value="utf-8" />
      <beans:property name="maxUploadSize" value="10485760000" />
      <beans:property name="maxInMemorySize" value="40960" />
  </beans:bean>

• 限制上传文件类型（这个我们在service层进行处理）
• 如果一个文件夹下面保存超过1000个文件，就会影响文件访问性能，所以上传的文件要分散存储（这个分散策略有多种，不必拘泥于一种。我这里偷懒用了年月日作为目录层级）

  /**
   * 获取当前日期字符串
   * @param separator
   * @return
   */
  public static String getNowDateStr(String separator){
      Calendar now = Calendar.getInstance();
      int year = now.get(Calendar.YEAR);
      int month = now.get(Calendar.MONTH)+1;
      int day = now.get(Calendar.DATE);
      
      return year + separator + month + separator + day;
  }

• 上传成功后保存的文件不能重名（即文件名要唯一）

  //生成唯一的文件名
  public static String getUniqueFileName(){
      String str = UUID.randomUUID().toString();
      return str.replace("-", "");
  }

上传图片流程如下：

点击上传后，返回

在浏览器中输入上面的这个图片地址访问，然后出现