Sun Java System Web Server 包含一個預設搜尋應用程式,可提供基本的搜尋查詢和搜尋結果頁面。可以直接使用這些網頁,也可以進行自訂以滿足特定需要。這種自訂可以像使用其他標誌重新設置網頁一樣簡單,也可以像變更搜尋結果顯示順序一樣複雜。
預設的搜尋應用程式提供 JSP 範例,說明如何使用搜尋標籤程式庫來建立自訂搜尋介面。您可以查看 /bin/https/webapps/search 中做為應用程式範例的預設搜尋應用程式,該應用程式說明可自訂搜尋標籤的用法。
預設的搜尋介面由以下四個主要的元件構成: 頁首、頁尾、查詢表單和結果。
僅變更標籤的屬性值,即可輕鬆自訂這些基本元素。可以使用標籤程式庫完成更為詳細的自訂。
搜尋介面包含以下元件:
標頭包括標誌、標題和簡短描述。
註腳包含版權資訊。
查詢表單包含一組表示搜尋集合的核取方塊、查詢輸入方塊以及提交和說明按鈕。
依預設,每頁列出 10 個結果記錄。對於每條記錄,將顯示標題、段落、大小、建立日期和 URL 等資訊。段落是頁面中反白顯示相符文字的一個短片段。
查詢表單包含搜尋集合的核取方塊清單、查詢輸入方塊和提交按鈕。此表單是使用 <s1ws:form> 標籤以及 <collElem>、<queryBox> 和 <submitButton> 標籤建立的,具有以下預設值:
<s1ws:form> <s1ws:collElem> <s1ws:queryBox> <s1ws:submitButton> </s1ws:form>
可以將查詢表單放到頁面的任意位置:中間、側邊等。也可以用不同格式顯示查詢表單,例如使用一個橫框,其中集合選取方塊、查詢字串輸入方塊以及 [提交] 按鈕水平排列;或顯示為一個區段,其中集合顯示為核取方塊,查詢輸入方塊和 [提交] 按鈕置於下方。
以下範例顯示了如何使用 <searchForm> 標籤集來建立不同格式的查詢表單。
以下程式碼範例將建立一個表單,其中包含所有集合的選取方塊、查詢輸入方塊和提交按鈕,均排在一列。
<s1ws:form> <table cellspacing="0" cellpadding="3" border="0"> <tr class="navBar"> <td class="navBar"><s1ws:collElem type=”select”></td> <td class="navBar"> <s1ws:querybox size="30"> <s1ws:submitButton class="navBar" style="padding: 0px; margin: 0px; width: 50px"> </td> </tr> </table> </s1ws:form>
您可以建立一個表單區段,其中表單元素排列在一個提要欄位中,表單區段的標題為「搜尋」,使用的格式與提要欄位中其他項目的格式相同。
在下面的程式碼範例中,表單內文包含三個排成一行的核取方塊,其中列出可用的搜尋集合。查詢輸入方塊和 [提交] 按鈕置於下方:
<s1ws:searchForm> <table> <!--... other sidebar items ... --> <tr class="Title"><td>Search</td></tr> <tr class="Body"> <td> <table cellspacing="0" cellpadding="3" border="0"> <tr class="formBlock"> <td class="formBlock"> <s1ws:collElem type="checkbox" cols="1" values="1,0,1,0" /> </td> </tr> <tr class="formBlock"> <td class="formBlock"> <s1ws:querybox size="15" maxlength="50"> </td> </tr> <tr class="formBlock"> <td class="formBlock"> <s1ws:submitButton class="navBar" style="padding: 0px; margin: 0px; width: 50px"> </td> </tr> </table> </td> </tr> </table> </s1ws:searchForm>
搜尋結果按照以下方式產生:
<formAction> 標籤擷取所有表單元素的值並進行基本驗證。
<search> 標籤、<resultIteration> 標籤和其他標籤都存在於 <formAction> 標籤中,可存取所有表單元素的值。
<search> 標籤透過 <formAction> 使用查詢字串和集合來執行搜尋,並將搜尋結果儲存在 pageContext 中。
<resultIteration> 標籤隨後將擷取結果集並重複運算。
僅變更標籤的屬性值,即可自訂搜尋結果頁面。
以下程式碼範例以標題列開頭,隨後顯示指定數目的記錄,最後為瀏覽位址列。標題列含有搜尋作業所使用的查詢字串,以及回傳記錄總數的範圍,如 1– 10。每一筆記錄的記錄區段都會顯示含有檔案連結的標題,其中多達三個段落含有反白顯示的關鍵字:文件的 URL、建立日期與大小。
在該區段的末尾處,瀏覽位址列與上一頁和下一頁的連結,以及與目前頁之前和之後八個其他頁面的直接連結。
<s1ws:formAction /> <s1ws:formSubmission success="true" > <s1ws:search scope="page" /> <!--search results--> (...html omitted...) <s1ws:resultStat formId="test" type="total" /></b> Results Found, Sorted by Relevance</span></td><td> <span class="body"><a href="/search/search.jsp?">Sort by Date</a></span></td> <td align="right"><span class="body"> <s1ws:resultNav formId="test" type="previous" caption="<img border=0 src=\\"images/arrow-left.gif\\" alt=\\"Previous\\">" /> <s1ws:resultStat formId="test" type="range" /> <s1ws:resultNav formId="test" type="next" caption="<img border=0 src=\\"images/arrow-right.gif\\" alt=\\"Next\\">" /> <!img alt="Next" src="images/arrow-right.gif" border="0" WIDTH="13" HEIGHT="9"> (...html omitted...) <table border=0> <s1ws:resultIteration formId="test" start="1" results="15"> <tr class=body> <td valign=top> <s1ws:item property=’number’ />. </td> <td> <b><a href="<s1ws:item property=’url’ />"><s1ws:item property=’title’ /></a></b> <br> <s1ws:item property=’passages’ /> <font color="#999999" size="-2"> <s1ws:item property=’url’ /> - <s1ws:item property=’date’ /> - <s1ws:item property=’size’ /> KB </font><br><br> </td> </tr> </s1ws:resultIteration> </table> (...html omitted...) <s1ws:resultNav formId="test" type="previous" /> <s1ws:resultNav formId="test" type="full" offset="8" /> <s1ws:resultNav formId="test" type="next" /> (...html omitted...) </s1ws:formSubmission>
透過處理標籤和修改 HTML,可以輕鬆自訂基本搜尋結果介面。例如,可以複製瀏覽位址列並將其放到搜尋結果前面。使用者也可以選擇顯示或不顯示搜尋記錄的任何特性。
除了與表單一起使用外,<search>、<resultIterate> 和相關標籤還可用於列出的特定主題。以下程式碼範例可列出某個網站上前十篇有關 Java Web 服務的文章:
<s1ws:search collection="Articles" query="Java Web Services" /> <table cellspacing="0" cellpadding="3" border="0"> <tr class="Title"><td>Java Web Services</td></tr> </table> <table cellspacing="0" cellpadding="3" border="0"> <s1ws:resultIteration> <tr> <td><a href="<s1ws:item property=’URL’ />"> <s1ws:item property=’Title’/></a></td> </tr> </s1ws:resultIteration> </table>
如果需要將表單頁面和結果頁面分開,您必須使用 <form> 標籤集建立表單頁面,並使用 <formAction> 標籤集建立結果頁面。
需要在結果頁面中增加與表單頁面的連結,以使頁面銜接順暢。
請注意以下標籤慣例:
標籤類別屬於套裝模組 com.sun.web.search.taglibs。
所有 pageContext 屬性的前綴均為 com.sun.web。例如,搜尋結果的屬性為 com.sun.web.searchresults.form_id,其中 form_id 為表單名稱。
可以使用 s1ws 前綴來參照標籤程式庫。標籤的名稱及其屬性是大小寫混合的,其中每個內部單字的首字母大寫,例如 pageContext。
Sun Java System Web Server 包括一組 JSP 標籤,可用於自訂搜尋介面中的搜尋查詢和搜尋結果頁面。
如需可用於自訂搜尋頁面的完整 JSP 標籤清單,請參閱「Sun Java System Web Server 7.0 Developer’s Guide to Web Applications」。