JSP內建對象
來源：互聯網
上載者：User
① out - javax.servlet.jsp.jspWriter
out對象用於把結果輸出到網頁上。
方法：
1. void clear() ;
清除輸出緩衝區的內容，但是不輸出到用戶端。
2. void clearBuffer() ;
清除輸出緩衝區的內容，並輸出到用戶端。
3. void close() ;
關閉輸出資料流，清除所有內容。
4. void flush() ;
輸出緩衝區裡面的資料。
5. int getBufferSize() ;
擷取以kb為單位的目前緩衝區大小。
6. int getRemaining() ;
擷取以kb為單位的緩衝區中未被佔用的空間大小。
7. boolean isAutoFlush() ;
是否自動重新整理緩衝區。
8. void newLine() ;
輸出一個換行字元。
9. void print( boolean b ) ;
void print( char c ) ;
void print( char[] s ) ;
void print( double d ) ;
void print( float f ) ;
void print( int i ) ;
void print( long l ) ;
void print( Object obj ) ;
void print( String s ) ;
將指定類型的資料輸出到Http流，不換行。
10. void println( boolean b ) ;
void println( char c ) ;
void println( char[] s ) ;
void println( double d ) ;
void println( float f ) ;
void println( int i ) ;
void println( long l ) ;
void println( Object obj ) ;
void println( String s ) ;
將指定類型的資料輸出到Http流，並輸出一個分行符號。
11. Appendable append( char c ) ;
Appendable append( CharSequence cxq, int start, int end ) ;
Appendable append( CharSequence cxq ) ;
將一個字元或者實現了CharSequence介面的對象添加到輸出資料流的後面。
成員：
int DEFAULT_BUFFER = 0 - 預設緩衝區大小
int NO_BUFFER = -1 - writer是否處於緩衝輸出狀態
int UNBOUNDED_BUFFER = -2 - 是否限制緩衝區大小
② request - javax.servlet.http.HttpServletRequest
request對象包含所有請求的資訊，如請求的來源、標題、cookies和請求相關的參數值等。
方法：
1. Object getAttribute( String name ) ;
返回由name指定的屬性值，該屬性不存在時返回null。
2. Enumeration getAttributeNames() ;
返回request對象的所有屬性名稱的集合。
3. String getAuthType() ;
返回用來保護servlet的認證方法的名稱，未受保護時返回null。
4. String getCharacterEncoding() ;
返回請求中的字元編碼方法，可以在response對象中設定。
5. int getContentLength() ;
返回請求的BODY的長度，不能確定長度時返回-1。可以在response中設定。
6. String getContentType() ;
返回在response中定義的內容類型。
7. String getContentPath() ;
返回請求的路徑。
8. Cookie[] getCookies() ;
返回用戶端所有的Cookie的數組。
9. Enumeration getHeaderNames() ;
返回所有HTTP頭的名稱的集合。
10. Enumeration getHeaders( String name ) ;
返回指定HTTP頭的所有值的集合。
11. String getHeader( String name ) ;
返回指定名稱的HTTP頭的資訊。
12. long getDateHeader( String name ) ;
返回指定名稱的Data類型的HTTP頭的資訊。
13. int getIntHeader( String name ) ;
返回指定名稱的Int類型的HTTP頭的資訊。
14. ServletInputStream getInputStream() ;
返回請求的輸入資料流。
15. Locale getLocale() ;
返回當前頁的Locale對象，可以在response中設定。
16. Enumeration getLocales() ;
返回請求中所有的Locale對象的集合。
17. String getLocalName() ;
擷取響應請求的伺服器端主機名稱。
18. String getLocalAddr() ;
擷取響應請求的伺服器端地址。
19. int getLocalPort() ;
擷取響應請求的伺服器端連接埠
20. String getMethod() ;
擷取用戶端向伺服器端發送請求的方法(GET、POST)。
21. String getParameter( String name ) ;
擷取用戶端發送給伺服器端的參數值。
22. Map getParameterMap() ;
該方法返回包含請求中所有參數的一個Map對象。
23. Enumeration getParameterNames() ;
返回請求中所有參數的集合。
24. String[] getParameterValues( String name ) ;
獲得請求中指定參數的所有值。
25. String getQueryString() ;
返回get方法傳遞的參數字串，該方法不分解出單獨的參數。
26. String getPathInfo() ;
取出請求中處於ServletPath和QueryString之間的額外資訊。
27. String getPathTranslated() ;
返回用getPathInfo()方法取得的路徑資訊的實際路徑。
28. String getProtocol() ;
返回請求使用的協議。可以是HTTP1.1或者HTTP1.0。
29. BufferedReader getReader() ;
返回請求的輸入資料流對應的Reader對象，該方法和getInputStream()方法在一個頁面中只能調用一個。
30. String getRemoteAddr() ;
擷取發出請求的用戶端IP地址。
31. String getRemoteHost() ;
擷取發出請求的用戶端主機名稱
32. String getRemoteUser() ;
返回經過用戶端驗證的使用者名稱，未經驗證返回null。
33. int getRemotePort() ;
返回傳出請求的用戶端主機連接埠。
34. String getRealPath( String path ) ;
返回給定虛擬路徑的實體路徑。
35. RequestDispatcher getRequestDispatcher( String path ) ;
按給定的路徑產生資源轉向處理配接器物件。
36. String getRequestedSessionId() ;
返回請求的session的標識。
37. String RequestURI() ;
返回傳出請求的用戶端地址，但是不包括請求的參數字串。
38. StringBuffer getRequestURI() ;
返迴響應請求的伺服器端地址
39. String getScheme() ;
擷取協議名稱，預設值為HTTP協議。
40. String getServerName() ;
返迴響應請求的伺服器名稱。
41. String getServletPath() ;
擷取用戶端所請求的指令檔的檔案路徑。
42. int getServerPort() ;
擷取響應請求的伺服器端主機連接埠號碼。
43. void removeAttribute( String name ) ;
在屬性列表中刪除指定名稱的屬性。
44. void setAttribute( String name, Object value ) ;
在屬性列表中添加/刪除指定的屬性。
45. void setCharacterEncoding( String name ) ;
佈建要求的字元編碼格式。
46. HttpSession getSession() ;
HttpSession getSession( boolean create ) ;
擷取session，如果create為true，在無session的情況下建立一個。
47. boolean isRequestedSessionIdFromCookie() ;
檢查請求的會話ID是否為通過Cookie傳入。
48. boolean isRequestedSessionIdFromURL() ;
檢查請求的會話ID是否為通過URL傳入。
49. boolean isRequestedSessionIdValid() ;
檢查請求的會話ID是否仍然有效。
50. boolean isSecure() ;
檢查請求是否使用安全連結，如果HTTPS等。
51. boolean isUserInRole( String role ) ;
檢查已經通過驗證的使用者是否在是role所指定的角色。
52. Principal getUserPrincipal() ;
返回包含使用者登陸名的一個java.security.Principal對象。
成員：
String BASIC_AUTH = "BASIC" -
String CLIENT_CERT_AUTH = "CLIENT_CERT" -
String DIGEST_AUTH = "DIGEST" -
String FORM_AUTH = "FORM" -
③ response - javax.servlet.http.HttpServletResponse
response對象主要將JSP容器處理後的結果傳回到用戶端。
方法：
1. void addCookie( Cookie cookie ) ;
添加一個Cookie對象，儲存用戶端資訊。
2. void addDateHeader( String name, long value ) ;
添加一個日期類型的HTTP頭資訊，覆蓋同名的HTTP頭資訊。
3. void addHeader( String name, String value ) ;
添加一個HTTP頭，覆蓋同名的舊HTTP頭。
4. void addIntHeader( String name, int value ) ;
添加一個整型的HTTP頭，覆蓋同名的舊HTTP頭。
5. boolean containsHeader( String name ) ;
判斷指定的HTTP頭是否存在。
6. String encodeRedirectURL( String url ) ;
對sendRedirect()方法使用的URL進行編碼。
7. String encodeURL( String url ) ;
將URL予以編碼，回傳包含session ID的URL。
8. void flushBuffer() ;
強制把當前緩衝區的內容發送到用戶端。
9. int getBufferSize() ;
取得以kb為單位的緩衝區大小。
10. String getCharacterEncoding() ;
擷取響應的字元編碼格式。
11. String getContentType() ;
擷取響應的類型。
12. Locale getLocale() ;
擷取響應的Locale對象。
13. ServletOutputStream getOutputStream() ;
返回用戶端的輸出資料流對象。
14. PrintWriter getWriter() ;
擷取輸出資料流對應的writer對象。
15. boolean isCommitted() ;
判斷伺服器端是否已經將資料輸出到用戶端。
16. void reset() ;
清空buffer中的所有內容。
17. void resetBuffer() ;
情況buffer中所有的內容，但是保留HTTP頭和狀態資訊。
18. void sendError( int xc, String msg ) ;
void sendError( int xc ) ;
發送錯誤，包括狀態代碼和錯誤資訊。
19. void sendRedirect( String locationg ) ;
把響應發送到另外一個位置進行處理。
20. void setBufferSize( int size ) ;
設定以kb為單位的緩衝區大小。
21. void setCharacterEncoding( String charset ) ;
設定響應使用的字元編碼格式。
22. void setContentLength( int length ) ;
設定響應的BODY長度。
23. void setContentType( String type ) ;
設定響應的類型。
24. void setDateHeader( String name, long value ) ;
設定指定名稱的Data類型的HTTP頭的值。
25. void setHeader( String name, String value ) ;
設定指定名稱的HTTP頭的值。
26. void setIntHeader( String name, int value ) ;
設定指定名稱的int類型的HTTP頭的值。
27. void setStatus( int xc ) ;
設定響應狀態代碼，新值會覆蓋當前值。
成員(HTTP狀態代碼)：
int SC_CONTINUE = 100
int SC_SWITCHING_PROTOCOLS = 101
int SC_OK = 200
int SC_NON_AUTHORITATIVE_INFORMATION = 203
int SC_ACCEPTED = 202
int SC_CREATED = 201
int SC_NO_CONTENT = 204
int SC_RESET_CONTENT = 205
int SC_PARTIAL_CONTENT = 206
int SC_MULTIPLE_CHOICES = 300
int SC_MOVED_PERMANENTLY = 301
int SC_MOVED_TEMPORARILY = 302
int SC_FOUND = 302
int SC_SEE_OTHER = 303
int SC_NOT_MODIFIED = 304
int SC_USE_PROXY = 305
int SC_TEMPORARY_REDIRECT = 307
int SC_BAD_REQUEST = 400
int SC_UNAUTHORIZED = 401
int SC_PAYMENT_REQUIRED = 402
int SC_FORBIDDEN = 403
int SC_NOT_FOUND = 404
int SC_METHOD_NOT_ALLOWED = 405
int SC_NOT_ACCEPTABLE = 406
int SC_PROXY_AUTHENTICATION_REQUIRED = 407
int SC_REQUEST_TIMEOUT = 408
int SC_CONFLICT = 409
int SC_GONE = 410
int SC_LENGTH_REQUIRED = 411
int SC_PRECONDITION_FAILED = 412
int SC_REQUEST_ENTITY_TOO_LARGE = 413
int SC_REQUEST_URI_TOO_LONG = 414
int SC_UNSUPPORTED_MEDIA_TYPE = 415
int SC_REQUESTED_RANGE_NOT_SATISFIABLE = 416
int SC_EXPECTATION_FAILED = 417
int SC_INTERNAL_SERVER_ERROR = 500
int SC_NOT_IMPLEMENTED = 501
int SC_BAD_GATEWAY = 502
int SC_SERVICE_UNAVAILABLE = 503
int SC_GATEWAY_TIMEOUT = 504
int SC_HTTP_VERSION_NOT_SUPPORTED = 505
④ session - javax.servlet.http.HttpSession
session對象表示目前個別使用者的工作階段狀態，用來識別每個使用者。
方法：
1. Object getAttribute( String name ) ;擷取與指定名字相關聯的session屬性值。
2. Enumeration getAttributeNames() ;取得session內所有屬性的集合。
3. long getCreationTime() ;返回session的建立時間，最小單位千分之一秒。
4. String getId() ;取得session標識。
5. long getLastAccessedTime() ;返回與當前session相關的用戶端最後一次訪問的時間，由1970-01-01算起，單位毫秒。
6. int getMaxInactiveInterval( int interval ) ;返回總時間，以秒為單位，表示session的有效時間(session不啟用時間)。-1為永不到期。
7. ServletContext getServletContext() ;返回一個該JSP頁面對應的ServletContext對象執行個體。
8. HttpSessionContext getSessionContext() ;
9. Object getValue( String name ) ;取得指定名稱的session變數值，不推薦使用。
10. String[] getValueNames() ;取得所有session變數的名稱的集合，不推薦使用。
11. void invalidate() ;銷毀這個session對象。
12. boolean isNew() ;判斷一個session是否由伺服器產生，但是用戶端並沒有使用。
13. void pubValue( String name, Object value ) ;添加一個session變數，不推薦使用。
14. void removeValue( String name ) ;移除一個session變數的值，不推薦使用。
15. void setAttribute( String name, String value ) ;設定指定名稱的session屬性值。
16. void setMaxInactiveInterval( int interval ) ;設定session的有效期間。
17. void removeAttribute( String name ) ;移除指定名稱的session屬性。
⑤ pageContext - javax.servlet.jsp.PageContext
pageContextObject Storage Service本JSP頁面相關資訊，如屬性、內建對象等。
方法：
1. void setAttribute( String name, Object value, int scope ) ;
void setAttribute( String name, Object value ) ;
在指定的共用範圍內設定屬性。
2. Object getAttribute( String name, int scope ) ;
Object getAttribute( String name ) ;
取得指定共用範圍內以name為名字的屬性值。
3. Object findAttribute( String name ) ;按頁面、請求、會話和應用程式共用範圍搜尋已命名的屬性。
4. void removeAttribute( String name, int scope ) ;
void removeAttribute( String name ) ;
移除指定名稱和共用範圍的屬性。
5. void forward( String url ) ;將頁面導航到指定的URL。
6. Enumeration getAttributeNamesScope( int scope ) ;取得指定共用範圍內的所有屬性名稱的集合。
7. int getAttributeScope( String name ) ; 取得指定屬性的共用範圍。
8. ErrorData getErrorDate() ;取得頁面的errorData對象。
9. Exception getException() ;取得頁面的exception對象。
10. ExpressionEvaluator getExpressionEvaluator() ;取得頁面的expressionEvaluator對象。
11. JspWriter getOut() ;取得頁面的out對象。
12. Object getPage() ;取得頁面的page對象。
13. ServletRequest getRequest() ;取得頁面的request對象。
14. ServletResponse getResponse() ;取得頁面的response對象。
15. ServletConfig getConfig() ;取得頁面的config對象。
16. ServletContext getServletContext() ;取得頁面的servletContext對象。
17. HttpSession getSession() ;取得頁面的session對象。
18. VariableResolver getVariableResolver() ;取得頁面的variableResolver對象。
19. void include( String url, boolean flush ) ;
void include( String url ) ;
包含其他的資源，並指定是否自動重新整理。
20. void release() ;重設pageContext內部狀態，釋放所有內部引用。
21. void initialize( Servlet servlet, ServletRequest request, ServletResponse response, String errorPageURL, boolean needSession, int bufferSize, boolean autoFlush ) ;
初始化未經初始化的pageContext對象。
22. BodyContext pushBody() ;
BodyContext pushBody( Writer writer ) ;
儲存當前的out對象，並更新pageContext中page範圍內的out對象。
23. JspWrite popBody() ;取出由pushBody()方法儲存的out對象。
24. void handlePageException( Exception e ) ;
void handlePageException( Thrwoable t ) ;
成員：
int PAGE_SCOPE = 1 - 頁面共用範圍
int REQUEST_SCOPE = 2 - 請求共用範圍
int SESSION_SCOPE = 3 - 會話共用範圍
int APPLICATION_SCOPE = 4 - 應用程式共用範圍
String PAGE = "javax.servlet.jsp.jspPage"
String PAGECONTEXT = "javax.servlet.jsp.jspPageContext"
String REQUEST = "javax.servlet.jsp.jspRequest"
String RESPONSE = "javax.servlet.jsp.jspResponse"
String CONFIG = "javax.servlet.jsp.jspConfig"
String SESSION = "javax.servlet.jsp.jspSession"
String OUT = "javax.servlet.jsp.jspOut"
String APPLICATION = "javax.servlet.jsp.jspApplication"
String EXCEPTION = "javax.servlet.jsp.jspException"
⑥ application - javax.servlet.ServletContext
application主要功用在於取得或更改Servlet的設定。
方法：
1. Object getAttribute( String name ) ;
返回由name指定的application屬性。
2. Enumeration getAttributes() ;
返回所有的application屬性。
3. ServletContext getContext( String uripath ) ;
取得當前應用的ServletContext對象。
4. String getInitParameter( String name ) ;
返回由name指定的application屬性的初始值。
5. Enumeration getInitParameters() ;
返回所有的application屬性的初始值的集合。
6. int getMajorVersion() ;
返回servlet容器支援的Servlet API的版本號碼。
7. String getMimeType( String file ) ;
返回指定檔案的類型，未知類型返回null。一般為"text/html"和"image/gif"。
8. int getMinorVersion() ;
返回servlet容器支援的Servlet API的副版本號碼。
9. String getRealPath( String path ) ;
返回給定虛擬路徑所對應實體路徑。
10. RequestDispatcher getNamedDispatcher( String name ) ;
為指定名字的Servlet對象返回一個RequestDispatcher對象的執行個體。
11. RequestDispatcher getRequestDispatcher( String path ) ;
返回一個RequestDispatcher對象的執行個體。
12. URL getResource( String path ) ;
返回指定的資源路徑對應的一個URL對象執行個體，參數要以"/"開頭。
13. InputStream getResourceAsStream( String path ) ;
返回一個由path指定位置的資源的InputStream對象執行個體。
14. Set getResourcePaths( String path ) ;
返回儲存在web-app中所有資源路徑的集合。
15. String getServerInfo() ;
取得應用伺服器版本資訊。
16. Servlet getServlet( String name ) ;
在ServletContext中檢索指定名稱的servlet。
17. Enumeration getServlets() ;
返回ServletContext中所有servlet的集合。
18. String getServletContextName() ;
返回本web應用的名稱。
19. Enumeration getServletContextNames() ;
返回ServletContext中所有servlet的名稱集合。
20. void log( Exception ex, String msg ) ;
void log( String msg, Throwable t ) ;
void log( String msg ) ;
把指定的資訊寫入servlet log檔案。
21. void removeAttribute( String name ) ;
移除指定名稱的application屬性。
22. void setAttribute( String name, Object value ) ;
設定指定的application屬性的值。
⑦ config - javax.servlet.ServletConfig
config對象用來存放Servlet初始的資料結構。
方法：
1. String getInitParameter( String name ) ;
返回名稱為name的促使參數的值。
2. Enumeration getInitParameters() ;
返回這個JSP所有的促使參數的名稱集合。
3. ServletContext getContext() ;
返回執行者的servlet上下文。
4. String getServletName() ;
返回servlet的名稱。
⑧ exception - java.lang.Throwable
錯誤對象，只有在JSP頁面的page指令中指定isErrorPage="true"後，才可以在本頁面使用exception對象。
方法：
1. Throwable fillInStackTrace() ;
將當前stack資訊記錄到exception對象中。
2. String getLocalizedMessage() ;
取得本地語系的錯誤提示資訊。
3. String getMessage()
取得錯誤提示資訊。
4. StackTrackElement[] getStackTrace() ;
返回對象中記錄的call stack track資訊。
5. Throwable initCause( Throwable cause ) ;
將另外一個異常對象嵌套進當前異常對象中。
6. Throwable getCause() ;
取出嵌套在當前異常對象中的異常。
7. void printStackTrace() ;
void printStackTrace( printStream s ) ;
void printStackTrace( printWriter s ) ;
列印出Throwable及其call stack trace資訊。
8. void setStackTrace( StackTraceElement[] stackTrace )
設定對象的call stack trace資訊。
⑨ page - javax.servlet.jsp.HttpJspPage
page對象代表JSP對象本身，或者說代表編譯後的servlet對象，
可以用( (javax.servlet.jsp.HttpJspPage)page )來取用它的方法和屬性。
