3.2 JSP標簽和指令 · JavaWeb項目開發學習手冊

# JSP指令 JSP指令用來設置整個JSP頁面相關的屬性，如網頁的編碼方式和腳本語言。語法格式如下： ~~~ <%@ directive attribute="value" %> ~~~ 指令可以有很多個屬性，它們以鍵值對的形式存在，并用逗號隔開。 JSP中的三種指令標簽： | **指令** | **描述** | | --- | --- | | <% @ page ...| 定義網頁依賴屬性，比如腳本語言、error頁面、緩存需求等等 | | <% @ include ...%> | 包含其他文件 | | <% @taglib ...%>| 引入標簽庫的定義 | * * * ## Page指令 Page指令為容器提供當前頁面的使用說明。一個JSP頁面可以包含多個page指令。 Page指令的語法格式： ~~~ <%@ page attribute="value" %> ~~~ 等價的XML格式： ~~~ <jsp:directive.page attribute="value" /> ~~~ * * * ## 屬性下表列出與Page指令相關的屬性： | **屬性** | **描述** | | --- | --- | | buffer | 指定out對象使用緩沖區的大小 | | autoFlush | 控制out對象的?緩存區 | | contentType | 指定當前JSP頁面的MIME類型和字符編碼 | | errorPage | 指定當JSP頁面發生異常時需要轉向的錯誤處理頁面 | | isErrorPage | 指定當前頁面是否可以作為另一個JSP頁面的錯誤處理頁面 | | extends | 指定servlet從哪一個類繼承 | | import | 導入要使用的Java類 | | info | 定義JSP頁面的描述信息 | | isThreadSafe | 指定對JSP頁面的訪問是否為線程安全 | | language | 定義JSP頁面所用的腳本語言，默認是Java | | session | 指定JSP頁面是否使用session | | isELIgnored | 指定是否執行EL表達式 | | isScriptingEnabled | 確定腳本元素能否被使用 | * * * ## Include指令 JSP可以通過include指令來包含其他文件。被包含的文件可以是JSP文件、HTML文件或文本文件。包含的文件就好像是該JSP文件的一部分，會被同時編譯執行。 Include指令的語法格式如下： ~~~ <%@ include file="文件相對 url 地址" %> ~~~ **include**指令中的文件名實際上是一個相對的 URL 地址。如果您沒有給文件關聯一個路徑，JSP編譯器默認在當前路徑下尋找。等價的XML語法： ~~~ <jsp:directive.include file="文件相對 url 地址" /> ~~~ * * * ## Taglib指令 JSP API允許用戶自定義標簽，一個自定義標簽庫就是自定義標簽的集合。 Taglib指令引入一個自定義標簽集合的定義，包括庫路徑、自定義標簽。 Taglib指令的語法： ~~~ <%@ taglib uri="uri" prefix="prefixOfTag" %> ~~~ uri屬性確定標簽庫的位置，prefix屬性指定標簽庫的前綴。等價的XML語法： ~~~ <jsp:directive.taglib uri="uri" prefix="prefixOfTag" /> ~~~ # JSP動作元素與JSP指令元素不同的是，JSP動作元素在請求處理階段起作用。JSP動作元素是用XML語法寫成的。利用JSP動作可以動態地插入文件、重用JavaBean組件、把用戶重定向到另外的頁面、為Java插件生成HTML代碼。動作元素只有一種語法，它符合XML標準： ~~~ <jsp:action_name attribute="value" /> ~~~ 動作元素基本上都是預定義的函數，JSP規范定義了一系列的標準動作，它用JSP作為前綴，可用的標準動作元素如下： | 語法 | 描述 | | --- | --- | | jsp:include | 在頁面被請求的時候引入一個文件。 | | jsp:useBean | 尋找或者實例化一個JavaBean。 | | jsp:setProperty | 設置JavaBean的屬性。 | | jsp:getProperty | 輸出某個JavaBean的屬性。 | | jsp:forward | 把請求轉到一個新的頁面。 | | jsp:plugin | 根據瀏覽器類型為Java插件生成OBJECT或EMBED標記。 | | jsp:element | 定義動態XML元素 | | jsp:attribute | 設置動態定義的XML元素屬性。 | | jsp:body | 設置動態定義的XML元素內容。 | | jsp:text | 在JSP頁面和文檔中使用寫入文本的模板 | * * * ## 常見的屬性所有的動作要素都有兩個屬性：id屬性和scope屬性。 * **id屬性：** id屬性是動作元素的唯一標識，可以在JSP頁面中引用。動作元素創建的id值可以通過PageContext來調用。 * **scope屬性：** 該屬性用于識別動作元素的生命周期。 id屬性和scope屬性有直接關系，scope屬性定義了相關聯id對象的壽命。 scope屬性有四個可能的值： (a) page, (b)request, (c)session, 和 (d) application。 * * * ## 動作元素動作元素用來包含靜態和動態的文件。該動作把指定文件插入正在生成的頁面。語法格式如下： ~~~ <jsp:include page="相對 URL 地址" flush="true" /> ~~~ 　前面已經介紹過include指令，它是在JSP文件被轉換成Servlet的時候引入文件，而這里的jsp:include動作不同，插入文件的時間是在頁面被請求的時候。以下是include動作相關的屬性列表。 | 屬性 | 描述 | | --- | --- | | page | 包含在頁面中的相對URL地址。 | | flush | 布爾屬性，定義在包含資源前是否刷新緩存區。 | ### 實例以下我們定義了兩個文件**date.jsp**和**main.jsp**，代碼如下所示： date.jsp文件代碼： ~~~ <%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%> <p> 今天的日期是: <%= (new java.util.Date()).toLocaleString()%> </p> ~~~ main.jsp文件代碼： ~~~ <%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%> <!DOCTYPE html> <html> <head> <meta charset="utf-8"> <title>JSP教程(cms.yiniuedu.com)</title> </head> <body> <h2>include 動作實例</h2> <jsp:include page="date.jsp" flush="true" /> </body> </html> ~~~ 現在將以上兩個文件放在服務器的根目錄下，訪問main.jsp文件。顯示結果如下： ~~~ include 動作實例今天的日期是: 2016-6-25 14:08:17 ~~~ * * * ## 動作元素 **jsp:useBean**動作用來加載一個將在JSP頁面中使用的JavaBean。這個功能非常有用，因為它使得我們可以發揮 Java 組件復用的優勢。 jsp:useBean動作最簡單的語法為： ~~~ <jsp:useBean id="name" class="package.class" /> ~~~ 在類載入后，我們既可以通過 jsp:setProperty 和 jsp:getProperty 動作來修改和檢索bean的屬性。以下是useBean動作相關的屬性列表。 | 屬性 | 描述 | | --- | --- | | class | 指定Bean的完整包名。 | | type | 指定將引用該對象變量的類型。 | | beanName | 通過 java.beans.Beans 的 instantiate() 方法指定Bean的名字。 | 在給出具體實例前，讓我們先來看下 jsp:setProperty 和 jsp:getProperty 動作元素： * * * ## 動作元素 jsp:setProperty用來設置已經實例化的Bean對象的屬性，有兩種用法。首先，你可以在jsp:useBean元素的外面（后面）使用jsp:setProperty，如下所示： ~~~ <jsp:useBean id="myName" ... /> ... <jsp:setProperty name="myName" property="someProperty" .../> ~~~ 此時，不管jsp:useBean是找到了一個現有的Bean，還是新創建了一個Bean實例，jsp:setProperty都會執行。第二種用法是把jsp:setProperty放入jsp:useBean元素的內部，如下所示： ~~~ <jsp:useBean id="myName" ... > ... <jsp:setProperty name="myName" property="someProperty" .../> </jsp:useBean> ~~~ 此時，jsp:setProperty只有在新建Bean實例時才會執行，如果是使用現有實例則不執行jsp:setProperty。 jsp:setProperty動作有下面四個屬性,如下表： | 屬性 | 描述 | | --- | --- | | name | name屬性是必需的。它表示要設置屬性的是哪個Bean。 | | property | property屬性是必需的。它表示要設置哪個屬性。有一個特殊用法：如果property的值是"\*"，表示所有名字和Bean屬性名字匹配的請求參數都將被傳遞給相應的屬性set方法。 | | value | value 屬性是可選的。該屬性用來指定Bean屬性的值。字符串數據會在目標類中通過標準的valueOf方法自動轉換成數字、boolean、Boolean、 byte、Byte、char、Character。例如，boolean和Boolean類型的屬性值（比如"true"）通過 Boolean.valueOf轉換，int和Integer類型的屬性值（比如"42"）通過Integer.valueOf轉換。　　value和param不能同時使用，但可以使用其中任意一個。 | | param | param 是可選的。它指定用哪個請求參數作為Bean屬性的值。如果當前請求沒有參數，則什么事情也不做，系統不會把null傳遞給Bean屬性的set方法。因此，你可以讓Bean自己提供默認屬性值，只有當請求參數明確指定了新值時才修改默認屬性值。 | * * * ## 動作元素 jsp:getProperty動作提取指定Bean屬性的值，轉換成字符串，然后輸出。語法格式如下： ~~~ <jsp:useBean id="myName" ... /> ... <jsp:getProperty name="myName" property="someProperty" .../> ~~~ 下表是與getProperty相關聯的屬性： | 屬性 | 描述 | | --- | --- | | name | 要檢索的Bean屬性名稱。Bean必須已定義。 | | property | 表示要提取Bean屬性的值 | ### 實例以下實例我們使用了Bean: ~~~ package com.runoob.main; public class TestBean { private String message = "JSP教程"; public String getMessage() { return(message); } public void setMessage(String message) { this.message = message; } } ~~~ 編譯以上實例文件 TestBean.java ： ~~~ $ javac TestBean.java ~~~ 編譯完成后會在當前目錄下生成一個**TestBean.class**文件，將該文件拷貝至當前 JSP 項目的**WebContent/WEB-INF/classes/com/runoob/main**下( com/runoob/main 包路徑，沒有需要手動創建)。下面是一個 Eclipse 中目錄結構圖： ![](http://h.yiniuedu.com/3109e1b2fb89614f5de943c61bfde07e) 下面是一個很簡單的例子，它的功能是裝載一個Bean，然后設置/讀取它的message屬性。現在讓我們在main.jsp文件中調用該Bean: ~~~ <%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%> <!DOCTYPE html> <html> <head> <meta charset="utf-8"> <title>JSP教程(cms.yiniuedu.com)</title> </head> <body> <h2>Jsp 使用 JavaBean 實例</h2> <jsp:useBean id="test" class="com.runoob.main.TestBean" /> <jsp:setProperty name="test" property="message" value="JSP教程..." /> <p>輸出信息....</p> <jsp:getProperty name="test" property="message" /> </body> </html> ~~~ 瀏覽器訪問，執行以上文件，輸出如下所示： JSP使用JavaBean實例輸出信息...... JSP教程... * * * ## 動作元素　jsp:forward動作把請求轉到另外的頁面。jsp:forward標記只有一個屬性page。語法格式如下所示： ~~~ <jsp:forward page="相對 URL 地址" /> ~~~ 以下是forward相關聯的屬性： | 屬性 | 描述 | | --- | --- | | page | page屬性包含的是一個相對URL。page的值既可以直接給出，也可以在請求的時候動態計算，可以是一個JSP頁面或者一個 Java Servlet. | ### 實例以下實例我們使用了兩個文件，分別是： date.jsp 和 main.jsp。 date.jsp 文件代碼如下： ~~~ <%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%> <p> 今天的日期是: <%= (new java.util.Date()).toLocaleString()%> </p> ~~~ main.jsp文件代碼： ~~~ <%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%> <!DOCTYPE html> <html> <head> <meta charset="utf-8"> <title>JSP教程(cms.yiniuedu.com)</title> </head> <body> <h2>forward 動作實例</h2> <jsp:forward page="date.jsp" /> </body> </html> ~~~ 現在將以上兩個文件放在服務器的根目錄下，訪問main.jsp文件。顯示結果如下： ~~~ 今天的日期是: 2016-6-25 14:37:25 ~~~ * * * ## 動作元素 jsp:plugin動作用來根據瀏覽器的類型，插入通過Java插件運行Java Applet所必需的OBJECT或EMBED元素。如果需要的插件不存在，它會下載插件，然后執行Java組件。 Java組件可以是一個applet或一個JavaBean。 plugin動作有多個對應HTML元素的屬性用于格式化Java 組件。param元素可用于向Applet 或 Bean 傳遞參數。以下是使用plugin 動作元素的典型實例: ~~~ <jsp:plugin type="applet" codebase="dirname" code="MyApplet.class" width="60" height="80"> <jsp:param name="fontcolor" value="red" /> <jsp:param name="background" value="black" /> <jsp:fallback> Unable to initialize Java Plugin </jsp:fallback> </jsp:plugin> ~~~ 如果你有興趣可以嘗試使用applet來測試jsp:plugin動作元素，元素是一個新元素，在組件出現故障的錯誤時發送給用戶錯誤信息。 * * * ## 、、動作元素、、動作元素動態定義XML元素。動態是非常重要的，這就意味著XML元素在編譯時是動態生成的而非靜態。以下實例動態定義了XML元素： ~~~ <%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%> <!DOCTYPE html> <html> <head> <meta charset="utf-8"> <title>JSP教程(cms.yiniuedu.com)</title> </head> <body> <jsp:element name="xmlElement"> <jsp:attribute name="xmlElementAttr"> 屬性值 </jsp:attribute> <jsp:body> XML 元素的主體 </jsp:body> </jsp:element> </body> </html> ~~~ 瀏覽器訪問以下頁面，輸出結果如下所示： ``` <!DOCTYPE html> <html> <head> <meta charset="utf-8"> <title>JSP教程(cms.yiniuedu.com)</title> </head> <body> <xmlElement xmlElementAttr="屬性值> XML 元素的主體 </xmlElement> </body> </html> ``` * * * ## 動作元素動作元素允許在JSP頁面和文檔中使用寫入文本的模板，語法格式如下： ~~~ <jsp:text>模板數據</jsp:text> ~~~ 以上文本模板不能包含重復元素，只能包含文本和EL表達式（注：EL表達式將在后續章節中介紹）。請注意，在XML文件中，您不能使用表達式如 ${whatever > 0}，因為>符號是非法的。你可以使用 ${whatever gt 0}表達式或者嵌入在一個CDATA部分的值。 ~~~ <jsp:text><![CDATA[<br>]]></jsp:text> ~~~ 如果你需要在 XHTML 中聲明 DOCTYPE,必須使用到動作元素，實例如下： ~~~ <jsp:text><![CDATA[<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "DTD/xhtml1-strict.dtd">]]> </jsp:text> <head><title>jsp:text action</title></head> <body> <books><book><jsp:text> Welcome to JSP Programming </jsp:text></book></books> </body> </html> ~~~ 你可以對以上實例嘗試使用及不使用該動作元素執行結果的區別。