1. 程式人生 > >jsp九大內建物件 page與pageContext的區別

jsp九大內建物件 page與pageContext的區別

九大內建物件介紹

① 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 )來取用它的方法和屬性。

page與pageContext的區別

        page java.lang.Object  對應this關鍵字。JSP網頁本身,page物件是當前頁面轉換後的Servlet類的例項。從轉換後的Servlet類的程式碼中,可以看到這種關係:Object page = this;在JSP頁面中,很少使用page物件。

  pageContext  javax.servlet.jsp.PageContext 的例項,該物件代表該JSP 頁面上下文,使用該物件可以訪問頁面中的共享資料。常用的方法有getServletContext和getServletConfig等。

  //使用pageContext 設定屬性,該屬性預設在page 範圍內
  pageContext. setAttribute ("page" , "hello") ;

  //使用request 設定屬性,該屬性預設在request 範圍內
  request. setAttribute ("request" , "hello");

  //使用pageContext將屬性設定在request 範圍中
  pageContext.setAttribute("request2″ , "hello" , pageContext.REQUEST_SCOPE);

  //使用session將屬性設定在session 範圍中
  session.setAttribute("session" , "hello");

  //使用pageContext將屬性設定在session範圍中
  pageContext.setAttribute("session2″ , "hello" , pageContext.SESSION_SCOPE);

  //使用application將屬性設定在application範圍中
  application. setAttribute ("app" , "hello") ;

  //使用pageContext 將屬性設定在application 範圍中
  pageContext.setAttribute("app2″ , "hello" , pageContext.APPLICATION_SCOPE) ; 

整理自:http://blog.csdn.net/lenhan12345/article/details/1566594

                http://tanlan.iteye.com/blog/705801