JSP - 9大內建對象及其API

標籤：

內建對象：不需要預先聲明就可以在指令碼代碼和運算式中隨意使用，有以下特點

1.由JSP規範提供，不用編寫者執行個體化

2.提供Web容器實現和管理

3.所有JSP頁面均可用

4.只有在指令碼元素的運算式或者代碼中才可使用(<%=使用內建對象%>或<%使用內建對象%>)

 

輸入輸出對象：request，response，out

通訊控制對象：pageContext，session，application

Servlet對象：page，config

錯誤處理對象：exception

 

 

1. request - 請求對象 javax.servlet.httpServletRequest

request 對象是 javax.servlet.httpServletRequest類的執行個體，該對象代表了用戶端的請求資訊，主要用於接受通過HTTP協議傳送到伺服器的資料。（包括頭資訊、系統資訊、請求方式以及請求參數等）。

request對象的範圍為一次請求，發送請求時，該對象建立，一次請求結束後即銷毀(一次請求，產生一個request對象)

該對象封裝了使用者提交資訊，通過調用該對象相應的方法以擷取封裝的資訊，使用該對象，可以擷取使用者提交的資訊。

1 String getParameter(String name)返回name指定參數的參數值

2 Enumeration getParameterNames()返回可用參數名的枚舉

3 String[] getParameterValues(String name) 返回包含參數name的所有值的數組

4 void setAttribute(String key,Object obj) 設定屬性的屬性值

5 object getAttribute(String name) 返回指定屬性的屬性值(即setAttribute中參數key的值)

6 Enumeration getAttributeNames() 返回所有可用屬性名稱的枚舉 

7 String getProtocol() 返回請求用的協議類型及版本號碼

8 String getServerName() 返回接受請求的伺服器?*? 

9 int getServerPort() 返回伺服器接受此請求所用的連接埠號碼 

10 BufferedReader getReader() 返回解碼過了的請求體 

11 String getRemoteAddr() 返回傳送此請求的用戶端IP地址 

12 String getRemoteHost() 返回傳送此請求的用戶端?*? 

13 String getScheme() 返回請求用的計劃名,如:http.https及ftp等 

14 String getRealPath(String path) 返回一虛擬路徑的真實路徑

15 String getCharacterEncoding() 返回字元編碼方式

16 int getContentLength() 返回請求體的長度（以位元組數）

17 String getContentType() 得到請求體的MIME類型

18 ServletInputStream getInputStream() 得到請求體中一行的二進位流

 

2. response - 響應對象 javax.servlet.http.HttpServletResponse

response代表的是對用戶端的響應，主要是將JSP容器處理過的對象傳回給用戶端

對用戶端請求做出動態響應，向用戶端發送資料，響應用戶端請求時建立，響應結束時銷毀(一次響應，產生一個response對象)

動態響應contentType屬性:

當一個使用者訪問了一個jsp頁面時，如果該頁面用page指令設定頁面的contentType屬性為text/html，那麼jsp引擎將按照這個屬性值做出反應。如果要動態改變這個屬性值來響應客戶，就需要使用Response對象

1 String getCharacterEncoding() 返迴響應用的是何種字元編碼 

2 ServletOutputStream getOutputStream() 返迴響應的一個二進位輸出資料流 

3 PrintWriter getWriter() 返回可以向用戶端輸出字元的一個對象 

4 void setContentLength(int len) 設定回應標頭長度 

5 void setContentType(String type) 設定響應的MIME類型 

6 sendRedirect(Java.lang.String location) 重新定向用戶端的請求

 

3. session - 會話對象 javax.servlet.http.HttpSession

在頁面的page指令加上session="true" 或預設 情況下以及在servlet中使用request.getSession();的方式進行建立。逾時或服務停止時，session結束。(一個使用者對應一個session對象)

什麼是session對象？——它是一個jsp內建對象，它在第一個jsp被裝載時自動建立，完成會話期管理。從一個客戶開啟瀏覽器並串連到伺服器開始，到客戶關閉瀏覽器離   開這個伺服器結束(或者逾時)，被稱為一個會話。當一個客戶訪問一個伺服器時，可能會在這個伺服器的幾個頁面之間切換，伺服器應當通過某種辦法知道這是一個客戶，就需要建立session對象

session對象的ID——當一個客戶首次訪問伺服器上的一個jsp頁面時，jsp引擎會產生一個session對象，同時分配一個String類型的的ID號，jsp引擎同時將這個ID號發送到用戶端，存放在cookie中，這樣，session對象直到客戶關閉瀏覽器後，伺服器端，該客戶的session對象才會消失，會並，和客戶的會話對應關係消失。當客戶重新開啟瀏覽器再串連到該伺服器時，伺服器為該客戶再建立一個新的session對象

1 long getCreationTime() 返回Session建立時間 

2 public String getId() 返回Session建立時，JSP引擎為它分配的惟一id號 

3 long getLastAccessedTime() 返回此Session裡用戶端最近一次請求時間 

4 int getMaxInactiveInterval() 返回兩次請求間隔多長時間此Session被取消(ms) 

5 String[] getValueNames() 返回一個包含此Session中所有可用屬性的數組 

6 void invalidate() 取消Session，使Session不可用 

7 boolean isNew() 返回伺服器建立的一個Session,用戶端是否已經加入 

8 void removeValue(String name) 刪除Session中指定的屬性 

9 void setMaxInactiveInterval() 設定兩次請求間隔多長時間此Session被取消(ms)

 

4. application - 應用程式物件 javax.servlet.ServletContext

application 對象實現了使用者間資料的共用，可存放全域變數。它開始於伺服器的啟動，直到伺服器的關閉，在此期間，此對象將一直存在；這樣在使用者的前後串連或不同使用者之 間的串連中，可以對此對象的同一屬性進行操作；在任何地方對此對象屬性的操作，都將影響到其他使用者對此的訪問。伺服器的啟動和關閉決定了application對象的生命。它是ServletContext類的執行個體

1 Object getAttribute(String name) 返回給定名的屬性值 

2 Enumeration getAttributeNames() 返回所有可用屬性名稱的枚舉 

3 void setAttribute(String name,Object obj) 設定屬性的屬性值 

4 void removeAttribute(String name) 刪除一屬性及其屬性值 

5 String getServerInfo() 返回JSP(SERVLET)引擎名及版本號碼 

6 String getRealPath(String path) 返回一虛擬路徑的真實路徑 

7 ServletContext getContext(String uripath) 返回指定WebApplication的application對象 

8 int getMajorVersion() 返回伺服器支援的Servlet API的最大版本號碼 

9 int getMinorVersion() 返回伺服器支援的Servlet API的最大版本號碼 

10 String getMimeType(String file) 返回指定檔案的MIME類型 

11 URL getResource(String path) 返回指定資源(檔案及目錄)的URL路徑 

12 InputStream getResourceAsStream(String path) 返回指定資源的輸入資料流 

13 RequestDispatcher getRequestDispatcher(String uripath) 返回指定資源的RequestDispatcher對象 

14 Servlet getServlet(String name) 返回指定名的Servlet 

15 Enumeration getServlets() 返回所有Servlet的枚舉 

16 Enumeration getServletNames() 返回所有Servlet名的枚舉 

17 void log(String msg) 把指定訊息寫入Servlet的記錄檔 

18 void log(Exception exception,String msg) 把指定異常的棧軌跡及錯誤訊息寫入Servlet的記錄檔 

19 void log(String msg,Throwable throwable) 把棧軌跡及給出的Throwable異常的說明資訊 寫入Servlet的記錄檔 

 

5. out - 資料流對象 javax.servlet.jsp.jspWriter

out對象是 javax.servlet.jsp.JspWriter 類的執行個體，用來在response對象中寫入內容，輸出到頁面中

1 void clear() 清除緩衝區的內容 

2 void clearBuffer() 清除緩衝區的當前內容 

3 void flush() 清空流 

4 int getBufferSize() 返回緩衝區以位元組數的大小，如不設緩衝區則為0 

5 int getRemaining() 返回緩衝區還剩餘多少可用 

6 boolean isAutoFlush() 返回緩衝區滿時，是自動清空還是拋出異常

7 void close() 關閉輸出資料流 

 

6. pageContext - 頁面內容物件 javax.servlet.jsp.PageContext

pageContext對象提供了對JSP頁面內所有的對象及名字空間的訪問，也就是說他可以訪問到本頁所在的Session，也可以取本頁面所在的application的某一屬性值，他相當於頁面中所有功能的集大成者，它的本類名也叫pageContext

1 JspWriter getOut() 返回當前用戶端響應被使用的JspWriter流(out)

2 HttpSession getSession() 返回當前頁中的HttpSession對象(session)

3 Object getPage() 返回當前頁的Object對象(page)

4 ServletRequest getRequest() 返回當前頁的ServletRequest對象(request)

5 ServletResponse getResponse() 返回當前頁的ServletResponse對象(response)

6 Exception getException() 返回當前頁的Exception對象(exception)

7 ServletConfig getServletConfig() 返回當前頁的ServletConfig對象(config)

8 ServletContext getServletContext() 返回當前頁的ServletContext對象(application)

9 void setAttribute(String name,Object attribute) 設定屬性及屬性值

10 void setAttribute(String name,Object obj,int scope) 在指定範圍內設定屬性及屬性值

11 public Object getAttribute(String name) 取屬性的值

12 Object getAttribute(String name,int scope) 在指定範圍內取屬性的值

13 public Object findAttribute(String name) 尋找一屬性,返回起屬性值或NULL

14 void removeAttribute(String name) 刪除某屬性

15 void removeAttribute(String name,int scope) 在指定範圍刪除某屬性

16 int getAttributeScope(String name) 返回某屬性的作用範圍

17 Enumeration getAttributeNamesInScope(int scope) 返回指定範圍內可用的屬性名稱枚舉

18 void release() 釋放pageContext所佔用的資源

19 void forward(String relativeUrlPath) 使當前頁面重導到另一頁面

20 void include(String relativeUrlPath) 在當前位置包含另一檔案

 

7.config - 設定物件 javax.servlet.ServletConfig

config對象是在一個Servlet初始化時，JSP引擎向它傳遞資訊用的，此資訊包括Servlet初始化時所要用到的參數（通過屬性名稱和屬性值構成）以及伺服器的有關資訊(通過傳遞一個ServletContext對象)

1 ServletContext getServletContext() 返回含有伺服器相關資訊的ServletContext對象 

2 String getInitParameter(String name) 返回初始化參數的值 

3 Enumeration getInitParameterNames() 返回Servlet初始化所需所有參數的枚舉

 

8. page - 當前JSP頁面對象 java.lang.object

page對象就是指向當前JSP頁面本身，類似類中的this關鍵字，對象就是頁面執行個體的引用。它可以被看做是整個JSP頁面的代表，它是java.lang.Object類的執行個體

1 class getClass 返回此Object的類 

2 int hashCode() 返回此Object的hash碼 

3 boolean equals(Object obj) 判斷此Object是否與指定的Object對象相等 

4 void copy(Object obj) 把此Object拷貝到指定的Object對象中 

5 Object clone() 複製此Object對象 

6 String toString() 把此Object對象轉換成String類的對象 

7 void notify() 喚醒一個等待的線程 

8 void notifyAll() 喚醒所有等待的線程 

9 void wait(int timeout) 使一個線程處於等待直到timeout結束或被喚醒 

10 void wait() 使一個線程處於等待直到被喚醒 

11 void enterMonitor() 對Object加鎖 

12 void exitMonitor() 對Object* 

 

9. exception - 例外對象 java.lang.Throwable

exception對象是一個例外對象，當一個頁面在運行過程中發生了例外，就產生這個對象。如果一個JSP頁面要應用此對象，就必須把isErrorPage設為true，否則無法編譯。它是java.lang.Throwable的對象

1 String getMessage() 返回描述異常的訊息 

2 String toString() 返回關於異常的簡短描述訊息 

3 void printStackTrace() 顯示異常及其棧軌跡 

4 Throwable FillInStackTrace() 重寫異常的執行棧軌跡

JSP - 9大內建對象及其API