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