一、page 對象
page物件代表JSP本身,更精確地說它代表JSP被轉譯後的Servlet,它可以呼叫Servlet類別所定義的方法。
二、config 對象
config 物件存放著一些Servlet 初始的資料結構。
config 物件實作為javax.servlet.ServletConfig 接口,它共有下列四種方法:
public String getInitParameter(name)
public java.util.Enumeration getInitParameterNames( )
public ServletContext getServletContext( )
public Sring getServletName( )
三、request 物件
request 物件包含所有請求的訊息,如:請求的來源、標頭、cookies和請求相關的參數值等等。
request 物件實作javax.servlet.http.HttpServletRequest介面的,所提供的方法可以將它分成四大類:
1.儲存和取得屬性方法;
void setAttribute(String name, Object value) 設定name屬性的值為value
Enumeration getAttributeNamesInScope(int scope) 取得所有scope 範圍的屬性
Object getAttribute(String name) 取得name 屬性的值
void removeAttribute(String name) 移除name 屬性的值
2.取得請求參數的方法
String getParameter(String name) 取得name 的參數值
Enumeration getParameterNames( ) 取得所有的參數名稱
String [] getParameterValues(String name) 取得所有name 的參數值
Map getParameterMap( ) 取得一個要求參數的Map
3.能夠取得請求HTTP 標頭的方法
String getHeader(String name) 取得name 的標頭
Enumeration getHeaderNames() 取得所有的標頭名稱
Enumeration getHeaders(String name) 取得所有name 的標頭
int getIntHeader(String name) 取得整數型別name 的標頭
long getDateHeader(String name) 取得日期類型name 的標頭
Cookie [] getCookies( ) 取得與請求有關的cookies
4.其他的方法
String getContextPath( ) 取得Context 路徑(即站台名稱)
String getMethod( ) 取得HTTP 的方法(GET、POST)
String getProtocol( ) 取得使用的協定(HTTP/1.1、HTTP/1.0 )
String getQueryString( ) 取得請求的參數字串,不過,HTTP的方法必須為GET
String getRequestedSessionId( ) 取得用戶端的Session ID
String getRequestURI( ) 取得請求的URL,但是不包含請求的參數字串
String getRemoteAddr( ) 取得使用者的IP 位址
String getRemoteHost( ) 取得使用者的主機名稱
int getRemotePort( ) 取得使用者的主機端口
String getRemoteUser( ) 取得使用者的名稱
void etCharacterEncoding(String encoding) 設定編碼格式,用來解決窗體傳遞中文的問題
四、response 對象
response 物件主要將JSP 處理資料後的結果傳回客戶端。
response 物件是實作javax.servlet.http.HttpServletResponse 介面。 response物件所提供的方法。
1.設定表頭的方法
void addCookie(Cookie cookie) 新增cookie
void addDateHeader(String name, long date) 新增long型別的值到name標頭
void addHeader(String name, String value) 新增String類型的值到name標頭
void addIntHeader(String name, int value) 新增int型別的值到name標頭
void setDateHeader(String name, long date) 指定long類型的值到name標頭
void setHeader(String name, String value) 指定String類型的值到name標頭
void setIntHeader(String name, int value) 指定int類型的值到name標頭
2.設定回應狀態碼的方法
void sendError(int sc) 傳送狀態碼(status code)
void sendError(int sc, String msg) 傳送狀態碼與錯誤訊息
void setStatus(int sc) 設定狀態碼
3.用來URL 重寫(rewriting)的方法
String encodeRedirectURL(String url) 對使用sendRedirect( )方法的URL予以編碼
五、out 對象
out 物件能把結果輸出到網頁上。
out主要是用來控制管理輸出的緩衝區(buffer)和輸出流(output stream)。
void clear( ) 清除輸出緩衝區的內容
void clearBuffer( ) 清除輸出緩衝區的內容
void close( ) 關閉輸出流,清除所有的內容
int getBufferSize( ) 取得目前緩衝區的大小(KB)
int getRemaining( ) 取得目前使用後還剩下的緩衝區大小(KB)
boolean isAutoFlush( ) 回傳true表示緩衝區滿時會自動清除;false表示不會自動清除並且產生異常處理
六、session 對象
session物件表示目前個別使用者的會話(session)狀況。
session物件實作javax.servlet.http.HttpSession接口,HttpSession介面所提供的方法
long getCreationTime() 取得session產生的時間,單位是毫秒
String getId() 取得session 的ID
long getLastAccessedTime() 取得使用者最後透過這個session送出請求的時間
long getMaxInactiveInterval() 取得最大session不活動的時間,若超過這時間,session 將會失效
void invalidate() 取消session 對象,並將物件存放的內容完全拋棄
boolean isNew() 判斷session 是否為"新"的
void setMaxInactiveInterval(int interval) 設定最大session不活動的時間,若超過這時間,session 將會失效
七、application對象
application物件最常被使用在存取環境的資訊。
因為環境的資訊通常都儲存在ServletContext中,所以常利用application物件來存取ServletContext中的資訊。
application 物件實作javax.servlet.ServletContext 接口,ServletContext介面容器所提供的方法
int getMajorVersion( ) 取得Container主要的Servlet API版本
int getMinorVersion( ) 取得Container次要的Servlet API 版本
String getServerInfo( ) 取得Container的名稱和版本
String getMimeType(String file) 取得指定檔案的MIME 類型
ServletContext getContext(String uripath) 取得指定Local URL的Application context
String getRealPath(String path) 取得本機path的絕對路徑
void log(String message) 將資訊寫入log檔案中
void log(String message, Throwable throwable) 將stack trace 所產生的例外訊息寫入log檔案中
八、pageContext對象
pageContext物件能夠存取其他隱含物件。
1.pageContext物件存取其他隱含物件屬性的方法,此時需要指定範圍的參數。
Object getAttribute(String name, int scope)
Enumeration getAttributeNamesInScope(int scope)
void removeAttribute(String name, int scope)
void setAttribute(String name, Object value, int scope)
範圍參數有四個,分別代表四種範圍:PAGE_SCOPE、REQUEST_SCOPE、SESSION_SCOPE、APPLICATION_SCOPE
2.PageContext物件取得其他隱含物件的方法
Exception getException( ) 回傳目前網頁的例外,不過此網頁要為error page,
JspWriter getOut( ) 回傳目前網頁的輸出流,例如:out
Object getPage( ) 回傳目前網頁的Servlet 實體(instance),例如:page
ServletRequest getRequest( ) 回傳目前網頁的請求,例如:request
ServletResponse getResponse( ) 回傳目前網頁的回應,例如:response
ServletConfig getServletConfig( ) 回傳目前此網頁的ServletConfig 對象,例如:config
ServletContext getServletContext( ) 回傳目前此網頁的執行環境(context),例如:application
HttpSession getSession( ) 回傳和目前網頁有聯繫的會話(session),例如:session
3.PageContext物件提供取得屬性的方法
Object getAttribute(String name, int scope) 回傳name 屬性,範圍為scope的屬性對象,回傳型別為Object
Enumeration getAttributeNamesInScope(int scope) 回傳所有屬性範圍為scope 的屬性名稱,回傳類型為 Enumeration
int getAttributesScope(String name) 回傳屬性名稱為name 的屬性範圍
void removeAttribute(String name) 移除屬性名稱為name 的屬性物件
void removeAttribute(String name, int scope) 移除屬性名稱為name,範圍為scope 的屬性對象
void setAttribute(String name, Object value, int scope) 指定屬性物件的名稱為name、值為value、範圍為scope
Object findAttribute(String name) 尋找在所有範圍中屬性名稱為name 的屬性物件
九、exception對象
若要使用exception 物件時,必須在page 指令中設定。 <%@ page isErrorPage="true" %>才能使用。
exception提供的三個方法:
getMessage( )
getLocalizedMessage( )、
printStackTrace(new java.io.PrintWriter(out))