JSP中的九大内置对象
JSP隐含对象（又称内置对象），是指可以不加声明和创建就可以在JSP页面脚本（Java程序片和Java表达式）中使用的成员变量。
在JSP中一共预先定义了九个隐含对象，分别为request, response, pageContext, session, application, out, config, page和exception。
JSP隐含对象的类型如下表所示：
| 隐含对象 | 类型 | 作用域 |
|---|---|---|
| request | javax.servlet.http.HttpServletRequest | request |
| response | javax.servlet.http.HttpServletResponse | page |
| pageContext | javax.servlet.jsp.PageContext | page |
| session | javax.servlet.http.HttpSession | session |
| application | javax.servlet.ServletContext | application |
| out | javax.servlet.jsp.JspWriter | page |
| config | javax.servlet.ServletConfig | page |
| page | java.lang.Object | page |
| exception | java.lang.Throwable | page |
request
request对象代表的是javax.servlet.http.HttpServletRequest类的对象，它封装了由客户端生成的HTTP请求的所有细节，主要包括HTTP头信息、系统信息、请求方式和请求参数等。通过request对象提供的相应方法可以处理客户端浏览器提交的HTTP请求中的各项参数。
request获取客户端信息的常用方法如下表所示：
| 方法 | 功能 |
|---|---|
| getHeader(String name) | 获得HTTP协议定义的文件头信息 |
| getHeaders(String name) | 返回指定名字的request Header的所有值，其结果是一个枚举型的实例 |
| getHeadersNames() | 返回所有request Header的名字，其结果是一个枚举型的实例 |
| getMethod() | 获得客户端向服务器端传送数据的方法，如get、post、header、trace等 |
| getProtocol() | 获得客户端向服务器端传送数据所依据的协议名称 |
| getRequestURI() | 获得发出请求字符串的客户端地址，不包括请求的参数 |
| getRequestURL() | 获得发出请求字符串的客户端地址 |
| getRealPath() | 返回当前请求文件的绝对路径 |
| getRemoteAddr() | 获取客户端的IP地址 |
| getRemoteHost() | 获取客户端的主机名 |
| getServerName() | 获取服务器的名字 |
| getServerPath() | 获取客户端所请求的脚本文件的文件路径 |
| getServerPort() | 获取服务器的端口号 |
| getParameter() | 获取客户端通过表单提交过来的参数值 |
| getScheme() | 获取请求使用的模式（协议）名字 |
例：
request.jsp
<%@ page contentType="text/html;charset=UTF-8" %>
<html>
<head><title> request内置对象的实例 </title></head>
<body>
<form aciton="request.jsp">
Get request results:
<input type="text" name="myname">
<input type="submit" name="get value">
</form>
获取客户提交信息的方式:<%=request.getMethod()%> <br>
获取请求信息中的协议名名字和版本号:<%=request.getProtocol()%> <br>
获取发出请求字符串的客户端地址:<%=request.getRequestURI()%> <br>
获取发出请求字符串的客户端地址:<%=request.getRequestURL()%> <br>
获取提交请求的客户端的IP地址:<%=request.getRemoteAddr()%> <br>
获取服务器的端口号:<%=request.getServerPort()%> <br>
获取接受请求的服务器名称:<%=request.getServerName()%> <br>
获取客户端所请求的脚本文件的文件路径:<%=request.getServletPath()%> <br>
获取Http协议定义的文件头信息Host的值:<%=request.getHeader("host")%> <br>
获取Http协议定义的文件头信息User-Agent的值:<%=request.getHeader("user-agent")%> <br>
获取Http协议定义的文件头信息accept-language的值:<%=request.getHeader("accept-language")%> <br>
获取请求文件的绝对路径:<%=request.getRealPath("request.jsp")%> <br>
获取客户端通过表单提交过来的参数值:<%=request.getParameter("myname")%> <br>
获取客户端的主机名:<%=request.getRemoteHost()%> <br>
获取请求中使用的模式（协议）名字:<%=request.getScheme()%> <br>
</body>
</html>- 1
- 2
- 3
- 4
- 5
- 6
- 7
- 8
- 9
- 10
- 11
- 12
- 13
- 14
- 15
- 16
- 17
- 18
- 19
- 20
- 21
- 22
- 23
- 24
- 25
- 26
运行结果：
获取客户提交信息的方式:GET
获取请求信息中的协议名名字和版本号:HTTP/1.1
获取发出请求字符串的客户端地址:/request.jsp
获取发出请求字符串的客户端地址:http://localhost:8080/request.jsp
获取提交请求的客户端的IP地址:127.0.0.1
获取服务器的端口号:8080
获取接受请求的服务器名称:localhost
获取客户端所请求的脚本文件的文件路径:/request.jsp
获取Http协议定义的文件头信息Host的值:localhost:8080
获取Http协议定义的文件头信息User-Agent的值:Mozilla/5.0 (Windows NT 6.1) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/50.0.2661.102 Safari/537.36
获取Http协议定义的文件头信息accept-language的值:zh-CN,zh;q=0.8,en;q=0.6
获取请求文件的绝对路径:D:\***\我的文档\Tomcat\apache-tomcat-8.0.35\webapps\ROOT\request.jsp
获取客户端通过表单提交过来的参数值:request
获取客户端的主机名:127.0.0.1
获取请求中使用的模式（协议）名字:http- 1
- 2
- 3
- 4
- 5
- 6
- 7
- 8
- 9
- 10
- 11
- 12
- 13
- 14
- 15
response
response对象用于响应客户请求，向客户端输出信息。它封装了JSP产生的响应，并发送到客户端以响应客户端的请求。
response对象提供了多个方法用来处理HTTP响应，比较常用的方法如下：
| 方法 | 功能 |
|---|---|
| setContentLength(int len) | 设置响应头的长度 |
| setContentType(String type) | 设置HTTP响应的contentType中的MIME类型 |
| getOutputStream() | 返回一个Servlet的输出流 |
| getWriter() | 返回一个PrintWriter对象 |
| getCharacterEncoding() | 获得此时响应所采用的字符编码类型 |
| sendRedirect(String location) | 将请求重新定位到一个不同的URL（页面）上 |
| setHeader(String headername, String value) | 使用指定的头名字以及相应的值来设置头信息 |
| addheader(String headername, String value) | 把指定的头名字以及相应值添加到头信息当中去 |
session
session在网络中被称为会话，它是javax.servlet.http.HttpSession.session类的对象。由于HTTP协议是一种无状态协议，也就是当一个客户端向服务器发出请求，服务器接收请求，并返回响应后，该连接就结束了，而服务器是不保存相关的信息。为了弥补这一缺点，HTTP协议提供了session。通过session可以在应用程序的Web页面间进行跳转时，保存用户的状态，使整个用户会话一直存在下去，直到关闭浏览器。
如果在一个会话中，客户端长时间不向服务器发出请求，session对象就会自动消失。这取决于服务器，Tomcat服务器默认为30分钟。
session对象的常用方法如下表所示：
| 方法 | 功能 |
|---|---|
| getId() | 返回唯一的标识，这些标识为每个session而产生 |
| getCreationTime() | 返回session被创建的时间，最小单位为千分之一秒 |
| getLastAccessedTime() | 返回客户端最后一次与会话相关联的请求时间 |
| getMaxInactiveInterval() | 以秒为单位返回会话内两个请求最大时间间隔 |
| setMaxInactiveInterval() | 以秒为单位设置session的有效时间 |
| getAttribute(String key) | 通过给定的关键字获取一个存储在session中相对应的信息 |
| setAttribute(String key, Object obj) | 提供一个关键词和一个对象值，然后存在session当中 |
| removeAttribute(String name) | 从session会话中移除指定的绑定对象 |
| invalidate() | 销毁session |
注意：session中保存和查找的信息不能是基本数据类型，如int、double等，而必须是java对象，如Integer、Double等。
具体例子可参考JSP中的四种范围属性。
application
application是javax.servlet.ServletContext类的对象。该对象用于保存所有应用程序中的公有数据。它在服务器启动时自动创建，在服务器停止时销毁。当application对象没有被销毁时，所有用户都可以共享该application对象。
application对象的常用方法如下表所示：
| 方法 | 功能 |
|---|---|
| getInitParameter(String name) | 返回已命名的应用程序初始化参数值 |
| getAttributeNames() | 返回所有已定义的应用程序初始化参数名的枚举 |
| getAttribute(String name) | 从application对象中获取指定对象名 |
| setAttribute(String name, Object obj) | 保存一个对象信息，并指定给一个名称 |
| removeAttribute(String name) | 从application对象中去掉指定名称的属性 |
| getServletInfo() | 返回JSP引擎的相关信息 |
| getRealPath(String path) | 返回虚拟路径的真实路径 |
| getContext(String URLPath) | 返回执行Web应用的application对象 |
| getMajorVersion() | 返回服务器所支持的Servlet API最大版本号 |
| getMinorVersion() | 返回服务器所支持的Servlet API最小版本号 |
| getMineType(String file) | 返回指定文件的MIME类型 |
| getResource(String path) | 返回指定资源的URL路径 |
| getResourceAsStream(String path) | 返回指定资源的输入流 |
| getRequestDispatcher(String URLPath) | 返回指定资源的RequestDispatcher对象 |
| getServlet(String name) | 返回指定名称的Servlet |
| getServlets() | 返回所有的Servlet，返回类型为枚举型 |
| getServletNames() | 返回所有的Servlet名称，返回类型为枚举型 |
| log(String msg) | 把指定信息写入到Servlet的日志文件中 |
| log(String msg, Throwable throwable) | 把栈轨迹以及给出的Throwable异常的说明信息写入Servlet的日志文件 |
具体例子可参考JSP中的四种范围属性。
out
out对象用于在Web浏览器内输出信息，并且管理应用服务器上的输出缓冲区。out对象可以输出各种数据类型的数据，在输出非字符串类型的数据时，会自动转换为字符串进行输出。
out对象的常用方法如下表所示：
| 方法 | 功能 |
|---|---|
| print() | 在页面中打印出字符串信息，不换行 |
| println() | 在页面中打印出字符串信息，并且换行 |
| clear() | 清除缓冲区中的内容 |
| clearBuffer() | 清除当前缓冲区中的内容 |
| flush() | 刷新流 |
| getBufferSize() | 获取缓冲区大小 |
| isAutoFlush() | 检测当前缓冲区已满时是自动清空还是抛出异常 |
| close() | 关闭输出流 |
config
config对象主要用于取得服务器的配置信息。当一个Servlet初始化时，容器把某些信息通过config对象传递给这个Servlet。
config对象的常用方法如下表所示：
| 方法 | 功能 |
|---|---|
| getServletContext() | 获取Servlet上下文 |
| getInitParameter(String name) | 返回初始化参数的值 |
| getInitParameterNames() | 返回包含了Servlet初始化所需要的所有参数，返回类型是枚举型 |
| getServletName() | 获取Servlet服务器名 |
page
page对象代表JSP本身，只有在JSP页面内才是合法的。page对象本质上是包含当前Servlet接口引用的变量，可以看作是this关键字的别名。
page对象的常用方法如下表所示：
| 方法 | 功能 |
|---|---|
| getClass() | 返回当前Object的类 |
| hashCode() | 返回此Object的哈希代码 |
| toString() | 把当前Object类转换成字符串 |
| equals(Object o) | 比较该对象和指定对象是否相等 |
| copy(Object o) | 把该对象复制到指定的对象当中去 |
| clone() | 对该对象进行克隆 |
exception
exception对象用来处理JSP文件执行时发生的所有错误和异常，只有在page指令中设置为isErrorPage属性值为true的页面中才可以被使用，在一般的JSP页面中使用该对象将无法编译JSP文件。
exception对象的常用方法如下表所示：
| 方法 | 功能 |
|---|---|
| getMessage() | 返回exception对象的异常信息字符串 |
| getLocalizedMessage() | 返回本地化的异常错误信息 |
| toString() | 返回关于异常错误的简单信息描述 |
| fillInStackTrace() | 重写异常错误的栈执行轨迹 |
pageContext
pageContext对象是一个比较特殊的对象。它相当于页面中所有其他对象功能的最大集成者，即使用它可以访问到本页面中所有其他对象，例如request、response以及application等。
pageContext对象常用方法如下表所示：
| 方法 | 功能 |
|---|---|
| getRequest() | 获取当前页面中的request对象 |
| getResponse() | 获取当前页面中的response对象 |
| getPage() | 获取当前页面中的page对象 |
| getSession() | 获取当前页面中的session对象 |
| getOut() | 获取当前页面中的out对象 |
| getException() | 获取当前页面中的exception对象 |
| getServletConfig() | 获取当前页面中的config对象 |
| getServletContext() | 获取当前页面中的application对象 |
| setAttribute(String name) | 给指定的属性名设置属性值 |
| getAttribute(String name) | 根据属性名找到相应的属性值 |
| setAttribute(String name, Object obj, int scope) | 在给定的范围内设置相应的属性值 |
| getAttribute(String name, int scope) | 在指定的范围内获取到相应的属性值 |
| findAttribute(String name) | 寻找一个属性并返回，如果没有找到则返回一个null |
| removeAttribute(String name) | 通过属性名删除掉某个属性 |
| removeAttribute(String name, int scope) | 在指定的某个范围内删除某个属性 |
| getAttributeScope(String scope) | 返回某属性的作用域 |
| getAttributeNamesInScope(int scope) | 返回指定范围内的所有属性名的枚举 |
| release() | 释放掉pageContext()所占的所有资源 |
| forward(String relativeURLpath) | 使用当前页面重导到另一个页面 |
| include(String relativeURLpath) | 使用当前位置包含的另一个页面 |
pageContext对象在实际JSP开发中一般很少使用，因为request和response等对象均为内置对象，如果通过pageContext来调用这些对象比较麻烦，都可以直接调用相关方法实现具体的功能。
