JSP基本内置对象,小总结（一）

 

定义：可以不加声明就在JSP页面脚本（Java程序片和Java表达式）中使用的成员变量

　　JSP共有以下9种基本内置对象：　　

内置对象	代表内容	范围
request	触发服务调用的请求	request
response	对请求的应答	page
session	为请求的客户创建的session对象	session
application	从 servlet 配置对象获得的 servlet 上下文（如在getServletConfig() ，getContext()的调用中）	application
out	向输出流写入内容的对象	page
pageContext	本 JSP 的页面上下文	page
page	实现处理本页当前请求的类的实例	page
config	本 JSP 的 ServletConfig	page
exception	表示JSP页面运行时产生的异常	Page

 

 

① 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属性。