概述
JavaServer 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 >
JavaServer 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 元素 语法 说明 备注
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 直接发送到客户端。此外,模板文本也可以用任何现有的页面制作工具来编写。
唯一的例外在于,如果要输出 “ < %” ,则模板文本中应该写成 “ <\ %” 。
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 元素 语法 说明 备注
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 直接发送到客户端。此外,模板文本也可以用任何现有的页面制作工具来编写。
唯一的例外在于,如果要输出 “ < %” ,则模板文本中应该写成 “ <\ %” 。