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("-", "");
  }

   

上傳圖片流程如下：

點擊上傳后，返回

在瀏覽器中輸入上面的這個圖片地址訪問，然后出現