9个内置对象

 JSP中的内置对象（9个）

内置对象是不需要声明，直接可以在JSP中使用的对象，JSP有以下几种内置对象： 
1.request对象 
request表示HttpServletRequest对象。它包含了有关浏览器请求的信息，并且提供了几个用于获取cookie,header,和session数据的有用的方法。客户端的请求信息被封装在request对象中，通过它才能了解到客户的需求，然后做出响应。 

1 Object getAttribute(String name)返回指定属性的属性值，该属性不存在时返回null。 
2 Enumeration getAttributeNames()返回所有可用属性名的枚举 
3 String getAuthType();返回用来保护servlet的认证方法的名称，未受保护时返回null。 
4 String getCharacterEncoding() 返回字符编码方式 
5 int getContentLength()返回请求体的长度（以字节数），不能确定长度时返回-1。 
6 String getContentType() 得到请求体的MIME类型 
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)返回name指定参数的参数值 
22 Map getParameterMap()该方法返回包含请求中所有参数的一个Map对象。 
23 Enumeration getParameterNames()返回请求中所有参数的集合。 
24 String[] getParameterValues(String name)返回包含参数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.https及ftp等 
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" 

2.response对象 response 
表示HttpServletResponse对象，主要将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予以编码，回传包含sessionID的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 intSC_NOT_ACCEPTABLE 

3.session对象 
session表示一个请求的javax.servlet.http.HttpSession对象。指的是客户端与服务器的一次会话，从客户连到服务器的一个WebApplication开始，直到客户端与服务器断开连接为止。 
1 long getCreationTime() 返回SESSION创建时间 
2 public String getId()返回SESSION创建时JSP引擎为它设的惟一ID号 
3 long getLastAccessedTime()返回此SESSION里客户端最近一次请求时间 
4 int getMaxInactiveInterval()返回两次请求间隔多长时间此SESSION被取消(ms) 
5 String[] getValueNames()返回一个包含此SESSION中所有可用属性的数组 
6 void invalidate() 取消SESSION，使SESSION不可用 
7 boolean isNew()返回服务器创建的一个SESSION,客户端是否已经加入 
8 void removeValue(String name)删除SESSION中指定的属性 
9 void setMaxInactiveInterval()设置两次请求间隔多长时间此SESSION被取消(ms) 

4.out对象 
out对象是javax.jsp.JspWriter的一个实例，并提供了几个方法使你能用于向浏览器回送输出结果。 
1 void clear() 清除缓冲区的内容，但是不输出到客户端。 
2 void clearBuffer() 清除缓冲区的当前内容，并输出到客户端。 
3 void close() 关闭输出流，清除所有内容。 

4 void flush() 输出缓冲区里面的数据。 
5 int getBufferSize()返回缓冲区以字节数的大小，如不设缓冲区则为0 
6 int getRemaining() 返回缓冲区还剩余多少可用 
7 boolean isAutoFlush() 返回缓冲区满时，是自动清空还是抛出异常 
8. void newLine() 输出一个换行字符。 
9. void print( boolean b )将指定类型的数据输出到Http流，不换行 
10. void println( boolean b )将指定类型的数据输出到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 - 是否限制缓冲区大小 


5.page对象 
page对象就是指向当前JSP页面本身，有点象类中的this指针，它是java.lang.Object类的实例 
1 class getClass 返回此Object的类 
2 int hashCode() 返回此Object的hash码 
3 boolean equals(Object obj)判断此Object是否与指定的Object对象相等 
4 void copy(Object obj)把此Object拷贝到指定的Object对象中 
5 Object clone() 克隆此Object对象 
6 String toString() 把此Object对象转换成String类的对象 
7 void notify() 唤醒一个等待的线程 
8 void notifyAll() 唤醒所有等待的线程 
9 void wait(int timeout)使一个线程处于等待直到timeout结束或被唤醒 
10 void wait() 使一个线程处于等待直到被唤醒 
11 void enterMonitor() 对Object加锁 
12 void exitMonitor() 对Object开锁 


6.application对象 
applicaton表示一个javax.servlet.ServletContext对象。他实现了用户间数据的共享，可存放全局变量。它 

开始于服务器的启动，直到服务器的关闭，在此期间，此对象将一直存在；这样在用户的前后连接或不同用户之 

间的连接中，可以对此对象的同一属性进行操作；在任何地方对此对象属性的操作，都将影响到其他用户对此的 

访问。服务器的启动和关闭决定了application对象的生命。 

1 Object getAttribute(String name)返回给定名的属性值 
2 Enumeration getAttributeNames()返回所有可用属性名的枚举 
3 void setAttribute(String name,Object obj)设定属性的属性值 
4 void removeAttribute(String name)删除一属性及其属性值 
5 String getServerInfo()返回JSP(SERVLET)引擎名及版本号 
6 String getRealPath(String path)返回一虚拟路径的真实路径 
7 ServletContext getContext(String uripath)返回指定WebApplication的application对象 
8 int getMajorVersion() 返回服务器支持的ServletAPI的最大版本号 
9 int getMinorVersion() 返回服务器支持的ServletAPI的最大版本号 
10 String getMimeType(String file)返回指定文件的MIME类型 
11 URL getResource(String path)返回指定资源(文件及目录)的URL路径 
12 InputStream getResourceAsStream(String path)返回指定资源的输入流 
13 RequestDispatcher getRequestDispatcher(String uripath)返回指定资源的RequestDispatcher对象 
14 Servlet getServlet(String name)返回指定名的Servlet 
15 Enumeration getServlets() 返回所有Servlet的枚举 
16 Enumeration getServletNames()返回所有Servlet名的枚举 
17 void log(String msg) 把指定消息写入Servlet的日志文件 
18 void log(Exception exception,String msg)把指定异常的栈轨迹及错误消息写入Servlet的日志文件 
19 void log(String msg,Throwable throwable)把栈轨迹及给出的Throwable异常的说明信息 写入Servlet的 

日志文件。 

7.exception对象 
exception对象是一个例外对象，当一个页面在运行过程中发生了例外，就产生这个对象。如果一个JSP页面要应 

用此对象，就必须把isErrorPage设为true，否则无法编译。他实际上是java.lang.Throwable的对象。 

8.pageContext对象 
pageContext表示一个javax.servlet.jsp.PageContext对象。pageContext对象提供了对JSP页面内所有的对象及 

名字空间的访问，也就是说他可以访问到本页所在的SESSION，也可以取本页面所在的application的某一属性值 

。 

1 JspWriter getOut()返回当前客户端响应被使用的JspWriter流(out) 
2 HttpSession getSession()返回当前页中的HttpSession对象(session) 
3 Object getPage() 返回当前页的Object对象(page) 
4 ServletRequest getRequest()返回当前页的ServletRequest对象(request) 
5 ServletResponse getResponse()返回当前页的ServletResponse对象(response) 
6 Exception getException()返回当前页的Exception对象(exception) 
7 ServletConfig getServletConfig()返回当前页的ServletConfig对象(config) 
8 ServletContext getServletContext()返回当前页的ServletContext对象(application) 
9 void setAttribute(String name,Object attribute)设置属性及属性值 
10 void setAttribute(String name,Object obj,int scope)在指定范围内设置属性及属性值 
11 public Object getAttribute(String name)取属性的值 
12 Object getAttribute(String name,int scope)在指定范围内取属性的值 
13 public Object findAttribute(String name)寻找一属性,返回起属性值或NULL 
14 void removeAttribute(String name) 删除某属性 
15 void removeAttribute(String name,int scope)在指定范围删除某属性 
16 int getAttributeScope(String name)返回某属性的作用范围 
17 Enumeration getAttributeNamesInScope(int scope)返回指定范围内可用的属性名枚举 
18 void release() 释放pageContext所占用的资源 
19 void forward(String relativeUrlPath)使当前页面重导到另一页面 
20 void include(String relativeUrlPath)在当前位置包含另一文件 


9.config对象 
config表示一个javax.servlet.ServletConfig对象。 
config对象是在一个Servlet初始化时，JSP引擎向它传递信息用的，此信息包括Servlet初始化时所要用到的参 

数（通过属性名和属性值构成）以及服务器的有关信息（通过传递一个ServletContext对象。） 

1 ServletContext getServletContext()返回含有服务器相关信息的ServletContext对象 
2 String getInitParameter(String name)返回初始化参数的值 
3 Enumeration getInitParameterNames()返回Servlet初始化所需所有参数的枚举 

JSP的9个内置对象