JSP 脚本调用 Java 代码

转自：http://blog.sina.com.cn/s/blog_5ec67df20100hso1.html

点击这里，了解：安装
JDK、Tomcat、中文编码问题（这里涉及的所有源文件及 Tomcat 均采用 utf-8 编码）
点击这里，了解：简单配置
Tomcat、servlet 模版、如何运行 servlet
点击这里，了解：用于各例程的
servlet 工具类 ServletUtil.java

一、JSP 脚本元素

使用 JSP 脚本元素可以将 Java 代码插入到与 JSP 页面相对应的 servlet 中。脚本元素有3种形式：

形如
<%= Java expression_r %> 的表达式，它们在求值后插入到 servlet 的输出之中。
形如
<% Java Code %> 的 scriptlet，它们将插入到 servlet 的 _jspService 方法（由 service 方法调用）中。
形如
<%! Field / Method Declaration %> 的声明，它们将插入到 servlet 类的定义中， 不属于任何已有的方法。

大多数情况下，JSP文档的大部分由静态文本（一般是HTML）)构成，称之为模板文本（template text）。几乎从任何方面看，这种 HTML 都类似于普通的 HTML，它们遵循所有相同的语法规则，为处理该页面而创建的 servlet 只是将它们原封不动地传递给客户程序。这些 HTML 不仅看起来很普通，还可以使用任何已有的用于构建网页的工具（例如，Dreamweaver 或 Frontpage）创建它们。

如果输出中含有 <% 或 %>，需要在模板文本中使用 <\% 或 %\>。如果希望添加一段注释，使之出现在 JSP 页面中但不出现在结果文档中，需要使用

<%!-- JSP Comment --%>

下面这种形式的 HTML 注释按照常规的方式传递给客户程序：

<!-- HTML Comment -->

二、JSP 中调用动态代码的策略

在 JSP 中可以使用许多不同的方式生成动态内容。这些方式中的每一种都有其合理的应用范围。在决定哪种方式更为恰当时，项目的大小和复杂度是需要考虑的最重要的因素。人们更容易犯将太多代码直接放在页面中的错误，这种情况发生的机率要比其对立面大得多。尽管对于简单的应用，将少量的 Java 代码直接放到 JSP 页面中也工作得很好，但如果在 JSP 页面中使用大量复杂的 Java 代码块，造成的后果是难以维护，难以调试，难以重用，并且很难在开发团队的不同成员间划分工作。

下面列出的在 JSP 中调用动态代码的策略是按照从“简单应用或小型开发团队” → “复杂应用或大型开发团队”而从上至下排列的：

直接调用 Java 代码。将所有的 Java 代码都放在 JSP 页面中。只适用于极少量的代码。
间接调用 Java 代码。开发单独的实用工具类。只在 JSP 页面中插入调用实用工具类所需的 Java 代码。
使用 bean。开发单独的实用工具类，按照 bean 的要求进行构造。使用 jsp:useBean、jsp:getProperty 和 jsp:setProperty 调用该代码。
使用 MVC 构架。由一个servlet 负责处理最初的请求，查找数据，并将结果存储在 bean 中，然后将请求转发到 JSP 页面来提交最后的结果。JSP 页面使用 bean。
使用 JSP 表达式语言。使用简写语法访问并输出对象的属性。一般与 bean 和 MVC 组合使用。
使用定制标签。开发标签处理类。用类 XML 的定制标签调用标签处理器。

无论是25行代码，还是1000行代码，最好都放在 Java 类中，然后使用一或两行基于 JSP 的 Java 代码调用它。理由如下：

开发

我们一般在面向 Java 的开发环境中（IDE，如 JBuider 或 Eclipse；或者代码 编辑器，如 UltraEdit 或 emacs）编写常规的类。一般在面向 HTML 的环境中，如 Dreamweaver 编写 JSP。面向 Java 的开发环境一般在平衡圆括号、提供工具提示、检查语法、代码着色等方面做得更好。
编译

如果要编译常规的 Java 类，只需在 IDE 中单击 Build 或调用 javac；要编译 JSP 页面，则必须将它放到正确的目录中，启动服务器，打开浏览器并输入相应的 URL。
调试

在编写 Java 类或 JSP 页面时，语法上的错误在所难免。如果在常规的类定义中含有语法错误，编译器会马上告诉我们，还会给出代码中错误所在的行。如果在 JSP 页面中存在语法错误，服务器一般提示错误出现在 servlet（即由 JSP 转换成的 servlet）中哪一行。如果要在运行期间输出跟踪信息，对于常规的类，如果所使用的 IDE 没有提供更好的方法，也可以使用简单的 System.out.println 语句。在 JSP 中，虽然有些情况下可以使用打印语句，但这些打印语句显示在什么地方则因服务器而异。
工作划分

许多大型的开发团队由精通 Java 语言的人员和精通 HTML，但对 Java 知之甚少，甚至一无所知的人员组成。直接出现在页面中的 Java 代码越多，Web 开发人员就越难以操作它。
测试

假定希望制作一个 JSP 页面，输出指定区间的某个随机整数。如果直接在 JSP 页面中执行这些运算，那么，在测试时，必须一次一次地调用该页面，检查是否得到指定区间内的所有数字，且区间之外的数字没有出现。将 Reload 按钮点击了数十次之后，就会对测试感到厌烦。但是，如果在常规 Java 类的静态方法中完成这项任务，则可以编写测试例程，由它在循环中调用该方法，这样就可以成百上千次地运行测试用例，没有任何问题。对十更复杂的方法，可以保存输出，只要对方法做出修改，就用新的输出与之前保存的结果进行比较。
重用

将一些代码放到 JSP 页面中，后来，发现需要在不同的 JSP 页面中完成相同的事情。应该怎么办呢？剪切、粘贴？以这种方式重复代码是万恶之源，因为如果要对代码做出更改，那么必须更改很多不同地方的代码。解决代码重用的问题是面向对象编程的全部内容。不要仅仅因为使用 JSP 来简化 HTML 的生成，就忘记所有那些好的 OOP 基木准则。

对于常规 servlet，由于可以使用分离的 Web 应用来避免与其他项目中的 servlet 发生名称冲突，因此有时使用默认的包也是合理的。然而，对于 JSP 所调用的代码，则一定要使用包。同时，由于在编写供 servlet 使用的实用工具类时，并不知道后来是否同样会在 JSP 中使用它，因而，所应采取的策略是：所有的类，不管是供 servlet 还是 JSP 页面使用，都应该使用包。

三、使用预定义变量

可用的变量是 request、response、out、session、application、config、pageContext 和 page。还有一个附加变量 exception，但仅仅在错误页面中才可用。

Request

这个变量是与请求相关联的 HttpServletRequest，可以通过它访问请求的参数、 请求的类型（如 GET 或 POST）和输入的 HTTP 报头（例如 cookie）。
Response

这个变量是与发往客户的响应相关联的 HttpServletResponse。由于输出流一般都会缓冲，在 JSP 页面的主体内设置 HTTP 状态代码和响应报头一般是合法的，尽管在已经有输出送往客户的情况下，servlet 中不允许设置报头和状态代码。但是，如果将缓冲关闭，必须在提供任何输出之前设置状态代码和报头。
Out

这个变量是用来将输出发送到客户程序的 Writer。但是，为了在 JSP 页面中的各个地方都可以设置响应报头，此处使用的 out 不是标准的 PrintWriter，它对输出的内容进行缓冲（JspWriter 类型）。可以使用 page 指令的 buffer 属性调整缓冲区的大小。由于 JSP 表达式会被自动放入到输出流中，从而很少需要直接引用 out，故而 out 变量几乎仅仅用在 scriptlet 中。
Session

这个变量是与请求相关联的 HttpSession 对象。JSP 中会话是自动创建的，因此即使不存在对输入会话的引用，也存在这个变量。例外的情况是，如果使用 page 指令的 session 属性禁用自动会话跟踪，则不存在这个变量。并且，这种情况下对 session 变量的引用在 JSP 页面转换成 servlet 时会引起错误。
Application

这个变量和 getServletContext 返回的类型相同，都为 ServletContext。servlet 和 JSP 页面可以在 ServletContext 对象中（而非实例变量中）存储持续性数据。ServletContext 拥有 setAttribute 和 getAttribute 方法，使用它们可以存储与指定键关联的任意数据。将数据存储在实例变量中或是存储在 ServletContext 中，二者之间的差异是：ServletContext 由 Web 应用中所有的 servlet 和 JSP
页面共享，而实例变量只能由存储数据的同一个 servlet 使用。
Config

这个变量是该页的 ServletConfig 对象。原则上可以使用它来读取初始化参数，但在实践中，初始化参数在 jspInit 中读取，而非 _jspService。
PageContext

JSP 引入一个名为 PageContext 的类，通过它可以访问页面的许多属性。PageContext 类拥有 getRequest、getResponse、getOut、getSession 等方法。pageContext 变量存储与当前页面相关联的 PageContext 对象的值。如果方法或构造函数需要访问多个与页面相关的对象，传递 pageContext 要比传递多个 request、response、out 等的独立引用更容易。
Page

这个变量不过是 this 的同义词，没有什么太大的用处。创建它是为了在脚本语言还不是 Java 的时代用作占位符。

四、JSP 调用 Java 代码实例

下面是一个 JSP 调用动态代码的实例 JspTest.jsp，包括了脚本元素调用 Java 代码的所有3种形式。将此文件放在 Tomcat 的安装目录 $Tomcat/webapps/ROOT 下，启动 Tomcat，然后就可以通过 http://localhost:8080/JspTest.jsp 调用它。其中用到了工具类 ServletUtil，可以通过此页面顶部的链接查看之。

<?xml version="1.0" encoding="UTF-8" ?>

<%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html xmlns="http://www.w3.org/1999/xhtml">

<head>

<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />

<title>随机数列表</title>

<%!private int randomNum = cn.foololdfat.ServletUtil.randomInt(100);%>

</head>

<body>

<h1>随机数列表</h1>

<p><b>保存在实例变量中的随机数，只在对象构建时初始化：</b></p>

<ul>

<li><%=this.randomNum%></li>

</ul>

<p><b>保存在临时变量中的随机数，随机数的个数也是随机的：</b></p>

<ul>

<%

int numEntries = cn.foololdfat.ServletUtil.randomInt(10);

for (int i = 0; i < numEntries; i++)

out.println("<li>" + cn.foololdfat.ServletUtil.randomInt(100) + "</li>");

%>

</ul>

<p><b>其他一些 JSP 的例子：</b></p>

<ul>

<li><b>当前时间：</b><%=new java.util.Date()%></li>

<li><b>服务器类型：</b><%=application.getServerInfo()%></li>

<li><b>Session ID：</b><%=session.getId()%></li>

</ul>

</body>

</html>