jsp九大內建物件及常用方法和詳細方法
• application: javax.servlet. ServletContext 的例項,該例項代表JSP 所屬的Web 應用本身,可用於JSP 頁面,或者Servlet 之間交換資訊。
常用的方法有:
getAttribute(String attNarne) , setAttribute(String attNarne , String attValue) 和getInitPararneter(String paramNarne)等。
• config: javax.servlet. ServletConfig 的例項,該例項代表該JSP 的配置資訊。事實上, JSP 頁面通常無須配置,也就不存在配置資訊。因此,該物件更多地在Servlet 中有效。
常用的方法有getInitPararneter(String paramNarne) 及getInitPararneternarnes() 等方法。
• exception: java.lang.Throwable 的例項,該例項代表其他頁面中的異常和錯誤。只有當頁面是錯誤處理頁面,即編譯指令page 的isErrorPage 屬性為true 時,該物件才可以使用。
常用的方法有getMessageO和printStackTraceO等。
• out: javax.servlet.jsp.JspWriter 的例項,該例項代表JSP 頁面的輸出流,用於輸出內容,形成HTML 頁面。
常用方法:
out.print()
out.newLine()
out.close() :關閉輸出流
• page: 代表該頁面本身,通常沒有太大用處。也就是Servlet 中的this ,其型別就是生成的Servlet
• pageContext: javax.servlet.jsp.PageContext 的例項,該物件代表該JSP 頁面上下文,使用該物件可以訪問頁面中的共享資料。
常用的方法有getServletContext()和getServletConfig()等。
• request: javax.servlet. http:HttpServletRequest 的例項,該物件封裝了一次請求,客戶端的請求引數都被封裝在該物件裡。這是一個常用的物件,獲取客戶端請求引數必須使用該物件。
常用的方法有
getPararneter(String paramNarne), getPararneterValues(String paramName), setAttribute(String atttibuteName,Object attributeValue), getAttribute(String attributeName)和setCharacterEncoding(String env)等。
• response: javax.servlet.http.HttpServletResponse 的例項,代表伺服器對客戶端的響應。通常,也很少使用該物件直接響應,輸出響應使用out 物件,而response 物件常用於重定向。
常用的方法有sendRedirect(j ava.lang.String location)等。
• session: javax.servlet.http.HttpSession 的例項,該物件代表一次會話。從客戶端瀏覽器與站點建立連線起,開始會話,直到關閉瀏覽器時結束會話。
常用的方法有:getAttribute(String attName), setAttribute(String attName, String attValue)等。
① 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