九大jsp內建對象[詳細]

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