# JSP 指南 ## 简介 ### 什么是 Java Server Pages `JSP`全称`Java Server Pages`，是一种动态网页开发技术。 它使用 JSP 标签在 HTML 网页中插入 Java 代码。标签通常以`<%`开头以`%>`结束。 JSP 是一种 Java servlet，主要用于实现 Java web 应用程序的用户界面部分。网页开发者们通过结合 HTML 代码、XHTML 代码、XML 元素以及嵌入 JSP 操作和命令来编写 JSP。 JSP 通过网页表单获取用户输入数据、访问数据库及其他数据源，然后动态地创建网页。 JSP 标签有多种功能，比如访问数据库、记录用户选择信息、访问 JavaBeans 组件等，还可以在不同的网页中传递控制信息和共享信息。 ### 为什么使用 JSP JSP 也是一种 Servlet，因此 JSP 能够完成 Servlet 能完成的任何工作。 JSP 程序与 CGI 程序有着相似的功能，但和 CGI 程序相比，JSP 程序有如下优势： - 性能更加优越，因为 JSP 可以直接在 HTML 网页中动态嵌入元素而不需要单独引用 CGI 文件。 - 服务器调用的是已经编译好的 JSP 文件，而不像 CGI/Perl 那样必须先载入解释器和目标脚本。 - JSP 基于 Java Servlets API，因此，JSP 拥有各种强大的企业级 Java API，包括 JDBC，JNDI，EJB，JAXP 等等。 - JSP 页面可以与处理业务逻辑的 servlets 一起使用，这种模式被 Java servlet 模板引擎所支持。 最后，JSP 是 Java EE 不可或缺的一部分，是一个完整的企业级应用平台。这意味着 JSP 可以用最简单的方式来实现最复杂的应用。 ### JSP 的优势 以下列出了使用 JSP 带来的其他好处： - 与 ASP 相比：JSP 有两大优势。首先，动态部分用 Java 编写，而不是 VB 或其他 MS 专用语言，所以更加强大与易用。第二点就是 JSP 易于移植到非 MS 平台上。 - 与纯 Servlets 相比：JSP 可以很方便的编写或者修改 HTML 网页而不用去面对大量的 println 语句。 - 与 SSI 相比：SSI 无法使用表单数据、无法进行数据库链接。 - 与 JavaScript 相比：虽然 JavaScript 可以在客户端动态生成 HTML，但是很难与服务器交互，因此不能提供复杂的服务，比如访问数据库和图像处理等等。 - 与静态 HTML 相比：静态 HTML 不包含动态信息。 ## JSP 工作原理 **JSP 是一种 Servlet**，但工作方式和 Servlet 有所差别。 Servlet 是先将源代码编译为 class 文件后部署到服务器下的，**先编译后部署**。 Jsp 是先将源代码部署到服务器再编译，**先部署后编译**。 Jsp 会在客户端第一次请求 Jsp 文件时被编译为 HttpJspPage 类（Servlet 的一个子类）。该类会被服务器临时存放在服务器工作目录里。所以，第一次请求 Jsp 后，访问速度会变快就是这个道理。 ### JSP 工作流程 网络服务器需要一个 JSP 引擎，也就是一个容器来处理 JSP 页面。容器负责截获对 JSP 页面的请求。本教程使用内嵌 JSP 容器的 Apache 来支持 JSP 开发。 JSP 容器与 Web 服务器协同合作，为 JSP 的正常运行提供必要的运行环境和其他服务，并且能够正确识别专属于 JSP 网页的特殊元素。 下图显示了 JSP 容器和 JSP 文件在 Web 应用中所处的位置。  #### 工作步骤 以下步骤表明了 Web 服务器是如何使用 JSP 来创建网页的： - 就像其他普通的网页一样，您的浏览器发送一个 HTTP 请求给服务器。 - Web 服务器识别出这是一个对 JSP 网页的请求，并且将该请求传递给 JSP 引擎。通过使用 URL 或者.jsp 文件来完成。 - JSP 引擎从磁盘中载入 JSP 文件，然后将它们转化为 servlet。这种转化只是简单地将所有模板文本改用 println()语句，并且将所有的 JSP 元素转化成 Java 代码。 - JSP 引擎将 servlet 编译成可执行类，并且将原始请求传递给 servlet 引擎。 - Web 服务器的某组件将会调用 servlet 引擎，然后载入并执行 servlet 类。在执行过程中，servlet 产生 HTML 格式的输出并将其内嵌于 HTTP response 中上交给 Web 服务器。 - Web 服务器以静态 HTML 网页的形式将 HTTP response 返回到您的浏览器中。 - 最终，Web 浏览器处理 HTTP response 中动态产生的 HTML 网页，就好像在处理静态网页一样。 以上提及到的步骤可以用下图来表示： 一般情况下，JSP 引擎会检查 JSP 文件对应的 servlet 是否已经存在，并且检查 JSP 文件的修改日期是否早于 servlet。如果 JSP 文件的修改日期早于对应的 servlet，那么容器就可以确定 JSP 文件没有被修改过并且 servlet 有效。这使得整个流程与其他脚本语言（比如 PHP）相比要高效快捷一些。 ### JSP 生命周期 理解 JSP 底层功能的关键就是去理解它们所遵守的生命周期。 JSP 生命周期就是从创建到销毁的整个过程，类似于 servlet 生命周期，区别在于 JSP 生命周期还包括将 JSP 文件编译成 servlet。 以下是 JSP 生命周期中所走过的几个阶段： - **编译阶段：**servlet 容器编译 servlet 源文件，生成 servlet 类 - **初始化阶段：**加载与 JSP 对应的 servlet 类，创建其实例，并调用它的初始化方法 - **执行阶段：**调用与 JSP 对应的 servlet 实例的服务方法 - **销毁阶段：**调用与 JSP 对应的 servlet 实例的销毁方法，然后销毁 servlet 实例 很明显，JSP 生命周期的四个主要阶段和 servlet 生命周期非常相似，下面给出图示：  #### JSP 编译 当浏览器请求 JSP 页面时，JSP 引擎会首先去检查是否需要编译这个文件。如果这个文件没有被编译过，或者在上次编译后被更改过，则编译这个 JSP 文件。 编译的过程包括三个步骤： - 解析 JSP 文件。 - 将 JSP 文件转为 servlet。 - 编译 servlet。 #### JSP 初始化 容器载入 JSP 文件后，它会在为请求提供任何服务前调用 jspInit()方法。如果您需要执行自定义的 JSP 初始化任务，复写 jspInit()方法就行了，就像下面这样： ```java public void jspInit(){ // 初始化代码 } ``` 一般来讲程序只初始化一次，servlet 也是如此。通常情况下您可以在 jspInit()方法中初始化数据库连接、打开文件和创建查询表。 #### JSP 执行 这一阶段描述了 JSP 生命周期中一切与请求相关的交互行为，直到被销毁。 当 JSP 网页完成初始化后，JSP 引擎将会调用 `_jspService()` 方法。 `_jspService()` 方法需要一个 HttpServletRequest 对象和一个 HttpServletResponse 对象作为它的参数，就像下面这样： ```java void _jspService(HttpServletRequest request, HttpServletResponse response) { // 服务端处理代码 } ``` `_jspService()` 方法在每个 request 中被调用一次并且负责产生与之相对应的 response，并且它还负责产生所有 7 个 HTTP 方法的回应，比如 GET、POST、DELETE 等等。 #### JSP 清理 JSP 生命周期的销毁阶段描述了当一个 JSP 网页从容器中被移除时所发生的一切。 jspDestroy()方法在 JSP 中等价于 servlet 中的销毁方法。当您需要执行任何清理工作时复写 jspDestroy()方法，比如释放数据库连接或者关闭文件夹等等。 jspDestroy()方法的格式如下： ```java public void jspDestroy() { // 清理代码 } ``` ## 语法 ### 脚本 脚本程序可以包含任意量的 Java 语句、变量、方法或表达式，只要它们在脚本语言中是有效的。 脚本程序的语法格式： ``` <% 代码片段 %> ``` 或者，您也可以编写与其等价的 XML 语句，就像下面这样： ``` 代码片段 ``` 任何文本、HTML 标签、JSP 元素必须写在脚本程序的外面。 下面给出一个示例，同时也是本教程的第一个 JSP 示例： ```

今天的日期是: <%= (new java.util.Date()).toLocaleString()%>

今天的日期是: <%= (new java.util.Date()).toLocaleString()%>

IF...ELSE 实例

今天是周末

今天不是周末

Sswitch...case示例

For 循环实例

While 循环实例

``` 你可以对以上实例尝试使用及不使用该动作元素执行结果的区别。 ## JSP 隐式对象 JSP 隐式对象是 JSP 容器为每个页面提供的 Java 对象，开发者可以直接使用它们而不用显式声明。JSP 隐式对象也被称为预定义变量。 JSP 所支持的九大隐式对象： | **对象** | **描述** | | ----------- | ------------------------------------------------------------------ | | request | **HttpServletRequest**类的实例 | | response | **HttpServletResponse**类的实例 | | out | **PrintWriter**类的实例，用于把结果输出至网页上 | | session | **HttpSession**类的实例 | | application | **ServletContext**类的实例，与应用上下文有关 | | config | **ServletConfig**类的实例 | | pageContext | **PageContext**类的实例，提供对 JSP 页面所有对象以及命名空间的访问 | | page | 类似于 Java 类中的 this 关键字 | | Exception | **Exception**类的对象，代表发生错误的 JSP 页面中对应的异常对象 | ### request 对象 `request`对象是`javax.servlet.http.HttpServletRequest` 类的实例。 每当客户端请求一个 JSP 页面时，JSP 引擎就会制造一个新的`request`对象来代表这个请求。 `request`对象提供了一系列方法来获取 HTTP 头信息，cookies，HTTP 方法等等。 ### response 对象 `response`对象是`javax.servlet.http.HttpServletResponse`类的实例。 当服务器创建`request`对象时会同时创建用于响应这个客户端的`response`对象。 `response`对象也定义了处理 HTTP 头模块的接口。通过这个对象，开发者们可以添加新的 cookies，时间戳，HTTP 状态码等等。 ### out 对象 `out`对象是`javax.servlet.jsp.JspWriter`类的实例，用来在`response`对象中写入内容。 最初的`JspWriter`类对象根据页面是否有缓存来进行不同的实例化操作。可以在`page`指令中使用`buffered='false'`属性来轻松关闭缓存。 `JspWriter`类包含了大部分`java.io.PrintWriter`类中的方法。不过，`JspWriter`新增了一些专为处理缓存而设计的方法。还有就是，`JspWriter`类会抛出`IOExceptions`异常，而`PrintWriter`不会。 下表列出了我们将会用来输出`boolean`，`char`，`int`，`double`，`String`，`object`等类型数据的重要方法： | **方法** | **描述** | | ---------------------------- | -------------------------- | | **out.print(dataType dt)** | 输出 Type 类型的值 | | **out.println(dataType dt)** | 输出 Type 类型的值然后换行 | | **out.flush()** | 刷新输出流 | ### session 对象 `session`对象是`javax.servlet.http.HttpSession`类的实例。和 Java Servlets 中的`session`对象有一样的行为。 `session`对象用来跟踪在各个客户端请求间的会话。 ### application 对象 `application`对象直接包装了 servlet 的`ServletContext`类的对象，是`javax.servlet.ServletContext`类的实例。 这个对象在 JSP 页面的整个生命周期中都代表着这个 JSP 页面。这个对象在 JSP 页面初始化时被创建，随着`jspDestroy()`方法的调用而被移除。 通过向`application`中添加属性，则所有组成您 web 应用的 JSP 文件都能访问到这些属性。 ### config 对象 `config`对象是`javax.servlet.ServletConfig`类的实例，直接包装了 servlet 的`ServletConfig`类的对象。 这个对象允许开发者访问 Servlet 或者 JSP 引擎的初始化参数，比如文件路径等。 以下是 config 对象的使用方法，不是很重要，所以不常用： ``` config.getServletName(); ``` 它返回包含在``元素中的 servlet 名字，注意，``元素在`WEB-INF\web.xml`文件中定义。 ### pageContext 对象 `pageContext`对象是`javax.servlet.jsp.PageContext`类的实例，用来代表整个 JSP 页面。 这个对象主要用来访问页面信息，同时过滤掉大部分实现细节。 这个对象存储了`request`对象和`response`对象的引用。`application`对象，`config`对象，`session`对象，`out`对象可以通过访问这个对象的属性来导出。 `pageContext`对象也包含了传给 JSP 页面的指令信息，包括缓存信息，ErrorPage URL,页面 scope 等。 `PageContext`类定义了一些字段，包括 PAGE_SCOPE，REQUEST_SCOPE，SESSION_SCOPE， APPLICATION_SCOPE。它也提供了 40 余种方法，有一半继承自`javax.servlet.jsp.JspContext` 类。 其中一个重要的方法就是`removeArribute()`，它可接受一个或两个参数。比如，pageContext.removeArribute("attrName")移除四个 scope 中相关属性，但是下面这种方法只移除特定 scope 中的相关属性： ``` pageContext.removeAttribute("attrName", PAGE_SCOPE); ``` ### page 对象 这个对象就是页面实例的引用。它可以被看做是整个 JSP 页面的代表。 `page`对象就是`this`对象的同义词。 ### exception 对象 `exception`对象包装了从先前页面中抛出的异常信息。它通常被用来产生对出错条件的适当响应。 ## EL 表达式 EL 表达式是用`${}`括起来的脚本，用来更方便地读取对象。EL 表达式写在 JSP 的 HTML 代码中，而不能写在`<%`与`%>`引起的 JSP 脚本中。 JSP 表达式语言（EL）使得访问存储在 JavaBean 中的数据变得非常简单。JSP EL 既可以用来创建算术表达式也可以用来创建逻辑表达式。在 JSP EL 表达式内可以使用整型数，浮点数，字符串，常量 true、false，还有 null。 ### 一个简单的语法 典型的，当您需要在 JSP 标签中指定一个属性值时，只需要简单地使用字符串即可： ``` ``` JSP EL 允许您指定一个表达式来表示属性值。一个简单的表达式语法如下： ``` ${expr} ``` 其中，expr 指的是表达式。在 JSP EL 中通用的操作符是"."和"[]"。这两个操作符允许您通过内嵌的 JSP 对象访问各种各样的 JavaBean 属性。 举例来说，上面的 `` 标签可以使用表达式语言改写成如下形式： ``` ``` 当 JSP 编译器在属性中见到"\${}"格式后，它会产生代码来计算这个表达式，并且产生一个替代品来代替表达式的值。 您也可以在标签的模板文本中使用表达式语言。比如 `` 标签简单地将其主体中的文本插入到 JSP 输出中： ```

Hello JSP!

``` param 对象返回单一的字符串，而 paramValues 对象则返回一个字符串数组。 ### header 和 headerValues 对象 header 和 headerValues 对象用来访问信息头，通过使用 request.getHeader 方法和 request.getHeaders 方法。 举例来说，要访问一个名为 user-agent 的信息头，可以这样使用表达式：`${header.user-agent}`，或者 `${header["user-agent"]}`。 接下来的例子表明了如何访问 user-agent 信息头： ``` <%@ page import="java.io.*,java.util.*" %> <% String title = "User Agent Example"; %>

``` 运行结果如下：  header 对象返回单一值，而 headerValues 则返回一个字符串数组。 ## JSTL JSP 标准标签库（JSTL）是一个 JSP 标签集合，它封装了 JSP 应用的通用核心功能。 JSTL 支持通用的、结构化的任务，比如迭代，条件判断，XML 文档操作，国际化标签，SQL 标签。 除了这些，它还提供了一个框架来使用集成 JSTL 的自定义标签。 根据 JSTL 标签所提供的功能，可以将其分为 5 个类别。 - **核心标签** - **格式化标签** - **SQL 标签** - **XML 标签** - **JSTL 函数** ### JSTL 库安装 Apache Tomcat 安装 JSTL 库步骤如下： 从 Apache 的标准标签库中下载的二进包(jakarta-taglibs-standard-current.zip)。 - 官方下载地址： - 本站下载地址：[jakarta-taglibs-standard-1.1.2.zip](http://static.runoob.com/download/jakarta-taglibs-standard-1.1.2.tar.gz) 下载 **jakarta-taglibs-standard-1.1.2.zip** 包并解压，将 **jakarta-taglibs-standard-1.1.2/lib/** 下的两个 jar 文件：**standard.jar** 和 **jstl.jar** 文件拷贝到 **/WEB-INF/lib/** 下。 将 tld 下的需要引入的 tld 文件复制到 WEB-INF 目录下。 接下来我们在 web.xml 文件中添加以下配置： ``` http://java.sun.com/jsp/jstl/fmt /WEB-INF/fmt.tld http://java.sun.com/jsp/jstl/fmt-rt /WEB-INF/fmt-rt.tld http://java.sun.com/jsp/jstl/core /WEB-INF/c.tld http://java.sun.com/jsp/jstl/core-rt /WEB-INF/c-rt.tld http://java.sun.com/jsp/jstl/sql /WEB-INF/sql.tld http://java.sun.com/jsp/jstl/sql-rt /WEB-INF/sql-rt.tld http://java.sun.com/jsp/jstl/x /WEB-INF/x.tld http://java.sun.com/jsp/jstl/x-rt /WEB-INF/x-rt.tld ``` 使用任何库，你必须在每个 JSP 文件中的头部包含 **** 标签。 ### 核心标签 核心标签是最常用的 JSTL 标签。引用核心标签库的语法如下： ``` <%@ taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core" %> ``` | 标签 | 描述 | | :---------------------------------------------------------------------- | :-------------------------------------------------------------------------- | | [``](http://www.runoob.com/jsp/jstl-core-out-tag.html) | 用于在 JSP 中显示数据，就像<%= ... > | | [``](http://www.runoob.com/jsp/jstl-core-set-tag.html) | 用于保存数据 | | [``](http://www.runoob.com/jsp/jstl-core-remove-tag.html) | 用于删除数据 | | [``](http://www.runoob.com/jsp/jstl-core-catch-tag.html) | 用来处理产生错误的异常状况，并且将错误信息储存起来 | | [``](http://www.runoob.com/jsp/jstl-core-if-tag.html) | 与我们在一般程序中用的 if 一样 | | [``](http://www.runoob.com/jsp/jstl-core-choose-tag.html) | 本身只当做和的父标签 | | [``](http://www.runoob.com/jsp/jstl-core-choose-tag.html) | 的子标签，用来判断条件是否成立 | | [``](http://www.runoob.com/jsp/jstl-core-choose-tag.html) | 的子标签，接在标签后，当标签判断为 false 时被执行 | | [``](http://www.runoob.com/jsp/jstl-core-import-tag.html) | 检索一个绝对或相对 URL，然后将其内容暴露给页面 | | [``](http://www.runoob.com/jsp/jstl-core-foreach-tag.html) | 基础迭代标签，接受多种集合类型 | | [``](http://www.runoob.com/jsp/jstl-core-foreach-tag.html) | 根据指定的分隔符来分隔内容并迭代输出 | | [`

``` 以上程序输出结果为： ``` Hello Custom Tag! ``` ### 访问标签体 你可以像标准标签库一样在标签中包含消息内容。如我们要在我们自定义的 Hello 中包含内容，格式如下： ``` This is message body ``` 我们可以修改标签处理类文件，代码如下： ```java package com.runoob; import javax.servlet.jsp.tagext.*; import javax.servlet.jsp.*; import java.io.*; public class HelloTag extends SimpleTagSupport { StringWriter sw = new StringWriter(); public void doTag() throws JspException, IOException { getJspBody().invoke(sw); getJspContext().getOut().println(sw.toString()); } } ``` 接下来我们需要修改 TLD 文件，如下所示： ``` 1.0 2.0 Example TLD with Body Hello com.runoob.HelloTag scriptless ``` 现在我们可以在 JSP 使用修改后的标签，如下所示: ``` <%@ taglib prefix="ex" uri="WEB-INF/custom.tld"%>

``` 以上程序输出结果如下所示： ``` This is message body ``` ### 自定义标签属性 你可以在自定义标准中设置各种属性，要接收属性，值自定义标签类必须实现 setter 方法， JavaBean 中的 setter 方法如下所示： ```java package com.runoob; import javax.servlet.jsp.tagext.*; import javax.servlet.jsp.*; import java.io.*; public class HelloTag extends SimpleTagSupport { private String message; public void setMessage(String msg) { this.message = msg; } StringWriter sw = new StringWriter(); public void doTag() throws JspException, IOException { if (message != null) { /* 从属性中使用消息 */ JspWriter out = getJspContext().getOut(); out.println( message ); } else { /* 从内容体中使用消息 */ getJspBody().invoke(sw); getJspContext().getOut().println(sw.toString()); } } } ``` 属性的名称是"message"，所以 setter 方法是的 setMessage()。现在让我们在 TLD 文件中使用的元素添加此属性： ``` 1.0 2.0 Example TLD with Body Hello com.runoob.HelloTag scriptless message ``` 现在我们就可以在 JSP 文件中使用 message 属性了，如下所示： ``` <%@ taglib prefix="ex" uri="WEB-INF/custom.tld"%>

``` 以上实例数据输出结果为： ``` This is custom tag ``` 你还可以包含以下属性： | 属性 | 描述 | | :---------- | :------------------------------------------------------- | | name | 定义属性的名称。每个标签的是属性名称必须是唯一的。 | | required | 指定属性是否是必须的或者可选的,如果设置为 false 为可选。 | | rtexprvalue | 声明在运行表达式时，标签属性是否有效。 | | type | 定义该属性的 Java 类类型 。默认指定为 **String** | | description | 描述信息 | | fragment | 如果声明了该属性,属性值将被视为一个 **JspFragment**。 | 以下是指定相关的属性实例： ``` ..... attribute_name false java.util.Date false ..... ``` 如果你使用了两个属性，修改 TLD 文件，如下所示： ``` ..... attribute_name1 false java.util.Boolean false attribute_name2 true java.util.Date ..... ```