JSP内置对象详解 & 常用方法

我会带着你远行 2024-03-29 14:25 7阅读 0赞

**目录**

out

request

response

session

application

exception

page

config

pageContext

JSP内置对象的作用域

--------------------

JSP内置对象是在JSP运行环境中已定义好的对象，可在JSP页面的脚本部分直接使用。

## out对象 ##

out 为输出流对象，主要用于向客户端输出流进行操作，可将有关信息发送到客户端的浏览器。

此外，通过out 对象，还可对输出缓存区与输出流进行相应的控制和管理。

out 是向客户端输出内容时所使用的常用对象，它其实是 javax.servlet.jsp.JspWriter 类的实例，具有 page 作用域。

JspWriter 类包含了 java.io.PrintWriter 类中的大部分方法，并新增了一些专为处理缓存而设计的方法，会抛出 IOException 异常（而PrintWriter不会）。

### out对象常用方法 ###

<table style="width:592px;"> 
 <tbody> 
  <tr> 
   <th style="width:164px;">方法</th> 
   <th style="width:426px;">说明</th> 
  </tr> 
  <tr> 
   <td style="width:164px;">void print(String str)</td> 
   <td style="width:426px;">输出数据</td> 
  </tr> 
  <tr> 
   <td style="width:164px;">void println(String str)</td> 
   <td style="width:426px;">输出数据并换行</td> 
  </tr> 
  <tr> 
   <td style="width:164px;">void newLine()</td> 
   <td style="width:426px;">输出一个换行符</td> 
  </tr> 
  <tr> 
   <td style="width:164px;">int getBufferSize()</td> 
   <td style="width:426px;">获取缓存区大小</td> 
  </tr> 
  <tr> 
   <td style="width:164px;">int getRemaining()</td> 
   <td style="width:426px;">获取缓存区剩余空间的大小</td> 
  </tr> 
  <tr> 
   <td style="width:164px;">void flush()</td> 
   <td style="width:426px;">输出缓存区中的数据</td> 
  </tr> 
  <tr> 
   <td style="width:164px;">void clear()</td> 
   <td style="width:426px;">清除缓存区中的数据，并关闭对客户端的输出流</td> 
  </tr> 
  <tr> 
   <td style="width:164px;">void clearBuffer()</td> 
   <td style="width:426px;">清除缓存区的数据</td> 
  </tr> 
  <tr> 
   <td style="width:164px;">void close()</td> 
   <td style="width:426px;">输出缓存区的数据，并关闭对客户端的输出流</td> 
  </tr> 
  <tr> 
   <td style="width:164px;">boolean isAutoFlush()</td> 
   <td style="width:426px;"> <p>缓冲区满时是否自动清空。该方法返回布尔值（由page指令的autoFlush属性确定）。若返回值为true， 则表示缓存区满了会自动清除；若为false，则表示缓冲区满时不会自动清除，而是抛出异常。</p> </td> 
  </tr> 
 </tbody> 
</table>

## request对象 ##

request 对象为请求对象，其中封装了客户端的所有信息，如请求的来源、标头、Cookies 以及与与请求相关的参数值等。为获取请求的有关信息（如用户在form表单中所填写的数据等），可调用request对象的有关方法。

request 对象是 javax.servlet.http.HttpServletRequest 类的实例，具有 request 作用域，代表的是来自客户端的请求（如 form 表单中写的信息等），是最常用的对象之一。每当客户端请求一个JSP 页面时，JSP引擎就会创建一个新的 request 对象来代表这个请求。

### request对象常用方法 ###

###  ###

<table style="width:628px;"> 
 <thead> 
  <tr> 
   <th style="width:298px;">方法</th> 
   <th style="width:328px;">说明</th> 
  </tr> 
  <tr> 
   <td style="width:298px;">String getServerName()</td> 
   <td style="width:328px;">获取接受请求的服务器的主机名</td> 
  </tr> 
  <tr> 
   <td style="width:298px;">int getServerPort()</td> 
   <td style="width:328px;">获取服务器接受请求所用的端口号</td> 
  </tr> 
  <tr> 
   <td style="width:298px;">String getRemoteHost()</td> 
   <td style="width:328px;">获取发送请求所用的端口号</td> 
  </tr> 
  <tr> 
   <td style="width:298px;">String getRemoteAddr()</td> 
   <td style="width:328px;">获取发送请求的客户端的IP地址</td> 
  </tr> 
  <tr> 
   <td style="width:298px;">int getRemoteUser()</td> 
   <td style="width:328px;">获取客户端发送请求所用的端口号</td> 
  </tr> 
  <tr> 
   <td style="width:298px;">String getRemoteUser()</td> 
   <td style="width:328px;">获取发送请求的客户端的用户名</td> 
  </tr> 
  <tr> 
   <td style="width:298px;">String getQueryString()</td> 
   <td style="width:328px;">获取查询字符串</td> 
  </tr> 
  <tr> 
   <td style="width:298px;">String getRequestURI（）</td> 
   <td style="width:328px;">获取请求去掉host的部分路径（不包含查询字符串）</td> 
  </tr> 
  <tr> 
   <td style="width:298px;">String getRequestURL（）</td> 
   <td style="width:328px;">获取请求的全路径</td> 
  </tr> 
  <tr> 
   <td style="width:298px;">String getRealPath(String path)</td> 
   <td style="width:328px;">获取指定虚拟路径的真实路径</td> 
  </tr> 
  <tr> 
   <td style="width:298px;">String getParameter(String name)</td> 
   <td style="width:328px;">获取指定参数的值（字符串）</td> 
  </tr> 
  <tr> 
   <td style="width:298px;">String[] getParameterValue(String name)</td> 
   <td style="width:328px;">获取指定参数的所有值</td> 
  </tr> 
  <tr> 
   <td style="width:298px;">Enumeration getParameterNames()</td> 
   <td style="width:328px;">获取所有参数名的枚举</td> 
  </tr> 
  <tr> 
   <td style="width:298px;">Cookies[] getCookies()</td> 
   <td style="width:328px;">获取与请求有关的Cookie对象（Cookie 数组）</td> 
  </tr> 
  <tr> 
   <td style="width:298px;">Map getParameterMap()</td> 
   <td style="width:328px;">获取请求参数的Map</td> 
  </tr> 
  <tr> 
   <td style="width:298px;">Object getAttribute(String name)</td> 
   <td style="width:328px;">获取指定属性的值。若不存在，则返回null</td> 
  </tr> 
  <tr> 
   <td style="width:298px;">Enumeration getAttributeNames()</td> 
   <td style="width:328px;">获取所有可用属性名的枚举</td> 
  </tr> 
  <tr> 
   <td style="width:298px;">String getHeader(String name)</td> 
   <td style="width:328px;">获取指定标头的信息</td> 
  </tr> 
  <tr> 
   <td style="width:298px;">Enumeration getHeaders(String name)</td> 
   <td style="width:328px;">获取指定标头的信息的枚举</td> 
  </tr> 
  <tr> 
   <td style="width:298px;">int getIntHeader(String name)</td> 
   <td style="width:328px;">获取指定整数类型标头的信息</td> 
  </tr> 
  <tr> 
   <td style="width:298px;">long getDateHeader(String name)</td> 
   <td style="width:328px;">获取指定日期类型标头的信息</td> 
  </tr> 
  <tr> 
   <td style="width:298px;">Enumeration getHeaderNames()</td> 
   <td style="width:328px;">获取所有标头名的枚举</td> 
  </tr> 
  <tr> 
   <td style="width:298px;">String getProtocol()</td> 
   <td style="width:328px;">获取客户端向服务器传送数据所使用的协议名</td> 
  </tr> 
  <tr> 
   <td style="width:298px;">String getScheme()</td> 
   <td style="width:328px;">获取请求所使用的协议名</td> 
  </tr> 
  <tr> 
   <td style="width:298px;">String getMethod()</td> 
   <td style="width:328px;">获取客户端向服务器端传送数据的方法（GET，POST）</td> 
  </tr> 
  <tr> 
   <td style="width:298px;">String getCharacterEncoding()</td> 
   <td style="width:328px;">获取请求的字符编码方式</td> 
  </tr> 
  <tr> 
   <td style="width:298px;">String getServletPath()</td> 
   <td style="width:328px;">获取客户端所请求的文件的路径</td> 
  </tr> 
  <tr> 
   <td style="width:298px;">String getContextPath()</td> 
   <td style="width:328px;">获取客户端所请求的文件的路径</td> 
  </tr> 
  <tr> 
   <td style="width:298px;">int getContentLength()</td> 
   <td style="width:328px;">获取请求体的长度（字节数）</td> 
  </tr> 
  <tr> 
   <td style="width:298px;">String getContentType()</td> 
   <td style="width:328px;">获取客户端请求的 MIME 类型。若无法得到该请求的 MIME 类型，则返回 -1</td> 
  </tr> 
  <tr> 
   <td style="width:298px;">ServletInputStream getInputStream()</td> 
   <td style="width:328px;">获取请求的输入流</td> 
  </tr> 
  <tr> 
   <td style="width:298px;">BufferedReader getReader()</td> 
   <td style="width:328px;">获取解码后的请求体</td> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td style="width:298px;">HttpSession getSession(Boolean creat)</td> 
   <td style="width:328px;">获取与当前客户端请求相关联的 HttpSeesion 对象。若参数 creat 为true，或不指定参数 creat，且 session 对象已经存在，则直接返回，否则创建一个新的 session 对象并返回；若 creat 为false，且 session 对象已经存在，则直接返回，否则返回null</td> 
  </tr> 
  <tr> 
   <td style="width:298px;">void getRequestedSessionId</td> 
   <td style="width:328px;">获取 session 对象的ID号</td> 
  </tr> 
  <tr> 
   <td style="width:298px;">void setAttribute(String name, Object obj)</td> 
   <td style="width:328px;">设置指定属性值</td> 
  </tr> 
  <tr> 
   <td style="width:298px;">void setCharacterEncoding(String encoding)</td> 
   <td style="width:328px;">设置字符编码形式</td> 
  </tr> 
 </tbody> 
</table>

## response对象 ##

response 对象为响应对象，用于对客户端的请求进行动态回应，可向客户端发送数据，如Cookies、时间戳、HTTP标头信息、HTTP状态码等。在实际应用中，response 对象主要用于将JSP数据处理后的结果传回到客户端。

response 对象是 javax.servlet.http.HttpServletResponse 类的实例，具有 page 作用域。当服务器创建 request 对象时，会同时创建用于响应该客户端的response对象。

### response对象的常用方法 ###

<table style="width:638px;"> 
 <thead> 
  <tr> 
   <th style="width:313px;">方法</th> 
   <th style="width:323px;">说明</th> 
  </tr> 
  <tr> 
   <td style="width:313px;">void addHeader(String name, String value)</td> 
   <td style="width:323px;">添加指定标头。若指定标头已存在，则覆盖其值。</td> 
  </tr> 
  <tr> 
   <td style="width:313px;">void setHeader(String name, String value)</td> 
   <td style="width:323px;">设置指定标头的值</td> 
  </tr> 
  <tr> 
   <td style="width:313px;">boolean containsHeader(String name)</td> 
   <td style="width:323px;">判断指定标头是否存在</td> 
  </tr> 
  <tr> 
   <td style="width:313px;">void sendRedirect(String url)</td> 
   <td style="width:323px;">重定向（跳转）到指定的页面（URL）</td> 
  </tr> 
  <tr> 
   <td style="width:313px;">String encodeRedirectURL(String url)</td> 
   <td style="width:323px;">对用于重定向的URL进行编码</td> 
  </tr> 
  <tr> 
   <td style="width:313px;">String encodeURL(String url)</td> 
   <td style="width:323px;">对URL进行编码</td> 
  </tr> 
  <tr> 
   <td style="width:313px;">void setCharacterEncoding(String encoding)</td> 
   <td style="width:323px;">设置响应的字符编码类型</td> 
  </tr> 
  <tr> 
   <td style="width:313px;">String getCharacterEncoding()</td> 
   <td style="width:323px;">获取响应的字符类型</td> 
  </tr> 
  <tr> 
   <td style="width:313px;">void setContentType(String type)</td> 
   <td style="width:323px;">设置响应的MIME类型</td> 
  </tr> 
  <tr> 
   <td style="width:313px;">String getContentType()</td> 
   <td style="width:323px;">获取响应的MIME类型</td> 
  </tr> 
  <tr> 
   <td style="width:313px;">void addCookie(Cookie cookie)</td> 
   <td style="width:323px;">添加指定的Cookie对象（用于保存客户端的用户信息）</td> 
  </tr> 
  <tr> 
   <td style="width:313px;">int getBuffersize()</td> 
   <td style="width:323px;">获取缓存区的大小</td> 
  </tr> 
  <tr> 
   <td style="width:313px;">void setBuffersize(int size)</td> 
   <td style="width:323px;">设置缓存区的大小</td> 
  </tr> 
  <tr> 
   <td style="width:313px;">void flushBuffer()</td> 
   <td style="width:323px;">将当前缓存区的内容强制发送到客户端</td> 
  </tr> 
  <tr> 
   <td style="width:313px;">void reset()</td> 
   <td style="width:323px;">清空缓存区中的所有内容</td> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td style="width:313px;">void resetBuffer()</td> 
   <td style="width:323px;">清空缓存区中除了标头与状态信息以外的所有内容</td> 
  </tr> 
  <tr> 
   <td style="width:313px;">ServletOutputStream getOutputStream()</td> 
   <td style="width:323px;">获取客户端的输出流对象</td> 
  </tr> 
  <tr> 
   <td style="width:313px;">PrintWriter getWriter()</td> 
   <td style="width:323px;">获取输出流对应的Writer对象</td> 
  </tr> 
  <tr> 
   <td style="width:313px;">void setContentLength(int length)</td> 
   <td style="width:323px;">设置响应的BODY长度</td> 
  </tr> 
  <tr> 
   <td style="width:313px;">void setStatus(int sc)</td> 
   <td style="width:323px;">设置状态码（status code）</td> 
  </tr> 
  <tr> 
   <td style="width:313px;">void sendError(int sc)</td> 
   <td style="width:323px;">发送状态码</td> 
  </tr> 
  <tr> 
   <td style="width:313px;">void sendError(int sc， String msg)</td> 
   <td style="width:323px;">发送状态码和状态信息</td> 
  </tr> 
  <tr> 
   <td style="width:313px;">void addDateHeader(String name, long date)</td> 
   <td style="width:323px;">添加指定的日期类型标头</td> 
  </tr> 
  <tr> 
   <td style="width:313px;">void addHeader（String name， String value）</td> 
   <td style="width:323px;">添加指定的字符串类型标头</td> 
  </tr> 
  <tr> 
   <td style="width:313px;">void addIntHeader(String name, int value)</td> 
   <td style="width:323px;">添加指定的整数类型标头</td> 
  </tr> 
  <tr> 
   <td style="width:313px;">void setDateHeader(String name， long date)</td> 
   <td style="width:323px;">设定指定日期类型标头的值</td> 
  </tr> 
  <tr> 
   <td style="width:313px;">void setHeader(String name, String value)</td> 
   <td style="width:323px;">设置指定字符串类型标头的值</td> 
  </tr> 
  <tr> 
   <td style="width:313px;">void setIntHeader(String name, int value)</td> 
   <td style="width:323px;">设置指定整数类型标头的值</td> 
  </tr> 
 </tbody> 
</table>

## session对象 ##

session 对象为会话对象，该对象封装了当前用户会话的有关信息。借助于 seesion 对象，可对各个客户端请求期间的会话进行跟踪。在实际应用中，通常用 session 对象储存用户在访问各个页面期间所产生的有关信息，并在页面之间进行分享。

session 对象是 javax.servlet.http.HttpSession 类的实例，具有 session 作用域。当一个用户首次访问服务器上的一个 JSP 页面时，JSP引擎就会产生一个 session 对象，同时为该对象分配一个 String 类型的ID号，并将该 ID 号发送到客户端，存放在用户的 Cookie 中。当该用户再次访问连接服务器的其他页面的时，或从服务器连接到其他服务器再返回该服务器时，JSP 引擎将继续使用此前创建的同一个 session 对象。待用户关闭浏览器（即终止与服务器端的会话）后，服务器端才将该用户的 session 对象销毁。

### session对象常用方法 ###

<table style="width:629px;"> 
 <thead> 
  <tr> 
   <th style="width:289px;">方法</th> 
   <th style="width:338px;">说明</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td style="width:289px;">String getId()</td> 
   <td style="width:338px;">获取 session 对象的ID号</td> 
  </tr> 
  <tr> 
   <td style="width:289px;">boolean isNew()</td> 
   <td style="width:338px;">判断是否为新的 session 对象。新的 session 对象是指该 session 对象已由服务器产生，但尚未客户端使用过</td> 
  </tr> 
  <tr> 
   <td style="width:289px;">void setMaxInactiveInterval(int interval)</td> 
   <td style="width:338px;">设置 session 对象的有效时间或生存时间（单位为秒），即会话期间客户端两次请求的最长时间间隔。超过此时间，session 对象将会失效。若为 0 或负值，则表示该 session 对象永远不会过期</td> 
  </tr> 
  <tr> 
   <td style="width:289px;">void getMaxInactiveInterval(int interval)</td> 
   <td style="width:338px;">获取 session 对象的有效时间或生存时间</td> 
  </tr> 
  <tr> 
   <td style="width:289px;">void setAttribute（String name, Object obj)</td> 
   <td style="width:338px;">在 session 中设置指定的属性及其值</td> 
  </tr> 
  <tr> 
   <td style="width:289px;">Object getAttribute(String name)</td> 
   <td style="width:338px;">获取指定的属性值。若不存在则，返回null</td> 
  </tr> 
  <tr> 
   <td style="width:289px;">Enumeration getAttributeNames()</td> 
   <td style="width:338px;">获取 session 中所有属性名的枚举</td> 
  </tr> 
  <tr> 
   <td style="width:289px;">void removeAttribute(String name)</td> 
   <td style="width:338px;">删除 session 中指定的属性</td> 
  </tr> 
  <tr> 
   <td style="width:289px;">void invalidate()</td> 
   <td style="width:338px;">注销当前的 session 对象，并删除其中的所有属性</td> 
  </tr> 
  <tr> 
   <td style="width:289px;">long getCreationTime()</td> 
   <td style="width:338px;">获取 session 对象的创建时间，单位为毫秒，由 1970年1月1日零时算起。</td> 
  </tr> 
  <tr> 
   <td style="width:289px;">long getLastAccessedTime()</td> 
   <td style="width:338px;">返回当前会话中客户端最后一次发出请求的时间，单位为毫秒，由 1970年1月1日零时算起。</td> 
  </tr> 
 </tbody> 
</table>

## application对象 ##

application 对象为应用对象，负责提供 Web 应用程序在服务器运行期间的某些全局性信息。与 session 对象不同，application对象针对 Web 应用程序的所用用户，并由所有用户所共享（seesion 对象只针对各个不同的用户，是由各个用户所独享的）。

application 对象是 javax.servlet.ServletContext 类的实例（其实是包装了 Servlet 的 ServletContext 类的对象），具有 application 作用域。当 Web 服务器启动一个 Web 应用程序时，就产生了一个 application 对象。当关闭 Web 服务器或停止 Web 应用程序时，该 application 对象才会被销毁。各个 Web 应用程序的 application 对象是不相同的。

### application对象常用方法 ###

<table style="width:672px;"> 
 <thead> 
  <tr> 
   <th style="width:292px;">方法</th> 
   <th style="width:375px;">说明</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td style="width:292px;">void setAttribute(String name, Object obj)</td> 
   <td style="width:375px;">设置指定的属性及其其值</td> 
  </tr> 
  <tr> 
   <td style="width:292px;">Object getAttribute（String name)</td> 
   <td style="width:375px;">获取指定的属性值</td> 
  </tr> 
  <tr> 
   <td style="width:292px;">Enumeration getAttributeNames()</td> 
   <td style="width:375px;">获取所有的属性名的枚举</td> 
  </tr> 
  <tr> 
   <td style="width:292px;">void removeAttribute(String name)</td> 
   <td style="width:375px;">删除指定的属性</td> 
  </tr> 
  <tr> 
   <td style="width:292px;">Object getInitParameter(String name)</td> 
   <td style="width:375px;">获取指定的属性的初始值。若该属性不在，则返回null</td> 
  </tr> 
  <tr> 
   <td style="width:292px;">String getServerInfo()</td> 
   <td style="width:375px;">获取JSP引擎的名称及版本号</td> 
  </tr> 
  <tr> 
   <td style="width:292px;">int getMajorVersion()</td> 
   <td style="width:375px;">获取服务器支持的Servlet API的主要版本号</td> 
  </tr> 
  <tr> 
   <td style="width:292px;">int getMinorVersion()</td> 
   <td style="width:375px;">获取服务器支持的Servlet API的次要版本号</td> 
  </tr> 
  <tr> 
   <td style="width:292px;">String getRealPath(String path)</td> 
   <td style="width:375px;">获取指定虚拟路径的真实路径（绝对路径）</td> 
  </tr> 
  <tr> 
   <td style="width:292px;">ServletContext getContext(String uripath)</td> 
   <td style="width:375px;">获取指定 web application 的application 对象</td> 
  </tr> 
  <tr> 
   <td style="width:292px;">String getMimeType(String file)</td> 
   <td style="width:375px;">获取指定文件的 MIME 类型</td> 
  </tr> 
  <tr> 
   <td style="width:292px;">URL getResourse(String path)</td> 
   <td style="width:375px;">获取指定资源（文件或目录）的URL对象</td> 
  </tr> 
  <tr> 
   <td style="width:292px;">InputStream getResourseAsStream(String path)</td> 
   <td style="width:375px;">获取指定资源的输入流</td> 
  </tr> 
  <tr> 
   <td style="width:292px;">RequestDispather getRequestDispatcher(String uripath)</td> 
   <td style="width:375px;">获取指定资源的RequestDispatcher对象</td> 
  </tr> 
  <tr> 
   <td style="width:292px;">Servlet getServlet(String name)</td> 
   <td style="width:375px;">获取指定名称的Servlet</td> 
  </tr> 
  <tr> 
   <td style="width:292px;">Enumeration getServlets()</td> 
   <td style="width:375px;">获取所有Servlet的枚举</td> 
  </tr> 
  <tr> 
   <td style="width:292px;">Enumeration getServletNames()</td> 
   <td style="width:375px;">获取所有Servlet名称的枚举</td> 
  </tr> 
  <tr> 
   <td style="width:292px;">void log(String msg)</td> 
   <td style="width:375px;">将指定的信息写入log文件中</td> 
  </tr> 
  <tr> 
   <td style="width:292px;">void log(String name, Throwable throwable)</td> 
   <td style="width:375px;">将stack trace（栈轨迹）及所产生的Throwable异常写入日志文件</td> 
  </tr> 
  <tr> 
   <td style="width:292px;">void log(Exception exception, String msg)</td> 
   <td style="width:375px;">将指定异常的stack trace及错误信息写入日志</td> 
  </tr> 
 </tbody> 
</table>

## exception对象 ##

exception 对象为异常对象，其中封装了从某个 JSP 页面中所抛出的异常信息，常用于处理 JSP 页面在执行时发生的错误或异常。

exception 对象是 javax.lang.Throwable 类的实例，具有 page 作用域。当一个 JSP 页面在运行过程中出现异常时，就会产生一个 exception 对象。不过，如果一个页面要使用exception对象，就必须将页面 page 指令的 isErroePage 属性设置为true，否则无法进行编译。通常，可使用 page 指令指定某一页面为专门的错误处理页面，从而将有关页面的异常或错误都集中到该页面中进行处理。

### exception对象常用方法 ###

<table style="width:590px;"> 
 <thead> 
  <tr> 
   <th style="width:248px;">方法</th> 
   <th style="width:338px;">说明</th> 
  </tr> 
  <tr> 
   <td style="width:248px;">String getMessage()</td> 
   <td style="width:338px;">获取异常的描述信息（字符串）</td> 
  </tr> 
  <tr> 
   <td style="width:248px;">String getLocalizedMessage()</td> 
   <td style="width:338px;">获取本地化语言的异常描述信息（字符串）</td> 
  </tr> 
  <tr> 
   <td style="width:248px;">String toString()</td> 
   <td style="width:338px;">获取关于异常的简短描述信息（字符串）</td> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td style="width:248px;">void printStackTrace(PrintWriter s)</td> 
   <td style="width:338px;">输出异常的栈轨迹</td> 
  </tr> 
  <tr> 
   <td style="width:248px;">Throwable FillInStackTrace()</td> 
   <td style="width:338px;">重写异常的栈轨迹</td> 
  </tr> 
 </tbody> 
</table>

## page对象 ##

page 对象为页面对象，是页面实例的引用，代表 JSP 页面本身，即 JSP 页面被转译后的 Servlet.。

page 对象是 java.lang.Object 类的实例，具有page作用域。从本质上看，page 对象是一个包含当前 Servelt 接口引用的变量，相当于 this 变量的一个别名。通过 page 对象，可以调用 Servlet 类所定义的方法。

### page对象常用方法 ###

<table style="width:593px;"> 
 <thead> 
  <tr> 
   <th style="width:190px;">方法</th> 
   <th style="width:401px;">说明</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td style="width:190px;">class getClass()</td> 
   <td style="width:401px;">获取当前对象的类</td> 
  </tr> 
  <tr> 
   <td style="width:190px;">int hashCode()</td> 
   <td style="width:401px;">获取当前对象的哈希代码</td> 
  </tr> 
  <tr> 
   <td style="width:190px;">boolean equals(Object obj)</td> 
   <td style="width:401px;">判断当前对象是否与指定对象相等</td> 
  </tr> 
  <tr> 
   <td style="width:190px;">void copy(Object obj)</td> 
   <td style="width:401px;">把当前对象复制到指定的对象中</td> 
  </tr> 
  <tr> 
   <td style="width:190px;">Object clone()</td> 
   <td style="width:401px;">克隆当前对象</td> 
  </tr> 
  <tr> 
   <td style="width:190px;">String toString()</td> 
   <td style="width:401px;">获取当前对象的一个字符串</td> 
  </tr> 
  <tr> 
   <td style="width:190px;">void notify()</td> 
   <td style="width:401px;">唤醒一个等待的线程</td> 
  </tr> 
  <tr> 
   <td style="width:190px;">void notifyAll()</td> 
   <td style="width:401px;">唤醒所有等待的线程</td> 
  </tr> 
  <tr> 
   <td style="width:190px;">void wait(int timeout)</td> 
   <td style="width:401px;">使一个线程处于等待状态，直到指定的超时时间结束或被唤醒</td> 
  </tr> 
  <tr> 
   <td style="width:190px;">void wait()</td> 
   <td style="width:401px;">使一个线程处于等待状态，直到被唤醒</td> 
  </tr> 
 </tbody> 
</table>

## config对象 ##

config 对象为配置对象，主要用于获取 Servlet 或者 JSp 引擎的初始化参数。

config 对象是 javax.servlet.ServletConfig 类的实例，具有 page 作用域。config 对象包含了初始化参数以及一些实用方法，可为实用 web.xml 问价的服务器程序与 JSP 页面在其环境中设置初始化参数。

### config对象常用方法 ###

<table style="width:500px;"> 
 <thead> 
  <tr> 
   <th>方法</th> 
   <th>说明</th> 
  </tr> 
  <tr> 
   <td>String getInitParameter(String name)</td> 
   <td>获取指定Servlet初始化参数的值</td> 
  </tr> 
  <tr> 
   <td>Enumeration getInitParameterNames()</td> 
   <td>获取所有Servlet初始化参数的枚举</td> 
  </tr> 
  <tr> 
   <td>String getServletName()</td> 
   <td>获取Servlet的名称</td> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>ServeltContext getServeltContext()</td> 
   <td>获取Servlet上下文（ServletContext)</td> 
  </tr> 
 </tbody> 
</table>

## pageContext对象 ##

pageContext 对象为页面上下文对象，主要用于访问页面的有关信息。其实，pageContext 对象是整个 JSP 页面的代表，相当于页面中的所有功能的集大成者，可实现对页面内所有对象的访问。

pageContext 对象是 javax.servlet.jsp.PageContext 类的实例，具有 page 作用域，其创建与初始化均有容器完成。PageContext 类定义了一些范围常量，包括 PAGE——SCOPE，REQUEST\_SCOPE，SESSION\_SCOPE 与 APPLICATION\_SCOPE，分别表示 page 范围，request 范围，seesion 范围 与 application 范围。

在 pageContext 对象中，包含了传递给 JSP 页面的指令信息，存储了 request 对象与 response 对象的引用。此外，out对象，session 对象， application 对象与 config 对象也可以从 pageContext 对象中导出。

### pageContext对象常用方法 ###

<table style="width:619px;"> 
 <thead> 
  <tr> 
   <th style="width:360px;">方法</th> 
   <th style="width:257px;">说明</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td style="width:360px;">Exception getException()</td> 
   <td style="width:257px;">获取当前页的exception对象</td> 
  </tr> 
  <tr> 
   <td style="width:360px;">JspWriter getOut()</td> 
   <td style="width:257px;">获取当前页的out对象</td> 
  </tr> 
  <tr> 
   <td style="width:360px;">Object getPage()</td> 
   <td style="width:257px;">获取当前页的page对象</td> 
  </tr> 
  <tr> 
   <td style="width:360px;">ServletRequest getRequest()</td> 
   <td style="width:257px;">获取当前页的request对象</td> 
  </tr> 
  <tr> 
   <td style="width:360px;">ServletResponse getResponse()</td> 
   <td style="width:257px;">获取当前页的response对象</td> 
  </tr> 
  <tr> 
   <td style="width:360px;">ServletConfig getServletConfg()</td> 
   <td style="width:257px;">获取当前页的config对象</td> 
  </tr> 
  <tr> 
   <td style="width:360px;">ServletContext getServletContext()</td> 
   <td style="width:257px;">获取当前页的application对象</td> 
  </tr> 
  <tr> 
   <td style="width:360px;">HttpSession getSession()</td> 
   <td style="width:257px;">获取当前页的session对象</td> 
  </tr> 
  <tr> 
   <td style="width:360px;">void setAttribute(String name, Object obj)</td> 
   <td style="width:257px;">设置指定的属性及其值</td> 
  </tr> 
  <tr> 
   <td style="width:360px;">void setAttribute(String name, Object obj， int scope)</td> 
   <td style="width:257px;">在指定范围设置指定的属性及其值</td> 
  </tr> 
  <tr> 
   <td style="width:360px;">public Object getAttribute(String name)</td> 
   <td style="width:257px;">获取指定的属性的值，若无，返回null</td> 
  </tr> 
  <tr> 
   <td style="width:360px;">Object findAttribute(String name)</td> 
   <td style="width:257px;">按顺序在 page，request，session，application范围内找并返回指定的属性值</td> 
  </tr> 
  <tr> 
   <td style="width:360px;">void removeAttribute(String name)</td> 
   <td style="width:257px;">z在所有范围内删除指定的属性</td> 
  </tr> 
  <tr> 
   <td style="width:360px;">void removeAttribute(Strinf name, int scope)</td> 
   <td style="width:257px;">在指定范围内删除指定的属性</td> 
  </tr> 
  <tr> 
   <td style="width:360px;">int getAttributeScope(String name)</td> 
   <td style="width:257px;">获取指定属性的作用范围</td> 
  </tr> 
  <tr> 
   <td style="width:360px;">Enumeration getAattributeNamesInScope(int scope)</td> 
   <td style="width:257px;">获取指定范围内的属性名枚举</td> 
  </tr> 
  <tr> 
   <td style="width:360px;">void release()</td> 
   <td style="width:257px;">释放pageContext对象所占用的资源</td> 
  </tr> 
  <tr> 
   <td style="width:360px;">void forward(String relativeUrlPath)</td> 
   <td style="width:257px;">将页面重定向到指定的地址</td> 
  </tr> 
  <tr> 
   <td style="width:360px;">void include(String relativeUrlPath)</td> 
   <td style="width:257px;">在当前位置包含指定的文件</td> 
  </tr> 
 </tbody> 
</table>

## JSP内置对象的作用域 ##

前面我们提到的具有page 作用域，具有 request 作用域等 ，其实是指JSP内置对象的作用域，

作用域是指对象的范围，JSP 的内置对象的作用一共有 4 个，分别是：

> page、request、session、application

page 作⽤域：对应的内置对象是 pageContext、config、exception、page、response、out。

request 作⽤域：对应的内置对象是 request。

session 作⽤域：对应的内置对象是 session。

application 作⽤域：对应的内置对象是 application。

### 作用域的范围大小 ###

page < request < session < application

![7d70431bb8ed4a89b06899fbd8bc7226.png][]

page 只在当前页面有效。