用 Ajax 與後端溝通時,JSON 是比 XML 更輕量、解析也更直覺的選擇。以下用「掃描二維碼接收訂單」這個場景,示範前端如何送出請求、後端如何回傳 JSON。
前端需引入 jquery-1.10.0.min.js;後端需要 org.json.jar 與 Apache Commons Logging(com.springsource.org.apache.commons.logging-1.1.1.jar)。
<form class="form-inline">
掃碼: <input id="txtQRCode" type="text">
<button id="btnReceive">確定</button>
</form>>
<script type="text/javascript">
$('#btnReceive').click(function () {
$.ajax({
type: "GET",
url: "<%=basePath%>asynchronous/receive.do",
data: { qrCode: $('#txtQRCode').val() },
dataType: "json",
cache: false,
success: function (msg) {
var flag = msg.flag;
var info = msg.info;
if (flag) {
alert(info);
$('#txtQRCode').val("");
} else {
alert(info);
}
},
error: function (error) { alert(error); }
});
});
</script>
這裡設定了 dataType: "json",jQuery 會自動把回應字串解析成物件,因此可以直接取用 msg.flag 與 msg.info,不必再自己 eval。加上 cache: false 則是避免掃碼結果被快取。
Controller 收到請求後,依序做幾件事:取出 qrCode 參數並去除空白、把二維碼內容解析成 JSON 取得 orderid、以訂單號查詢業務資料、更新訂單狀態、寫入流程記錄表,最後組出結果 JSON 回傳。
@Controller
@RequestMapping(value = "/asynchronous")
public class AsynchronousController {
private final static Log logger =
LogFactory.getLog(AsynchronousController.class);
/**
* 掃描二維碼,將訂單改為待審核
*/
@RequestMapping(value = "/receive")
public void receive(HttpServletRequest request,
HttpServletResponse response)
throws IOException, JSONException {
String rets = "";
boolean b = false;
try {
String qrcode = request.getParameter("qrCode") == null
? "" : request.getParameter("qrCode").toString().trim();
logger.info(qrcode);
if (!"".equals(qrcode)) {
JSONObject obj = new JSONObject(qrcode);
String orderid = obj.getString("orderid").trim();
if (!"".equals(orderid)) {
KeyRequestDao keyDao = new KeyRequestDao();
KeyRequest k = keyDao.findOneByOrderId(orderid);
if (k != null) {
// 修改訂單狀態為待審核
int n = keyDao.updateState(orderid,
String.valueOf(KeyRequestAttr.KqStateEnum.verify.getStep()));
Flow flow = new Flow();
FlowDao flowDao = new FlowDao();
UtcUsers users = (UtcUsers)
request.getSession().getAttribute("utcUsers");
flow.setKq_id(orderid);
flow.setKq_state(String.valueOf(
KeyRequestAttr.KqStateEnum.cus_send.getStep()));
flow.setKq_state_to(String.valueOf(
KeyRequestAttr.KqStateEnum.verify.getStep()));
flow.setIs_Pass(YesNoEnum.Y.getCode());
flow.setUser_id(users.getUser_id());
flow.setUser_id_from(users.getUser_id());
flow.setOpTimer(DateOperate.getDateTime());
int flowNum = flowDao.save(flow);
logger.info("掃碼提交結果:n=" + n + ";flowNum=" + flowNum);
if (n > 0) {
b = true;
rets = "UTC 接收訂單成功";
} else {
rets = "UTC 接收訂單失敗";
}
} else {
rets = "訂單查詢失敗";
}
} else {
rets = "二維碼中訂單號為空";
logger.error("二維碼中訂單號為空");
}
} else {
rets = "二維碼內容為空";
logger.error("二維碼內容為空");
}
} catch (Exception e) {
e.printStackTrace();
rets = e.getMessage();
logger.error(e.getMessage());
}
JSONObject ret = new JSONObject();
ret.put("flag", b);
ret.put("info", rets);
PrintWriter write = response.getWriter();
write.write(ret.toString());
write.flush();
}
}
逐層檢查而非一次巢狀。二維碼內容為空、訂單號為空、訂單查不到、更新失敗——每個環節都給明確訊息,前端才能提示使用者到底哪裡出了問題。這比一律回「失敗」友善得多。
用 JSONObject 組回應,不要手拼字串。手寫 "{\"flag\":" + b + "}" 一旦內容含引號就會產生非法 JSON。用 JSONObject.put() 由函式庫負責轉義,安全得多。
回應別忘了 Content-Type。若前端用 dataType: "json",後端最好明確輸出 application/json; charset=UTF-8,避免編碼與解析上的疑慮。
前端不要再用 eval。範例註解裡保留了 eval('('+msg+')') 這類舊寫法,那是為了說明「字串要變物件」的概念。實際上應一律改用 dataType: "json" 或 JSON.parse(),eval 會執行任意程式碼,是明確的安全風險。