九大內置對象

內置對象

類型

說明

作用域

request

javax.servlet.ServletRequest

請求對象——在 一次請求/一個Request請求周期 中傳遞數據，請求結束后，數據不可訪問，用于頁面之間的值的傳遞

用戶請求期

response

javax.servlet.SrvletResponse

響應對象——用來響應客戶端請求并向客戶端輸出信息

頁面執行期

out

javax.servlet.jsp.JspWriter

輸出對象——表示輸出流，該流將作為請求的響應發送到客戶端

頁面執行期

session

javax.servlet.http.HttpSession

會話對象——在一個session會話周期中，用于存儲有關用戶會話的所有信息

會話周期

application

javax.servlet.ServletContext

應用程序對象——用于實現用戶之間的數據共享，負責提供應用程序在服務器中運行時的一些全局信息

整個程序運行期

pageContext

javax.servlet.jsp.PageContext

頁面上下文對象——此對象提供所有四個作用域層次的屬性查詢和修改能力，它也提供了轉發請求到其它資源和包含其他資源的方法

頁面執行期

page

javax.lang.Object

頁面對象——只在當前JSP頁面內有效，提供對網頁上定義的所有對象的訪問，其表示的就是頁面本身

頁面執行期

config

javax.servlet.ServletConfig

配置對象——是ServletConfig的實例，代理當前jsp頁面配置，提供配置信息

頁面執行期

Execpiton

javax.lang.Throwable

例外對象——此對象指JSP文件運行時所產生的例外對象，也就是JSP引擎在執行代碼時拋出的異常，此對象不能在一般JSP文件中直接使用，而只能在使用了“<%@ page isErrorPage="true"%>”的JSP文件中使用，也就是說只有在page指令中具有屬性isErrorPage="true"時才有效

頁面執行期

out 對象方法

返回類型

方法名稱

說明

void

clear()

清除輸出緩沖區的內容，但是不輸出到客戶端

void

clearBuffer()

清除輸出緩沖區的內容，并輸出到客戶端

void

close()

關閉輸出流，清除所有內容

void

flush()

輸出緩沖區里面的數據

int

getBufferSize()

獲取以kb為單位的目前緩沖區大小

int

getRemaining()

獲取以kb為單位的緩沖區中未被占用的空間大小

boolean

isAutoFlush()

是否自動刷新緩沖區

void

newLine()

輸出一個換行字符

void

print(Object)

將指定類型的數據輸出到Http流，不換行

void

println(Object)

將指定類型的數據輸出到Http流，并輸出一個換行符

Appendable

append(char c | CharSequence cxq, int start, int end | CharSequence cxq )

將一個字符或者實現了CharSequence接口的對象添加到輸出流的后面

request 對象方法

返回類型

方法名稱

說明

Object

getAttribute(String name)

返回由name指定的屬性值，該屬性不存在時返回null

Enumeration

getAttributeNames()

返回request對象的所有屬性名稱的集合

String

getAuthType()

返回用來保護servlet的認證方法的名稱，未受保護時返回null

String

getCharacterEncoding()

返回請求中的字符編碼方法，可以在response對象中設置

int

getContentLength()

返回請求的BODY的長度，不能確定長度時返回-1?？梢栽趓esponse中設置

String

getContentType()

返回在response中定義的內容類型

String

getContentPath()

返回請求的路徑

Cookie[]

getCookies()

返回客戶端所有的Cookie的數組

Enumeration

getHeaderNames()

返回所有HTTP頭的名稱的集合

Enumeration

getHeaders(String name)

返回指定HTTP頭的所有值的集合

String

getHeader(String name)

返回指定名稱的HTTP頭的信息

long

getDateHeader(String name)

返回指定名稱的Data類型的HTTP頭的信息

int

getIntHeader(String name)

返回指定名稱的Int類型的HTTP頭的信息

ServletInputStream

getInputStream()

返回請求的輸入流

Locale

getLocale()

返回當前頁的Locale對象(此對象有兩個方法，分別是getDisplayCountry和getDisplayLanguage)，可以在response中設定

Enumeration

getLocales()

返回請求中所有的Locale對象的集合

String

getLocalName()

獲取響應請求的服務器端主機名

String

getLocalAddr()

獲取響應請求的服務器端地址

int

getLocalPort()

獲取響應請求的服務器端端口

String

getMethod()

獲取客戶端向服務器端發送請求的方法(GET、POST)

String

getParameter(String name)

獲取客戶端發送給服務器端的參數值

Map

getParameterMap()

該方法返回包含請求中所有參數的一個Map對象

Enumeration

getParameterNames()

返回請求中所有參數的集合

String[]

getParameterValues(String name)

獲得請求中指定參數的所有值

String

getQueryString()

返回get方法傳遞的參數字符串，該方法不分解出單獨的參數

String

getPathInfo()

取出請求中處于ServletPath和QueryString之間的額外信息

String

getPathTranslated()

返回用getPathInfo()方法取得的路徑信息的實際路徑

String

getProtocol()

返回請求使用的協議。可以是HTTP1.1或者HTTP1.0

BufferedReader

getReader()

返回請求的輸入流對應的Reader對象，該方法和getInputStream()方法在一個頁面中只能調用一個

String

getRemoteAddr()

獲取發出請求的客戶端ip地址

String

getRemoteHost()

獲取發出請求的客戶端主機名

String

getRemoteUser()

返回經過客戶端驗證的用戶名，未經驗證返回null

int

getRemotePort()

返回發出請求的客戶端主機端口

String

getRealPath(String path)

返回給定虛擬路徑的物理路徑

RequestDispatcher

getRequestDispatcher(String path)

按給定的路徑生成資源轉向處理適配器對象(轉發)

String

getRequestedSessionId()

返回請求的session的標識

String

RequestURI()

返回發出請求的客戶端地址，但是不包括請求的參數字符串

StringBuffer

getRequestURI()

返回響應請求的服務器端地址

String

getScheme()

獲取協議名稱，缺省值為HTTP協議

String

getServerName()

返回響應請求的服務器名稱

String

getServletPath()

獲取客戶端所請求的腳本文件的文件路徑

int

getServerPort()

獲取響應請求的服務器端主機端口號

void

removeAttribute(String name)

在屬性列表中刪除指定名稱的屬性

void

setAttribute(String name, Object value)

在屬性列表中添加/刪除指定的屬性

void

setCharacterEncoding(String charset)

設置請求的字符編碼格式

HttpSession

getSession() | getSession(boolean create)

獲取session，如果create為true，在無session的情況下創建一個

boolean

isRequestedSessionIdFromCookie()

檢查請求的會話ID是否為通過Cookie傳入

boolean

isRequestedSessionIdFromURL()

檢查請求的會話ID是否為通過URL傳入

boolean

isRequestedSessionIdValid()

檢查請求的會話ID是否仍然有效

boolean

isSecure()

檢查請求是否使用安全鏈接，如果HTTPS等

boolean

isUserInRole(String role)

檢查已經通過驗證的用戶是否在是role所指定的角色

Principal

getUserPrincipal()

返回包含用戶登陸名的一個java.security.Principal對象

response 對象方法

返回類型

方法名稱

說明

void

addCookie(Cookie cookie)

添加一個Cookie對象，保存客戶端信息

void

addDateHeader(String name, long value)

添加一個日期類型的HTTP頭信息，覆蓋同名的HTTP頭信息

void

addHeader(String name, String value)

添加一個HTTP頭，覆蓋同名的舊HTTP頭

void

addIntHeader(String name, int value)

添加一個整型的HTTP頭，覆蓋同名的舊HTTP頭

boolean

containsHeader(String name)

判斷指定的HTTP頭是否存在

String

encodeRedirectURL(String url)

對sendRedirect()方法使用的URL進行編碼

String

encodeURL(String url)

將URL予以編碼，回傳包含session ID的URL

void

flushBuffer()

強制把當前緩沖區的內容發送到客戶端

int

getBufferSize()

取得以kb為單位的緩沖區大小

String

getCharacterEncoding()

獲取響應的字符編碼格式

String

getContentType()

獲取響應的類型

Locale

getLocale()

獲取響應的Locale對象

ServletOutputStream

getOutputStream()

返回客戶端的輸出流對象

PrintWriter

getWriter()

獲取輸出流對應的writer對象

boolean

isCommitted()

判斷服務器端是否已經將數據輸出到客戶端

void

reset()

清空buffer中的所有內容

void

sendError(int xc | int xc, String msg)

發送錯誤，包括狀態碼和錯誤信息

void

sendRedirect(String locationg)

把響應發送到另外一個位置進行處理(轉發)

void

setBufferSize(int size)

設置以kb為單位的緩沖區大小

void

setCharacterEncoding(String charset)

設置響應使用的字符編碼格式

void

setContentLength(int length)

設置響應的BODY長度

void

setContentType(String type)

設置響應的類型

void

setDateHeader(String name, long value)

設置指定名稱的Data類型的HTTP頭的值

void

setHeader(String name, String value)

設置指定名稱的HTTP頭的值

void

setIntHeader(String name, int value)

設置指定名稱的int類型的HTTP頭的值

void

setStatus(int xc)

設置響應狀態碼，新值會覆蓋當前值