1 JSP内置对象综述
JSP内置对象是一类由容器创建,可直接使用的对象。这些内置对象可以直接在service方法中使用,这意味着我们可以在小脚本标签(<% %>)和表达式标签(<%= %>)直接使用内置对象。这是因为在service方法中可以执行嵌入在小脚本的代码,但我们不能使用这些变量嵌入到JSP的声明标签(<%= %>),主要是写在声明标签的代码是类等级的。
2 JSP内置变量
容器提供了全部的9个内置变量。让我们回忆一下_jspService()方法吧,它提供了两个参数:request和response(可以参考下面代码)
public void _jspService(HttpServletRequest request, HttpServletResponse response)
{
// Custom code
}
9个变量可以由request和response获得。由于这些变量可以直接使用,所以我们不需要通过导入包的方式来使用它们。
9个内置对象(implicit objects)如下:
request
response
session
out
application
config
page
pageContext
exception
注意:定义其他普通变量时就不能使用上面9个单词了。
2.1 JSP request
JSP request内置对象是由javax.serlet.http.HttpServletRequest
实现的一个实例。request也可以作为_jspService()方法的参数。
在小脚本中我们可以使用request变量,如同在servlet中通过调用service() doGet() doPost()方法来获得request头部信息(headers),request参数信息(parameters),内容类型(types)等等。
如:
<body>
<%
String param = request.getParameter("param");
request.setAttribute("attribute","value");
%>
<%= request.getContentType() %>
</body>
2.2 JSP response
JSP response内置对象是javax.servlet.http.HttpServletResponse
所实现的一个实例。它也同样可作为_jspService()方法的1个参数。
所有的方法都可以在HttpServletResponseAPI中找到,像建立response头部(response header),重定向request(redirect request),添加cookie(add Cookie),编码UPL(encode URL)等等功能都可以被使用。
如:
<body>
<%
response.encodeURL("http://www.google.com");
response.addCookie(new Cookie("key","val"));
%>
</body>
2.3 JSP session
JSP 内置对象是javax.servlet.http.HttpSession
所实现的一个实例。我们可以从request获取一个session对象,而不由容器直接提供这个变量给我们。
所有session的API 如存储,删除,恢复属性,失效会话(invalidate session) 可供使用。
如:
<body>
<%
session.setAttribute("attribute","value");
session.getAttribute("attribute");
session.removeAttribute("attribute");
%>
</body>
2.4 JSP out
JSP out内置对象是javax.sevlet.jsp.JspWriter
所实现的一个实例,它通常来实现在响应(response)的页面内容输出(output)的功能。在servlet中,我们可以通过获得PrintWriter对象来使用response对象,像response.getWriter();而不是在JSP中,out变量可以直接使用。
例:
<body>
<%
out.println("Hello World");
%>
<%=
request.getAttribute("attribute")
%>
</body>
所有表达式里的内容将作为out.println()
的一个参数来运行。所以上面代码中下半段将会翻译成out.println("request.getAttribute("attribute")")
2.5 JSP application
JSP application 内置内置对象是javax.servlet.ServletContext
所实现的一个实例,在jsp中它常用于获得内容(context)信息和属性(attributes)。
记住ServletContext是被应用于整个网页应用(web application)中。在servlets中,ServletContext对象可以被getServletContext()方法捕获但在jsp中可作为application对象直接使用。
所有ServletContext的API,如获得RequestDispatch对象(这可以向前请求另一个资源也可以囊括reponse),获得context参数等等都是可供使用的。
例:
<body>
<%
application.getInitParameter("init-param");
application.getRequestDispatcher("/path");
%>
</body>
2.6 JSP config
JSP config内置对象是javax.servlet.ServletConfig
实现的一个实例。
ServletConfig在每一个servlet或者jsp都可以使用。在servlets,ServletConfig对象可以被getServletConfig()方法捕获但是同样在jsp中可以直接使用。
关于ServletConfig的API,比如可以获得已经初始化的parameters。
例:
<body>
<%
config.getInitParameter("init-param");
config.getServletName();
%>
</body>
2.7 JSP page
JSP page对象是java.lang.Obeject
类的实例,也代表着当前JSP 的页面。它等同于java中的代表当前实例的“this”。
2.8 JSP pageContext
JSP pageContext内置对象是javax.servlet.jsp.PageContext
所实现的一个实例,它包含了其他8个内置对象的引用。
同数个方法一样,pageContext定义的域与4个对象(PAGE_SCOPE, REQUEST_SCOPE, SESSION_SCOPE,APPLICATION_SCOPE)的作用范围一样。
我们在可以在pageContext对象的帮助下,存储或删除四个作用域(scope)中的属性。
默认的作用范围是PAGE但setAttribute(),getAttribute和removeAttribute()方法重载了,在原来的基础上增加一个额外的参数(scope)。
例:
<body>
<%
pageContext.setAttribute("attribute", "value");
pageContext.setAttribute("attribute", "value",PageContext.REQUEST_SCOPE);
pageContext.getAttribute("attribute");
pageContext.getAttribute("attribute",PageContext.REQUEST_SCOPE);
pageContext.removeAttribute("attribute");
pageContext.removeAttribute("attribute",PageContext.REQUEST_SCOPE);
%>
</body>
2.9 JSP exception
JSP exception内置对象是java.lang.Throwable
类的实例,常用来显示JSP错误页面中的异常细节。
这个内置对象只有在错误页面和将会成为错误页面的jsp页面才能使用,同时我们必须要在页面中添加isErrorPage指令。
例如:
<body>
<%@page isErrorPage="true" %>
<%
exception.printStackTrace();
exception.getCause();
%>
</body>
3 JSP内置对象例子
我们创建一个implicitObjects.jsp文件来使用所有的内置变量。为了看到config和application对象怎么运行的,我们需要在web.xml中添加context参数和init参数。
- 在WEB-INF目录下创建一个web.xml。
<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns="http://java.sun.com/xml/ns/javaee"
xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_3_0.xsd" version="3.0">
<display-name>JSP Tutorial</display-name>
<context-param>
<param-name>MyContextParam</param-name>
<param-value>Context Parameters are applicable for whole application</param-value>
</context-param>
<servlet>
<description>Implicit Objects</description>
<servlet-name>ImplicitObjectsExample</servlet-name>
<jsp-file>/implicitObjects.jsp</jsp-file>
<init-param>
<description>config parameters</description>
<param-name>MyInitParam</param-name>
<param-value>Init Params are JSP specific</param-value>
</init-param>
</servlet>
<servlet-mapping>
<servlet-name>ImplicitObjectsExample</servlet-name>
<url-pattern>/implicitObjects.jsp</url-pattern>
</servlet-mapping>
</web-app>
如果我们要为JSP初始化参数,我们需要定义servlet标签,类似于配置Servlet,只是有一小点的变化。为了替代servlet类名,我们需要使用标签来定义jsp的路径,这个路径解析后是将会在mapping匹配到的url。
- 在WebContent目录下创建implicitObeject.jsp。
<html>
<head>
<title> Implicit Object Example </title>
</head>
<body>
<% response.getWriter().print("Writing Content using response object") ;%>
<br/>
Port Number (using request object) :: <%= request.getLocalPort() %>
<br/>
Session ID (using session object ) ::<%= session.getId() %>
<br/>
<% out.println("Message getting printed (using out object )") ; %>
<br/>
Init parameter (using application object) :: <%= application.getInitParameter("MyContextParam") %>
<br/>
Init parameter (using config object) :: <%= config.getInitParameter("MyInitParam") %>
<br/>
Class Name (using page object) :: <%= page.getClass() %>
<br/>
<%
pageContext.setAttribute("pageContextVariable", "Variable Value",PageContext.REQUEST_SCOPE);
%>
Attribute Value (using page context) :: <%= pageContext.getAttribute("pageContextVariable", PageContext.REQUEST_SCOPE)%>
<br/>
</body>
</html>
运行结果: