- JSP 九大内置对象简介
- application 对象
- 1 让多个 JSPServlet 共享数据
- 2 获取 Web 应用配置参数
- config 对象
- exception 对象
- out 对象
- pageContext 对象
- request 对象
- 1 获取请求参数
- 2 操作 request 范围的属性
- 3 执行 forward 或 include
- response 对象
- 1 response 响应生成非字符响应
- 2 重定向
- 3 增加 Cookie
- session 对象
- JSP 中的四大域对象
1. JSP 九大内置对象简介
JSP 脚本中包含 9 个内置对象,这 9 个内置对象都是 Servlet API 接口的实例,只是 JSP 规范对它们进行了默认的初始化(由 JSP 页面对应的 Servlet 的 _jspService() 方法来创建这些实例),即它们已经是对象了,可以直接使用。
9 个内置对象依次如下:
-
- application
- javax.servlet.ServletContext 的实例,该实例代表 JSP 所属的 Web 应用本身,可用于 JSP 页面或者在 Servlet 之间交换信息。常用方法有 getAttribute(String attName)、setAttribute(String attName, String attValue) 和 getInitParameter(String paramName) 等。
-
- config
- javax.servlet.ServletConfig 的实例,该实例代表该 JSP 配置信息。常用方法有 getInitParameter(String paramName) 和 getInitParameters() 等方法。事实上,JSP 页面通常无须配置,也就不存在配置信息,因此,该对象更多地在 Servlet 中有效。
-
- exception
- java.lang.Throwable 的实例,该实例代表其他页面中的导演和错误。只有当页面中错误处理页面,即编译指令 page 的isErrorPage 属性为 true 时,该对象才可以使用。常用的方法有 getMessage() 和 printStackTrace() 等。
-
- out
- javax.servlet.jsp.JspWriter 的实例,该实例代表 JSP 页面的输出流,用于输出内容形成 HTML 页面。
-
- page
- 代表该页面本身,通常没什么太大用处。也就是 Servlet 中的 this,其类型就是生成的 Servlet 类,能用 page 的地方就能用 this。
-
- pageContext
- javax.servlet.jsp.PageContext 的实例,该对象代表该 JSP 页面的上下文,使用该对象可以访问页面中的共享数据。常用的方法有 getServletContext() 和 getServletConfig() 等。
-
- request
- javax.servlet.http.HttpServletRequest 的实例,该对象封装了一次请求,客户端的请求参数都被封装在该对象里。这是一个常用对象,获取客户端请求必须使用该对象。常用的方法有 getParameter(String paramName)、 getParameterValues(String paramName)、 setAttribute(String attrName, Object attrValue)、 getAttribute(String attrName) 和 setCharacterEncoding(String env) 等。
-
- response
- javax.servlet.http.HttpServletResponse 的实例,代表服务器对客户端的响应。通常很少使用该对象直接响应,而是使用 out 对象,除非需要生成非字符响应,response 对象常用于重定向。常用的方法有 getOutputStream()、 sendRedirect(java.lang.String location) 等。
-
- session
- javax.servlet.http.HttpSession 的实例,该对象代表一次会话。当客户端浏览器与站点建立连接时,会话开始;当客户端关闭浏览器时,会话结束。常用的方法有 getAttribute(String attrName)、 setAttribute(String attrName, Object attrValue) 等。
打开 Tomcat\work\cataline\localhost\…\jsp,其中几乎所有的 JSP 页面编译后 Servlet 类都有如下所示结构:
public final class index_jsp extends org.apache.jasper.runtime.HttpJspBase
implements org.apache.jasper.runtime.JspSourceDependent {
public void _jspService(final javax.servlet.http.HttpServletRequest request, final javax.servlet.http.HttpServletResponse response)
throws java.io.IOException, javax.servlet.ServletException {
final javax.servlet.jsp.PageContext pageContext;
final javax.servlet.ServletContext application;
final javax.servlet.ServletConfig config;
javax.servlet.jsp.JspWriter out = null;
final java.lang.Object page = this;
javax.servlet.jsp.JspWriter _jspx_out = null;
javax.servlet.jsp.PageContext _jspx_page_context = null;
try {
response.setContentType("text/html");
pageContext = _jspxFactory.getPageContext(this, request, response,
null, false, 8192, true);
_jspx_page_context = pageContext;
application = pageContext.getServletContext();
config = pageContext.getServletConfig();
out = pageContext.getOut();
_jspx_out = out;
// ...
}
}
}
说明:
- 通过上面的代码可以发现 JSP 内置对象的实质:它们要么是 _jspService() 方法的形参,要么是 _jspService() 方法的局部变量,所以我们直接在 JSP 脚本(脚本对应于 Servlet 的 _jspService() 方法部分)中调用这些对象,无须创建它们。
- 上面的代码中并没有 exception 内置对象,只有当页面的 page 指令的 isErrorPage 属性为 true 时,才可使用 exception 对象,也就是说:只有异常处事页面对应的 Servlet 时才会初始化 exception 对象。
注意:
由于 JSP 内置对象都是在 _jspService() 方法中完成初始化的,因此在 JSP 脚本、JSP 输出表达式中使用这些内置对象,不能在 JSP 声明中使用它们,否则,系统将提示找不到这些变量。
2. application 对象
application 对象代表 Web 应用本身,因此使用 application 来操作 Web 应用相关数据。application 对象通常有如下两个作用:
- 在整个 Web 应用的多个 JSP、Servlet 之间共享数据。
- 访问 Web 应用的配置参数
2.1 让多个 JSP、Servlet 共享数据
application 通过 setAttribute(String attrName, Object value) 方法将一个值设置成 application 的 attrName 属性,该属性的值对整个 Web 应用有效,因此该 Web 应用的每个 JSP 页面或 Servlet 都可以访问该属性,访问该属性的方法为 getAttribute(String attrName)。
在 JSP 中可直接通过 application 内置对象在 JSP 脚本或者表达式中进行赋值和取值:
<%
application.setAttribute("name", "JSP")
%>
<%=application.getAttribute("name")%>
在 Servlet 中,必须先获取 ServletContext 对象,才能进行赋值和取值:
ServletContext sc = getServletContext();
// ServletContext sc = getServletConfig().getServletContext();
sc.setAttribute("name", "Servlet");
sc.getAttribute("name");
建议:
虽然使用 application(即 ServletContext 实例)可以方便多个 JSP、Servlet 共享数据,但不要仅为了 JSP、Servlet 共享数据就将数据放入 application 中。由于 application 代表整个 Web 应用,所以通常只应该把 Web 应用的状态数据放入 application 里。
2.2 获取 Web 应用配置参数
因为 application 对象代表 Web 应用本身,所以可用于获取 Web 应用的初始化配置参数。
在 JSP 页面中的访问方式如下:
<%
String name = application.getInitParameter("name");
%>
在 web.xml 文件的根元素(web-app)下配置 Web 应用的初始化参数:
<web-app ...>
......
<context-param>
<param-name>name</param-name>
<param-value>web</param-value>
</context-param>
</web-app>
3. config 对象
config 对象代表当前 JSP 配置信息,但 JSP 页面通常无须配置,也就不存在配置信息。此对象在 JSP 页面中比较少用,此处简单作说明,但在 Servlet 中则用处相对较大,详见 Servlet。
在 JSP 获取配置参数:
<%=config.getServletName()%>
<%=config.getInitParameter("name")%>
在 web.xml 中为 JSP 配置初始化参数:
<servlet>
<servlet-name>config</servlet-name>
<jsp-file>/config.jsp</jsp-file>
<init-param>
<param-name>name</param-name>
<param-value>jsp config</param-value>
</init-param>
</servlet>
注意:
由于对 JSP 进行了如上配置(相当于将 JSP 作为 Servlet 进行配置),所以,此 JSP 页面存在两种访问方式:
- 正常的 JSP 访问方式:http://localhost:8080/WebProject/config.jsp
- Servlet 的访问方式:http://localhost:8080/WebProject/config
不过要想在 JSP 页面中通过 config 内置对象获取在 web.xml 中配置的初始化参数,必须使用第二种方式。
4. exception 对象
exception 对象是 Throwable 的实例,代表 JSP 脚本中产生的错误和异常,是 JSP 页面异常机制的一部分。
在 JSP 脚本中无须处理异常,即使该异常是 checked 异常。事实上,JSP 脚本包含的所有可能出现的异常都可交给错误处理页面处理。
打开普通的 JSP 页面生成的 Servlet 类如下:
public void _jspService(final javax.servlet.http.HttpServletRequest request, final javax.servlet.http.HttpServletResponse response)
throws java.io.IOException, javax.servlet.ServletException {
// 内置对象定义,init(),destory()...
try {
// 内置对象初始化,所有 JSP 脚本、静态 HTML 部分都会转换成此部分代码
} catch (java.lang.Throwable t) { // 异常处理
if (!(t instanceof javax.servlet.jsp.SkipPageException)) {
out = _jspx_out;
if (out != null && out.getBufferSize() != 0)
try {
if (response.isCommitted()) {
out.flush();
} else {
out.clearBuffer();
}
} catch (java.io.IOException e) {}
if (_jspx_page_context != null) _jspx_page_context.handlePageException(t);
else throw new ServletException(t);
}
} finally { // 释放资源
_jspxFactory.releasePageContext(_jspx_page_context);
}
}
说明:
- 从上面的代码可以看出,JSP脚本和静态 HTML 部分都将转换成 _jspService() 方法中的执行性代码,且已经处于 try-catch 块中,一旦捕获到 JSP 脚本异常,并且 _jsp_page_context 不为 null,就会以由该对象来处理异常。
- _jsp_page_context 对异常的处理:如果该页面的 page 指令指定了 errorPage,则将请求 forward 到 errorPage 属性指定的页面,否则使用系统页面来输出异常信息。
- 由于只有 JSP 脚本、表达式才会对应于 _jspService() 方法里的代码,所以,对于 JSP 声明部分的 checked 异常仍需要用户手动处理。
在 JSP 的异常处理机制中,一个异常处理页面可以处理多个 JSP 页面脚本部分的异常,异常处理页面通过 page 指令的 errorPage 属性确定。在异常处理页面中,需要通过 page 指令中指定 isErrorPage 属性为 true,否则 JSP 的异常处理机制无法找到 errorPage 属性指定的异常处理页面,该页面中也无法访问 exception 内置对象。
在 JSP 的异常处理页面,可以使用如下方法获取异常信息:
异常类型:<%=exception.getClass()%>
异常信息:<%=exception.getMessage()%>
5. out 对象
out 对象代表一个页面输出流,通常用于在页面上输出变量值及常量。一般在使用输出表达式的地方,都可以使用 out 对象来达到同样的效果,<%=...%>
的本质就是 out.write(…)。建议使用输出表达式,更加简洁。
在 JSP 页面中使用 out 对象的语法如下:
<%
out.write("abc");
%>
6. pageContext 对象
这个对象代表页面上下文,该对象主要用于访问 JSP 之间的共享数据。使用 pageContext 对象可以访问 page、request、session 和 application 范围的变量。
pageContext 是 PageContext 实例,它提供了如下两个方法来访问 page、request、session 和 application 范围的变量:
- getAttribute(String name):取得 page 范围内的 name 属性
- getAttribute(String name, int scope):取得指定范围内的 name 属性,其中 scope 可以是如下 4 个常量值:
- PageContext.PAGE_SCOPE(1):对应于 page 范围
- PageContext.REQUEST_SCOPE(2):对应于 request 范围
- PageContext.SESSION_SCOPE(3):对应于 session 范围
- PageContext.APPLICATION_SCOPE(4):对应于 application 范围
与 getAttribute() 方法相对应,PageContext 也提供了 2 个对应的 setAttribute() 方法,用于将指定变量的值存入指定的范围内:
- setAttribute(String name, Object value)
- setAttribute(String name, Object value, int scope)
在 JSP 页面中使用 pageContext 对象进行相关范围内的赋值与取值语法:
<%
pageContext.setAttribute("username", "administrator", PageContext.SESSION_SCOPE);
pageContext.getAttribute("username", PageContext.SESSION_SCOPE);
%>
pageContext 还可获取其他内置对象,方法如下:
- ServletRequest getRequest()
- ServletResponse getResponse()
- ServletConfig getServletConfig()
- ServeltContext getServeltContext()
- HttpSession getSession()
因此一旦在 JSP、Servlet 编程中获取了 pageContext 对象,就可以通过它获取其他内置对象。
7. request 对象
每个 request 对象封装着一次用户请求,并且所有的请求参数都被封装在 request 对象中。该对象通常有如下几个作用:
- 获取请求参数
- 用于操作 request 范围的属性
- 执行 forward 或 include
7.1 获取请求参数
request 是 HttpServletRequest 接口的实例,它提供了如下几个方法来获取请求参数:
- String getParameter(String paramName):获取 paramName 请求参数的值
- Map getParameterMap():获取所有请求参数名和参数值所组成的 Map 对象
- Enumeration getParameterNames():获取所有请求参数所组成的 Enumeration 对象
- String[] getParameterValues(String name):paramName 请求参数的值,当该请求参数有多个值时,该 方法返回多个值所组成的数组。
HttpServletRequest 提供了如下方法来访问请求头:
- String getHeader(String name):获取指定请求头的值
- Enumeration getHeaderNames():获取所有请求头的名称
- Enumeration getHeaders(String name):获取指定请求头的多个值
- int getIntHeader(String name):获取指定请求头的值,并将该值转为整数值
7.2 操作 request 范围的属性
HttpServletRequest包含如下两个方法,用于设置和获取 request 范围的属性:
- setAttribute(String attName, Object attValue):将 attValue 设置成 request 范围的属性
- Object getAttribute(String attName):获取 request 范围的属性
7.3 执行 forward 或 include
除了 JSP 提供的 forward 和 include 动作指令,request 也可以执行 forward 和 include。
HttpServletRequest 类提供了一个 getRequestDispatcher(String path) 方法,其中 path 就是希望 forward 或者 include 的目标路径,该方法返回 RequestDispatcher,该对象提供了如下两个方法:
- forward(ServletRequest request, ServletResponse response):执行 forward
- include(ServeltRequest request, ServletResponse response):执行 include
8. response 对象
response 对象代表服务器对客户端的响应。通常情况下,在 JSP 页面中直接使用 out 对象来输出响应信息即可,但 out 是 Writer 的子类,是一个字符输出流,对于非字符内容,就必须使用 response 作为输出响应。除此之外,还可以使用 response 来重定向请求以及用于向客户端增加 Cookie。
8.1 response 响应生成非字符响应
response 是 HttpServletResponse 接口的实例,该接口提供了一个 getOutputStream() 方法,该方法返回响应的输出字节流。
8.2 重定向
HttpServletResponse 提供了一个 sendRedirect(String path) 方法,该方法用于重定向到 path 资源,即重新向 path 资源发送请求。
8.3 增加 Cookie
Cookie 通常用于网站记录客户的某些信息,存放客户端机器上,直到超出 Cookie 的生命期限。客户端浏览器完全可以禁用 Cookie,所以使用 Cookie 必须客户端浏览器支持才行。
response 对象提供如下方法增加 Cookie:
- void addCookie(Cookie cookie)
9. session 对象
session 对象代表一次用户会话。一次用户会话是从客户端浏览器连接服务器开始,到客户端浏览器与服务器断开为止。session 范围内的属性可以在多个页面的跳转之间共享,一旦关闭浏览器,即 session 结束,session 范围内的属性将全部丢失。
session 对象是 HttpSession 的实例,HttpSession 有如下两个常用的方法:
- setAttribute(String attName, Object attValue):设置 session 范围内 attName 属性的值为 attValue
- getAttribute(String attName):返回 session 范围内 attName 属性的值
10. JSP 中的四大域对象
在 JSP 九大内置类中存在四大域对象,分别是:
- page 域:pageContext 对象
- request 域:request 对象
- session 域:session 对象
- application 域:application 对象
域对象主要是用于 JSP 和 Servlet 的数据共享。