剛學完 SSM(Spring + Spring MVC + MyBatis)框架,試著做了一個 AJAX 校驗的功能,成功後把設定分享出來。

關鍵是 JSON 相關的套件,Spring MVC 要輸出 JSON,靠的是 Jackson 系列的 jackson-databind、jackson-core 與 jackson-annotations。
<!-- 讓註解式控制器能使用訊息轉換器 -->
<bean class="org.springframework.web.servlet.mvc.annotation.AnnotationMethodHandlerAdapter">
<property name="messageConverters">
<list>
<ref bean="mappingJackson2HttpMessageConverter" />
</list>
</property>
</bean>
<bean id="mappingJackson2HttpMessageConverter"
class="org.springframework.http.converter.json.MappingJackson2HttpMessageConverter">
<property name="supportedMediaTypes">
<list>
<value>text/html;charset=UTF-8</value>
<value>text/json;charset=UTF-8</value>
<value>application/json;charset=UTF-8</value>
</list>
</property>
</bean>註冊 MappingJackson2HttpMessageConverter 之後,控制器只要標上 @ResponseBody 並回傳物件,Spring 就會自動序列化成 JSON,不必手動 json.dumps 或 writeValueAsString。這是三種 SSM 輸出 JSON 的做法裡最省事的一種。
若使用 Spring 4 以後的版本,也可以直接用更簡短的 <mvc:annotation-driven />,它預設就會註冊 Jackson 轉換器。
@ResponseBody
@RequestMapping(value = "queryByUser",
method = RequestMethod.POST,
produces = "application/json;charset=UTF-8")
public User queryByName(User user, HttpServletRequest request) {
User u = userBiz.queryByName(user);
return u;
}回傳型別直接寫成 User,Spring 會轉成 {"userId":1,"username":"..."} 這樣的 JSON。查不到使用者時回傳 null,前端就以「是否為 null」判斷帳號可用與否。
function checkUser() {
var username = $("#username").val();
$.ajax({
url: "queryByUser",
type: "post",
data: { "username": username },
dataType: "json",
success: function (data) {
if (data != null) {
$("#userSpan").text("使用者名稱已存在");
$("#username").val('');
} else if (username != '') {
$("#userSpan").text("使用者名稱可用");
}
}
});
}
加上 else if (username != '') 這層判斷,可以避免輸入框清空時還顯示「可用」的誤導訊息——這類邊界條件往往比主流程更容易被漏掉。
實務建議:輸入框記得搭配 blur 或加上 debounce 的 keyup 觸發,不要每打一個字就查一次資料庫;後端也應對 username 加上格式與長度驗證,並在資料庫層建立唯一索引作為最後防線,畢竟前端校驗只是為了改善體驗,真正的把關仍要在伺服器端。