JSP內置對象整理

① 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 pageContext對象存儲本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 )來取用它的方法和屬性.

Tags: