page Directive Element

在原來的JSP 1.2中，有page、include與taglib三種Directive Elements（指令元素），在JSP 2.0之後，新增Tag File，它自身擁有tag、attrivute和variable三個指令元素。

指令元素的語法使用<%@ 與 %>包括，因為每個元素的使用場合各不相同，在這邊不直接介紹所有的用法，先要介紹page的用法，以實例來說明：

nowTime.jsp

<%@page info="JSP指令元素示範"%> 
<%@page contentType="text/html;charset=Big5"%> 
<%@page  
     import="javax.servlet.jsp.HttpJspPage,java.util.Date"%> 
<html> 
<head>
   <title><%= ((HttpJspPage)page).getServletInfo() %></title>
</head> 
<body> 
 
    現在時間: <b><%= new Date() %> 
 
</body> 
</html>

在例子中介紹了page的三個屬性設定：info、contentType與import。

info

用於設定目前JSP頁面的基本資訊，這個資訊最後會轉換為Servlet程式中使用getServletInf()所取得的資訊。

在例子中使用JSP中的隱含物件（Implicit object）page，page物件對應的Java物件型態是Object，簡單的說代表目前這個JSP轉換過後的Servlet物件本身，也就是相當於 this，HttpJspPage是該Servlet物件實作的一個介面，我們轉型至HttpJspPage型態，如此就可以使用 getServletInfo()方法取得JSP的頁面資訊。

contentType

用於設定MIME型態及網頁編碼方式，在這邊設定的是text/html，而編碼方式則設定Big5碼，這個部份的設定是給瀏覽器判斷該以什麼樣的方式顯示網頁文件，在Servlet中，這個部份是對應於 HttpServletResponse物件的setContentType()方法：

response.setContentType("text/html;charset=Big5");

使用Big5編碼網頁時，有些中文字的顯示會有問題（例如碁），比較建議的是UTF8編碼方式。

import

即轉譯為Java語法的import。

page元素除了以上三個屬性設定之外，還有其它的屬性，我們介紹如下：

autoFlush

用於設定至客戶端的輸出串流是否要自動出清，預設是true，如果設定為false，而緩衝區滿了卻還沒將資料送出至客戶端，將會產生例外。

buffer

用於設定至客戶端的輸出串流緩衝區大小，預設是8KB。

errorPage

用於設定當JSP執行錯誤而產生例外時，該由哪一個頁面處理這個例外。

extends

可以用來指定JSP網頁轉譯為Servlet程式之後，該繼承哪一個類別，以Tomcat 5.5.4為例，預設是繼承自org.apache.jasper.runtime.HttpJspBase，而HttpJspBase又繼承自 HttpServlet，這個類別的繼承架構則如下：
　　java.lang.Object
　　　javax.servlet.GenericServlet
　　　　javax.servlet.http.HttpServlet
　　　　　org.apache.jasper.runtime.HttpJspBase

isErrorPage

用以設定JSP頁面是否為處理例外的頁面，這個屬性要與errorPage配合使用，將在之後介紹。

language

用來指定容器使用哪種語言的語法來編譯JSP網頁，言下之意是JSP基本上可使用其它語言來撰寫，不過事實上目前只能使用Java的語法且是預設。

session

可設定是否使用session物件，預設是true，若某些頁面不需作進程追蹤，可以設成false，可以增加一些效能。

pageEncoding

用於指定JSP網頁轉為Servlet編譯時採取的編碼方式，如此在編譯時才能正確的轉換程式碼中設定的字元，例如JSP網頁中包括Big5中文字的話，必須設定<%@ page pageEncoding="Big5"%>，預設是作業系統的語系設定，在不使用 response 的setCharacterEncoding()設定時，pageEncoding也是回應時預設的編碼指定。

isELIgnored

用以設定JSP網頁中是否忽略Expression Language，預設是false，如果設定為true，則Expression Language不會被轉譯，這個設定會推翻web.xml中的<el-ignored>設定，Expression Language在JSP 2.0成為標準規格之一，將在之後介紹。

isThreadSafe

決定轉譯之後的Servlet是否為執行緒安全的，預設值是true，如果設定為false，則轉譯之後的Servlet會實作SingleThreadModel介面，這會引起效能問題，相當不建議這麼作。

您可以在使用page元素時一行一行撰寫，也可以撰寫在同一個 <%@ 與 %>之間，例如：

<%@page contentType="text/html;charset=Big5"
import="javax.servlet.jsp.HttpJspPage,java.util.Date"%>

當然如果內容太長，仍是分開撰寫來得明瞭；最後列出範例所傳回的HTML內容：
<html>
<head><title>JSP指令元素示範</title></head>
<body>
現在時間: Wed May 05 20:27:02 CST 2004
</body>
</html>

From Gossip@caterpillar

JSP/Servlet: page Directive Element