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 )来取用它的方法和属性。