DIV CSS 佈局教程網

Servlet + AJAX 打造搜尋框智慧提示
編輯:AJAX基礎知識     

用無刷新技術讓搜尋框即時變換提示關鍵字,效果就像搜尋引擎的下拉建議。

基本原理

1. 為搜尋框掛上事件:onkeyup(鍵盤輸入時觸發)、onfocus(取得焦點時)、onblur(失去焦點時清空提示)。

2. 取得使用者輸入後交給後端,後端比對詞庫並回傳 JSON;前端在回呼函式中解析,把結果渲染到搜尋框下方的展示區。

需要 JSON 支援的套件:

search.jsp

<%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%>
<html>
<head>
<title>ajax 搜尋</title>

<script type="text/javascript">
// 取得更多關聯字詞
function getMore() {
    var content = document.getElementById("keyword");

    // 沒有輸入時直接清空,避免殘留舊提示
    if (content.value == "") {
        keywordBlur();
        return;
    }

    // 建立 XmlHttp 物件(內部已處理跨瀏覽器相容)
    var xmlHttp = CreatXMLHttp();

    // 中文參數需編碼,否則後端會收到亂碼
    var url = "serch?keyword=" + escape(content.value);

    // 第三個參數 true 代表異步,send() 之後腳本繼續執行
    xmlHttp.open("GET", url, true);

    xmlHttp.onreadystatechange = callback;
    xmlHttp.send(null);

    // 回呼函式:只關心 readyState 為 4 的狀態
    function callback() {
        if (xmlHttp.readyState == 4) {
            // 200 成功、404 資源不存在、500 伺服器內部錯誤
            if (xmlHttp.status == 200) {
                var result = xmlHttp.responseText;
                // 兩側加小括號,eval 才會把它當物件而非程式碼區塊
                var json = eval("(" + result + ")");
                setContent(json);
            }
        }
    }

    // 把關聯資料渲染成表格列
    function setContent(contents) {
        keywordBlur();   // 先清掉舊的殘留資料

        var size = contents.length;
        for (var i = 0; i < size; i++) {
            var newRow = content_table_body.insertRow();
            var newCell = newRow.insertCell();
            newCell.innerHTML = contents[i];
        }
    }
}

// 建立 XmlHttp 物件
function CreatXMLHttp() {
    var xmlHttpReq;

    if (window.XMLHttpRequest) {
        // 標準瀏覽器
        xmlHttpReq = new XMLHttpRequest();
    } else {
        // 舊版 IE:先試新版 ActiveX,失敗再退回舊版
        try {
            xmlHttpReq = new ActiveXObject("Microsoft.XMLHTTP");
        } catch (e) {
            try {
                xmlHttpReq = new ActiveXObject("Msxml2.XMLHTTP");
            } catch (e) { }
        }
    }

    return xmlHttpReq;
}

// 失去焦點時清空提示
function keywordBlur() {
    var contentTableBody = document.getElementById("content_table_body");

    // 從後往前刪,避免索引錯位
    for (var i = contentTableBody.childNodes.length - 1; i >= 0; i--) {
        contentTableBody.removeChild(contentTableBody.childNodes[i]);
    }

    document.getElementById("popDiv").style.border = "none";
}
</script>

<style type="text/css">
.mouseOver { background: #708090; color: #FFFAFA; }
.mouseOut  { background: #FFFAFA; color: #000000; }
</style>
</head>
<body>
<div id="mydiv">
  <input type="text" id="keyword" size="50"
         onblur="keywordBlur()" onkeyup="getMore()" onfocus="getMore()" />
  <input type="button" value="搜尋一下">

  <div id="popDiv">
    <table id="contentTable" bgcolor="#FFFAFA" border="0"
           cellpadding="0" cellspacing="0">
      <tbody id="content_table_body"></tbody>
    </table>
  </div>
</div>
</body>
</html>

兩個細節值得留意:清空節點時從後往前迴圈,因為刪除會改變 childNodes 的索引,從前往後會漏刪;以及 escape() 編碼中文參數,避免查詢字串亂掉(現今更建議用 encodeURIComponent(),它對 UTF-8 的處理更完整)。

SearchServlet

package com.ninka;

import java.io.IOException;
import java.util.ArrayList;
import java.util.List;
import javax.servlet.ServletException;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import net.sf.json.JSONArray;

public class SearchServlet extends HttpServlet {

    static List<String> datas = new ArrayList<String>();

    static {
        datas.add("ajax1");
        datas.add("ajax2");
        datas.add("ajax3");
        datas.add("bichi1");
        datas.add("bichi2");
        datas.add("php");
        datas.add("javascript");
        datas.add("java");
        datas.add("html");
    }

    @Override
    protected void doGet(HttpServletRequest request, HttpServletResponse response)
            throws ServletException, IOException {

        request.setCharacterEncoding("UTF-8");
        response.setCharacterEncoding("UTF-8");

        // 參數名稱必須與前端一致,否則會拿到 null
        String keyword = request.getParameter("keyword");

        List<String> listData = getData(keyword);

        // 輸出 JSON 陣列
        response.getWriter().write(JSONArray.fromObject(listData).toString());
    }

    // 從詞庫中挑出包含關鍵字的項目
    public List<String> getData(String keyword) {
        List<String> list = new ArrayList<String>();
        for (String data : datas) {
            if (data.contains(keyword)) {
                list.add(data);
            }
        }
        return list;
    }
}

web.xml

<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns:xsi="https://www.w3.org/2001/XMLSchema-instance"
         xmlns="https://xmlns.jcp.org/xml/ns/javaee"
         xsi:schemaLocation="https://xmlns.jcp.org/xml/ns/javaee
         https://xmlns.jcp.org/xml/ns/javaee/web-app_3_1.xsd"
         id="WebApp_ID" version="3.1">

  <display-name>ajaxtest</display-name>

  <welcome-file-list>
    <welcome-file>search.jsp</welcome-file>
  </welcome-file-list>

  <servlet>
    <!-- servlet-name 故意與 js 中請求的 url 相同,省去額外映射 -->
    <servlet-name>search</servlet-name>
    <servlet-class>com.ninka.SearchServlet</servlet-class>
  </servlet>

  <servlet-mapping>
    <servlet-name>search</servlet-name>
    <url-pattern>/search</url-pattern>
  </servlet-mapping>
</web-app>

(這裡把 url-pattern 從 / 改為 /search。原本寫成 / 會攔截整站所有請求,一旦專案有其他 Servlet 或靜態資源就會全部失效。)

兩個實務提醒:一是前端用 eval() 解析 JSON 存在執行任意程式碼的風險,請改用 JSON.parse();二是每次按鍵都發一次請求, thực 作時應加上 debounce(例如停止輸入 300 毫秒後才送出),並在後端對 keyword 做長度下限與特殊字元過濾,否則使用者貼一大段文字進來會讓查詢變成負擔。

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