DIV CSS 佈局教程網

用 jQuery ajaxSubmit() 一次搞定非同步圖片上傳與表單資料儲存
編輯:JavaScript綜合知識     

註冊頁面常有一個尷尬的需求:使用者要選一張 logo 圖片,同時填幾個欄位,按一次送出之後圖片和文字都要存進資料庫。傳統做法是表單先 post 到一個頁面存圖,再 redirect 回來存文字,流程又長又容易出錯。本文示範用 jQuery Form Plugin 的 ajaxSubmit(),把「先傳圖、成功後再存表單」串成一條非同步流程。

一、前端頁面(add.jsp)

頁面用 Bootstrap 排版,表單的 enctype 必須是 multipart/form-data,這是檔案上傳的前提。.jsp 開頭先統一編碼,並從 session 取出登入者資訊:

<%@ page language="java" contentType="text/html; charset=utf-8" pageEncoding="utf-8"%>
<%@ taglib uri="https://java.sun.com/jsp/jstl/core" prefix="c" %>
<c:set var="ctx" value="${pageContext.request.contextPath}" />
<%
  response.setCharacterEncoding("utf-8");   // 設定編碼方式
  response.setContentType("text/html");   // 設定網頁型別
  UserInformation user = null;
  String username = "";
  Integer userId = null;
  if (request.getSession().getAttribute("userinfo") != null) {
    user = (UserInformation) request.getSession().getAttribute("userinfo");
    username = user.getUsername();
    userId = user.getUserId();
  } else {
    username = "請<a href='login.jsp'>登入</a>";
  }
%>

表單本體,注意 id 是 uploadImgForm,稍後就是靠它呼叫 ajaxSubmit:

<form class="form-horizontal" method="post" action="${ctx}/upload/upload.do"
      id="uploadImgForm" enctype="multipart/form-data">
  <div class="control-group">
    <label class="control-label">*商圈名:</label>
    <div class="controls">
      <input type="text" name="businessName" maxlength="20" id="businessName" />
      <input type="text" name="userId" value="<%=userId%>" id="userId" />
      <div id="businessName_error"></div>
    </div>
  </div>
  <div class="control-group">
    <label class="control-label">*商圈 logo:</label>
    <div class="controls">
      <input type="file" name="file" id="file">
      <div id="file_error"></div>
    </div>
  </div>
  <div class="control-group">
    <label class="control-label">*商圈英文名:</label>
    <div class="controls">
      <input type="text" name="businessEname" id="businessEname" />
      <div id="businessEname_error"></div>
    </div>
  </div>
  <div class="form-actions">
    <button type="button" id="imgSave" class="btn btn-primary">提交註冊</button>
  </div>
</form>

二、驗證與送出邏輯

引入 jQuery 與 jquery.form.js 之後,先做即時驗證,再處理上傳。這裡有兩個值得注意的細節:副檔名用白名單比對,而不是猜;中文欄位在組查詢字串前要 encodeURI,否則後端收到的又是亂碼。

<script src="${ctx}/js/jquery-1.9.0.js"></script>
<script src="${ctx}/js/jquery.form.js"></script>
<script type="text/javascript">
$(document).ready(function () {

  // 驗證商圈名
  $("#businessName").blur(function () {
    var businessName = $("#businessName").val();
    if (businessName != "") {
      $("#businessName_error").html("<img src='${ctx}/images/success_img.gif' />");
    } else {
      $("#businessName_error").attr("class", "error_div")
        .html("<img src='${ctx}/images/error_img2.gif' />商圈名不能為空!");
    }
  });

  // 驗證商圈英文名
  $("#businessEname").blur(function () {
    var businessEname = $("#businessEname").val();
    if (businessEname != "") {
      $("#businessEname_error").html("<img src='${ctx}/images/success_img.gif' />");
    } else {
      $("#businessEname_error").attr("class", "error_div")
        .html("<img src='${ctx}/images/error_img2.gif' />商圈英文名不能為空!");
    }
  });

  // 圖片上傳 + 資料保存
  $("#imgSave").click(function () {
    var ext = '.jpg.jpeg.gif.bmp.png.';
    var f = $("#file").val();
    if (f == "") {                       // 先判斷是否已選擇檔案
      $("#file_error").attr("class", "error_div")
        .html("<img src='${ctx}/images/error_img2.gif' />請新增商圈 logo!");
      return false;
    }
    f = f.substr(f.lastIndexOf('.') + 1).toLowerCase();
    if (ext.indexOf('.' + f + '.') == -1) {
      $("#file_error").attr("class", "error_div")
        .html("<img src='${ctx}/images/error_img2.gif' />圖片格式不正確!");
      return false;
    }

    var options = {
      url: "${ctx}/upload/upload.do",
      dataType: 'json',
      contentType: "application/json; charset=utf-8",
      success: function (data) {
        // 圖片上傳成功後,才保存表單註冊資料
        if (data.status == "0") {
          var fileName = data.fileName;
          var businessName = $("#businessName").val();
          var userId = $("#userId").val();
          var businessEname = $("#businessEname").val();
          businessName = encodeURI(businessName);
          var urls = "${ctx}/business/addBusiness.do?businessName=" + businessName
                   + "&businessPic=" + fileName
                   + "&businessEname=" + businessEname
                   + "&userId=" + userId;
          $.ajax({
            type: "post",
            url: urls,
            dataType: "json",
            contentType: "application/json; charset=utf-8",
            success: function (data) {
              if (data.status == "0") {
                alert("註冊成功!");
              } else {
                alert("註冊失敗!原因是:" + data.message);
              }
            },
            error: function (XMLHttpRequest, textStatus, errorThrown) {
              alert(errorThrown);
            }
          });
        } else {
          $("#file_error").attr("class", "error_div")
            .html("<img src='${ctx}/images/error_img2.gif' />" + data.message);
        }
      }
    };
    $('#uploadImgForm').ajaxSubmit(options);   // 提交表單
  });
});
</script>

三、後端接收(SpringMVC Controller)

Controller 用 MultipartHttpServletRequest 取出檔案,重新命名後寫到暫存目錄,最後把結果序列化成 JSON 回給前端。這裡最容易忽略的是 finally 區塊中的 response.setContentType——少了它,回傳的 JSON 一定亂碼。

@Controller
@RequestMapping(value = "/upload")
public class FileUploadController {

    private Logger logger = Logger.getLogger(FileUploadController.class);

    @RequestMapping(value = "upload.do", method = RequestMethod.POST)
    public void fileUpload(HttpServletRequest request, HttpServletResponse response) {
        Map<String, Object> resultMap = new HashMap<String, Object>();
        String newRealFileName = null;
        try {
            MultipartHttpServletRequest multipartRequest = (MultipartHttpServletRequest) request;
            CommonsMultipartFile file = (CommonsMultipartFile) multipartRequest.getFile("file");
            String realFileName = file.getOriginalFilename();   // 取得原始檔名
            if (file.getSize() / 1024 >= 5 * 1024) {
                resultMap.put("status", 1);
                resultMap.put("message", "圖片不能大於 5M");
            } else {
                newRealFileName = getNowTime() + realFileName.substring(realFileName.indexOf("."));
                String ctxPath = request.getSession().getServletContext().getRealPath("//") + "//temp//";
                File dirPath = new File(ctxPath);
                if (!dirPath.exists()) {
                    dirPath.mkdir();
                }
                File uploadFile = new File(ctxPath + newRealFileName);
                FileCopyUtils.copy(file.getBytes(), uploadFile);
                resultMap.put("status", 0);
                resultMap.put("fileName", newRealFileName);
            }
        } catch (Exception e) {
            resultMap.put("status", 1);
            resultMap.put("message", "圖片上傳出錯");
            logger.info("***** 圖片上傳出錯 *****");
        } finally {
            PrintWriter out = null;
            try {
                out = response.getWriter();
            } catch (IOException e) {
                e.printStackTrace();
            }
            // 必須設定字元編碼,否則回傳的 JSON 會亂碼
            response.setContentType("text/html;charset=UTF-8");
            out.write(JSONSerializer.toJSON(resultMap).toString());
            out.flush();
            out.close();
        }
    }
}

四、流程小結

整個鏈路是:使用者按鈕 → 前端驗證 → ajaxSubmit 上傳圖片 → 後端回傳 status 與檔名 → 前端拿檔名再呼叫一次後端存業務資料 → 提示成功或失敗。兩段請求都用 status 欄位當作與後端的契約,前端只需判斷 0 與非 0,可讀性比一堆分散的 alert 好得多。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved