概述

　　Java Server Pages（JSP）使得我们能够分离页面的静态HTML和动态部分。HTML可以用任何通常使用的Web制作工具编写，编写方式也和原来的一样；动态部分的代码放入特殊标记之内，大部分以“＜%”开始，以“%＞”结束。

　　例如，下面是一个JSP页面的片断，如果我们用http://host/OrderConfirmation.jsp/title=Core+Web+Programming这个URL打开该页面，则结果显示“Thanks for ordering Core Web Programming”。

Thanks for ordering ＜I＞＜%= request.getParameter("title") %＞＜/I＞

　　JSP页面文件通常以.JSP为扩展名，而且可以安装到任何能够存放普通Web页面的地方。虽然从代码编写来看，JSP页面更象普通Web页面而不象Servlet，但实际上，JSP最终会被转换成正规的Servlet，静态HTML直接输出到和Servlet service方法关联的输出流。

　　JSP到Servlet的转换过程一般在出现第一次页面请求时进行。因此，如果你希望第一个用户不会由于JSP页面转换成Servlet而等待太长的时间，希望确保Servlet已经正确地编译并装载，你可以在安装JSP页面之后自己请求一下这个页面。

　　另外也请注意，许多Web服务器允许定义别名，所以一个看起来指向HTML文件的URL实际上可能指向Servlet或JSP页面。

　　除了普通HTML代码之外，嵌入JSP页面的其他成分主要有如下三种：脚本元素（Scripting Element），指令（Directive），动作（Action）。脚本元素用来嵌入Java代码，这些Java代码将成为转换得到的Servlet的一部分；JSP指令用来从整体上控制Servlet的结构；动作用来引入现有的组件或者控制JSP引擎的行为。为了简化脚本元素，JSP定义了一组可以直接使用的变量（预定义变量），比如前面代码片断中的request就是其中一例。

　　注意本文以JSP 1.0规范为基础。和0.92版相比，新版本的JSP作了许多重大的改动。虽然这些改动只会使JSP变得更好，但应注意1.0的JSP页面几乎和早期的JSP引擎完全不兼容。

　　JSP语法概要表

　　JSP表达式 ＜%= expression %＞ 计算表达式并输出结果。 等价的XML表达是：

＜jsp:expression＞ expression ＜/jsp:expression＞

　　可以使用的预定义变量包括：request，response，out，session，application，config，pageContext。这些预定义变量也可以在JSP Scriptlet中使用。

　　JSP Scriptlet ＜% code %＞ 插入到service方法的代码。 等价的XML表达是：

＜jsp:scriptlet＞ code ＜/jsp:scriptlet＞

　　JSP声明 ＜%! code %＞ 代码被插入到Servlet类（在service方法之外）。 等价的XML表达是：

＜jsp:declaration＞ code ＜/jsp:declaration＞

　　page指令 ＜%@ page att="val" %＞ 作用于Servlet引擎的全局性指令。 等价的XML表达是

＜jsp:directive.page att="val"＼＞

　　合法的属性如下表，其中粗体表示默认值：

import="package.class" contentType="MIME-Type" isThreadSafe="true|false" session="true|false" buffer="size kb|none" autoflush="true|false" extends="package.class" info="message" errorPage="url" isErrorPage="true|false" language="java"

　　include指令 ＜%@ include file="url" %＞ 当JSP转换成Servlet时，应当包含本地系统上的指定文件。 等价的XML表达是：

＜jsp:directive.include file="url"＼＞.

　　其中URL必须是相对URL。

　　利用jsp:include动作可以在请求的时候（而不是JSP转换成Servlet时）引入文件。

　　JSP注释 ＜%-- comment --%＞ 注释；JSP转换成Servlet时被忽略。 如果要把注释嵌入结果HTML文档，使用普通的HTML注释标记＜-- comment --＞。

　　jsp:include动作 ＜jsp:include page="relative URL" flush="true"/＞ 当Servlet被请求时，引入指定的文件。 如果你希望在页面转换的时候包含某个文件，使用JSP include指令。

　　注意：在某些服务器上，被包含文件必须是HTML文件或JSP文件，具体由服务器决定（通常根据文件扩展名判断）。

jsp:useBean动作 ＜jsp:useBean att=val*/＞ 或者 ＜jsp:useBean att=val*＞ ... ＜/jsp:useBean＞寻找或实例化一个Java Bean。 可能的属性包括： id="name" scope="page|request |session|application" class="package.class" type="package.class" beanName="package.class" jsp:setProperty动作 ＜jsp:setProperty att=val*/＞ 设置Bean的属性。既可以设置一个确定的值， 也可以指定属性值来自请求参数。 合法的属性包括： name="beanName" property="propertyName|*" param="parameterName" value="val" jsp:getProperty动作 ＜jsp:getProperty name="propertyName" value="val"/＞ 提取并输出Bean的属性。 　 jsp:forward动作 ＜jsp:forward page="relative URL"/＞把请求转到另外一个页面。 　 jsp:plugin动作 ＜jsp:plugin attribute="value"*＞ ... ＜/jsp:plugin＞ 根据浏览器类型生成OBJECT或者EMBED标记， 以便通过Java Plugin运行Java Applet。

　　关于模板文本（静态HTML）

　　许多时候，JSP页面的很大一部分都由静态HTML构成，这些静态HTML也称为“模板文本”。模板文本和普通HTML几乎完全相同，它们都遵从相同的语法规则，而且模板文本也是被Servlet直接发送到客户端。此外，模板文本也可以用任何现有的页面制作工具来编写。

　　唯一的例外在于，如果要输出“＜%”，则模板文本中应该写成“＜＼%”。

12.1 JSP脚本元素

　　 JSP脚本元素用来插入Java代码，这些Java代码将出现在由当前JSP页面生成的Servlet中。脚本元素有三种格式：

表达式格式＜%= expression %＞：计算表达式并输出其结果。
Scriptlet格式＜% code %＞：把代码插入到Servlet的service方法。
声明格式＜%! code %＞：把声明加入到Servlet类（在任何方法之外）。
　　 下面我们详细说明它们的用法。

　　 12.1.1 JSP表达式

　　 JSP表达式用来把Java数据直接插入到输出。其语法如下：
＜%= Java Expression %＞

　　 计算Java表达式得到的结果被转换成字符串，然后插入到页面。计算在运行时进行（页面被请求时），因此可以访问和请求有关的全部信息。例如，下面的代码显示页面被请求的日期/时间：
Current time: ＜%= new java.util.Date() %＞

　　 为简化这些表达式，JSP预定义了一组可以直接使用的对象变量。后面我们将详细介绍这些隐含声明的对象，但对于JSP表达式来说，最重要的几个对象及其类型如下：

request：HttpServletRequest;
response：HttpServletResponse;
session：和request关联的HttpSession
out：PrintWriter（带缓冲的版本，JspWriter），用来把输出发送到客户端
　　 下面是一个例子：
Your hostname: ＜%= request.getRemoteHost() %＞

　　 最后，如果使用XML的话，JSP表达式也可以写成下面这种形式：


　　 请记住XML元素和HTML不一样。XML是大小写敏感的，因此务必使用小写。有关XML语法的说明，请参见《XML教程 》

　　 12.1.2 JSP Scriptlet

　　 如果你要完成的任务比插入简单的表达式更加复杂，可以使用JSP Scriptlet。JSP Scriptlet允许你把任意的Java代码插入Servlet。JSP Scriptlet语法如下：


　　 和JSP表达式一样，Scriptlet也可以访问所有预定义的变量。例如，如果你要向结果页面输出内容，可以使用out变量：

　　 注意Scriptlet中的代码将被照搬到Servlet内，而Scriptlet前面和后面的静态HTML（模板文本）将被转换成println语句。这就意味着，Scriptlet内的Java语句并非一定要是完整的，没有关闭的块将影响Scriptlet外的静态HTML。例如，下面的JSP片断混合了模板文本和Scriptlet：

　　 上述JSP代码将被转换成如下Servlet代码：


　　 如果要在Scriptlet内部使用字符“%＞”，必须写成“%＼＞”。另外，请注意＜% code %＞的XML等价表达是：
＜jsp:scriptlet＞
Code
＜/jsp:scriptlet＞

　　 12.1.3 JSP声明

　　 JSP声明用来定义插入Servlet类的方法和成员变量，其语法如下：

　　 由于声明不会有任何输出，因此它们往往和JSP表达式或Scriptlet结合在一起使用。例如，下面的JSP代码片断输出自从服务器启动（或Servlet类被改动并重新装载以来）当前页面被请求的次数：
自从服务器启动以来页面访问次数为：

　　 和Scriptlet一样，如果要使用字符串“%＞”，必须使用“%＼＞”代替。最后，＜%! code %＞的XML等价表达方式为：

　　 12.2 JSP指令

　　 JSP指令影响Servlet类的整体结构，它的语法一般如下：

　　 另外，也可以把同一指令的多个属性结合起来，例如：

　　 JSP指令分为两种类型：第一是page指令，用来完成下面这类任务：导入指定的类，自定义Servlet的超类，等等；第二是include指令，用来在JSP文件转换成Servlet时引入其他文件。JSP规范也提到了taglib指令，其目的是让JSP开发者能够自己定义标记，但JSP 1.0不支持该指令，有希望它将成为JSP 1.1的主要改进之一。

　　 12.2.1 page指令

　　 page指令的作用是定义下面一个或多个属性，这些属性大小写敏感。

import="package.class"，或者import="package.class1,...,package.classN"：

用于指定导入哪些包，例如：＜%@ page import="java.util.*" %＞。import是唯一允许出现一次以上的属性。

contentType="MIME-Type" 或contentType="MIME-Type; charset=Character-Set"：

该属性指定输出的MIME类型。默认是text/html。例如，下面这个指令：
＜%@ page contentType="text/plain" %＞。
和下面的Scriptlet效果相同：
＜% response.setContentType("text/plain"); %＞

isThreadSafe="true|false"

默认值true表明Servlet按照标准的方式处理，即假定开发者已经同步对实例变量的访问，由单个Servlet实例同时地处理多个请求。如果取值false，表明Servlet应该实现SingleThreadModel，请求或者是逐个进入，或者多个并行的请求分别由不同的Servlet实例处理。

session="true|false"

默认值true表明预定义变量session（类型为HttpSession）应该绑定到已有的会话，如果不存在已有的会话，则新建一个并绑定session变量。如果取值false，表明不会用到会话，试图访问变量session将导致JSP转换成Servlet时出错。

buffer="size kb|none"

该属性指定JspWrite out的缓存大小。默认值和服务器有关，但至少应该是8 KB。

autoflush="true|false"

默认值true表明如果缓存已满则刷新它。autoflush很少取false值，false值表示如果缓存已满则抛出异常。如果buffer="none"，autoflush不能取false值。

extends="package.class"

该属性指出将要生成的Servlet使用哪个超类。使用该属性应当十分小心，因为服务器可能已经在用自定义的超类。

info="message"

该属性定义一个可以通过getServletInfo方法提取的字符串。

errorPage="url"

该属性指定一个JSP页面，所有未被当前页面捕获的异常均由该页面处理。

isErrorPage="true|false"

该属性指示当前页面是否可以作为另一JSP页面的错误处理页面。默认值false。

language="java"

该属性用来指示所使用的语言。目前没有必要关注这个属性，因为默认的Java是当前唯一可用的语言。
　　 定义指令的XML语法为：

　　 例如，下面这个指令：

　　 它的XML等价表达是：

　　 12.2.2 include指令

　　 include指令用于JSP页面转换成Servlet时引入其他文件。该指令语法如下：


　　 这里所指定的URL是和发出引用指令的JSP页面相对的URL，然而，与通常意义上的相对URL一样，你可以利用以“/”开始的URL告诉系统把URL视为从Web服务器根目录开始。包含文件的内容也是JSP代码，即包含文件可以包含静态HTML、脚本元素、JSP指令和动作。

　　 例如，许多网站的每个页面都有一个小小的导航条。由于HTML框架存在不少问题，导航条往往用页面顶端或左边的一个表格制作，同一份HTML代码重复出现在整个网站的每个页面上。include指令是实现该功能的非常理想的方法。使用include指令，开发者不必再把导航HTML代码拷贝到每个文件中，从而可以更轻松地完成维护工作。

　　 由于include指令是在JSP转换成Servlet的时候引入文件，因此如果导航条改变了，所有使用该导航条的JSP页面都必须重新转换成Servlet。如果导航条改动不频繁，而且你希望包含操作具有尽可能好的效率，使用include指令是最好的选择。然而，如果导航条改动非常频繁，你可以使用jsp:include动作。jsp:include动作在出现对JSP页面请求的时候才会引用指定的文件，请参见本文后面的具体说明。

　　 12.3 实例：脚本元素和指令的应用

　　 下面是一个使用JSP表达式、Scriptlet、声明、指令的简单例子。

　　 12.4 JSP预定义变量

　　 为了简化JSP表达式和Scriptlet的代码，JSP提供了8个预先定义的变量（或称为隐含对象）。这些变量是request、response、out、session、application、config、pageContext和page。

　　 12.4.1 request

　　 这是和请求关联的HttpServletRequest，通过它可以查看请求参数（调用getParameter），请求类型（GET，POST，HEAD，等），以及请求的HTTP头（Cookie，Referer，等）。严格说来，如果请求所用的是HTTP之外的其他协议，request可以是ServletRequest的子类（而不是HttpServletRequest），但在实践中几乎不会用到。

　　 12.4.2 response

　　 这是和应答关联的HttpServletResponse。注意，由于输出流（参见下面的out）是带缓冲的，因此，如果已经向客户端发送了输出内容，普通Servlet不允许再设置HTTP状态代码，但在JSP中却是合法的。

　　 12.4.3 out

　　 这是用来向客户端发送内容的PrintWriter。然而，为了让response对象更为实用，out是带缓存功能的PrintWriter，即JspWriter。JSP允许通过page指令的buffer属性调整缓存的大小，甚至允许关闭缓存。

　　 out一般只在Scriptlet内使用，这是因为JSP表达式是自动发送到输出流的，很少需要显式地引用out。

　　 12.4.4 session

　　 这是和请求关联的HttpSession对象。前面我们已经介绍过会话的自动创建，我们知道，即使不存在session引用，这个对象也是自动绑定的。但有一个例外，这就是如果你用page指令的session属性关闭了会话，此时对session变量的引用将导致JSP页面转换成Servlet时出错。

　　 12.4.5 application

　　 这是一个ServletContext，也可以通过getServletConfig().getContext()获得。

　　 12.4.6 config

　　 这是当前页面的ServletConfig对象。

　　 12.4.7 pageContext

　　 主要用来管理页面的属性。

　　 12.4.8 page

　　 它是this的同义词，当前用处不大。它是为了Java不再是唯一的JSP编程语言而准备的占位符。







JSP动作利用XML语法格式的标记来控制Servlet引擎的行为。利用JSP动作可以动态地插入文件、重用JavaBean组件、把用户重定向到另外的页面、为Java插件生成HTML代码。

　　 JSP动作包括：

jsp:include：在页面被请求的时候引入一个文件。
jsp:useBean：寻找或者实例化一个JavaBean。
jsp:setProperty：设置JavaBean的属性。
jsp:getProperty：输出某个JavaBean的属性。
jsp:forward：把请求转到一个新的页面。
jsp:plugin：根据浏览器类型为Java插件生成OBJECT或EMBED标记。
　　 13.1 jsp:include动作

　　 该动作把指定文件插入正在生成的页面。其语法如下：

　　 前面已经介绍过include指令，它是在JSP文件被转换成Servlet的时候引入文件，而这里的jsp:include动作不同，插入文件的时间是在页面被请求的时候。jsp:include动作的文件引入时间决定了它的效率要稍微差一点，而且被引用文件不能包含某些JSP代码（例如不能设置HTTP头），但它的灵活性却要好得多。

　　 例如，下面的JSP页面把4则新闻摘要插入一个“What's New ?”页面。改变新闻摘要时只需改变这四个文件，而主JSP页面却可以不作修改：


　　 13.2 jsp:useBean动作

　　 jsp:useBean动作用来装载一个将在JSP页面中使用的JavaBean。这个功能非常有用，因为它使得我们既可以发挥Java组件重用的优势，同时也避免了损失JSP区别于Servlet的方便性。jsp:useBean动作最简单的语法为：
＜jsp:useBean id="name" class="package.class" /＞

　　 这行代码的含义是：“创建一个由class属性指定的类的实例，然后把它绑定到其名字由id属性给出的变量上”。不过，就象我们接下来会看到的，定义一个scope属性可以让Bean关联到更多的页面。此时，jsp:useBean动作只有在不存在同样id和scope的Bean时才创建新的对象实例，同时，获得现有Bean的引用就变得很有必要。

　　 获得Bean实例之后，要修改Bean的属性既可以通过jsp:setProperty动作进行，也可以在Scriptlet中利用id属性所命名的对象变量，通过调用该对象的方法显式地修改其属性。这使我们想起，当我们说“某个Bean有一个类型为X的属性foo”时，就意味着“这个类有一个返回值类型为X的getFoo方法，还有一个setFoo方法以X类型的值为参数”。

　　 有关jsp:setProperty动作的详细情况在后面讨论。但现在必须了解的是，我们既可以通过jsp:setProperty动作的value属性直接提供一个值，也可以通过param属性声明Bean的属性值来自指定的请求参数，还可以列出Bean属性表明它的值应该来自请求参数中的同名变量。

　　 在JSP表达式或Scriptlet中读取Bean属性通过调用相应的getXXX方法实现，或者更一般地，使用jsp:getProperty动作。

　　 注意包含Bean的类文件应该放到服务器正式存放Java类的目录下，而不是保留给修改后能够自动装载的类的目录。例如，对于Java Web Server来说，Bean和所有Bean用到的类都应该放入classes目录，或者封装进jar文件后放入lib目录，但不应该放到servlets下。

　　 下面是一个很简单的例子，它的功能是装载一个Bean，然后设置/读取它的message属性。


　　 SimpleBean.java

　　 BeanTest页面用到了一个SimpleBean。SimpleBean的代码如下：



　　 13.3 关于jsp:useBean的进一步说明

　　 使用Bean最简单的方法是先用下面的代码装载Bean：

　　 然后通过jsp:setProperty和jsp:getProperty修改和提取Bean的属性。不过有两点必须注意。第一，我们还可以用下面这种格式实例化Bean：
＜jsp:useBean ...＞
Body
＜/jsp:useBean＞

　　 它的意思是，只有当第一次实例化Bean时才执行Body部分，如果是利用现有的Bean实例则不执行Body部分。正如下面将要介绍的，jsp:useBean并非总是意味着创建一个新的Bean实例。

　　 第二，除了id和class外，jsp:useBean还有其他三个属性，即：scope，type，beanName。下表简要说明这些属性的用法。 属性 用法
id 命名引用该Bean的变量。如果能够找到id和scope相同的Bean实例，jsp:useBean动作将使用已有的Bean实例而不是创建新的实例。
class 指定Bean的完整包名。
scope 指定Bean在哪种上下文内可用，可以取下面的四个值之一：page，request，session和application。
默认值是page，表示该Bean只在当前页面内可用（保存在当前页面的PageContext内）。
request表示该Bean在当前的客户请求内有效（保存在ServletRequest对象内）。
session表示该Bean对当前HttpSession内的所有页面都有效。
最后，如果取值application，则表示该Bean对所有具有相同ServletContext的页面都有效。
scope之所以很重要，是因为jsp:useBean只有在不存在具有相同id和scope的对象时才会实例化新的对象；如果已有id和scope都相同的对象则直接使用已有的对象，此时jsp:useBean开始标记和结束标记之间的任何内容都将被忽略。

type 指定引用该对象的变量的类型，它必须是Bean类的名字、超类名字、该类所实现的接口名字之一。请记住变量的名字是由id属性指定的。
beanName 指定Bean的名字。如果提供了type属性和beanName属性，允许省略class属性。

　　 13.4 jsp:setProperty动作

　　 jsp:setProperty用来设置已经实例化的Bean对象的属性，有两种用法。首先，你可以在jsp:useBean元素的外面（后面）使用jsp:setProperty，如下所示：

　　 此时，不管jsp:useBean是找到了一个现有的Bean，还是新创建了一个Bean实例，jsp:setProperty都会执行。第二种用法是把jsp:setProperty放入jsp:useBean元素的内部，如下所示：


　　 此时，jsp:setProperty只有在新建Bean实例时才会执行，如果是使用现有实例则不执行jsp:setProperty。

　　 jsp:setProperty动作有下面四个属性： 属性 说明
name name属性是必需的。它表示要设置属性的是哪个Bean。
property property属性是必需的。它表示要设置哪个属性。有一个特殊用法：如果property的值是“*”，表示所有名字和Bean属性名字匹配的请求参数都将被传递给相应的属性set方法。
value value属性是可选的。该属性用来指定Bean属性的值。字符串数据会在目标类中通过标准的valueOf方法自动转换成数字、boolean、Boolean、byte、Byte、char、Character。例如，boolean和Boolean类型的属性值（比如“true”）通过Boolean.valueOf转换，int和Integer类型的属性值（比如“42”）通过Integer.valueOf转换。
value和param不能同时使用，但可以使用其中任意一个。

param param是可选的。它指定用哪个请求参数作为Bean属性的值。如果当前请求没有参数，则什么事情也不做，系统不会把null传递给Bean属性的set方法。因此，你可以让Bean自己提供默认属性值，只有当请求参数明确指定了新值时才修改默认属性值。
例如，下面的代码片断表示：如果存在numItems请求参数的话，把numberOfItems属性的值设置为请求参数numItems的值；否则什么也不做。

＜jsp:setProperty name="orderBean"
property="numberOfItems"
param="numItems" /＞

如果同时省略value和param，其效果相当于提供一个param且其值等于property的值。进一步利用这种借助请求参数和属性名字相同进行自动赋值的思想，你还可以在property（Bean属性的名字）中指定“*”，然后省略value和param。此时，服务器会查看所有的Bean属性和请求参数，如果两者名字相同则自动赋值。

　　 下面是一个利用JavaBean计算素数的例子。如果请求中有一个numDigits参数，则该值被传递给Bean的numDigits属性；numPrimes也类似。


　　 注：NumberedPrimes的代码略。

　　 13.5 jsp:getProperty动作

　　 jsp:getProperty动作提取指定Bean属性的值，转换成字符串，然后输出。jsp:getProperty有两个必需的属性，即：name，表示Bean的名字；property，表示要提取哪个属性的值。下面是一个例子，更多的例子可以在前文找到。


　　 13.6 jsp:forward动作

　　 jsp:forward动作把请求转到另外的页面。jsp:forward标记只有一个属性page。page属性包含的是一个相对URL。page的值既可以直接给出，也可以在请求的时候动态计算，如下面的例子所示：

　　 13.7 jsp:plugin动作

　　 jsp:plugin动作用来根据浏览器的类型，插入通过Java插件 运行Java Applet所必需的OBJECT或EMBED元素。

　　 附录：JSP注释和字符引用约定

　　 下面是一些特殊的标记或字符，你可以利用它们插入注释或可能被视为具有特殊含义的字符。 语法 用途
＜%-- comment --%＞ JSP注释，也称为“隐藏注释”。JSP引擎将忽略它。标记内的所有JSP脚本元素、指令和动作都将不起作用。
＜!-- comment --＞ HTML注释，也称为“输出的注释”，直接出现在结果HTML文档中。标记内的所有JSP脚本元素、指令和动作正常执行。
＜＼% 在模板文本（静态HTML）中实际上希望出现“＜%”的地方使用。
%＼＞ 在脚本元素内实际上希望出现“%＞”的地方使用。
＼' 使用单引号的属性内的单引号。不过，你既可以使用单引号也可以使用双引号，而另外一种引号将具有普通含义。
＼" 使用双引号的属性内的双引号。参见“＼'”的说明。