JSP九大內建對象__JSP

內建對象:

Request,Response,Out,Session,Application,Cookie,Config,Page,Exception。

1、Request對象

    該對象封裝了使用者提交的資訊，通過調用該對象相應的方法可以擷取封裝的資訊，即使用該對象可以
擷取使用者提交的資訊。
    當Request對象擷取客戶提交的漢字字元時，會出現亂碼問題，必須進行特殊處理。首先，將擷取的
字串用ISO-8859－1進行編碼，並將編碼存發島一個位元組數組中，然後再將這個數組轉化為字串對象
即可。如下：

String textContent=request.getParameter("boy"); byte b[]=textContent.getBytes("ISO-8859-1"); textContent=new String(b);

Request常用的方法：
1.01 getParameter(String strTextName) 擷取表單提交的資訊。

String strName＝request.getParameter("name");

    1.02 getProtocol() 擷取客戶使用的協議。

String strProtocol=request.getProtocol();

    1.03 getServletPath() 擷取客戶提交資訊的頁面。

String strServlet=request.getServletPath();

    1.04 getMethod() 擷取客戶提交資訊的方式，get|post。

String strMethod = request.getMethod();

    1.05 getHeade() 擷取HTTP標頭檔中的accept、accept-encoding和Host的值。

String strHeader = request.getHeader("accept");

    1.06 getRermoteAddr() 擷取客戶的IP地址。

String strIP = request.getRemoteAddr();

    1.07 getRemoteHost() 擷取客戶機的名稱。

String clientName = request.getRemoteHost();

    1.08 getServerName() 擷取伺服器名稱。

String serverName = request.getServerName();

    1.09 getServerPort() 擷取伺服器的連接埠號碼。

int serverPort = request.getServerPort();

    1.10 getParameterNames() 擷取用戶端提交的所有參數的名字。

Enumeration enum = request.getParameterNames(); while(enum.hasMoreElements()){     String s=(String)enum.nextElement();     out.println(s); }

2、Response對象

    對客戶的請求做出動態響應，向用戶端發送資料。
    2.1 動態響應contentType屬性
    當一個使用者訪問一個JSP頁面時，如果該頁面用page指令設定頁面的contentType屬性時text/html，那麼JSP引擎將按照這個屬性值做出反應。如果要動態改變這換個屬性值來響應客戶，就需要使用Response對象的setContentType(String s)方法來改變contentType的屬性值。
    格式：response.setContentType(String s);
    參數s可取text/html,application/x-msexcel,application/msword等。
    2.2 Response重新導向
    在某些情況下，當響應客戶時，需要將客戶重新引導至另一個頁面，可以使用Response的sendRedirect(URL)方法實現客戶的重新導向。例如：

response.sendRedirect("index.jsp");

3、Session對象

    （1）什麼是Session對象
    Session對象是一個JSP內建對象，它在第一個JSP頁面被裝載時自動建立，完成會話期管理。從一個客戶開啟瀏覽器並串連到伺服器開始，到客戶關閉瀏覽器離開這個伺服器結束，被稱為一個會話。當一個客戶訪問一個伺服器時，可能會在這個伺服器的幾個頁面之間切換，伺服器應當通過某種辦法知道這是一個客戶，就需要Session對象。
    （2）Session對象的ID
    當一個客戶首次訪問伺服器上的一個JSP頁面時，JSP引擎產生一個Session對象，同時分配一個String類型的ID號，JSP引擎同時將這換個ID號發送到用戶端，存放在Cookie中，這樣Session對象，直到客戶關閉瀏覽器後，伺服器端該客戶的Session對象才取消，並且和客戶的會話對應關係消失。當客戶重新開啟瀏覽器再串連到該伺服器時，伺服器為該客戶再建立一個新的Session對象。
    （3）Session對象的常用方法
    ● public String getId()：擷取Session對象編號。
    ● public void setAttribute(String key,Object obj)：將參數Object指定的對象obj添加到Session對象中，並為添加的對象指定一個索引關鍵字。
    ● public Object getAttribute(String key)：擷取Session對象中含有關鍵字的對象。
    ● public Boolean isNew()：判斷是否是一個新的客戶。

4、Application對象

    （1）什麼時Application對象
    伺服器啟動後就產生了這個Application對象，當客戶再所訪問的網站的各個頁面之間瀏覽時，這個Application對象都時同一個，直到伺服器關閉。但是與Session對象不同的時，所有客戶的Application對象都時同一個，即所有客戶共用這個內建的Application對象。
    （2）Application對象的常用方法
    ● setAttribute(String key,Object obj)：將參數Object指定的對象obj添加到Application對象中，並為添加的對象指定一個索引關鍵字。
    ● getAttribute(String key)：擷取Application對象中含有關鍵字的對象。

5、Out對象

   Out對象時一個輸出資料流，用來向用戶端輸出資料。Out對象用於各種資料的輸出。其常用方法如下。
    ● out.print()：輸出各種類型資料。
    ● out.newLine()：輸出一個分行符號。
    ● out.close()：關閉流。

6、Cookie對象

    （1）什麼是Cookie
    Cookie是Web伺服器儲存在使用者硬碟上的一段文本。Cookie允許一個Web網站在使用者電腦上儲存資訊並且隨後再取回它。
    舉例來說，一個Web網站可能會為每一個訪問者產生一個唯一的ID，然後以Cookie檔案的形式儲存在每個使用者的機器上。
    如果使用者使用IE瀏覽器訪問Web，使用者就會看到所有儲存在自己硬碟上的Cookie。它們最常存放的地方是：C:/Windows/Cookies。Cookie是以“關鍵字key=值value”的格式來儲存記錄的。
    （2）建立一個Cookie對象
    調用Cookie對象的建構函式就可以建立Cookie對象。Cookie對象的建構函式有兩個字串參數：Cookie名字和Cookie值。
    例如：Cookie c = new Cookie("username","john");
    （3）將Cookie對象傳送到用戶端
    在JSP中，如果要將封裝好的Cookie對象傳送到用戶端，可使用Response對象的addCookie()方法。
    例如：response.addCookie(c)。
    （4）讀取儲存到用戶端的Cookie
    使用Request對象的getCookie()方法，執行時將所有用戶端傳來的Cookie對象以數組的形式排列，如果要取出符合需要的Cookie對象，就需要迴圈比較數組內每個對象的關鍵字。
    例如：

Cookie[] c = request.getCookies(); if(c != null)  for(int i = 0;i < c.length;i++){        if("username".equals(c.getName()))            out.println(c.getValue());     }

    （5）設定Cookie對象的有效時間
    調用Cookie對象的setMaxAge()方法便可以設定Cookie對象的有效時間，
    例如：Cookie c = new Cookie("username","john");
          c.setMaxAge(3600);
    （6）Cookie應用
    Cookie對象的典型應用時用來統計網站的訪問人數。由於Proxy 伺服器、緩衝等的使用，唯一能協助網站精確統計來訪人數的方法就是為每個訪問者建立一個唯一ID。使用Cookie，網站可以完成一下工作。
    ● 測定多少人訪問過。
    ● 測定訪問者有多少是新使用者（即第一次來訪），多少是老使用者。
    ● 測定一個使用者多久訪問一次網站
    當一個使用者第一次訪問時，網站在資料庫中建立一個新的ID，並把ID通過Cookie傳送給使用者。使用者再次來訪時，網站把該使用者ID對應的計數器加1，得到使用者的來訪次數。

7、Config對象

    設定物件

8、Page對象

    頁面對象。

  PageContext對象

    頁面內容物件
    Jsp引入了一個名位PageContext的類，通過它可以訪問頁面的許多屬性。
    PageContext類擁有getRequest，getResponse，getOut，getSession等方法。
    pageContext變數儲存與當前頁面相關聯的PageContext對象的值。
    補：
    如果方法需要訪問多個與頁面相關的對象，
傳遞pageContext要比傳遞request，response，out等的獨立引用更容易。（雖然兩種方式都能達到同樣的目的）

9、Exception對象

     在處理異常的網頁中可以直接存取exception隱式對象。

-----------------------------------補充部分--------------------------------

 

① 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