jsp/servlet内置方法详解

方法: 
 
    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 )来取用它的方法和属性.  [/size][size=x-small][size=medium][/size][color=red][/color]