什么是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程序与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运行环境,这需要有一定的Java基础。

如果您还未学过Java,可以先学习我们为您提供的Java教程

JSP开发环境是您用来开发、测试和运行JSP程序的地方。

本节将会带您搭建JSP开发环境,具体包括以下几个步骤。


配置Java开发工具(JDK)

这一步涉及Java SDK的下载和PATH环境变量的配置。

您可以从Oracle公司的Java页面中下载SDK:Java SE Downloads

Java SDK下载完后,请按照给定的指示来安装和配置SDK。最后,通过设置PATH和JAVA_HOME环境变量来指明包括java和javac的文件夹路径,通常是java_install_dir/bin和java_install_dir。

假如您用的是Windows系统并且SDK的安装目录为C::jdk1.5.0_20,那么您就需要在 C:autoexec.bat 文件中添加以下两行:

set PATH=C:jdk1.5.0_20in;%PATH%set JAVA_HOME=C:jdk1.5.0_20

或者,在Windows NT/2000/XP下,您可以直接右击我的电脑图标,选择属性,然后高级,然后环境变量,接下来您就可以很方便地设置PATH变量并且确定退出就行了。

在Linux/Unix系统下,如果SDK的安装目录为/usr/local/jdk1.5.0_20并且使用的是C shell,那么您就需要在.cshrc文件中添加以下两行:

setenv PATH /usr/local/jdk1.5.0_20/bin:$PATHsetenv JAVA_HOME /usr/local/jdk1.5.0_20

或者,假如您正在使用类似于Borland JBuilder、Eclipse、IntelliJ IDEA和Sun ONE Studio这样的集成开发环境,可以试着编译并运行一个简单的程序来确定IDE(集成开发环境)是否已经知道 SDK的安装目录。

本步骤你也可以参考本站Java开发环境配置章节的教程。


设置Web服务器:Tomcat

目前,市场上有很多支持JSP和Servlets开发的Web服务器。他们中的一些可以免费下载和使用,Tomcat就是其中之一。

Apache Tomcat是一个开源软件,可作为独立的服务器来运行JSP和Servlets,也可以集成在 Apache Web Server中。以下是Tomcat的配置方法:

  • 下载最新版本的Tomcat:http://tomcat.apache.org/
  • 下载完安装文件后,将压缩文件解压到一个方便的地方,比如Windows下的C:apache-tomcat-5.5.29目录或者Linux/Unix下的/usr/local/apache-tomcat-5.5.29目录,然后创建CATALINA_HOME环境变量指向这些目录。

在Windows机器下,Tomcat可以通过执行以下命令来启动:

%CATALINA_HOME%instartup.bat或者C:apache-tomcat-5.5.29instartup.bat

在Linux/Unix机器下,Tomcat可以通过执行以下命令来启动:

$CATALINA_HOME/bin/startup.sh或者/usr/local/apache-tomcat-5.5.29/bin/startup.sh

成功启动Tomcat后,通过访问http://localhost:8080/便可以使用Tomcat自带的一些web应用了。假如一切顺利的话,您应该能够看到以下的页面:

更多关于配置和运行Tomcat的信息可以在Tomcat提供的文档中找到,或者去Tomcat官网查阅:http://tomcat.apache.org。

在Windows机器下,Tomcat可以通过执行以下命令来停止:

%CATALINA_HOME%inshutdown或者C:apache-tomcat-5.5.29inshutdown

在Linux/Unix机器下,Tomcat可以通过执行以下命令来停止:

$CATALINA_HOME/bin/shutdown.sh或者/usr/local/apache-tomcat-5.5.29/bin/shutdown.sh

设置CLASSPATH环境变量

由于servlets不是Java SE的一部分,所以您必须标示出servlet类的编译器。

假如您用的是Windows机器,您需要在C:autoexec.bat文件中添加以下两行:

set CATALINA=C:apache-tomcat-5.5.29set CLASSPATH=%CATALINA%commonlibjsp-api.jar;%CLASSPATH%

或者,在Windows NT/2000/XP下,您只要右击我的电脑,选择属性,然后点击高级,然后点击环境变量,接下来便可以设置CLASSPATH变量并且确定退出即可。

在Linux/Unix机器下,假如您使用的是C shell,那么您就需要在.cshrc文件中添加以下两行:

setenv CATALINA=/usr/local/apache-tomcat-5.5.29setenv CLASSPATH $CATALINA/common/lib/jsp-api.jar:$CLASSPATH

注意:如果您的开发路径是C:JSPDev (Windows)或者 /usr/JSPDev (Linux/Unix),那么您就需要将这些路径添加进CLASSPATH变量中。



本文假定你已安装了 JDK 环境,如未安装,可参阅 Java 开发环境配置

我们可以使用 Eclipse 来搭建 JSP 开发环境,首先我们分别下载一下软件包:


Tomcat 下载安装

你可以根据你的系统下载对应的包(以下以Window系统为例):

下载之后,将压缩包解压到D盘(你可以自己选择):

注意目录名不能有中文和空格。目录介绍如下:

  • bin:二进制执行文件。里面最常用的文件是startup.bat,如果是 Linux 或 Mac 系统启动文件为 startup.sh
  • conf:配置目录。里面最核心的文件是server.xml。可以在里面改端口号等。默认端口号是8080,也就是说,此端口号不能被其他应用程序占用。
  • lib:库文件。tomcat运行时需要的jar包所在的目录
  • logs:日志
  • temp:临时产生的文件,即缓存
  • webapps:web的应用程序。web应用放置到此目录下浏览器可以直接访问
  • work:编译以后的class文件。

接着我们可以双击 startup.bat 启动 Tomcat,弹出如下界面:

这个时候,本地的服务器就已经搭建起来了。如果想关闭服务器,可以直接关闭上面的窗口,或者在里面输入Ctrl+C禁止服务。

接着我们在浏览器中输入 http://localhost:8080/,如果弹出如下界面,表示tomcat安装成功并且启动起来了:

我们现在在浏览器上测试一下它吧:

首先在D:apache-tomcat-8.0.14webappsROOT目录中新建一个jsp文件:

test.jsp 文件代码如下:

<%@ page contentType="text/html;charset=UTF-8" %><%out.print("51coolma教程 : http://www.51coolma.cn");%> 

接着在浏览器中访问地址 http://localhost:8080/test.jsp, 输出结果如下:



将 Tomcat 和 Eclipse 相关联

Eclipse J2EE下载后,解压即可使用,我们打开Java EE ,选择菜单栏Windows-->preferences(Mac 系统为 Eclipse-->偏好设置),弹出如下界面:

上图中,点击"add"的添加按钮,弹出如下界面:

在选项中,我们选择对应的 Tomcat 版本,接着点击 "Next",选择 Tomcat 的安装目录,并选择我们安装的 Java 环境:

点击 "Finish",完成配置。

创建实例

选择 "File-->New-->Dynamic Web Project",创建 TomcatTest 项目:

点开上图中的红框部分,弹出如下界面:

注意如果已默认选择了我们之前安装的 Tomcat 和 JDK 则可跳过此步。

然后,单击finish, 继续:

工程文件结构:

上图中各个目录解析:

  • deployment descriptor:部署的描述。
  • Web App Libraries:自己加的包可以放在里面。
  • build:放入编译之后的文件。
  • WebContent:放进写入的页面。

在WebContent文件夹下新建一个test.jsp文件。在下图中可以看到它的默认代码:

<%@ page language="java" contentType="text/html; charset=UTF-8"    pageEncoding="UTF-8"%><!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"><html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>Insert title here</title></head><body></body></html>

接着我们修改下test.jsp文件代码如下所示:

<%@ page language="java" contentType="text/html; charset=UTF-8"    pageEncoding="UTF-8"%><!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"><html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>51coolma教程</title></head><body><%    out.println("Hello World!");%></body></html>

程序运行之前,我们先修改一下浏览器选项:

未标题-1(1)

接着我们运行该项目:

未标题-1

运行时,弹出如下错误:(如果没有此错误,请忽略)

原因是,我们之前点击了Tomcat安装包中的​startup.bat,这样一来就手动打开了Tomcat服务器,这明显是多余的,因为程序运行时,eclipse会自动开启Tomcat服务器。所以我们先手动关掉tomcat软件,再次运行程序,就行了。控制台信息如下:

浏览器访问 http://localhost:8080/TomcatTest/test.jsp, 即可输出正常结果:



Servlet 实例创建

我们也可以使用以上环境创建 Servlet 文件,选择 "File-->New-->Servlet":

位于 TomcatTest项目的 /TomcatTest/src 目录下创建 "HelloServlet" 类,包为 "com.youj.test":

未标题-2

HelloServlet.java 代码如下所示:

package com.youj.test;import java.io.IOException;import javax.servlet.ServletException;import javax.servlet.annotation.WebServlet;import javax.servlet.http.HttpServlet;import javax.servlet.http.HttpServletRequest;import javax.servlet.http.HttpServletResponse;/** * Servlet implementation class HelloServlet */@WebServlet("/HelloServlet")public class HelloServlet extends HttpServlet {	private static final long serialVersionUID = 1L;           /**     * @see HttpServlet#HttpServlet()     */    public HelloServlet() {        super();        // TODO Auto-generated constructor stub    }	/**	 * @see HttpServlet#doGet(HttpServletRequest request, HttpServletResponse response)	 */	protected void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {		// 使用 GBK 设置中文正常显示		response.setCharacterEncoding("GBK");		response.getWriter().write("51coolma教程:http://www.51coolma.cn");	}	/**	 * @see HttpServlet#doPost(HttpServletRequest request, HttpServletResponse response)	 */	protected void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {		// TODO Auto-generated method stub		doGet(request, response);	}}

接着重启 Tomcat,浏览器访问 http://localhost:8080/TomcatTest/HelloServlet


参考文章:http://www.cnblogs.com/smyhvae/p/4046862.html


网络服务器需要一个JSP引擎,也就是一个容器来处理JSP页面。容器负责截获对JSP页面的请求。本教程使用内嵌JSP容器的Apache来支持JSP开发。

JSP容器与Web服务器协同合作,为JSP的正常运行提供必要的运行环境和其他服务,并且能够正确识别专属于JSP网页的特殊元素。

下图显示了JSP容器和JSP文件在Web应用中所处的位置。


JSP处理

以下步骤表明了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网页就是用另一种方式来编写servlet而不用成为Java编程高手。除了解释阶段外,JSP网页几乎可以被当成一个普通的servlet来对待。


理解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()方法就行了,就像下面这样:

public void jspInit(){  // 初始化代码}

一般来讲程序只初始化一次,servlet也是如此。通常情况下您可以在jspInit()方法中初始化数据库连接、打开文件和创建查询表。


JSP执行

这一阶段描述了JSP生命周期中一切与请求相关的交互行为,直到被销毁。

当JSP网页完成初始化后,JSP引擎将会调用_jspService()方法。

_jspService()方法需要一个HttpServletRequest对象和一个HttpServletResponse对象作为它的参数,就像下面这样:

void _jspService(HttpServletRequest request,HttpServletResponse response){   // 服务端处理代码}

_jspService()方法在每个request中被调用一次并且负责产生与之相对应的response,并且它还负责产生所有7个HTTP方法的回应,比如GET、POST、DELETE等等。


JSP清理

JSP生命周期的销毁阶段描述了当一个JSP网页从容器中被移除时所发生的一切。

jspDestroy()方法在JSP中等价于servlet中的销毁方法。当您需要执行任何清理工作时复写jspDestroy()方法,比如释放数据库连接或者关闭文件夹等等。

jspDestroy()方法的格式如下:

public void jspDestroy(){   // 清理代码}

实例

JSP生命周期代码实例如下所示:

<%@ page language="java" contentType="text/html; charset=UTF-8"    pageEncoding="UTF-8"%><html><head><title>life.jsp</title></head><body><%!   private int initVar=0;  private int serviceVar=0;  private int destroyVar=0;%>  <%!  public void jspInit(){    initVar++;    System.out.println("jspInit(): JSP被初始化了"+initVar+"次");  }  public void jspDestroy(){    destroyVar++;    System.out.println("jspDestroy(): JSP被销毁了"+destroyVar+"次");  }%><%  serviceVar++;  System.out.println("_jspService(): JSP共响应了"+serviceVar+"次请求");  String content1="初始化次数 : "+initVar;  String content2="响应客户请求次数 : "+serviceVar;  String content3="销毁次数 : "+destroyVar;%><h1>51coolma教程 JSP 测试实例</h1><p><%=content1 %></p><p><%=content2 %></p><p><%=content3 %></p></body></html>


本小节将会简单地介绍一下JSP开发中的基础语法。


脚本程序

脚本程序可以包含任意量的Java语句、变量、方法或表达式,只要它们在脚本语言中是有效的。

脚本程序的语法格式:

<% 代码片段 %>

或者,您也可以编写与其等价的XML语句,就像下面这样:

<jsp:scriptlet>   
代码片段
</jsp:scriptlet>

任何文本、HTML标签、JSP元素必须写在脚本程序的外面。

下面给出一个示例,同时也是本教程的第一个JSP示例:

<html>
<head>
<title>Hello World</title>
</head>
<body>
Hello World!<br/>
<%
out.println("Your IP address is " + request.getRemoteAddr());
%>
</body>
</html>

注意:请确保Apache Tomcat已经安装在C:apache-tomcat-7.0.2目录下并且运行环境已经正确设置。

将以上代码保存在hello.jsp中,然后将它放置在 C:apache-tomcat-7.0.2webappsROOT目录下,打开浏览器并在地址栏中输入http://localhost:8080/hello.jsp。运行后得到以下结果:


JSP声明

一个声明语句可以声明一个或多个变量、方法,供后面的Java代码使用。在JSP文件中,您必须先声明这些变量和方法然后才能使用它们。

JSP声明的语法格式:

<%! declaration; [ declaration; ]+ ... %>

或者,您也可以编写与其等价的XML语句,就像下面这样:

<jsp:declaration>   
代码片段
</jsp:declaration>

程序示例:

<%! int i = 0; %> 
<%! int a, b, c; %>
<%! Circle a = new Circle(2.0); %>

JSP表达式

一个JSP表达式中包含的脚本语言表达式,先被转化成String,然后插入到表达式出现的地方。

由于表达式的值会被转化成String,所以您可以在一个文本行中使用表达式而不用去管它是否是HTML标签。

表达式元素中可以包含任何符合Java语言规范的表达式,但是不能使用分号来结束表达式。

JSP表达式的语法格式:

<%= 表达式 %>

同样,您也可以编写与之等价的XML语句:

<jsp:expression>   
表达式
</jsp:expression>

程序示例:

<html> 
<head>
<title>A Comment Test</title>
</head>
<body>
<p>
Today's date: <%= (new java.util.Date()).toLocaleString()%>
</p>
</body>
</html>

运行后得到以下结果:

Today's date: 11-Sep-2013 21:24:25

JSP注释

JSP注释主要有两个作用:为代码作注释以及将某段代码注释掉。

JSP注释的语法格式:

<%-- 这里可以填写 JSP 注释 --%>

程序示例:

<html> 
<head>
<title>A Comment Test</title>
</head>
<body>
<h2>A Test of Comments</h2>
<%-- 该部分注释在网页中不会被显示--%>
</body>
</html>

运行后得到以下结果:

A Test of Comments

不同情况下使用注释的语法规则:

语法 描述
<%-- 注释 --%> JSP注释,注释内容不会被发送至浏览器甚至不会被编译
<!-- 注释 --> HTML注释,通过浏览器查看网页源代码时可以看见注释内容
<\% 代表静态 <%常量
%> 代表静态 %> 常量
' 在属性中使用的单引号
" 在属性中使用的双引号

JSP指令

JSP指令用来设置与整个JSP页面相关的属性。

JSP指令语法格式:

<%@ directive attribute="value" %>

这里有三种指令标签:

指令 描述
<%@ page ... %> 定义页面的依赖属性,比如脚本语言、error页面、缓存需求等等
<%@ include ... %> 包含其他文件
<%@ taglib ... %> 引入标签库的定义,可以是自定义标签

JSP行为

JSP行为标签使用XML语法结构来控制servlet引擎。它能够动态插入一个文件,重用JavaBean组件,引导用户去另一个页面,为Java插件产生相关的HTML等等。

行为标签只有一种语法格式,它严格遵守XML标准:

<jsp:action_name attribute="value" />

行为标签基本上是一些预先就定义好的函数,下表罗列出了一些可用的JSP行为标签::

语法 描述
jsp:include 用于在当前页面中包含静态或动态资源
jsp:useBean 寻找和初始化一个JavaBean组件
jsp:setProperty 设置 JavaBean组件的值
jsp:getProperty 将 JavaBean组件的值插入到 output中
jsp:forward 从一个JSP文件向另一个文件传递一个包含用户请求的request对象
jsp:plugin 用于在生成的HTML页面中包含Applet和JavaBean对象
jsp:element 动态创建一个XML元素
jsp:attribute 定义动态创建的XML元素的属性
jsp:body 定义动态创建的XML元素的主体
jsp:text 用于封装模板数据

JSP隐含对象

JSP支持九个自动定义的变量,江湖人称隐含对象。这九个隐含对象的简介见下表:

对象 描述
request HttpServletRequest类的实例
response HttpServletResponse类的实例
out PrintWriter类的实例,用于把结果输出至网页上
session HttpSession类的实例
application ServletContext类的实例,与应用上下文有关
config ServletConfig类的实例
pageContext PageContext类的实例,提供对JSP页面所有对象以及命名空间的访问
page 类似于Java类中的this关键字
Exception Exception类的对象,代表发生错误的JSP页面中对应的异常对象

控制流语句

JSP提供对Java语言的全面支持。您可以在JSP程序中使用Java API甚至建立Java代码块,包括判断语句和循环语句等等。

判断语句

If…else块,请看下面这个例子:

<%! int day = 3; %> 
<html>
<head>
<title>IF...ELSE Example</title>
</head>
<body>
<% if (day == 1 | day == 7) { %>
<p> Today is weekend</p>
<% } else { %>
<p> Today is not weekend</p>
<% } %>
</body>
</html>

运行后得到以下结果:

Today is not weekend

现在来看看switch…case块,与if…else块有很大的不同,它使用out.println(),并且整个都装在脚本程序的标签中,就像下面这样:

<%! int day = 3; %> 
<html>
<head>
<title>SWITCH...CASE Example</title></head>
<body>
<%
switch(day) {
case 0:
out.println("It's Sunday.");
break;
case 1:
out.println("It's Monday.");
break;
case 2:
out.println("It's Tuesday.");
break;
case 3:
out.println("It's Wednesday.");
break;
case 4:
out.println("It's Thursday.");
break;
case 5:
out.println("It's Friday.");
break;
default:
out.println("It's Saturday.");
}
%>
</body>
</html>

运行后得出以下结果:

It's Wednesday.

循环语句

在JSP程序中可以使用Java的三个基本循环类型:for,while,和 do…while。

让我们来看看for循环的例子:

<%! int fontSize; %> 
<html>
<head>
<title>FOR LOOP Example</title>
</head>
<body>
<%for ( fontSize = 1; fontSize <= 3; fontSize++){ %>
<font color="green" size="<%= fontSize %>">
JSP Tutorial
</font><br />
<%}%>
</body>
</html>

运行后得到以下结果:

JSP Tutorial
JSP Tutorial
JSP Tutorial

将上例改用while循环来写:

<%! int fontSize; %> 
<html>
<head>
<title>WHILE LOOP Example</title>
</head>
<body>
<%while ( fontSize <= 3){ %>
<font color="green" size="<%= fontSize %>">
JSP Tutorial
</font><br />
<%fontSize++;%>
<%}%>
</body>
</html>

运行后得到同样的结果:


JSP Tutorial
JSP Tutorial
JSP Tutorial

JSP运算符

JSP支持所有Java逻辑和算术运算符。

下表罗列出了JSP常见运算符,优先级从高到底:

类别 操作符 结合性
后缀 () [] . (点运算符) 左到右
一元 ++ - - ! ~ 右到左
可乘性 * / %  左到右
可加性 + -  左到右
移位 >> >>> <<   左到右 
关系 > >= < <=   左到右
相等/不等 == !=  左到右
位与 左到右
位异或 左到右
位或 左到右
逻辑与 &&  左到右
逻辑或 ||  左到右
条件判断 ?:  右到左
赋值 = += -= *= /= %= >>= <<= &= ^= |=  右到左
逗号  左到右 

JSP常量

JSP语言定义了以下几个常量:

  • 布尔值(boolean):true 和 false;
  • 整型(int):与Java中的一样;
  • 浮点型(float):与Java中的一样;
  • 字符串(string):以单引号或双引号开始和结束;
  • Null:null。


JSP指令用来设置整个JSP页面相关的属性,如网页的编码方式和脚本语言。

语法格式如下:

<%@ directive attribute="value" %>

指令可以有很多个属性,它们以键值对的形式存在,并用逗号隔开。

JSP中的三种指令标签:

指令

描述
<%@ page ... %> 定义网页依赖属性,比如脚本语言、error页面、缓存需求等等
<%@ include ... %> 包含其他文件
<%@ taglib ... %> 引入标签库的定义

Page指令

Page指令为容器提供当前页面的使用说明。一个JSP页面可以包含多个page指令。

Page指令的语法格式:

<%@ page attribute="value" %>

等价的XML格式:

<jsp:directive.page attribute="value" />

属性

下表列出与Page指令相关的属性:

属性 描述
buffer 指定out对象使用缓冲区的大小
autoFlush 控制out对象的 缓存区
contentType 指定当前JSP页面的MIME类型和字符编码
errorPage 指定当JSP页面发生异常时需要转向的错误处理页面
isErrorPage 指定当前页面是否可以作为另一个JSP页面的错误处理页面
extends 指定servlet从哪一个类继承
import 导入要使用的Java类
info 定义JSP页面的描述信息
isThreadSafe 指定对JSP页面的访问是否为线程安全
language 定义JSP页面所用的脚本语言,默认是Java
session 指定JSP页面是否使用session
isELIgnored 指定是否执行EL表达式
isScriptingEnabled 确定脚本元素能否被使用

Include指令

JSP可以通过include指令来包含其他文件。被包含的文件可以是JSP文件、HTML文件或文本文件。包含的文件就好像是该JSP文件的一部分,会被同时编译执行。

Include指令的语法格式如下:

<%@ include file="relative url" %>

Include指令中的文件名实际上是一个相对的URL。如果您没有给文件关联一个路径,JSP编译器默认在当前路径下寻找。

等价的XML语法:

<jsp:directive.include file="relative url" />

Taglib指令

JSP API允许用户自定义标签,一个自定义标签库就是自定义标签的集合。

Taglib指令引入一个自定义标签集合的定义,包括库路径、自定义标签。

Taglib指令的语法:

<%@ taglib uri="uri" prefix="prefixOfTag" %>

uri属性确定标签库的位置,prefix属性指定标签库的前缀。

等价的XML语法:

<jsp:directive.taglib uri="uri" prefix="prefixOfTag" />


与JSP指令元素不同的是,JSP动作元素在请求处理阶段起作用。JSP动作元素是用XML语法写成的。

利用JSP动作可以动态地插入文件、重用JavaBean组件、把用户重定向到另外的页面、为Java插件生成HTML代码。

动作元素只有一种语法,它符合XML标准:

<jsp:action_name attribute="value" />

动作元素基本上都是预定义的函数,JSP规范定义了一系列的标准动作,它用JSP作为前缀,可用的标准动作元素如下:

语法 描述
jsp:include在页面被请求的时候引入一个文件。
jsp:useBean寻找或者实例化一个JavaBean。
jsp:setProperty设置JavaBean的属性。
jsp:getProperty输出某个JavaBean的属性。
jsp:forward把请求转到一个新的页面。
jsp:plugin根据浏览器类型为Java插件生成OBJECT或EMBED标记。
jsp:element定义动态XML元素
jsp:attribute设置动态定义的XML元素属性。
jsp:body设置动态定义的XML元素内容。
jsp:text在JSP页面和文档中使用写入文本的模板

常见的属性

所有的动作要素都有两个属性:id属性和scope属性。

  • id属性:

    id属性是动作元素的唯一标识,可以在JSP页面中引用。动作元素创建的id值可以通过PageContext来调用。

  • scope属性:

    该属性用于识别动作元素的生命周期。 id属性和scope属性有直接关系,scope属性定义了相关联id对象的寿命。 scope属性有四个可能的值: (a) page, (b)request, (c)session, 和 (d) application。


<jsp:include>动作元素

<jsp:include>动作元素用来包含静态和动态的文件。该动作把指定文件插入正在生成的页面。语法格式如下:

<jsp:include page="relative URL" flush="true" />

 前面已经介绍过include指令,它是在JSP文件被转换成Servlet的时候引入文件,而这里的jsp:include动作不同,插入文件的时间是在页面被请求的时候。

以下是include动作相关的属性列表。

属性 描述
page包含在页面中的相对URL地址。
flush布尔属性,定义在包含资源前是否刷新缓存区。

实例

以下我们定义了两个文件date.jsp和main.jsp,代码如下所示:

date.jsp文件代码:

<p>   Today's date: <%= (new java.util.Date()).toLocaleString()%></p>

main.jsp文件代码:

<html><head><title>The include Action Example</title></head><body><center><h2>The include action Example</h2><jsp:include page="date.jsp" flush="true" /></center></body></html>

现在将以上两个文件放在服务器的根目录下,访问main.jsp文件。显示结果如下:

The include action ExampleToday's date: 12-Sep-2013 14:54:22

<jsp:useBean>动作元素

 jsp:useBean动作用来装载一个将在JSP页面中使用的JavaBean。

这个功能非常有用,因为它使得我们既可以发挥Java组件重用的优势,同时也避免了损失JSP区别于Servlet的方便性。

jsp:useBean动作最简单的语法为:

<jsp:useBean id="name" class="package.class" />

在类载入后,我们既可以通过 jsp:setProperty 和 jsp:getProperty 动作来修改和检索bean的属性。

以下是useBean动作相关的属性列表。

属性 描述
class指定Bean的完整包名。
type指定将引用该对象变量的类型。
beanName通过 java.beans.Beans 的 instantiate() 方法指定Bean的名字。

在给出具体实例前,让我们先来看下 jsp:setProperty 和 jsp:getProperty 动作元素:


<jsp:setProperty>动作元素

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

<jsp:useBean id="myName" ... />...<jsp:setProperty name="myName" property="someProperty" .../>

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

<jsp:useBean id="myName" ... >...   <jsp:setProperty name="myName" property="someProperty" .../></jsp:useBean>

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

属性 描述
namename属性是必需的。它表示要设置属性的是哪个Bean。
propertyproperty属性是必需的。它表示要设置哪个属性。有一个特殊用法:如果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自己提供默认属性值,只有当请求参数明确指定了新值时才修改默认属性值。

<jsp:getProperty>动作元素

 jsp:getProperty动作提取指定Bean属性的值,转换成字符串,然后输出。语法格式如下:

<jsp:useBean id="myName" ... />...<jsp:getProperty name="myName" property="someProperty" .../>

下表是与getProperty相关联的属性:

属性 描述
name要检索的Bean属性名称。Bean必须已定义。
property表示要提取Bean属性的值

实例

以下实例我们使用了Bean:

/* 文件: TestBean.java */package action; public class TestBean {   private String message = "No message specified";    public String getMessage() {      return(message);   }   public void setMessage(String message) {      this.message = message;   }}

编译以上实例并生成 TestBean.class 文件,将该文件拷贝至服务器正式存放Java类的目录下,而不是保留给修改后能够自动装载的类的目录( 如:C:apache-tomcat-7.0.2webappsWEB-INFclassesaction目录中,CLASSPATH 变量必须包含该路径。 )。例如,对于Java Web Server来说,Bean和所有Bean用到的类都应该放入classes目录,或者封装进jar文件后放入lib目录,但不应该放到servlets 下。   下面是一个很简单的例子,它的功能是装载一个Bean,然后设置/读取它的message属性。

现在让我们在main.jsp文件中调用该Bean:

 <html><head><title>Using JavaBeans in JSP</title></head><body><center><h2>Using JavaBeans in JSP</h2> <jsp:useBean id="test" class="action.TestBean" /> <jsp:setProperty name="test"                      property="message"                      value="Hello JSP..." /> <p>Got message....</p> <jsp:getProperty name="test" property="message" /> </center></body></html>

执行以上文件,输出如下所示:

Using JavaBeans in JSPGot message....Hello JSP...

<jsp:forward> 动作元素

 jsp:forward动作把请求转到另外的页面。jsp:forward标记只有一个属性page。语法格式如下所示:

<jsp:forward page="Relative URL" />

以下是forward相关联的属性:

属性 描述
pagepage属性包含的是一个相对URL。page的值既可以直接给出,也可以在请求的时候动态计算,可以是一个JSP页面或者一个 Java Servlet.

实例

以下实例我们使用了两个文件,分别是: date.jsp 和 main.jsp。

date.jsp文件代码如下:

<p>   Today's date: <%= (new java.util.Date()).toLocaleString()%></p>

main.jsp文件代码:

<html><head><title>The forward Action Example</title></head><body><center><h2>The forward action Example</h2><jsp:forward page="date.jsp" /></center></body>

现在将以上两个文件放在服务器的根目录下,访问main.jsp文件。显示结果如下:

Today's date: 12-Sep-2010 14:54:22

<jsp:plugin>动作元素

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

如果需要的插件不存在,它会下载插件,然后执行Java组件。 Java组件可以是一个applet或一个JavaBean。

plugin动作有多个对应HTML元素的属性用于格式化Java 组件。param元素可用于向Applet 或 Bean 传递参数。

以下是使用plugin 动作元素的典型实例:

<jsp:plugin type="applet" codebase="dirname" code="MyApplet.class"                            width="60" height="80">   <jsp:param name="fontcolor" value="red" />   <jsp:param name="background" value="black" />    <jsp:fallback>      Unable to initialize Java Plugin   </jsp:fallback> </jsp:plugin>

如果你有兴趣可以尝试使用applet来测试jsp:plugin动作元素,<fallback>元素是一个新元素,在组件出现故障的错误是发送给用户错误信息。


<jsp:element> 、 <jsp:attribute>、 <jsp:body>动作元素

<jsp:element> 、 <jsp:attribute>、 <jsp:body>动作元素动态定义XML元素。动态是非常重要的,这就意味着XML元素在编译时是动态生成的而非静态。

以下实例动态定义了XML元素:

<%@page language="java" contentType="text/html"%><html xmlns="http://www.w3c.org/1999/xhtml"       xmlns:jsp="http://java.sun.com/JSP/Page"><head><title>Generate XML Element</title></head><body><jsp:element name="xmlElement"><jsp:attribute name="xmlElementAttr">   Value for the attribute</jsp:attribute><jsp:body>   Body for XML element</jsp:body></jsp:element></body></html>

执行时生成HTML代码如下:

<html xmlns="http://www.w3c.org/1999/xhtml"       xmlns:jsp="http://java.sun.com/JSP/Page"> <head><title>Generate XML Element</title></head><body><xmlElement xmlElementAttr="Value for the attribute">   Body for XML element</xmlElement></body></html>

<jsp:text>动作元素

<jsp:text>动作元素允许在JSP页面和文档中使用写入文本的模板,语法格式如下:

<jsp:text>Template data</jsp:text>

以上文本模板不能包含其他元素,只能只能包含文本和EL表达式(注:EL表达式将在后续章节中介绍)。请注意,在XML文件中,您不能使用表达式如 ${whatever > 0},因为>符号是非法的。 你可以使用 ${whatever gt 0}表达式或者嵌入在一个CDATA部分的值。

<jsp:text><![CDATA[<br>]]></jsp:text>

如果你需要在 XHTML 中声明 DOCTYPE,必须使用到<jsp:text>动作元素,实例如下:

<jsp:text><![CDATA[<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "DTD/xhtml1-strict.dtd">]]></jsp:text><head><title>jsp:text action</title></head><body><books><book><jsp:text>      Welcome to JSP Programming</jsp:text></book></books></body></html>

你可以对以上实例尝试使用<jsp:text>及不使用该动作元素执行结果的区别。


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-name>元素中的servlet名字,注意,<servlet-name>元素在 WEB-INFweb.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 对象包装了从先前页面中抛出的异常信息。它通常被用来产生对出错条件的适当响应。


当浏览器请求一个网页时,它会向网络服务器发送一系列不能被直接读取的信息,因为这些信息是作为HTTP信息头的一部分来传送的。您可以查阅HTTP协议来获得更多的信息。

下表列出了浏览器端信息头的一些重要内容,在以后的网络编程中将会经常见到这些信息:

信息 描述
Accept指定浏览器或其他客户端可以处理的MIME类型。它的值通常为 image/png 或 image/jpeg
Accept-Charset指定浏览器要使用的字符集。比如 ISO-8859-1
Accept-Encoding指定编码类型。它的值通常为 gzip 或compress
Accept-Language指定客户端首选语言,servlet会优先返回以当前语言构成的结果集,如果servlet支持这种语言的话。比如 en,en-us,ru等等
Authorization在访问受密码保护的网页时识别不同的用户
Connection表明客户端是否可以处理HTTP持久连接。持久连接允许客户端或浏览器在一个请求中获取多个文件。Keep-Alive 表示启用持久连接
Content-Length仅适用于POST请求,表示 POST 数据的字节数
Cookie返回先前发送给浏览器的cookies至服务器
Host指出原始URL中的主机名和端口号
If-Modified-Since表明只有当网页在指定的日期被修改后客户端才需要这个网页。 服务器发送304码给客户端,表示没有更新的资源
If-Unmodified-Since与If-Modified-Since相反, 只有文档在指定日期后仍未被修改过,操作才会成功
Referer标志着所引用页面的URL。比如,如果你在页面1,然后点了个链接至页面2,那么页面1的URL就会包含在浏览器请求页面2的信息头中
User-Agent用来区分不同浏览器或客户端发送的请求,并对不同类型的浏览器返回不同的内容

HttpServletRequest类

request对象是javax.servlet.http.HttpServletRequest类的实例。每当客户端请求一个页面时,JSP引擎就会产生一个新的对象来代表这个请求。

request对象提供了一系列方法来获取HTTP信息头,包括表单数据,cookies,HTTP方法等等。

接下来将会介绍一些在JSP编程中常用的获取HTTP信息头的方法。详细内容请见下表:

序号 方法& 描述
1 Cookie[] getCookies()

返回客户端所有的Cookie的数组
2 Enumeration getAttributeNames()

返回request对象的所有属性名称的集合
3 Enumeration getHeaderNames()

返回所有HTTP头的名称集合
4 Enumeration getParameterNames()

返回请求中所有参数的集合
5 HttpSession getSession()

返回request对应的session对象,如果没有,则创建一个
6 HttpSession getSession(boolean create)

返回request对应的session对象,如果没有并且参数create为true,则返回一个新的session对象
7 Locale getLocale()

返回当前页的Locale对象,可以在response中设置
8 Object getAttribute(String name)

返回名称为name的属性值,如果不存在则返回null。
9 ServletInputStream getInputStream()

返回请求的输入流
10 String getAuthType()

返回认证方案的名称,用来保护servlet,比如 "BASIC" 或者 "SSL" 或 null 如果 JSP没设置保护措施
11 String getCharacterEncoding()

返回request的字符编码集名称
12 String getContentType()

返回request主体的MIME类型,若未知则返回null
13 String getContextPath()

返回request URI中指明的上下文路径
14 String getHeader(String name)

返回name指定的信息头
15 String getMethod()

返回此request中的HTTP方法,比如 GET,,POST,或PUT
16 String getParameter(String name)

返回此request中name指定的参数,若不存在则返回null
17 String getPathInfo()

返回任何额外的与此request URL相关的路径
18 String getProtocol()

返回此request所使用的协议名和版本
19 String getQueryString()

返回此 request URL包含的查询字符串
20 String getRemoteAddr()

返回客户端的IP地址
21 String getRemoteHost()

返回客户端的完整名称
22 String getRemoteUser()

返回客户端通过登录认证的用户,若用户未认证则返回null
23 String getRequestURI()

返回request的URI
24 String getRequestedSessionId()

返回request指定的session ID
25 String getServletPath()

返回所请求的servlet路径
26 String[] getParameterValues(String name)

返回指定名称的参数的所有值,若不存在则返回null
27 boolean isSecure()

返回request是否使用了加密通道,比如HTTPS
28 int getContentLength()

返回request主体所包含的字节数,若未知的返回-1
29 int getIntHeader(String name)

返回指定名称的request信息头的值
30 int getServerPort()

返回服务器端口号

HTTP信息头示例

在这个例子中,我们会使用HttpServletRequest类的getHeaderNames()方法来读取HTTP信息头。这个方法以枚举的形式返回当前HTTP请求的头信息。

获取Enumeration对象后,用标准的方式来遍历Enumeration对象,用hasMoreElements()方法来确定什么时候停止,用nextElement()方法来获得每个参数的名字。

<%@ page import="java.io.*,java.util.*" %><html><head><title>HTTP Header Request Example</title></head><body><center><h2>HTTP Header Request Example</h2><table width="100%" border="1" align="center"><tr bgcolor="#949494"><th>Header Name</th><th>Header Value(s)</th></tr><%    Enumeration headerNames = request.getHeaderNames();    while(headerNames.hasMoreElements()) {       String paramName = (String)headerNames.nextElement();       out.print("<tr><td>" + paramName + "</td>
");      String paramValue = request.getHeader(paramName);      out.println("<td> " + paramValue + "</td></tr>
");   }%></table></center></body></html>

访问main.jsp,将会得到以下结果:

HTTP Header Request Example

Header NameHeader Value(s)
accept*/*
accept-languageen-us
user-agentMozilla/4.0 (compatible; MSIE 7.0; Windows NT 5.1; Trident/4.0; InfoPath.2; MS-RTC LM 8)
accept-encodinggzip, deflate
hostlocalhost:8080
connectionKeep-Alive
cache-controlno-cache

您可以在上面代码中尝试HttpServletRequest类的其它方法。


Response响应对象主要将JSP容器处理后的结果传回到客户端。可以通过response变量设置HTTP的状态和向客户端发送数据,如Cookie、HTTP文件头信息等。

一个典型的响应看起来就像下面这样:

HTTP/1.1 200 OKContent-Type: text/htmlHeader2: ......HeaderN: ...  (Blank Line)<!doctype ...><html><head>...</head><body>...</body></html>

状态行包含HTTP版本信息,比如HTTP/1.1,一个状态码,比如200,还有一个非常短的信息对应着状态码,比如OK。

下表摘要出了HTTP1.1响应头中最有用的部分,在网络编程中您将会经常见到它们:

响应头 描述
Allow 指定服务器支持的request方法(GET,POST等等)
Cache-Control 指定响应文档能够被安全缓存的情况。通常取值为 publicprivate 或no-cache 等等。 Public意味着文档可缓存,Private意味着文档只为单用户服务并且只能使用私有缓存。No-cache 意味着文档不被缓存。
Connection 命令浏览器是否要使用持久的HTTP连接。close 命令浏览器不使用持久HTTP连接,而keep-alive 意味着使用持久化连接。
Content-Disposition 让浏览器要求用户将响应以给定的名称存储在磁盘中
Content-Encoding 指定传输时页面的编码规则
Content-Language 表述文档所使用的语言,比如en, en-us,,ru等等
Content-Length 表明响应的字节数。只有在浏览器使用持久化 (keep-alive) HTTP 连接时才有用
Content-Type 表明文档使用的MIME类型
Expires 指明啥时候过期并从缓存中移除
Last-Modified 指明文档最后修改时间。客户端可以 缓存文档并且在后续的请求中提供一个 If-Modified-Since请求头
Location 在300秒内,包含所有的有一个状态码的响应地址,浏览器会自动重连然后检索新文档
Refresh 指明浏览器每隔多久请求更新一次页面。
Retry-After 与503 (Service Unavailable)一起使用来告诉用户多久后请求将会得到响应
Set-Cookie 指明当前页面对应的cookie

HttpServletResponse类

response对象是javax.servlet.http.HttpServletResponse类的一个实例。就像服务器会创建request对象一样,它也会创建一个客户端响应。

response对象定义了处理创建HTTP信息头的接口。通过使用这个对象,开发者们可以添加新的cookie或时间戳,还有HTTP状态码等等。

下表列出了用来设置HTTP响应头的方法,这些方法由HttpServletResponse 类提供:

S.N. 方法 & 描述
1 String encodeRedirectURL(String url)

对sendRedirect()方法使用的URL进行编码
2 String encodeURL(String url)

将URL编码,回传包含Session ID的URL
3 boolean containsHeader(String name)

返回指定的响应头是否存在
4 boolean isCommitted()

返回响应是否已经提交到客户端
5 void addCookie(Cookie cookie)

添加指定的cookie至响应中
6 void addDateHeader(String name, long date)

添加指定名称的响应头和日期值
7 void addHeader(String name, String value)

添加指定名称的响应头和值
8 void addIntHeader(String name, int value)

添加指定名称的响应头和int值
9 void flushBuffer()

将任何缓存中的内容写入客户端
10 void reset()

清除任何缓存中的任何数据,包括状态码和各种响应头
11 void resetBuffer()

清除基本的缓存数据,不包括响应头和状态码
12 void sendError(int sc)

使用指定的状态码向客户端发送一个出错响应,然后清除缓存
13 void sendError(int sc, String msg)

使用指定的状态码和消息向客户端发送一个出错响应
14 void sendRedirect(String location)

使用指定的URL向客户端发送一个临时的间接响应
15 void setBufferSize(int size)

设置响应体的缓存区大小
16 void setCharacterEncoding(String charset)

指定响应的编码集(MIME字符集),例如UTF-8
17 void setContentLength(int len)

指定HTTP servlets中响应的内容的长度,此方法用来设置 HTTP Content-Length 信息头
18 void setContentType(String type)

设置响应的内容的类型,如果响应还未被提交的话
19 void setDateHeader(String name, long date)

使用指定名称和值设置响应头的名称和内容
20 void setHeader(String name, String value)

使用指定名称和值设置响应头的名称和内容
21 void setIntHeader(String name, int value)

使用指定名称和值设置响应头的名称和内容
22 void setLocale(Locale loc)

设置响应的语言环境,如果响应尚未被提交的话
23 void setStatus(int sc)

设置响应的状态码

HTTP响应头程序示例

接下来的例子使用setIntHeader()方法和setRefreshHeader()方法来模拟一个数字时钟:

<%@ page import="java.io.*,java.util.*" %><html><head><title>Auto Refresh Header Example</title></head><body><center><h2>Auto Refresh Header Example</h2><%    // 设置每隔5秒自动刷新    response.setIntHeader("Refresh", 5);    // 获取当前时间    Calendar calendar = new GregorianCalendar();    String am_pm;    int hour = calendar.get(Calendar.HOUR);    int minute = calendar.get(Calendar.MINUTE);    int second = calendar.get(Calendar.SECOND);    if(calendar.get(Calendar.AM_PM) == 0)       am_pm = "AM";    else       am_pm = "PM";    String CT = hour+":"+ minute +":"+ second +" "+ am_pm;    out.println("Current Time is: " + CT + "
"); %></center></body></html>

将以上代码保存为main.jsp,然后通过浏览器访问它。它将会每隔5秒显示一下系统当前时间。

运行结果如下:

Auto Refresh Header ExampleCurrent Time is: 9:44:50 PM

您也可以自己动手修改以上代码,试试使用其他的方法,将能得到更深的体会。


HTTP请求与HTTP响应的格式相近,都有着如下结构:

  • 以状态行+CRLF(回车换行)开始
  • 零行或多行头模块+CRLF
  • 一个空行,比如CRLF
  • 可选的消息体比如文件,查询数据,查询输出

举例来说,一个服务器响应头看起来就像下面这样:

HTTP/1.1 200 OKContent-Type: text/htmlHeader2: ......HeaderN: ...  (Blank Line)<!doctype ...><html><head>...</head><body>...</body></html>

状态行包含HTTP版本,一个状态码,和状态码相对应的短消息。

下表列出了可能会从服务器返回的HTTP状态码和与之关联的消息:

状态码 消息 描述
100Continue只有一部分请求被服务器接收,但只要没被服务器拒绝,客户端就会延续这个请求
101Switching Protocols服务器交换机协议
200OK请求被确认
201Created请求已完成,新的资源被创建
202Accepted请求被接受,但未处理完
203Non-authoritative Information 
204No Content 
205Reset Content 
206Partial Content 
300Multiple Choices一个超链接表,用户可以选择一个超链接并访问,最大支持5个超链接
301Moved Permanently被请求的页面已经移动到了新的URL下
302Found被请求的页面暂时性地移动到了新的URL下
303See Other被请求的页面可以在一个不同的URL下找到
304Not Modified 
305Use Proxy 
306 Unused已经不再使用此状态码,但状态码被保留
307Temporary Redirect被请求的页面暂时性地移动到了新的URL下
400Bad Request服务器无法识别请求
401Unauthorized被请求的页面需要用户名和密码
402Payment Required 目前还不能使用此状态码
403Forbidden禁止访问所请求的页面
404Not Found服务器无法找到所请求的页面
405Method Not Allowed请求中所指定的方法不被允许
406Not Acceptable服务器只能创建一个客户端无法接受的响应
407Proxy Authentication Required在请求被服务前必须认证一个代理服务器
408Request Timeout请求时间超过了服务器所能等待的时间,连接被断开
409Conflict请求有矛盾的地方
410Gone被请求的页面不再可用
411Length Required"Content-Length"没有被定义,服务器拒绝接受请求
412Precondition Failed请求的前提条件被服务器评估为false
413Request Entity Too Large因为请求的实体太大,服务器拒绝接受请求
414Request-url Too Long服务器拒绝接受请求,因为URL太长。多出现在把"POST"请求转换为"GET"请求时所附带的大量查询信息
415Unsupported Media Type服务器拒绝接受请求,因为媒体类型不被支持
417Expectation Failed 
500Internal Server Error请求不完整,服务器遇见了出乎意料的状况
501Not Implemented请求不完整,服务器不提供所需要的功能
502Bad Gateway请求不完整,服务器从上游服务器接受了一个无效的响应
503Service Unavailable请求不完整,服务器暂时重启或关闭
504Gateway Timeout网关超时
505HTTP Version Not Supported服务器不支持所指定的HTTP版本

设置HTTP状态码的方法

下表列出了HttpServletResponse 类中用来设置状态码的方法:

S.N. 方法 & 描述
1 public void setStatus ( int statusCode )

此方法可以设置任意的状态码。如果您的响应包含一个特殊的状态码和一个文档,请确保在用PrintWriter返回任何内容前调用setStatus方法
2 public void sendRedirect(String url)

此方法产生302响应,同时产生一个 Location 头告诉URL 一个新的文档
3 public void sendError(int code, String message)

此方法将一个状态码(通常为 404)和一个短消息,自动插入HTML文档中并发回给客户端

HTTP状态码程序示例

接下来的例子将会发送407错误码给浏览器,然后浏览器将会告诉您"Need authentication!!!"。

<html><head><title>Setting HTTP Status Code</title></head><body><%    // 设置错误代码,并说明原因    response.sendError(407, "Need authentication!!!" ); %></body></html>

访问以上JSP页面,将会得到以下结果:

js_http_status_codes

您也可以试试使用其他的状态码,看会不会得到什么意想不到结果。


我们在浏览网页的时候,经常需要向服务器提交信息,并让后台程序处理。浏览器中使用 GET 和 POST 方法向服务器提交数据。


GET 方法

GET方法将请求的编码信息添加在网址后面,网址与编码信息通过"?"号分隔。如下所示:

//www.51coolma.cn/hello?key1=value1&key2=value2

GET方法是浏览器默认传递参数的方法,一些敏感信息,如密码等建议不使用GET方法。

用get时,传输数据的大小有限制 (注意不是参数的个数有限制),最大为1024字节。


POST 方法

一些敏感信息,如密码等我们可以同过POST方法传递,post提交数据是隐式的。

POST提交数据是不可见的,GET是通过在url里面传递的(可以看一下你浏览器的地址栏)。

JSP使用getParameter()来获得传递的参数,getInputStream()方法用来处理客户端的二进制数据流的请求。


JSP 读取表单数据

  • getParameter(): 使用 request.getParameter() 方法来获取表单参数的值。

  • getParameterValues(): 获得如checkbox类(名字相同,但值有多个)的数据。 接收数组变量 ,如checkbox类型

  • getParameterNames():该方法可以取得所有变量的名称,该方法返回一个Emumeration。

  • getInputStream():调用此方法来读取来自客户端的二进制数据流。


使用URL的 GET 方法实例

以下是一个简单的URL,并使用GET方法来传递URL中的参数:

http://localhost:8080/main.jsp?first_name=ZARA&last_name=ALI

以下是main.jsp文件的JSP程序用于处理客户端提交的表单数据,我们使用getParameter()方法来获取提交的数据:

<html><head><title>Using GET Method to Read Form Data</title></head><body><center><h1>Using GET Method to Read Form Data</h1><ul><li><p><b>First Name:</b>   <%= request.getParameter("first_name")%></p></li><li><p><b>Last  Name:</b>   <%= request.getParameter("last_name")%></p></li></ul></body></html>

接下来我们通过浏览器访问http://localhost:8080/main.jsp?first_name=ZARA&last_name=ALI 输出结果如下所示:

Using GET Method to Read Form DataFirst Name: ZARALast Name: ALI

使用表单的 GET 方法实例

以下是一个简单的HTML表单,该表单通过GET方法将客户端数据提交 到main.jsp文件中:

<html><body><form action="main.jsp" method="GET">First Name: <input type="text" name="first_name"><br />Last Name: <input type="text" name="last_name" /><input type="submit" value="Submit" /></form></body></html>

将以上HTML代码保存到Hello.htm文件中。 将该文件放置于/webapps/ROOT 目录下。 通过访问 http://localhost:8080/Hello.htm,输出界面如下所示:

form-1

在"First Name" 与 "Last Name"两个表单中填入信息,并点击"Submit"按钮,它将输出结果。


使用表单的 POST 方法实例

接下来让我们使用POST方法来传递表单数据,修改main.jsp与Hello.htm文件代码,如下所示:

main.jsp文件代码:

<html><head><title>Using GET and POST Method to Read Form Data</title></head><body><center><h1>Using GET Method to Read Form Data</h1><ul><li><p><b>First Name:</b>   <%= request.getParameter("first_name")%></p></li><li><p><b>Last  Name:</b>   <%= request.getParameter("last_name")%></p></li></ul></body></html>

以下是Hello.htm修改后的代码:

<html><body><form action="main.jsp" method="POST">First Name: <input type="text" name="first_name"><br />Last Name: <input type="text" name="last_name" /><input type="submit" value="Submit" /></form></body></html>

通过浏览器访问 http://localhost:8080/Hello.htm,输出如下:

form-1

在"First Name" 与 "Last Name"两个表单中填入信息,并点击"Submit"按钮,它将输出结果。


传递 Checkbox 数据到JSP程序

复选框 checkbox 可以传递一个甚至多个数据。

以下是一个简单的HTML代码,并将代码保存在CheckBox.htm文件中:

<html><body><form action="main.jsp" method="POST" target="_blank"><input type="checkbox" name="maths" checked="checked" /> Maths<input type="checkbox" name="physics"  /> Physics<input type="checkbox" name="chemistry" checked="checked" />                                                 Chemistry<input type="submit" value="Select Subject" /></form></body></html>

以下为main.jsp文件代码,用于处理复选框数据:

<html><head><title>Reading Checkbox Data</title></head><body><center><h1>Reading Checkbox Data</h1><ul><li><p><b>Maths Flag:</b>   <%= request.getParameter("maths")%></p></li><li><p><b>Physics Flag:</b>   <%= request.getParameter("physics")%></p></li><li><p><b>Chemistry Flag:</b>   <%= request.getParameter("chemistry")%></p></li></ul></body></html>

以上实例输出结果为:

form-2


读取所有表单参数

以下我们将使用 HttpServletRequest 的getParameterNames()来读取所有可用的表单参数,该方法可以取得所有变量的名称,该方法返回一个Emumeration。

一旦我们有了一个Enumeration(枚举),我们就可以调用hasMoreElements()方法来确定何时停止使用和nextElement()方法来获得每个参数的名称。

<%@ page import="java.io.*,java.util.*" %><html><head><title>HTTP Header Request Example</title></head><body><center><h2>HTTP Header Request Example</h2><table width="100%" border="1" align="center"><tr bgcolor="#949494"><th>Param Name</th><th>Param Value(s)</th></tr><%    Enumeration paramNames = request.getParameterNames();     while(paramNames.hasMoreElements()) {       String paramName = (String)paramNames.nextElement();       out.print("<tr><td>" + paramName + "</td>
");      String paramValue = request.getParameterValues(paramName);      out.println("<td> " + paramValue + "</td></tr>
");   }%></table></center></body></html>

以下是Hello.htm文件的内容:

<html><body><form action="main.jsp" method="POST" target="_blank"><input type="checkbox" name="maths" checked="checked" /> Maths<input type="checkbox" name="physics"  /> Physics<input type="checkbox" name="chemistry" checked="checked" /> Chem<input type="submit" value="Select Subject" /></form></body></html>

现在我们通过浏览器访问 Hello.htm 文件并提交数据,输出结果如下:

form-3

你可以尝试使用以上的JSP代码读取其它对象,如文本框,单选按钮或下拉框等等其他形式的数据。


Servlet和JSP中的过滤器都是Java类,它们存在的目的如下:

  • 在请求访问后端资源时拦截它
  • 管理从服务器返回给客户端的响应

下面列出了多种常用的过滤器类型:

  • 认证过滤器
  • 数据压缩过滤器
  • 加密过滤器
  • 触发资源访问事件的过滤器
  • 图像转换过滤器
  • 登录和验证过滤器
  • MIME类型链过滤器
  • 令牌过滤器
  • 转换XML内容的XSL/T过滤器

过滤器将会被插入进web.xml文件中,然后映射servlet、JSP文件的名字,或URL模式。部署描述文件web.xml可以在 <Tomcat-installation-directory>conf 目录下找到。

当JSP容器启动网络应用程序时,它会创建每一个过滤器的实例,这些过滤器必须在部署描述文件web.xml中声明,并且按声明的顺序执行。


Servlet过滤器方法

一个过滤器就是一个Java类,它实现了javax.servlet.Filter 接口。javax.servlet.Filter接口定义了三个方法:

序号 方法 &描述
1 public void doFilter (ServletRequest, ServletResponse, FilterChain)

每当 request/response要通过过滤链时容器会调用这个方法,因为客户端请求链尾的资源
2 public void init(FilterConfig filterConfig)

容器调用这个方法来表明一个过滤器被安置在服务中
3 public void destroy()

容器调用这个方法来表明一个过滤器正在从服务中移除

JSP过滤器示例

这个例子将会打印IP地址和每次访问JSP文件的日期时间。当然,这只是个简单的例子,让您了解一些简单的过滤器用法,但是可以使用这些概念来自行构造更复杂的程序。

//  引入Java包import java.io.*;import javax.servlet.*;import javax.servlet.http.*;import java.util.*; // 实现 Filter 类public class LogFilter implements Filter  {   public void  init(FilterConfig config)                          throws ServletException{      // 获取初始化参数      String testParam = config.getInitParameter("test-param");        //打印初始化参数      System.out.println("Test Param: " + testParam);    }   public void  doFilter(ServletRequest request,                  ServletResponse response,                 FilterChain chain)                  throws java.io.IOException, ServletException {       // 获取客户端ip地址        String ipAddress = request.getRemoteAddr();       // 输出ip地址及当前时间      System.out.println("IP "+ ipAddress + ", Time "                                       + new Date().toString());       // 传递请求道过滤器链      chain.doFilter(request,response);   }   public void destroy( ){      /* 在Filter实例在服务器上被移除前调用。*/   }}

编译LogFilter.java文件,然后将编译后的class文件放在<Tomcat安装目录>/webapps/ROOT/WEB-INF/classes目录下。


web.xml文件中的JSP过滤器映射

过滤器被定义,然后映射成一个URL或JSP文件名,与servlet被定义然后映射的方式差不多。在部署描述文件web.xml中,使用<filter>标签来进行过滤器映射:

<filter>   <filter-name>LogFilter</filter-name>   <filter-class>LogFilter</filter-class>   <init-param>	  <param-name>test-param</param-name>	  <param-value>Initialization Paramter</param-value>   </init-param></filter><filter-mapping>   <filter-name>LogFilter</filter-name>   <url-pattern>/*</url-pattern></filter-mapping>

上述过滤器将会应用在所有servlet和JSP程序中,因为我们在配置中指定了" /*"。您也可以指定一个servlet或JSP路径,如果您只想要将过滤器应用在少数几个servlet或JSP程序中的话。

现在,像平常一样访问servlet或JSP页面,您就会发现服务器日志中产生了关于此次访问的记录。您也可以使用Log4J记录器来把日志记录在其它文件中。


使用多重过滤器

您的网络应用程序可以定义很多不同的过滤器。现在,您定义了两个过滤器,AuthenFilter和LogFilter,其它的步骤与前面讲的一样,除非要创建一个不同的映射,就像下面这样:

<filter>   <filter-name>LogFilter</filter-name>   <filter-class>LogFilter</filter-class>   <init-param>	  <param-name>test-param</param-name>	  <param-value>Initialization Paramter</param-value>   </init-param></filter> <filter>   <filter-name>AuthenFilter</filter-name>   <filter-class>AuthenFilter</filter-class>   <init-param>	  <param-name>test-param</param-name>	  <param-value>Initialization Paramter</param-value>   </init-param></filter> <filter-mapping>   <filter-name>LogFilter</filter-name>   <url-pattern>/*</url-pattern></filter-mapping> <filter-mapping>   <filter-name>AuthenFilter</filter-name>   <url-pattern>/*</url-pattern></filter-mapping>

过滤器的应用顺序

在web.xml中<filter>元素的映射顺序决定了容器应用这些过滤器的顺序。要反转应用的顺序,您只需要反转web.xml中<filter>元素的定义顺序就行了。

比如,上面的例子会首先应用 LogFilter然后再应用AuthenFilter,但是下面这个例子将会反转应用的顺序:

<filter-mapping>   <filter-name>AuthenFilter</filter-name>   <url-pattern>/*</url-pattern></filter-mapping> <filter-mapping>   <filter-name>LogFilter</filter-name>   <url-pattern>/*</url-pattern></filter-mapping>


Cookies是存储在客户机的文本文件,它们保存了大量轨迹信息。在servlet技术基础上,JSP显然能够提供对HTTP cookies的支持。

通常有三个步骤来识别回头客:

  • 服务器脚本发送一系列cookies至浏览器。比如名字,年龄,ID号码等等。
  • 浏览器在本地机中存储这些信息,以备不时之需。
  • 当下一次浏览器发送任何请求至服务器时,它会同时将这些cookies信息发送给服务器,然后服务器使用这些信息来识别用户或者干些其它事情。

本章节将会传授您如何去设置或重设cookie的方法,还有如何访问它们及如何删除它们。


Cookie剖析

Cookies通常在HTTP信息头中设置(虽然JavaScript能够直接在浏览器中设置cookies)。在JSP中,设置一个cookie需要发送如下的信息头给服务器:

HTTP/1.1 200 OKDate: Fri, 04 Feb 2000 21:03:38 GMTServer: Apache/1.3.9 (UNIX) PHP/4.0b3Set-Cookie: name=xyz; expires=Friday, 04-Feb-07 22:03:38 GMT;                  path=/; domain=tutorialspoint.comConnection: closeContent-Type: text/html

正如您所见,Set-Cookie信息头包含一个键值对,一个GMT(格林尼治标准)时间,一个路径,一个域名。键值对会被编码为URL。有效期域是个指令,告诉浏览器在什么时候之后就可以清除这个cookie。

如果浏览器被配置成可存储cookies,那么它将会保存这些信息直到过期。如果用户访问的任何页面匹配了cookie中的路径和域名,那么浏览器将会重新将这个cookie发回给服务器。浏览器端的信息头长得就像下面这样:

GET / HTTP/1.0Connection: Keep-AliveUser-Agent: Mozilla/4.6 (X11; I; Linux 2.2.6-15apmac ppc)Host: zink.demon.co.uk:1126Accept: image/gif, */*Accept-Encoding: gzipAccept-Language: enAccept-Charset: iso-8859-1,*,utf-8Cookie: name=xyz

JSP脚本通过request对象中的getCookies()方法来访问这些cookies,这个方法会返回一个Cookie对象的数组。


Servlet Cookies 方法

下表列出了Cookie对象中常用的方法:

序号 方法 & 描述
1 public void setDomain(String pattern)

设置cookie的域名,比如51coolma.cn
2 public String getDomain()

获取cookie的域名,比如51coolma.cn
3 public void setMaxAge(int expiry)

设置cookie有效期,以秒为单位,默认有效期为当前session的存活时间
4 public int getMaxAge()

获取cookie有效期,以秒为单位,默认为-1 ,表明cookie会活到浏览器关闭为止
5 public String getName()

返回 cookie的名称,名称创建后将不能被修改
6 public void setValue(String newValue)

设置 cookie的值
7 public String getValue()

获取cookie的值
8 public void setPath(String uri)

设置cookie 的路径,默认为当前页面目录下的所有URL,还有此目录下的所有子目录
9 public String getPath()

获取cookie 的路径
10 public void setSecure(boolean flag)

指明cookie是否要加密传输
11 public void setComment(String purpose)

设置注释描述 cookie的目的。当浏览器将cookie展现给用户时,注释将会变得非常有用
12 public String getComment()

返回描述cookie目的的注释,若没有则返回null

使用JSP设置Cookies

使用JSP设置cookie包含三个步骤:

(1)创建一个Cookie对象: 调用Cookie的构造函数,使用一个cookie名称和值做参数,它们都是字符串。

Cookie cookie = new Cookie("key","value");

请务必牢记,名称和值中都不能包含空格或者如下的字符:

[ ] ( ) = , " / ? @ : ;

(2) 设置有效期:调用setMaxAge()函数表明cookie在多长时间(以秒为单位)内有效。下面的操作将有效期设为了24小时。

cookie.setMaxAge(60*60*24); 

(3) 将cookie发送至HTTP响应头中:调用response.addCookie()函数来向HTTP响应头中添加cookies。

response.addCookie(cookie);

实例演示

<%    
// 为 first_name 和 last_name设置cookie
Cookie firstName = new Cookie("first_name", request.getParameter("first_name"));
Cookie lastName = new Cookie("last_name",request.getParameter("last_name"));
// 设置cookie过期时间为24小时。
firstName.setMaxAge(60*60*24);
lastName.setMaxAge(60*60*24);
// 在响应头部添加cookie
response.addCookie( firstName );
response.addCookie( lastName );
%><html><head><title>Setting Cookies</title></head><body>
<center><h1>Setting Cookies</h1></center><ul><li><p><b>First Name:</b><%= request.getParameter("first_name")%></p></li><li><p><b>Last Name:</b> <%= request.getParameter("last_name")%></p></li></ul></body></html>

将上面的文件放在<Tomcat安装目录>/webapps/ROOT目录下,然后访问http://localhost:8080/hello.jsp,将会得到如下输出结果:

试着输入First Name和Last Name,然后点击提交按钮,它将会在您的屏幕中显示first name和last name,并且设置first name和last name两个cookie,下一次点击提交按钮时会发给服务器。


使用JSP读取Cookies

想要读取cookies,您就需要调用request.getCookies()方法来获得一个javax.servlet.http.Cookie对象的数组,然后遍历这个数组,使用getName()方法和getValue()方法来获取每一个cookie的名称和值。

让我们来读取上个例子中的cookies。

<html><head><title>Reading Cookies</title></head><body><center><h1>Reading Cookies</h1></center><%    
Cookie cookie = null;
Cookie[] cookies = null;
// 获取cookies的数据,是一个数组
cookies = request.getCookies();
if( cookies != null ){
out.println("<h2> Found Cookies Name and Value</h2>"); for (int i = 0; i < cookies.length; i++){
cookie = cookies[i];

out.print("Name : " + cookie.getName( ) + ", ");
out.print("Value: " + cookie.getValue( )+" <br/>"); } }else{ out.println("<h2>No cookies founds</h2>"); }%></body></html>

如果您把first name cookie设置成"John",last name设置成"Player",访问 http://localhost:8080/main.jsp,将会得到如下输出结果:

Found Cookies Name and ValueName : first_name, Value: John Name : last_name, Value: Player

使用JSP删除Cookies

删除cookies非常简单。如果您想要删除一个cookie,按照下面给的步骤来做就行了:

  • 获取一个已经存在的cookie然后存储在Cookie对象中。
  • 将cookie的有效期设置为0。
  • 将这个cookie重新添加进响应头中。

实例演示

下面的程序删除一个名为"first_name"的cookie,当您下次运行main.jsp时,first_name将会为null。

<html><head><title>Reading Cookies</title></head><body><center>  <h1>Reading Cookies</h1></center><%    
Cookie cookie = null;
Cookie[] cookies = null;
// 获取当前域名下的cookies,是一个数组
cookies = request.getCookies();
if( cookies != null ){
out.println("<h2> Found Cookies Name and Value</h2>"); for (int i = 0; i < cookies.length; i++){
cookie = cookies[i];
if((cookie.getName( )).compareTo("first_name") == 0 ){
cookie.setMaxAge(0);
response.addCookie(cookie);
out.print("Deleted cookie: " +
cookie.getName( ) + "<br/>"); } out.print("Name : " + cookie.getName( ) + ", "); out.print("Value: " + cookie.getValue( )+" <br/>"); } }else{ out.println( "<h2>No cookies founds</h2>"); }%></body></html>

访问它,将会得到如下输出结果:

Cookies Name and ValueDeleted cookie : first_nameName : first_name, Value: JohnName : last_name, Value: Player

再次访问http://localhost:8080/main.jsp,将会得到如下结果:

Found Cookies Name and ValueName : last_name, Value: Player

您也可以手动在浏览器中删除cookies。点击Tools菜单项,然后选择Internet Options,点击Delete Cookies,就能删除所有cookies了。


HTTP是无状态协议,这意味着每次客户端检索网页时,都要单独打开一个服务器连接,因此服务器不会记录下先前客户端请求的任何信息。

有三种方法来维持客户端与服务器的会话:


Cookies

网络服务器可以指定一个唯一的session ID作为cookie来代表每个客户端,用来识别这个客户端接下来的请求。

这可能不是一种有效的方式,因为很多时候浏览器并不一定支持cookie,所以我们不建议使用这种方法来维持会话。


隐藏表单域

一个网络服务器可以发送一个隐藏的HTML表单域和一个唯一的session ID,就像下面这样:

<input type="hidden" name="sessionid" value="12345">

这个条目意味着,当表单被提交时,指定的名称和值将会自动包含在GET或POST数据中。每当浏览器发送一个请求,session_id的值就可以用来保存不同浏览器的轨迹。

这种方式可能是一种有效的方式,但点击<A HREF>标签中的超链接时不会产生表单提交事件,因此隐藏表单域也不支持通用会话跟踪。


重写URL

您可以在每个URL后面添加一些额外的数据来区分会话,服务器能够根据这些数据来关联session标识符。

举例来说,http://51coolma.cn/file.htm;sessionid=12345, session标识符为sessionid=12345,服务器可以用这个数据来识别客户端。

相比而言,重写URL是更好的方式来,就算浏览器不支持cookies也能工作,但缺点是您必须为每个URL动态指定session ID,就算这是个简单的HTML页面。


session对象

除了以上几种方法外,JSP利用servlet提供的HttpSession接口来识别一个用户,存储这个用户的所有访问信息。

默认情况下,JSP允许会话跟踪,一个新的HttpSession对象将会自动地为新的客户端实例化。禁止会话跟踪需要显式地关掉它,通过将page指令中session属性值设为false来实现,就像下面这样:

<%@ page session="false" %>

JSP引擎将隐含的session对象暴露给开发者。由于提供了session对象,开发者就可以方便地存储或检索数据。

下表列出了session对象的一些重要方法:

S.N. 方法 & 描述
1 public Object getAttribute(String name)

返回session对象中与指定名称绑定的对象,如果不存在则返回null
2 public Enumeration getAttributeNames()

返回session对象中所有的对象名称
3 public long getCreationTime()

返回session对象被创建的时间, 以毫秒为单位,从1970年1月1号凌晨开始算起
4 public String getId()

返回session对象的ID
5 public long getLastAccessedTime()

返回客户端最后访问的时间,以毫秒为单位,从1970年1月1号凌晨开始算起
6 public int getMaxInactiveInterval()

返回最大时间间隔,以秒为单位,servlet 容器将会在这段时间内保持会话打开
7 public void invalidate()

将session无效化,解绑任何与该session绑定的对象
8 public boolean isNew(

返回是否为一个新的客户端,或者客户端是否拒绝加入session
9 public void removeAttribute(String name)

移除session中指定名称的对象
10 public void setAttribute(String name, Object value) 

使用指定的名称和值来产生一个对象并绑定到session中
11 public void setMaxInactiveInterval(int interval)

用来指定时间,以秒为单位,servlet容器将会在这段时间内保持会话有效

JSP Session应用

这个例子描述了如何使用HttpSession对象来获取创建时间和最后一次访问时间。我们将会为request对象关联一个新的session对象,如果这个对象尚未存在的话。

<%@ page import="java.io.*,java.util.*" %><%    // 获取session创建时间    Date createTime = new Date(session.getCreationTime());    // 获取最后访问页面的时间    Date lastAccessTime = new Date(session.getLastAccessedTime());     String title = "Welcome Back to my website";    Integer visitCount = new Integer(0);    String visitCountKey = new String("visitCount");    String userIDKey = new String("userID");    String userID = new String("ABCD");     // 检测网页是否由新的访问用户    if (session.isNew()){       title = "Welcome to my website";       session.setAttribute(userIDKey, userID);       session.setAttribute(visitCountKey,  visitCount);    }     visitCount = (Integer)session.getAttribute(visitCountKey);    visitCount = visitCount + 1;    userID = (String)session.getAttribute(userIDKey);    session.setAttribute(visitCountKey,  visitCount); %><html><head><title>Session Tracking</title></head><body><center><h1>Session Tracking</h1></center><table border="1" align="center"> <tr bgcolor="#949494">   <th>Session info</th>   <th>Value</th></tr> <tr>   <td>id</td>   <td><% out.print( session.getId()); %></td></tr> <tr>   <td>Creation Time</td>   <td><% out.print(createTime); %></td></tr> <tr>   <td>Time of Last Access</td>   <td><% out.print(lastAccessTime); %></td></tr> <tr>   <td>User ID</td>   <td><% out.print(userID); %></td></tr> <tr>   <td>Number of visits</td>   <td><% out.print(visitCount); %></td></tr> </table> </body></html>

试着访问http://localhost:8080/main.jsp ,第一次运行时将会得到如下结果:


再次访问,将会得到如下结果:



删除Session数据

当处理完一个用户的会话数据后,您可以有如下选择:

  • 移除一个特定的属性:

    调用public void removeAttribute(String name)  方法来移除指定的属性。

  • 删除整个会话:

    调用public void invalidate() 方法来使整个session无效。

  • 设置会话有效期:

    调用 public void setMaxInactiveInterval(int interval)  方法来设置session超时。

  • 登出用户:

    支持servlet2.4版本的服务器,可以调用 logout()方法来登出用户,并且使所有相关的session无效。

  • 配置web.xml文件:

    如果使用的是Tomcat,可以向下面这样配置web.xml文件:

  <session-config>    <session-timeout>15</session-timeout>  </session-config>

超时以分钟为单位,Tomcat中的默认的超时时间是30分钟。

Servlet中的getMaxInactiveInterval( ) 方法以秒为单位返回超时时间。如果在web.xml中配置的是15分钟,则getMaxInactiveInterval( ) 方法将会返回900。


使用JSP最重要的优势之一,就是可以使用所有Java  API。本章将会详细地讲述Java中的Date类,它在java.util包下,封装了当前日期和时间。

Date类有两个构造函数。第一个构造函数使用当前日期和时间来初始化对象。

Date( )

第二个构造函数接受一个参数,这个参数表示从1970年1月1日凌晨至所要表示时间的毫秒数。

Date(long millisec)

获取Date对象后,您就能够使用下表列出的所有方法:

序号 方法 & 描述
1 boolean after(Date date)

如果比给定的日期晚,则返回true,否则返回false
2 boolean before(Date date)

如果比给定的日期早,则返回true,否则返回false
3 Object clone( )

获取当前对象的一个副本
4 int compareTo(Date date)

如果与给定日期相等,则返回0,如果比给定日期早,则返回一个负数,如果比给定日期晚,则返回一个正数
5 int compareTo(Object obj)

与 compareTo(Date) 方法相同,如果 obj 不是Date类或其子类的对象,抛出ClassCastException异常
6 boolean equals(Object date)

如果与给定日期相同,则返回true,否则返回false
7 long getTime( )

返回从1970年1月1日凌晨至此对象所表示时间的毫秒数
8 int hashCode( )

返回此对象的哈希码
9 void setTime(long time)

使用给定参数设置时间和日期,参数time表示从1970年1月1日凌晨至time所经过的毫秒数
10 String toString( )

将此对象转换为字符串并返回这个字符串

获取当前日期和时间

使用JSP编程可以很容易的获取当前日期和时间,只要使用Date对象的toString()方法就行了,就像下面这样:

<%@ page import="java.io.*,java.util.*, javax.servlet.*" %><html><head><title>Display Current Date & Time</title></head><body><center><h1>Display Current Date & Time</h1></center><%    Date date = new Date();    out.print( "<h2 align="center">" +date.toString()+"</h2>");%></body></html>

将上面的代码保存在CurrentDate.jsp文件中,然后访问http://localhost:8080/CurrentDate.jsp,运行结果如下:

Display Current Date & TimeMon Jun 21 21:46:49 GMT+04:00 2013

刷新http://localhost:8080/CurrentDate.jsp,就可以发现每次刷新所得到的秒数都不相同。


日期比较

就像我在开头所提到的,您可以在JSP脚本中使用任何Java方法。如果您想要比较两个日期,

可以参照下面的方法来做:

  • 使用getTime()方法得到毫秒数,然后比较毫秒数就行了。
  • 使用before(),after(),equals()方法。比如,new Date(99,2,12).before(new Date(99,2,18))返回true。
  • 使用compareTo()方法,这个方法在Comparable接口中定义,在Date中实现。

使用SimpleDateFormat格式化日期

SimpleDateFormat使用一种地区敏感的方式来格式化和解析日期,它允许您使用自定义的模式来格式化日期和时间。

对CurrentDate.jsp稍作修改,得到如下修改后的代码:

<%@ page import="java.io.*,java.util.*" %><%@ page import="javax.servlet.*,java.text.*" %><html><head><title>Display Current Date & Time</title></head><body><center><h1>Display Current Date & Time</h1></center><%    Date dNow = new Date( );    SimpleDateFormat ft = new SimpleDateFormat ("E yyyy.MM.dd 'at' hh:mm:ss a zzz");    out.print( "<h2 align="center">" + ft.format(dNow) + "</h2>");%></body></html>

再次编译CurrentDate.jsp,然后访问http://localhost:8080/CurrentDate.jsp,就可以得到如下结果:

Display Current Date & TimeMon 2013.06.21 at 10:06:44 PM GMT+04:00

SimpleDateFormat格式码

要指定模式字符串,需要使用下表列出的格式码:

字符 描述 示例
G 时代标识符 AD
y 4位数年份 2001
M July or 07
d 10
h 12小时制, A.M./P.M. (1~12) 12
H 24小时制 22
m 分钟 30
s 55
S 毫秒 234
E 星期 Tuesday
D 一年中的某天 360
F 一个月中某星期的某天 2 (second Wed. in July)
w 一年中的某星期 40
W 一个月中的某星期 1
a A.M./P.M. 标记 PM
k 一天中的某个小时 (1~24) 24
K 一天中的某个小时,A.M./P.M. (0~11) 10
z 时区 Eastern Standard Time
' 文本分隔 Delimiter
" 单引号 `

更多关于Date类的详细信息请查阅Java API文档。


当需要将文档移动到一个新的位置时,就需要使用JSP重定向了。

最简单的重定向方式就是使用response对象的sendRedirect()方法。这个方法的签名如下:

public void response.sendRedirect(String location)throws IOException 

这个方法将状态码和新的页面位置作为响应发回给浏览器。您也可以使用setStatus()和setHeader()方法来得到同样的效果:

....String site = "http://www.51coolma.cn" ;response.setStatus(response.SC_MOVED_TEMPORARILY);response.setHeader("Location", site); ....

实例演示

这个例子表明了JSP如何进行页面重定向:

<%@ page import="java.io.*,java.util.*" %><html><head><title>Page Redirection</title></head><body><center><h1>Page Redirection</h1></center><%    // 重定向到新地址    String site = new String("http://www.51coolma.cn");    response.setStatus(response.SC_MOVED_TEMPORARILY);    response.setHeader("Location", site);  %></body></html>

将以上代码保存在PageRedirecting.jsp文件中,然后访问http://localhost:8080/PageRedirect.jsp,它将会把您带至//www.51coolma.cn/


有时候我们需要知道某个页面被访问的次数,这时我们就需要在页面上添加页面统计器,页面访问的统计一般在用户第一次载入时累加该页面的访问数上。

要实现一个计数器,您可以利用应用程序隐式对象和相关方法getAttribute()和setAttribute()来实现。

这个对象表示JSP页面的整个生命周期中。当JSP页面初始化时创建此对象,当JSP页面调用jspDestroy()时删除该对象。

以下是在应用中创建变量的语法:

application.setAttribute(String Key, Object Value);

您可以使用上述方法来设置一个计数器变量及更新该变量的值。读取该变量的方法如下:

application.getAttribute(String Key);

在页面每次被访问时,你可以读取计数器的当前值,并递增1,然后重新设置,在下一个用户访问时就将新的值显示在页面上。


实例演示

该实例将介绍如何使用JSP来计算特定页面访问的总人数。如果你要计算你网站使用页面的总点击量,那么你就必须将该代码放在所有的JSP页面上。

<%@ page import="java.io.*,java.util.*" %><html><head><title>Applcation object in JSP</title></head><body><%     Integer hitsCount = (Integer)application.getAttribute("hitCounter");     if( hitsCount ==null || hitsCount == 0 ){            /* 第一次访问 */            out.println("Welcome to my website!");            hitsCount = 1;     }else{            /* 返回访问值 */            out.println("Welcome back to my website!");            hitsCount += 1;     }         application.setAttribute("hitCounter", hitsCount); %><center><p>Total number of visits: <%= hitsCount%></p></center></body></html>

现在我们将上面的代码放置于main.jsp文件上,并访问http://localhost:8080/main.jsp文件。你会看到页面会生成个计数器,在我们每次刷新页面时,计数器都会发生变化(每次刷新增加1)。 你也可以通过不同的浏览器访问,计数器会在每次访问后增加1。如下所示:

Welcome back to my website!Total number of visits: 12

复位计数器

使用以上方法,在web服务器重启后,计数器会被复位为0,即前面保留的数据都会消失,你可以使用一下几种方式解决该问题:

  • 在数据库中定义一个用于统计网页访问量的数据表count,字段为hitcount,hitcount默认值为0,将统计数据写入到数据表中。
  • 在每次访问时我们读取表中hitcount字段。

  • 每次访问时让hitcount自增1。
  • 在页面上显示新的 hitcount 值作为页面的访问量。

  • 如果你需要统计每个页面的访问量,你可以使用以上逻辑将代码添加到所有页面上。


想象一下,如果要直播比赛的比分,或股票市场的实时状态,或当前的外汇配给,该怎么实现呢?显然,要实现这种实时功能,您就不得不规律性地刷新页面。

JSP提供了一种机制来使这种工作变得简单,它能够定时地自动刷新页面。

刷新一个页面最简单的方式就是使用response对象的setIntHeader()方法。这个方法的签名如下:

public void setIntHeader(String header, int headerValue)

这个方法通知浏览器在给定的时间后刷新,时间以秒为单位。


页面自动刷新程序示例

这个例子使用了setIntHeader()方法来设置刷新头,模拟一个数字时钟:

<%@ page import="java.io.*,java.util.*" %><html><head><title>Auto Refresh Header Example</title></head><body><center><h2>Auto Refresh Header Example</h2><%    // Set refresh, autoload time as 5 seconds    response.setIntHeader("Refresh", 5);    // Get current time    Calendar calendar = new GregorianCalendar();    String am_pm;    int hour = calendar.get(Calendar.HOUR);    int minute = calendar.get(Calendar.MINUTE);    int second = calendar.get(Calendar.SECOND);    if(calendar.get(Calendar.AM_PM) == 0)       am_pm = "AM";    else       am_pm = "PM";    String CT = hour+":"+ minute +":"+ second +" "+ am_pm;    out.println("Crrent Time: " + CT + "
"); %></center></body></html>

把以上代码保存在main.jsp文件中,访问它。它会每隔5秒钟刷新一次页面并获取系统当前时间。运行结果如下:

Auto Refresh Header ExampleCurrent Time is: 9:44:50 PM

您也可以自己动手写个更复杂点的程序。


虽然使用JSP实现邮件发送功能很简单,但是需要有JavaMail API,并且需要安装JavaBean Activation Framework。

下载并解压这些文件,在根目录下,您将会看到一系列jar包。将mail.jar包和activation.jar包加入CLASSPATH变量中。

发送一封简单的邮件

这个例子展示了如何从您的机器发送一封简单的邮件。它假定localhost已经连接至网络并且有能力发送一封邮件。与此同时,请再一次确认mail.jar包和activation.jar包已经添加进CLASSPATH变量中。

<%@ page import="java.io.*,java.util.*,javax.mail.*"%><%@ page import="javax.mail.internet.*,javax.activation.*"%><%@ page import="javax.servlet.http.*,javax.servlet.*" %><%    String result;    // 收件人的电子邮件    String to = "abcd@gmail.com";     // 发件人的电子邮件    String from = "mcmohd@gmail.com";     // 假设你是从本地主机发送电子邮件    String host = "localhost";     // 获取系统属性对象    Properties properties = System.getProperties();     // 设置邮件服务器    properties.setProperty("mail.smtp.host", host);     // 获取默认的Session对象。    Session mailSession = Session.getDefaultInstance(properties);     try{       // 创建一个默认的MimeMessage对象。       MimeMessage message = new MimeMessage(mailSession);       // 设置 From: 头部的header字段       message.setFrom(new InternetAddress(from));       // 设置 To: 头部的header字段       message.addRecipient(Message.RecipientType.TO,                                new InternetAddress(to));       // 设置 Subject: header字段       message.setSubject("This is the Subject Line!");       // 现在设置的实际消息       message.setText("This is actual message");       // 发送消息       Transport.send(message);       result = "Sent message successfully....";    }catch (MessagingException mex) {       mex.printStackTrace();       result = "Error: unable to send message....";    } %><html><head><title>Send Email using JSP</title></head><body><center><h1>Send Email using JSP</h1></center><p align="center"><%     out.println("Result: " + result + "
"); %></p></body></html>

现在访问http://localhost:8080/SendEmail.jsp,它将会发送一封邮件给abcd@gmail.com 并显示如下结果:

Send Email using JSPResult: Sent message successfully....

如果想要把邮件发送给多人,下面列出的方法可以用来指明多个邮箱地址:

void addRecipients(Message.RecipientType type,                    Address[] addresses)throws MessagingException

参数的描述如下:

  • type:这个值将会被设置成TO,CC,或BCC。CC代表副本,BCC代表黑色副本,例子程序中使用的是TO。
  • addresses:这是一个邮箱地址的数组,当指定邮箱地址时需要使用InternetAddress()方法。

发送一封HTML邮件

这个例子发送一封简单的HTML邮件。它假定您的localhost已经连接至网络并且有能力发送邮件。与此同时,请再一次确认mail.jar包和activation.jar包已经添加进CLASSPATH变量中。

这个例子和前一个例子非常相似,不过在这个例子中我们使用了setContent()方法,将"text/html"做为第二个参数传给它,用来表明消息中包含了HTML内容。

<%@ page import="java.io.*,java.util.*,javax.mail.*"%><%@ page import="javax.mail.internet.*,javax.activation.*"%><%@ page import="javax.servlet.http.*,javax.servlet.*" %><%    String result;    // 收件人的电子邮件    String to = "abcd@gmail.com";     // 发件人的电子邮件    String from = "mcmohd@gmail.com";     // 假设你是从本地主机发送电子邮件    String host = "localhost";     // 获取系统属性对象    Properties properties = System.getProperties();     // 设置邮件服务器    properties.setProperty("mail.smtp.host", host);     // 获取默认的Session对象。    Session mailSession = Session.getDefaultInstance(properties);     try{       // 创建一个默认的MimeMessage对象。       MimeMessage message = new MimeMessage(mailSession);       // 设置 From: 头部的header字段       message.setFrom(new InternetAddress(from));       // 设置 To: 头部的header字段       message.addRecipient(Message.RecipientType.TO,                                new InternetAddress(to));       // 设置 Subject: header字段       message.setSubject("This is the Subject Line!");             // 设置 HTML消息       message.setContent("<h1>This is actual message</h1>","text/html" );      // 发送消息      Transport.send(message);      result = "Sent message successfully....";   }catch (MessagingException mex) {      mex.printStackTrace();      result = "Error: unable to send message....";   }%><html><head><title>Send HTML Email using JSP</title></head><body><center><h1>Send Email using JSP</h1></center><p align="center"><%     out.println("Result: " + result + "
"); %></p></body></html>

现在你可以尝试使用以上JSP文件来发送HTML消息的电子邮件。


在邮件中包含附件

这个例子告诉我们如何发送一封包含附件的邮件。

<%@ page import="java.io.*,java.util.*,javax.mail.*"%><%@ page import="javax.mail.internet.*,javax.activation.*"%><%@ page import="javax.servlet.http.*,javax.servlet.*" %><%    String result;    // 收件人的电子邮件    String to = "abcd@gmail.com";     // 发件人的电子邮件    String from = "mcmohd@gmail.com";     // 假设你是从本地主机发送电子邮件    String host = "localhost";     // 获取系统属性对象    Properties properties = System.getProperties();     // 设置邮件服务器    properties.setProperty("mail.smtp.host", host);     // 获取默认的Session对象。    Session mailSession = Session.getDefaultInstance(properties);     try{       // 创建一个默认的MimeMessage对象。       MimeMessage message = new MimeMessage(mailSession);        // 设置 From: 头部的header字段       message.setFrom(new InternetAddress(from));        // 设置 To: 头部的header字段       message.addRecipient(Message.RecipientType.TO,                                new InternetAddress(to));        // 设置 Subject: header字段       message.setSubject("This is the Subject Line!");        // 创建消息部分       BodyPart messageBodyPart = new MimeBodyPart();        // 填充消息       messageBodyPart.setText("This is message body");              // 创建多媒体消息       Multipart multipart = new MimeMultipart();        // 设置文本消息部分       multipart.addBodyPart(messageBodyPart);        // 附件部分       messageBodyPart = new MimeBodyPart();       String filename = "file.txt";       DataSource source = new FileDataSource(filename);       messageBodyPart.setDataHandler(new DataHandler(source));       messageBodyPart.setFileName(filename);       multipart.addBodyPart(messageBodyPart);        // 发送完整消息       message.setContent(multipart );        // 发送消息       Transport.send(message);       String title = "Send Email";       result = "Sent message successfully....";    }catch (MessagingException mex) {       mex.printStackTrace();       result = "Error: unable to send message....";    } %><html><head><title>Send Attachement Email using JSP</title></head><body><center><h1>Send Attachement Email using JSP</h1></center><p align="center"><%     out.println("Result: " + result + "
"); %></p></body></html>

用户认证部分

如果邮件服务器需要用户名和密码来进行用户认证的话,可以像下面这样来设置:

 props.setProperty("mail.user", "myuser"); props.setProperty("mail.password", "mypwd");

使用表单发送邮件

使用HTML表单接收一封邮件,并通过request对象获取所有邮件信息:

String to = request.getParameter("to");String from = request.getParameter("from");String subject = request.getParameter("subject");String messageText = request.getParameter("body");

获取以上信息后,您就可以使用前面提到的例子来发送邮件了。


JSP标准标签库(JSTL)是一个JSP标签集合,它封装了JSP应用的通用核心功能。

JSTL支持通用的、结构化的任务,比如迭代,条件判断,XML文档操作,国际化标签,SQL标签。 除了这些,它还提供了一个框架来使用集成JSTL的自定义标签。

根据JSTL标签所提供的功能,可以将其分为5个类别。

  • 核心标签
  • 格式化标签
  • SQL 标签
  • XML 标签
  • JSTL 函数

JSTL 库安装

Apache Tomcat安装JSTL 库步骤如下:

  • 从Apache的标准标签库中下载的二进包(jakarta-taglibs-standard-current.zip)。下载地址:http://archive.apache.org/dist/jakarta/taglibs/standard/binaries/
  • 下载jakarta-taglibs-standard-1.1.1.zip 包并解压,将jakarta-taglibs-standard-1.1.1/lib/下的两个jar文件:standard.jar和jstl.jar文件拷贝到/WEB-INF/lib/下。
  • 接下来我们在 web.xml 文件中添加以下配置:

    ……	<jsp-config>	<taglib>	<taglib-uri>http://java.sun.com/jstl/fmt</taglib-uri>	<taglib-location>/WEB-INF/fmt.tld</taglib-location>	</taglib>	<taglib>	<taglib-uri>http://java.sun.com/jstl/fmt-rt</taglib-uri>	<taglib-location>/WEB-INF/fmt-rt.tld</taglib-location>	</taglib>	<taglib>	<taglib-uri>http://java.sun.com/jstl/core</taglib-uri>	<taglib-location>/WEB-INF/c.tld</taglib-location>	</taglib>	<taglib>	<taglib-uri>http://java.sun.com/jstl/core-rt</taglib-uri>	<taglib-location>/WEB-INF/c-rt.tld</taglib-location>	</taglib>	<taglib>	<taglib-uri>http://java.sun.com/jstl/sql</taglib-uri>	<taglib-location>/WEB-INF/sql.tld</taglib-location>	</taglib>	<taglib>	<taglib-uri>http://java.sun.com/jstl/sql-rt</taglib-uri>	<taglib-location>/WEB-INF/sql-rt.tld</taglib-location>	</taglib>	<taglib>	<taglib-uri>http://java.sun.com/jstl/x</taglib-uri>	<taglib-location>/WEB-INF/x.tld</taglib-location>	</taglib>	<taglib>	<taglib-uri>http://java.sun.com/jstl/x-rt</taglib-uri>	<taglib-location>/WEB-INF/x-rt.tld</taglib-location>	</taglib>	</jsp-config>……

    使用任何库,你必须在每个JSP文件中的头部包含<taglib>标签。


核心标签

核心标签是最常用的JSTL标签。引用核心标签库的语法如下:

<%@ taglib prefix="c"                       uri="http://java.sun.com/jsp/jstl/core" %>
标签 描述
<c:out> 用于在JSP中显示数据,就像<%= ... >
<c:set> 用于保存数据
<c:remove> 用于删除数据
<c:catch> 用来处理产生错误的异常状况,并且将错误信息储存起来
<c:if> 与我们在一般程序中用的if一样
<c:choose> 本身只当做<c:when>和<c:otherwise>的父标签
<c:when> <c:choose>的子标签,用来判断条件是否成立
<c:otherwise> <c:choose>的子标签,接在<c:when>标签后,当<c:when>标签判断为false时被执行
<c:import> 检索一个绝对或相对 URL,然后将其内容暴露给页面
<c:forEach> 基础迭代标签,接受多种集合类型
<c:forTokens> 根据指定的分隔符来分隔内容并迭代输出
<c:param> 用来给包含或重定向的页面传递参数
<c:redirect> 重定向至一个新的URL.
<c:url> 使用可选的查询参数来创造一个URL

格式化标签

JSTL格式化标签用来格式化并输出文本、日期、时间、数字。引用格式化标签库的语法如下:

<%@ taglib prefix="fmt"            uri="http://java.sun.com/jsp/jstl/fmt" %>

标签 描述
<fmt:formatNumber> 使用指定的格式或精度格式化数字
<fmt:parseNumber> 解析一个代表着数字,货币或百分比的字符串
<fmt:formatDate> 使用指定的风格或模式格式化日期和时间
<fmt:parseDate> 解析一个代表着日期或时间的字符串
<fmt:bundle> 绑定资源
<fmt:setLocale> 指定地区
<fmt:setBundle> 绑定资源
<fmt:timeZone> 指定时区
<fmt:setTimeZone> 指定时区
<fmt:message> 显示资源配置文件信息
<fmt:requestEncoding> 设置request的字符编码

SQL标签

JSTL SQL标签库提供了与关系型数据库(Oracle,MySQL,SQL Server等等)进行交互的标签。引用SQL标签库的语法如下:

<%@ taglib prefix="sql"                        uri="http://java.sun.com/jsp/jstl/sql" %>
标签 描述
<sql:setDataSource> 指定数据源
<sql:query> 运行SQL查询语句
<sql:update> 运行SQL更新语句
<sql:param> 将SQL语句中的参数设为指定值
<sql:dateParam> 将SQL语句中的日期参数设为指定的java.util.Date 对象值
<sql:transaction> 在共享数据库连接中提供嵌套的数据库行为元素,将所有语句以一个事务的形式来运行

XML 标签

JSTL XML标签库提供了创建和操作XML文档的标签。引用XML标签库的语法如下:

<%@ taglib prefix="x"                        uri="http://java.sun.com/jsp/jstl/xml" %>

在使用xml标签前,你必须将XML 和 XPath 的相关包拷贝至你的<Tomcat 安装目录>lib下:

标签 描述
<x:out> 与<%= ... >,类似,不过只用于XPath表达式
<x:parse> 解析 XML 数据
<x:set> 设置XPath表达式
<x:if> 判断XPath表达式,若为真,则执行本体中的内容,否则跳过本体
<x:forEach> 迭代XML文档中的节点
<x:choose> <x:when>和<x:otherwise>的父标签
<x:when> <x:choose>的子标签,用来进行条件判断
<x:otherwise> <x:choose>的子标签,当<x:when>判断为false时被执行
<x:transform> 将XSL转换应用在XML文档中
<x:param> 与<x:transform>共同使用,用于设置XSL样式表

JSTL函数

JSTL包含一系列标准函数,大部分是通用的字符串处理函数。引用JSTL函数库的语法如下:

<%@ taglib prefix="fn"                        uri="http://java.sun.com/jsp/jstl/functions" %>
函数 描述
fn:contains() 测试输入的字符串是否包含指定的子串
fn:containsIgnoreCase() 测试输入的字符串是否包含指定的子串,大小写不敏感
fn:endsWith() 测试输入的字符串是否以指定的后缀结尾
fn:escapeXml() 跳过可以作为XML标记的字符
fn:indexOf() 返回指定字符串在输入字符串中出现的位置
fn:join() 将数组中的元素合成一个字符串然后输出
fn:length() 返回字符串长度
fn:replace() 将输入字符串中指定的位置替换为指定的字符串然后返回
fn:split() 将字符串用指定的分隔符分隔然后组成一个子字符串数组并返回
fn:startsWith() 测试输入字符串是否以指定的前缀开始
fn:substring() 返回字符串的子集
fn:substringAfter() 返回字符串在指定子串之后的子集
fn:substringBefore() 返回字符串在指定子串之前的子集
fn:toLowerCase() 将字符串中的字符转为小写
fn:toUpperCase() 将字符串中的字符转为大写
fn:trim() 移除首位的空白符


本章节假设您已经对JDBC有一定的了解。在开始学习JSP数据库访问前,请确保JDBC环境已经正确配置。

首先,让我们按照下面的步骤来创建一个简单的表并插入几条简单的记录:


创建表

在数据库中创建一个Employees表,步骤如下:

步骤1:

打开CMD,然后进入数据库安装目录:

C:>C:>cd Program FilesMySQLinC:Program FilesMySQLin>

步骤2:

C:Program FilesMySQLin>mysql -u root -pEnter password: ********mysql>

步骤3:

用create database语句建立一个新的数据库TEST:

mysql> create database TEST

步骤4:

在TEST数据库中创建Employee表:

mysql> use TEST;mysql> create table Employees    (     id int not null,     age int not null,     first varchar (255),     last varchar (255)    );Query OK, 0 rows affected (0.08 sec)mysql>

插入数据记录

创建好Employee表后,往表中插入几条记录:

mysql> INSERT INTO Employees VALUES (100, 18, 'Zara', 'Ali');Query OK, 1 row affected (0.05 sec) mysql> INSERT INTO Employees VALUES (101, 25, 'Mahnaz', 'Fatma');Query OK, 1 row affected (0.00 sec) mysql> INSERT INTO Employees VALUES (102, 30, 'Zaid', 'Khan');Query OK, 1 row affected (0.00 sec) mysql> INSERT INTO Employees VALUES (103, 28, 'Sumit', 'Mittal');Query OK, 1 row affected (0.00 sec) mysql>

SELECT操作

接下来的这个例子告诉我们如何使用JSTL SQL标签来运行SQL SELECT语句:

<%@ page language="java" contentType="text/html; charset=UTF-8"    pageEncoding="UTF-8"%><%@ page import="java.io.*,java.util.*,java.sql.*"%><%@ page import="javax.servlet.http.*,javax.servlet.*" %><%@ taglib uri="http://java.sun.com/jsp/jstl/core" prefix="c"%><%@ taglib uri="http://java.sun.com/jsp/jstl/sql" prefix="sql"%> <html><head><title>SELECT 操作</title></head><body> <sql:setDataSource var="snapshot" driver="com.mysql.jdbc.Driver"     url="jdbc:mysql://localhost:3306/TEST"     user="root"  password="pass123"/> <sql:query dataSource="${snapshot}" var="result">SELECT * from Employees;</sql:query> <table border="1" width="100%"><tr>   <th>Emp ID</th>   <th>First Name</th>   <th>Last Name</th>   <th>Age</th></tr><c:forEach var="row" items="${result.rows}"><tr>   <td><c:out value="${row.id}"/></td>   <td><c:out value="${row.first}"/></td>   <td><c:out value="${row.last}"/></td>   <td><c:out value="${row.age}"/></td></tr></c:forEach></table> </body></html>

访问这个JSP例子,运行结果如下:

mysql-access-1


INSERT操作

这个例子告诉我们如何使用JSTL SQL标签来运行SQL INSERT语句:

<%@ page language="java" contentType="text/html; charset=UTF-8"    pageEncoding="UTF-8"%><%@ page import="java.io.*,java.util.*,java.sql.*"%><%@ page import="javax.servlet.http.*,javax.servlet.*" %><%@ taglib uri="http://java.sun.com/jsp/jstl/core" prefix="c"%><%@ taglib uri="http://java.sun.com/jsp/jstl/sql" prefix="sql"%> <html><head><title>INSERT 操作</title></head><body> <sql:setDataSource var="snapshot" driver="com.mysql.jdbc.Driver"     url="jdbc:mysql://localhost/TEST"     user="root"  password="pass123"/><sql:update dataSource="${snapshot}" var="result">INSERT INTO Employees VALUES (104, 2, 'Nuha', 'Ali');</sql:update> <sql:query dataSource="${snapshot}" var="result">SELECT * from Employees;</sql:query> <table border="1" width="100%"><tr>   <th>Emp ID</th>   <th>First Name</th>   <th>Last Name</th>   <th>Age</th></tr><c:forEach var="row" items="${result.rows}"><tr>   <td><c:out value="${row.id}"/></td>   <td><c:out value="${row.first}"/></td>   <td><c:out value="${row.last}"/></td>   <td><c:out value="${row.age}"/></td></tr></c:forEach></table> </body></html>

访问这个JSP例子,运行结果如下:

mysql-access-2


DELETE操作

这个例子告诉我们如何使用JSTL SQL标签来运行SQL DELETE语句:

<%@ page language="java" contentType="text/html; charset=UTF-8"    pageEncoding="UTF-8"%><%@ page import="java.io.*,java.util.*,java.sql.*"%><%@ page import="javax.servlet.http.*,javax.servlet.*" %><%@ taglib uri="http://java.sun.com/jsp/jstl/core" prefix="c"%><%@ taglib uri="http://java.sun.com/jsp/jstl/sql" prefix="sql"%> <html><head><title>DELETE 操作</title></head><body> <sql:setDataSource var="snapshot" driver="com.mysql.jdbc.Driver"     url="jdbc:mysql://localhost/TEST"     user="root"  password="pass123"/> <c:set var="empId" value="103"/> <sql:update dataSource="${snapshot}" var="count">  DELETE FROM Employees WHERE Id = ?  <sql:param value="${empId}" /></sql:update> <sql:query dataSource="${snapshot}" var="result">   SELECT * from Employees;</sql:query> <table border="1" width="100%"><tr>   <th>Emp ID</th>   <th>First Name</th>   <th>Last Name</th>   <th>Age</th></tr><c:forEach var="row" items="${result.rows}"><tr>   <td><c:out value="${row.id}"/></td>   <td><c:out value="${row.first}"/></td>   <td><c:out value="${row.last}"/></td>   <td><c:out value="${row.age}"/></td></tr></c:forEach></table> </body></html>

访问这个JSP例子,运行结果如下:

mysql-access-3


UPDATE操作

这个例子告诉我们如何使用JSTL SQL标签来运行SQL UPDATE语句:

<%@ page language="java" contentType="text/html; charset=UTF-8"    pageEncoding="UTF-8"%><%@ page import="java.io.*,java.util.*,java.sql.*"%><%@ page import="javax.servlet.http.*,javax.servlet.*" %><%@ taglib uri="http://java.sun.com/jsp/jstl/core" prefix="c"%><%@ taglib uri="http://java.sun.com/jsp/jstl/sql" prefix="sql"%> <html><head><title>UPDATE 操作</title></head><body> <sql:setDataSource var="snapshot" driver="com.mysql.jdbc.Driver"     url="jdbc:mysql://localhost/TEST"     user="root"  password="pass123"/> <c:set var="empId" value="102"/> <sql:update dataSource="${snapshot}" var="count">  UPDATE Employees SET last = 'Ali' WHERE Id = ?  <sql:param value="${empId}" /></sql:update> <sql:query dataSource="${snapshot}" var="result">   SELECT * from Employees;</sql:query> <table border="1" width="100%"><tr>   <th>Emp ID</th>   <th>First Name</th>   <th>Last Name</th>   <th>Age</th></tr><c:forEach var="row" items="${result.rows}"><tr>   <td><c:out value="${row.id}"/></td>   <td><c:out value="${row.first}"/></td>   <td><c:out value="${row.last}"/></td>   <td><c:out value="${row.age}"/></td></tr></c:forEach></table> </body></html>

访问这个JSP例子,运行结果如下:



当通过HTTP发送XML数据时,就有必要使用JSP来处理传入和流出的XML文档了,比如RSS文档。作为一个XML文档,它仅仅只是一堆文本而已,使用JSP创建XML文档并不比创建一个HTML文档难。


使用JSP发送XML

使用JSP发送XML内容就和发送HTML内容一样。唯一的不同就是您需要把页面的context属性设置为text/xml。要设置context属性,使用<%@page % >命令,就像这样:

<%@ page contentType="text/xml" %>

接下来这个例子向浏览器发送XML内容:

<%@ page contentType="text/xml" %><books>   <book>      <name>Padam History</name>      <author>ZARA</author>      <price>100</price>   </book></books>

使用不同的浏览器来访问这个例子,看看这个例子所呈现的文档树。


在JSP中处理XML

在使用JSP处理XML之前,您需要将与XML 和XPath相关的两个库文件放在<Tomcat Installation Directory>lib目录下:

books.xml文件:

<books><book>  <name>Padam History</name>  <author>ZARA</author>  <price>100</price></book><book>  <name>Great Mistry</name>  <author>NUHA</author>  <price>2000</price></book></books>

main.jsp文件:

<%@ page language="java" contentType="text/html; charset=UTF-8"    pageEncoding="UTF-8"%><%@ taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core" %><%@ taglib prefix="x" uri="http://java.sun.com/jsp/jstl/xml" %> <html><head>  <title>JSTL x:parse Tags</title></head><body><h3>Books Info:</h3><c:import var="bookInfo" url="http://localhost:8080/books.xml"/> <x:parse xml="${bookInfo}" var="output"/><b>The title of the first book is</b>: <x:out select="$output/books/book[1]/name" /><br><b>The price of the second book</b>: <x:out select="$output/books/book[2]/price" /> </body></html>

访问http://localhost:8080/main.jsp,运行结果如下:

BOOKS INFO:The title of the first book is:Padam History The price of the second book: 2000

使用JSP格式化XML

这个是XSLT样式表style.xsl文件:

<?xml version="1.0"?><xsl:stylesheet xmlns:xsl= "http://www.w3.org/1999/XSL/Transform" version="1.0"> <xsl:output method="html" indent="yes"/> <xsl:template match="/">  <html>  <body>   <xsl:apply-templates/>  </body>  </html></xsl:template> <xsl:template match="books">  <table border="1" width="100%">    <xsl:for-each select="book">      <tr>        <td>          <i><xsl:value-of select="name"/></i>        </td>        <td>          <xsl:value-of select="author"/>        </td>        <td>          <xsl:value-of select="price"/>        </td>      </tr>    </xsl:for-each>  </table></xsl:template></xsl:stylesheet>

这个是main.jsp文件:

<%@ taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core" %><%@ taglib prefix="x" uri="http://java.sun.com/jsp/jstl/xml" %> <html><head>  <title>JSTL x:transform Tags</title></head><body><h3>Books Info:</h3><c:set var="xmltext">  <books>    <book>      <name>Padam History</name>      <author>ZARA</author>      <price>100</price>    </book>    <book>      <name>Great Mistry</name>      <author>NUHA</author>      <price>2000</price>    </book>  </books></c:set> <c:import url="http://localhost:8080/style.xsl" var="xslt"/><x:transform xml="${xmltext}" xslt="${xslt}"/> </body></html>

运行结果如下:

更多关于使用JSTL处理XML的内容请查阅JSP标准标签库


JavaBean是特殊的Java类,是用Java语言写成的可重用组件,并且遵守JavaBeans API规范。

接下来给出的是JavaBean与其它Java类相比而言独一无二的特征:

  • 提供一个默认的无参构造函数。
  • 需要被序列化并且实现了Serializable接口。
  • 可能有一系列可读写属性。
  • 可能有一系列的"getter"或"setter"方法。

JavaBeans属性

一个JavaBean对象的属性应该是可访问的。这个属性可以是任意合法的Java数据类型,包括自定义Java类。

一个JavaBean对象的属性可以是可读写,或只读,或只写。JavaBean对象的属性通过JavaBean实现类中提供的两个方法来访问:

方法 描述
getPropertyName() 举例来说,如果属性的名称为myName,那么这个方法的名字就要写成getMyName()来读取这个属性。这个方法也称为访问器。
setPropertyName() 举例来说,如果属性的名称为myName,那么这个方法的名字就要写成setMyName()来写入这个属性。这个方法也称为写入器。

一个只读的属性只提供getPropertyName()方法,一个只写的属性只提供setPropertyName()方法。


JavaBeans程序示例

这是StudentBean.java文件:

package com.tutorialspoint;public class StudentsBean implements java.io.Serializable{   private String firstName = null;   private String lastName = null;   private int age = 0;   public StudentsBean() {   }   public String getFirstName(){      return firstName;   }   public String getLastName(){      return lastName;   }   public int getAge(){      return age;   }   public void setFirstName(String firstName){      this.firstName = firstName;   }   public void setLastName(String lastName){      this.lastName = lastName;   }   public void setAge(Integer age){      this.age = age;   }}

编译StudentBean.java文件,在本章最后的例子中将会使用到它。


访问JavaBeans

<jsp:useBean>标签可以在JSP中声明一个JavaBean,然后使用。声明后,JavaBean对象就成了脚本变量,可以通过脚本元素或其他自定义标签来访问。<jsp:useBean>标签的语法格式如下:

<jsp:useBean id="bean's name" scope="bean's scope" typeSpec/>

其中,根据具体情况,scope的值可以是page,request,session或application。id值可任意只要不和同一JSP文件中其它<jsp:useBean>中id值一样就行了。

接下来给出的是<jsp:useBean>标签的一个简单的用法:

<html><head><title>useBean Example</title></head><body><jsp:useBean id="date" class="java.util.Date" /> <p>The date/time is <%= date %></body></html>

它将会产生如下结果:

The date/time is Thu Sep 30 11:18:11 GST 2013

访问JavaBeans对象的属性

在<jsp:useBean>标签主体中使用<jsp:getProperty/>标签来调用getter方法,使用<jsp:setProperty/>标签来调用setter方法,语法格式如下:

<jsp:useBean id="id" class="bean's class" scope="bean's scope">   <jsp:setProperty name="bean's id" property="property name"                       value="value"/>   <jsp:getProperty name="bean's id" property="property name"/>   ...........</jsp:useBean>

name属性指的是Bean的id属性。property属性指的是想要调用的getter或setter方法。

接下来给出使用以上语法进行属性访问的一个简单例子:

<html><head><title>get and set properties Example</title></head><body><jsp:useBean id="students"                      class="com.tutorialspoint.StudentsBean">    <jsp:setProperty name="students" property="firstName"                     value="Zara"/>   <jsp:setProperty name="students" property="lastName"                      value="Ali"/>   <jsp:setProperty name="students" property="age"                      value="10"/></jsp:useBean><p>Student First Name:    <jsp:getProperty name="students" property="firstName"/></p><p>Student Last Name:    <jsp:getProperty name="students" property="lastName"/></p><p>Student Age:    <jsp:getProperty name="students" property="age"/></p></body></html>

将StudentBean.class加入CLASSPATH环境变量中,然后访问以上JSP,运行结果如下:

Student First Name: Zara Student Last Name: Ali Student Age: 10 


自定义标签是用户定义的JSP语言元素。当JSP页面包含一个自定义标签时将被转化为servlet,标签转化为对被 称为tag handler的对象的操作,即当servlet执行时Web container调用那些操作。

JSP标签扩展可以让你创建新的标签并且可以直接插入到一个JSP页面。 JSP 2.0规范中引入Simple Tag Handlers来编写这些自定义标记。

你可以继承SimpleTagSupport类并重写的doTag()方法来开发一个最简单的自定义标签。


创建"Hello"标签

接下来,我们想创建一个自定义标签叫作<ex:Hello>,标签格式为:

<ex:Hello />

要创建自定义的JSP标签,你首先必须创建处理标签的Java类。所以,让我们创建一个HelloTag类,如下所示:

package com.tutorialspoint;import javax.servlet.jsp.tagext.*;import javax.servlet.jsp.*;import java.io.*;public class HelloTag extends SimpleTagSupport {  public void doTag() throws JspException, IOException {    JspWriter out = getJspContext().getOut();    out.println("Hello Custom Tag!");  }}

以下代码重写了doTag()方法,方法中使用了getJspContext()方法来获取当前的JspContext对象,并将"Hello Custom Tag!"传递给JspWriter对象。

编译以上类,并将其复制到环境变量CLASSPATH目录中。最后创建如下标签库:<Tomcat安装目录>webappsROOTWEB-INFcustom.tld。

<taglib>  <tlib-version>1.0</tlib-version>  <jsp-version>2.0</jsp-version>  <short-name>Example TLD</short-name>  <tag>    <name>Hello</name>    <tag-class>com.tutorialspoint.HelloTag</tag-class>    <body-content>empty</body-content>  </tag></taglib>

接下来,我们就可以在JSP文件中使用Hello标签:

<%@ taglib prefix="ex" uri="WEB-INF/custom.tld"%><html>  <head>    <title>A sample custom tag</title>  </head>  <body>    <ex:Hello/>  </body></html>

以上程序输出结果为:

Hello Custom Tag!

访问标签体

你可以像标准标签库一样在标签中包含消息内容。如我们要在我们自定义的Hello中包含内容,格式如下:

<ex:Hello>   This is message body</ex:Hello>

我们可以修改标签处理类文件,代码如下:

package com.tutorialspoint;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文件,如下所示:

<taglib>  <tlib-version>1.0</tlib-version>  <jsp-version>2.0</jsp-version>  <short-name>Example TLD with Body</short-name>  <tag>    <name>Hello</name>    <tag-class>com.tutorialspoint.HelloTag</tag-class>    <body-content>scriptless</body-content>  </tag></taglib>

现在我们可以在JSP使用修改后的标签,如下所示:

<%@ taglib prefix="ex" uri="WEB-INF/custom.tld"%><html>  <head>    <title>A sample custom tag</title>  </head>  <body>    <ex:Hello>        This is message body    </ex:Hello>  </body></html>

以上程序输出结果如下所示:

This is message body

自定义标签属性

你可以在自定义标准中设置各种属性,要接收属性,值自定义标签类必须实现setter方法, JavaBean 中的setter方法如下所示:

package com.tutorialspoint;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文件中使用的<attribute>元素添加此属性:

<taglib>  <tlib-version>1.0</tlib-version>  <jsp-version>2.0</jsp-version>  <short-name>Example TLD with Body</short-name>  <tag>    <name>Hello</name>    <tag-class>com.tutorialspoint.HelloTag</tag-class>    <body-content>scriptless</body-content>    <attribute>       <name>message</name>    </attribute>  </tag></taglib>

现在我们就可以在JSP文件中使用message属性了,如下所示:

<%@ taglib prefix="ex" uri="WEB-INF/custom.tld"%><html>  <head>    <title>A sample custom tag</title>  </head>  <body>    <ex:Hello message="This is custom tag" />  </body></html>

以上实例数据输出结果为:

This is custom tag

你还可以包含以下属性:

属性 描述
name定义属性的名称。每个标签的是属性名称必须是唯一的。
required指定属性是否是必须的或者可选的,如果设置为false为可选。
rtexprvalue声明在运行表达式时,标签属性是否有效。
type定义该属性的Java类类型 。默认指定为 String
description描述信息
fragment如果声明了该属性,属性值将被视为一个 JspFragment

以下是指定相关的属性实例:

.....    <attribute>      <name>attribute_name</name>      <required>false</required>      <type>java.util.Date</type>      <fragment>false</fragment>    </attribute>.....

如果你使用了两个属性,修改TLD文件,如下所示:

.....    <attribute>      <name>attribute_name1</name>      <required>false</required>      <type>java.util.Boolean</type>      <fragment>false</fragment>    </attribute>    <attribute>      <name>attribute_name2</name>      <required>true</required>      <type>java.util.Date</type>    </attribute>.....


JSP 表达式语言(EL)使得访问存储在 JavaBean 中的数据变得非常简单。JSP EL 既可以用来创建算术表达式也可以用来创建逻辑表达式。在 JSP EL 表达式内可以使用整型数,浮点数,字符串,常量 true、false,还有 null。


一个简单的语法

典型的,当您需要在 JSP 标签中指定一个属性值时,只需要简单地使用字符串即可:

<jsp:setProperty name="box" property="perimeter" value="100"/>

JSP EL 允许您指定一个表达式来表示属性值。一个简单的表达式语法如下:

${expr}

其中,​expr​ 指的是表达式。在 JSP EL 中通用的操作符是​"."​和​"[]"​。这两个操作符允许您通过内嵌的 JSP 对象访问各种各样的 ​JavaBean​ 属性。

举例来说,上面的​<jsp:setProperty>​标签可以使用表达式语言改写成如下形式:

<jsp:setProperty name="box" property="perimeter"                   value="${2*box.width+2*box.height}"/>

当 JSP 编译器在属性中见到"​${}​"格式后,它会产生代码来计算这个表达式,并且产生一个替代品来代替表达式的值。

您也可以在标签的模板文本中使用表达式语言。比如​<jsp:text>​标签简单地将其主体中的文本插入到 JSP 输出中:

<jsp:text><h1>Hello JSP!</h1></jsp:text>

现在,在​<jsp:text>​标签主体中使用表达式,就像这样:

<jsp:text>Box Perimeter is: ${2*box.width + 2*box.height}</jsp:text>

在EL表达式中可以使用圆括号来组织子表达式。比如​${(1 + 2) * 3}​等于9,但是​${1 + (2 * 3)} ​等于7。

想要停用对 EL 表达式的评估的话,需要使用 ​page ​指令将 ​isELIgnored​ 属性值设为​ true​:

<%@ page isELIgnored ="true|false" %>

这样,EL 表达式就会被忽略。若设为​false​,则容器将会计算 EL 表达式。


EL中的基础操作符

EL表达式支持大部分Java所提供的算术和逻辑操作符:

操作符 描述
. 访问一个​Bean​属性或者一个映射条目
[] 访问一个数组或者链表的元素
( ) 组织一个子表达式以改变优先级
+
- 减或负
*
/ or div
% or mod 取模
== or eq 测试是否相等
!= or ne 测试是否不等
< or lt 测试是否小于
> or gt 测试是否大于
<= or le 测试是否小于等于
>= or ge 测试是否大于等于
&& or and 测试逻辑与
|| or or 测试逻辑或
! or not 测试取反
empty 测试是否空值

JSP EL中的函数

JSP EL 允许您在表达式中使用函数。这些函数必须被定义在自定义标签库中。函数的使用语法如下:

${ns:func(param1, param2, ...)}

ns 指的是命名空间(namespace),​func​指的是函数的名称,​param1​指的是第一个参数,​param2​ 指的是第二个参数,以此类推。比如,有函数​fn:length​,在 JSTL 库中定义,可以像下面这样来获取一个字符串的长度:

${fn:length("Get my length")}

要使用任何标签库中的函数,您需要将这些库安装在服务器中,然后使用​<taglib>​标签在 JSP 文件中包含这些库。


JSP EL隐含对象

JSP EL支持下表列出的隐含对象:

隐含对象 描述
pageScope page 作用域
requestScope request 作用域
sessionScope session 作用域
applicationScope application 作用域
param Request 对象的参数,字符串
paramValues Request对象的参数,字符串集合
header HTTP 信息头,字符串
headerValues HTTP 信息头,字符串集合
initParam 上下文初始化参数
cookie Cookie值
pageContext 当前页面的pageContext

您可以在表达式中使用这些对象,就像使用变量一样。接下来会给出几个例子来更好的理解这个概念。


pageContext对象

pageContext​ 对象是 JSP 中 ​pageContext​ 对象的引用。通过 ​pageContext​ 对象,您可以访问 ​request​ 对象。比如,访问 ​request​ 对象传入的查询字符串,就像这样:

${pageContext.request.queryString}

Scope对象

pageScope​,​requestScope​,​sessionScope​,​applicationScope​ 变量用来访问存储在各个作用域层次的变量。

举例来说,如果您需要显式访问在 ​applicationScope​ 层的 ​box ​变量,可以这样来访问: ​applicationScope.box​。


param和paramValues对象

param​ 和 ​paramValues​ 对象用来访问参数值,通过使用 ​request.getParameter​ 方法和​ request.getParameterValues​ 方法。

举例来说,访问一个名为​ order​ 的参数,可以这样使用表达式:​${param.order}​,或者​${param["order"]}​。

接下来的例子表明了如何访问 request 中的​ username​ 参数:

<%@ page import="java.io.*,java.util.*" %><%     String title = "Accessing Request Param"; %><html><head><title><% out.print(title); %></title></head><body><center><h1><% out.print(title); %></h1></center><div align="center"><p>${param["username"]}</p></div></body></html>

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"; %><html><head><title><% out.print(title); %></title></head><body><center><h1><% out.print(title); %></h1></center><div align="center"><p>${header["user-agent"]}</p></div></body></html>

运行结果如下:

jsp-expression-language

header对象返回单一值,而headerValues则返回一个字符串数组。


当编写JSP程序的时候,程序员可能会遗漏一些BUG,这些BUG可能会出现在程序的任何地方。JSP代码中通常有以下几类异常:

  • 检查型异常:检查型异常就是一个典型的用户错误或者一个程序员无法预见的错误。举例来说,如果一个文件将要被打开,但是无法找到这个文件,则一个异常被抛出。这些异常不能再编译期被简单地忽略。
  • 运行时异常:一个运行时异常可能已经被程序员避免,这种异常在编译期将会被忽略。
  • 错误:这里没有异常,但问题是它超出了用户或者程序员的控制范围。错误通常会在代码中被忽略,您几乎不能拿它怎么样。举例来或,栈溢出错误。这些错误都会在编译期被忽略。

本节将会给出几个简单而优雅的方式来处理运行时异常和错误。


使用Exception对象

exception对象是Throwable子类的一个实例,只在错误页面中可用。下表列出了Throwable类中一些重要的方法:

序号 方法&描述
1 public String getMessage()

返回异常的信息。这个信息在Throwable构造函数中被初始化
2 public ThrowablegetCause()

返回引起异常的原因,类型为Throwable对象
3 public String toString()

返回类名
4 public void printStackTrace()

将异常栈轨迹输出至System.err
5 public StackTraceElement [] getStackTrace()

以栈轨迹元素数组的形式返回异常栈轨迹
6 public ThrowablefillInStackTrace()

使用当前栈轨迹填充Throwable对象

JSP提供了可选项来为每个JSP页面指定错误页面。无论何时页面抛出了异常,JSP容器都会自动地调用错误页面。

接下来的例子为main.jsp指定了一个错误页面。使用<%@page errorPage="XXXXX"%>指令指定一个错误页面。

<%@ page errorPage="ShowError.jsp" %><html><head>   <title>Error Handling Example</title></head><body><%    // Throw an exception to invoke the error page    int x = 1;    if (x == 1)    {       throw new RuntimeException("Error condition!!!");    } %></body></html>

现在,编写ShowError.jsp文件如下:

<%@ page isErrorPage="true" %><html><head><title>Show Error Page</title></head><body><h1>Opps...</h1><p>Sorry, an error occurred.</p><p>Here is the exception stack trace: </p><pre><% exception.printStackTrace(response.getWriter()); %>

注意到,ShowError.jsp文件使用了<%@page isErrorPage="true"%>指令,这个指令告诉JSP编译器需要产生一个异常实例变量。

现在试着访问main.jsp页面,它将会产生如下结果:

java.lang.RuntimeException: Error condition!!!......Opps...Sorry, an error occurred.Here is the exception stack trace:

在错误页面中使用JSTL标签

可以利用JSTL标签来编写错误页面ShowError.jsp。这个例子中的代码与上例代码的逻辑几乎一样,但是本例的代码有更好的结构,并且能够提供更多信息:

<%@ taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core" %><%@page isErrorPage="true" %><html><head><title>Show Error Page</title></head><body><h1>Opps...</h1><table width="100%" border="1"><tr valign="top"><td width="40%"><b>Error:</b></td><td>${pageContext.exception}</td></tr><tr valign="top"><td><b>URI:</b></td><td>${pageContext.errorData.requestURI}</td></tr><tr valign="top"><td><b>Status code:</b></td><td>${pageContext.errorData.statusCode}</td></tr><tr valign="top"><td><b>Stack trace:</b></td><td><c:forEach var="trace"           items="${pageContext.exception.stackTrace}"><p>${trace}</p></c:forEach></td></tr></table></body></html>

运行结果如下:

jsp-exeception-1


使用 try…catch块

如果您想要将异常处理放在一个页面中,并且对不同的异常进行不同的处理,那么您就需要使用try…catch块了。

接下来的这个例子显示了如何使用try…catch块,将这些代码放在main.jsp中:

<html><head>   <title>Try...Catch Example</title></head><body><%    try{       int i = 1;       i = i / 0;       out.println("The answer is " + i);    }    catch (Exception e){       out.println("An exception occurred: " + e.getMessage());    } %></body></html>

试着访问main.jsp,它将会产生如下结果:

An exception occurred: / by zero 


要测试/调试一个JSP或servlet程序总是那么的难。JSP和Servlets程序趋向于牵涉到大量客户端/服务器之间的交互,这很有可能会产生错误,并且很难重现出错的环境。

接下来将会给出一些小技巧和小建议,来帮助您调试程序。


使用System.out.println()

System.out.println()可以很方便地标记一段代码是否被执行。当然,我们也可以打印出各种各样的值。此外:

  • 自从System对象成为Java核心对象后,它便可以使用在任何地方而不用引入额外的类。使用范围包括Servlets,JSP,RMI,EJB's,Beans,类和独立应用。
  • 与在断点处停止运行相比,用System.out进行输出不会对应用程序的运行流程造成重大的影响,这个特点在定时机制非常重要的应用程序中就显得非常有用了。

接下来给出了使用System.out.println()的语法:

System.out.println("Debugging message");

这是一个使用System.out.print()的简单例子:

<%@taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core" %><html><head><title>System.out.println</title></head><body><c:forEach var="counter" begin="1" end="10" step="1" >   <c:out value="${counter-5}"/></br>   <% System.out.println( "counter= " +                       pageContext.findAttribute("counter") ); %></c:forEach></body></html>

现在,如果运行上面的例子的话,它将会产生如下的结果:

-4-3-2-1012345

如果使用的是Tomcat服务器,您就能够在logs目录下的stdout.log文件中发现多出了如下内容:

counter=1counter=2counter=3counter=4counter=5counter=6counter=7counter=8counter=9counter=10

使用这种方法可以将变量和其它的信息输出至系统日志中,用来分析并找出造成问题的深层次原因。


使用JDB Logger

J2SE日志框架可为任何运行在JVM中的类提供日志记录服务。因此我们可以利用这个框架来记录任何信息。

让我们来重写以上代码,使用JDK中的 logger API:

<%@taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core" %><%@page import="java.util.logging.Logger" %><html><head><title>Logger.info</title></head><body><% Logger logger=Logger.getLogger(this.getClass().getName());%><c:forEach var="counter" begin="1" end="10" step="1" >   <c:set var="myCount" value="${counter-5}" />   <c:out value="${myCount}"/></br>   <% String message = "counter="                   + pageContext.findAttribute("counter")                   + " myCount="                   + pageContext.findAttribute("myCount");                   logger.info( message );    %></c:forEach></body></html>

它的运行结果与先前的类似,但是,它可以获得额外的信息输出至stdout.log文件中。在这我们使用了logger中的info方法。下面我们给出stdout.log文件中的一个快照:

24-Sep-2013 23:31:31 org.apache.jsp.main_jsp _jspServiceINFO: counter=1 myCount=-424-Sep-2013 23:31:31 org.apache.jsp.main_jsp _jspServiceINFO: counter=2 myCount=-324-Sep-2013 23:31:31 org.apache.jsp.main_jsp _jspServiceINFO: counter=3 myCount=-224-Sep-2013 23:31:31 org.apache.jsp.main_jsp _jspServiceINFO: counter=4 myCount=-124-Sep-2013 23:31:31 org.apache.jsp.main_jsp _jspServiceINFO: counter=5 myCount=024-Sep-2013 23:31:31 org.apache.jsp.main_jsp _jspServiceINFO: counter=6 myCount=124-Sep-2013 23:31:31 org.apache.jsp.main_jsp _jspServiceINFO: counter=7 myCount=224-Sep-2013 23:31:31 org.apache.jsp.main_jsp _jspServiceINFO: counter=8 myCount=324-Sep-2013 23:31:31 org.apache.jsp.main_jsp _jspServiceINFO: counter=9 myCount=424-Sep-2013 23:31:31 org.apache.jsp.main_jsp _jspServiceINFO: counter=10 myCount=5

消息可以使用各种优先级发送,通过使用sever(),warning(),info(),config(),fine(),finer(),finest()方法。finest()方法用来记录最好的信息,而sever()方法用来记录最严重的信息。

使用Log4J 框架来将消息记录在不同的文件中,这些消息基于严重程度和重要性来进行分类。


调试工具

NetBeans是树形结构,是开源的Java综合开发环境,支持开发独立的Java应用程序和网络应用程序,同时也支持JSP调试。

NetBeans支持如下几个基本的调试功能:

  • 断点
  • 单步跟踪
  • 观察点

详细的信息可以查看NetBeans使用手册。


使用JDB Debugger

可以在JSP和servlets中使用jdb命令来进行调试,就像调试普通的应用程序一样。

通常,我们直接调试sun.servlet.http.HttpServer 对象来查看HttpServer在响应HTTP请求时执行JSP/Servlets的情况。这与调试applets非常相似。不同之处在于,applets程序实际调试的是sun.applet.AppletViewer。

大部分调试器在调试applets时都能够自动忽略掉一些细节,因为它知道如何调试applets。如果想要将调试对象转移到JSP身上,就需要做好以下两点:

  • 设置调试器的classpath,让它能够找到sun.servlet.http.Http-Server  和相关的类。
  • 设置调试器的classpath,让它能够找到您的JSP文件和相关的类。

设置好classpath后,开始调试sun.servlet.http.Http-Server 。您可以在JSP文件的任意地方设置断点,只要你喜欢,然后使用浏览器发送一个请求给服务器就应该可以看见程序停在了断点处。


使用注释

程序中的注释在很多方面都对程序的调试起到一定的帮助作用。注释可以用在调试程序的很多方面中。

JSP使用Java注释。如果一个BUG消失了,就请仔细查看您刚注释过的代码,通常都能找出原因。


客户端和服务器的头模块

有时候,当JSP没有按照预定的方式运行时,查看未加工的HTTP请求和响应也是很有用的。如果对HTTP的结构很熟悉的话,您可以直接观察request和response然后看看这些头模块到底怎么了。


重要调试技巧

这里我们再透露两个调试JSP的小技巧:

  • 使用浏览器显示原始的页面内容,用来区分是否是格式问题。这个选项通常在View菜单下。
  • 确保浏览器在强制重新载入页面时没有捕获先前的request输出。若使用的是Netscape Navigator浏览器,则用Shift-Reload;若使用的是IE浏览器,则用Shift-Refresh。


在开始前,需要解释几个重要的概念:

  • 国际化(i18n):表明一个页面根据访问者的语言或国家来呈现不同的翻译版本。
  • 本地化(l10n):向网站添加资源,以使它适应不同的地区和文化。比如网站的印度语版本。
  • 区域:这是一个特定的区域或文化,通常认为是一个语言标志和国家标志通过下划线连接起来。比如"en_US"代表美国英语地区。

如果想要建立一个全球化的网站,就需要关心一系列项目。本章将会详细告诉您如何处理国际化问题,并给出了一些例子来加深理解。

JSP容器能够根据request的locale属性来提供正确地页面版本。接下来给出了如何通过request对象来获得Locale对象的语法:

java.util.Locale request.getLocale() 

检测Locale

下表列举出了Locale对象中比较重要的方法,用于检测request对象的地区,语言,和区域。所有这些方法都会在浏览器中显示国家名称和语言名称:

序号 方法 & 描述
1 String getCountry()

返回国家/地区码的英文大写,或 ISO 3166 2-letter 格式的区域
2 String getDisplayCountry()

返回要显示给用户的国家名称
3 String getLanguage()

返回语言码的英文小写,或ISO 639 格式的区域
4 String getDisplayLanguage()

返回要给用户看的语言名称
5 String getISO3Country()

返回国家名称的3字母缩写
6 String getISO3Language()

返回语言名称的3字母缩写

实例演示

这个例子告诉我们如何在JSP中显示语言和国家:

<%@ page import="java.io.*,java.util.Locale" %><%@ page import="javax.servlet.*,javax.servlet.http.* "%><%    //获取客户端本地化信息    Locale locale = request.getLocale();    String language = locale.getLanguage();    String country = locale.getCountry(); %><html><head><title>Detecting Locale</title></head><body><center><h1>Detecting Locale</h1></center><p align="center"><%     out.println("Language : " + language  + "<br />");   out.println("Country  : " + country   + "<br />");%></p></body></html>

语言设置

JSP可以使用西欧语言来输出一个页面,比如英语,西班牙语,德语,法语,意大利语等等。由此可见,设置Content-Language信息头来正确显示所有字符是很重要的。

第二点就是,需要使用HTML字符实体来显示特殊字符,比如"&#241;" 代表的是"?","&#161;"代表的是 "?" :

<%@ page import="java.io.*,java.util.Locale" %><%@ page import="javax.servlet.*,javax.servlet.http.* "%><%     // Set response content type     response.setContentType("text/html");     // Set spanish language code.     response.setHeader("Content-Language", "es");     String title = "En Espa?ol";  %><html><head><title><%  out.print(title); %></title></head><body><center><h1><%  out.print(title); %></h1></center><div align="center"><p>En Espa?ol</p><p>?Hola Mundo!</p></div></body></html>

区域特定日期

可以使用java.text.DateFormat类和它的静态方法getDateTimeInstance()来格式化日期和时间。接下来的这个例子显示了如何根据指定的区域来格式化日期和时间:

<%@ page import="java.io.*,java.util.Locale" %><%@ page import="javax.servlet.*,javax.servlet.http.* "%><%@ page import="java.text.DateFormat,java.util.Date" %><%     String title = "Locale Specific Dates";     //Get the client's Locale     Locale locale = request.getLocale( );     String date = DateFormat.getDateTimeInstance(                                   DateFormat.FULL,                                    DateFormat.SHORT,                                    locale).format(new Date( )); %><html><head><title><% out.print(title); %></title></head><body><center><h1><% out.print(title); %></h1></center><div align="center"><p>Local Date: <%  out.print(date); %></p></div></body></html>

区域特定货币

可以使用java.text.NumberFormat类和它的静态方法getCurrencyInstance()来格式化数字。比如在区域特定货币中的long型和double型。接下来的例子显示了如何根据指定的区域来格式化货币:

<%@ page import="java.io.*,java.util.Locale" %><%@ page import="javax.servlet.*,javax.servlet.http.* "%><%@ page import="java.text.NumberFormat,java.util.Date" %><%     String title = "Locale Specific Currency";     //Get the client's Locale     Locale locale = request.getLocale( );     NumberFormat nft = NumberFormat.getCurrencyInstance(locale);     String formattedCurr = nft.format(1000000); %><html><head><title><% out.print(title); %></title></head><body><center><h1><% out.print(title); %></h1></center><div align="center"><p>Formatted Currency: <%  out.print(formattedCurr); %></p></div></body></html>

区域特定百分比

可以使用java.text.NumberFormat类和它的静态方法getPercentInstance()来格式化百分比。接下来的例子告诉我们如何根据指定的区域来格式化百分比:

<%@ page import="java.io.*,java.util.Locale" %><%@ page import="javax.servlet.*,javax.servlet.http.* "%><%@ page import="java.text.NumberFormat,java.util.Date" %><%     String title = "Locale Specific Percentage";     //Get the client's Locale     Locale locale = request.getLocale( );     NumberFormat nft = NumberFormat.getPercentInstance(locale);     String formattedPerc = nft.format(0.51); %><html><head><title><% out.print(title); %></title></head><body><center><h1><% out.print(title); %></h1></center><div align="center"><p>Formatted Percentage: <%  out.print(formattedPerc); %></p></div></body></html>


什么是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程序与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运行环境,这需要有一定的Java基础。

如果您还未学过Java,可以先学习我们为您提供的Java教程

JSP开发环境是您用来开发、测试和运行JSP程序的地方。

本节将会带您搭建JSP开发环境,具体包括以下几个步骤。


配置Java开发工具(JDK)

这一步涉及Java SDK的下载和PATH环境变量的配置。

您可以从Oracle公司的Java页面中下载SDK:Java SE Downloads

Java SDK下载完后,请按照给定的指示来安装和配置SDK。最后,通过设置PATH和JAVA_HOME环境变量来指明包括java和javac的文件夹路径,通常是java_install_dir/bin和java_install_dir。

假如您用的是Windows系统并且SDK的安装目录为C::jdk1.5.0_20,那么您就需要在 C:autoexec.bat 文件中添加以下两行:

set PATH=C:jdk1.5.0_20in;%PATH%set JAVA_HOME=C:jdk1.5.0_20

或者,在Windows NT/2000/XP下,您可以直接右击我的电脑图标,选择属性,然后高级,然后环境变量,接下来您就可以很方便地设置PATH变量并且确定退出就行了。

在Linux/Unix系统下,如果SDK的安装目录为/usr/local/jdk1.5.0_20并且使用的是C shell,那么您就需要在.cshrc文件中添加以下两行:

setenv PATH /usr/local/jdk1.5.0_20/bin:$PATHsetenv JAVA_HOME /usr/local/jdk1.5.0_20

或者,假如您正在使用类似于Borland JBuilder、Eclipse、IntelliJ IDEA和Sun ONE Studio这样的集成开发环境,可以试着编译并运行一个简单的程序来确定IDE(集成开发环境)是否已经知道 SDK的安装目录。

本步骤你也可以参考本站Java开发环境配置章节的教程。


设置Web服务器:Tomcat

目前,市场上有很多支持JSP和Servlets开发的Web服务器。他们中的一些可以免费下载和使用,Tomcat就是其中之一。

Apache Tomcat是一个开源软件,可作为独立的服务器来运行JSP和Servlets,也可以集成在 Apache Web Server中。以下是Tomcat的配置方法:

  • 下载最新版本的Tomcat:http://tomcat.apache.org/
  • 下载完安装文件后,将压缩文件解压到一个方便的地方,比如Windows下的C:apache-tomcat-5.5.29目录或者Linux/Unix下的/usr/local/apache-tomcat-5.5.29目录,然后创建CATALINA_HOME环境变量指向这些目录。

在Windows机器下,Tomcat可以通过执行以下命令来启动:

%CATALINA_HOME%instartup.bat或者C:apache-tomcat-5.5.29instartup.bat

在Linux/Unix机器下,Tomcat可以通过执行以下命令来启动:

$CATALINA_HOME/bin/startup.sh或者/usr/local/apache-tomcat-5.5.29/bin/startup.sh

成功启动Tomcat后,通过访问http://localhost:8080/便可以使用Tomcat自带的一些web应用了。假如一切顺利的话,您应该能够看到以下的页面:

更多关于配置和运行Tomcat的信息可以在Tomcat提供的文档中找到,或者去Tomcat官网查阅:http://tomcat.apache.org。

在Windows机器下,Tomcat可以通过执行以下命令来停止:

%CATALINA_HOME%inshutdown或者C:apache-tomcat-5.5.29inshutdown

在Linux/Unix机器下,Tomcat可以通过执行以下命令来停止:

$CATALINA_HOME/bin/shutdown.sh或者/usr/local/apache-tomcat-5.5.29/bin/shutdown.sh

设置CLASSPATH环境变量

由于servlets不是Java SE的一部分,所以您必须标示出servlet类的编译器。

假如您用的是Windows机器,您需要在C:autoexec.bat文件中添加以下两行:

set CATALINA=C:apache-tomcat-5.5.29set CLASSPATH=%CATALINA%commonlibjsp-api.jar;%CLASSPATH%

或者,在Windows NT/2000/XP下,您只要右击我的电脑,选择属性,然后点击高级,然后点击环境变量,接下来便可以设置CLASSPATH变量并且确定退出即可。

在Linux/Unix机器下,假如您使用的是C shell,那么您就需要在.cshrc文件中添加以下两行:

setenv CATALINA=/usr/local/apache-tomcat-5.5.29setenv CLASSPATH $CATALINA/common/lib/jsp-api.jar:$CLASSPATH

注意:如果您的开发路径是C:JSPDev (Windows)或者 /usr/JSPDev (Linux/Unix),那么您就需要将这些路径添加进CLASSPATH变量中。



本文假定你已安装了 JDK 环境,如未安装,可参阅 Java 开发环境配置

我们可以使用 Eclipse 来搭建 JSP 开发环境,首先我们分别下载一下软件包:


Tomcat 下载安装

你可以根据你的系统下载对应的包(以下以Window系统为例):

下载之后,将压缩包解压到D盘(你可以自己选择):

注意目录名不能有中文和空格。目录介绍如下:

  • bin:二进制执行文件。里面最常用的文件是startup.bat,如果是 Linux 或 Mac 系统启动文件为 startup.sh
  • conf:配置目录。里面最核心的文件是server.xml。可以在里面改端口号等。默认端口号是8080,也就是说,此端口号不能被其他应用程序占用。
  • lib:库文件。tomcat运行时需要的jar包所在的目录
  • logs:日志
  • temp:临时产生的文件,即缓存
  • webapps:web的应用程序。web应用放置到此目录下浏览器可以直接访问
  • work:编译以后的class文件。

接着我们可以双击 startup.bat 启动 Tomcat,弹出如下界面:

这个时候,本地的服务器就已经搭建起来了。如果想关闭服务器,可以直接关闭上面的窗口,或者在里面输入Ctrl+C禁止服务。

接着我们在浏览器中输入 http://localhost:8080/,如果弹出如下界面,表示tomcat安装成功并且启动起来了:

我们现在在浏览器上测试一下它吧:

首先在D:apache-tomcat-8.0.14webappsROOT目录中新建一个jsp文件:

test.jsp 文件代码如下:

<%@ page contentType="text/html;charset=UTF-8" %><%out.print("51coolma教程 : http://www.51coolma.cn");%> 

接着在浏览器中访问地址 http://localhost:8080/test.jsp, 输出结果如下:



将 Tomcat 和 Eclipse 相关联

Eclipse J2EE下载后,解压即可使用,我们打开Java EE ,选择菜单栏Windows-->preferences(Mac 系统为 Eclipse-->偏好设置),弹出如下界面:

上图中,点击"add"的添加按钮,弹出如下界面:

在选项中,我们选择对应的 Tomcat 版本,接着点击 "Next",选择 Tomcat 的安装目录,并选择我们安装的 Java 环境:

点击 "Finish",完成配置。

创建实例

选择 "File-->New-->Dynamic Web Project",创建 TomcatTest 项目:

点开上图中的红框部分,弹出如下界面:

注意如果已默认选择了我们之前安装的 Tomcat 和 JDK 则可跳过此步。

然后,单击finish, 继续:

工程文件结构:

上图中各个目录解析:

  • deployment descriptor:部署的描述。
  • Web App Libraries:自己加的包可以放在里面。
  • build:放入编译之后的文件。
  • WebContent:放进写入的页面。

在WebContent文件夹下新建一个test.jsp文件。在下图中可以看到它的默认代码:

<%@ page language="java" contentType="text/html; charset=UTF-8"    pageEncoding="UTF-8"%><!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"><html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>Insert title here</title></head><body></body></html>

接着我们修改下test.jsp文件代码如下所示:

<%@ page language="java" contentType="text/html; charset=UTF-8"    pageEncoding="UTF-8"%><!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"><html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>51coolma教程</title></head><body><%    out.println("Hello World!");%></body></html>

程序运行之前,我们先修改一下浏览器选项:

未标题-1(1)

接着我们运行该项目:

未标题-1

运行时,弹出如下错误:(如果没有此错误,请忽略)

原因是,我们之前点击了Tomcat安装包中的​startup.bat,这样一来就手动打开了Tomcat服务器,这明显是多余的,因为程序运行时,eclipse会自动开启Tomcat服务器。所以我们先手动关掉tomcat软件,再次运行程序,就行了。控制台信息如下:

浏览器访问 http://localhost:8080/TomcatTest/test.jsp, 即可输出正常结果:



Servlet 实例创建

我们也可以使用以上环境创建 Servlet 文件,选择 "File-->New-->Servlet":

位于 TomcatTest项目的 /TomcatTest/src 目录下创建 "HelloServlet" 类,包为 "com.youj.test":

未标题-2

HelloServlet.java 代码如下所示:

package com.youj.test;import java.io.IOException;import javax.servlet.ServletException;import javax.servlet.annotation.WebServlet;import javax.servlet.http.HttpServlet;import javax.servlet.http.HttpServletRequest;import javax.servlet.http.HttpServletResponse;/** * Servlet implementation class HelloServlet */@WebServlet("/HelloServlet")public class HelloServlet extends HttpServlet {	private static final long serialVersionUID = 1L;           /**     * @see HttpServlet#HttpServlet()     */    public HelloServlet() {        super();        // TODO Auto-generated constructor stub    }	/**	 * @see HttpServlet#doGet(HttpServletRequest request, HttpServletResponse response)	 */	protected void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {		// 使用 GBK 设置中文正常显示		response.setCharacterEncoding("GBK");		response.getWriter().write("51coolma教程:http://www.51coolma.cn");	}	/**	 * @see HttpServlet#doPost(HttpServletRequest request, HttpServletResponse response)	 */	protected void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {		// TODO Auto-generated method stub		doGet(request, response);	}}

接着重启 Tomcat,浏览器访问 http://localhost:8080/TomcatTest/HelloServlet


参考文章:http://www.cnblogs.com/smyhvae/p/4046862.html


网络服务器需要一个JSP引擎,也就是一个容器来处理JSP页面。容器负责截获对JSP页面的请求。本教程使用内嵌JSP容器的Apache来支持JSP开发。

JSP容器与Web服务器协同合作,为JSP的正常运行提供必要的运行环境和其他服务,并且能够正确识别专属于JSP网页的特殊元素。

下图显示了JSP容器和JSP文件在Web应用中所处的位置。


JSP处理

以下步骤表明了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网页就是用另一种方式来编写servlet而不用成为Java编程高手。除了解释阶段外,JSP网页几乎可以被当成一个普通的servlet来对待。


理解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()方法就行了,就像下面这样:

public void jspInit(){  // 初始化代码}

一般来讲程序只初始化一次,servlet也是如此。通常情况下您可以在jspInit()方法中初始化数据库连接、打开文件和创建查询表。


JSP执行

这一阶段描述了JSP生命周期中一切与请求相关的交互行为,直到被销毁。

当JSP网页完成初始化后,JSP引擎将会调用_jspService()方法。

_jspService()方法需要一个HttpServletRequest对象和一个HttpServletResponse对象作为它的参数,就像下面这样:

void _jspService(HttpServletRequest request,HttpServletResponse response){   // 服务端处理代码}

_jspService()方法在每个request中被调用一次并且负责产生与之相对应的response,并且它还负责产生所有7个HTTP方法的回应,比如GET、POST、DELETE等等。


JSP清理

JSP生命周期的销毁阶段描述了当一个JSP网页从容器中被移除时所发生的一切。

jspDestroy()方法在JSP中等价于servlet中的销毁方法。当您需要执行任何清理工作时复写jspDestroy()方法,比如释放数据库连接或者关闭文件夹等等。

jspDestroy()方法的格式如下:

public void jspDestroy(){   // 清理代码}

实例

JSP生命周期代码实例如下所示:

<%@ page language="java" contentType="text/html; charset=UTF-8"    pageEncoding="UTF-8"%><html><head><title>life.jsp</title></head><body><%!   private int initVar=0;  private int serviceVar=0;  private int destroyVar=0;%>  <%!  public void jspInit(){    initVar++;    System.out.println("jspInit(): JSP被初始化了"+initVar+"次");  }  public void jspDestroy(){    destroyVar++;    System.out.println("jspDestroy(): JSP被销毁了"+destroyVar+"次");  }%><%  serviceVar++;  System.out.println("_jspService(): JSP共响应了"+serviceVar+"次请求");  String content1="初始化次数 : "+initVar;  String content2="响应客户请求次数 : "+serviceVar;  String content3="销毁次数 : "+destroyVar;%><h1>51coolma教程 JSP 测试实例</h1><p><%=content1 %></p><p><%=content2 %></p><p><%=content3 %></p></body></html>


本小节将会简单地介绍一下JSP开发中的基础语法。


脚本程序

脚本程序可以包含任意量的Java语句、变量、方法或表达式,只要它们在脚本语言中是有效的。

脚本程序的语法格式:

<% 代码片段 %>

或者,您也可以编写与其等价的XML语句,就像下面这样:

<jsp:scriptlet>   
代码片段
</jsp:scriptlet>

任何文本、HTML标签、JSP元素必须写在脚本程序的外面。

下面给出一个示例,同时也是本教程的第一个JSP示例:

<html>
<head>
<title>Hello World</title>
</head>
<body>
Hello World!<br/>
<%
out.println("Your IP address is " + request.getRemoteAddr());
%>
</body>
</html>

注意:请确保Apache Tomcat已经安装在C:apache-tomcat-7.0.2目录下并且运行环境已经正确设置。

将以上代码保存在hello.jsp中,然后将它放置在 C:apache-tomcat-7.0.2webappsROOT目录下,打开浏览器并在地址栏中输入http://localhost:8080/hello.jsp。运行后得到以下结果:


JSP声明

一个声明语句可以声明一个或多个变量、方法,供后面的Java代码使用。在JSP文件中,您必须先声明这些变量和方法然后才能使用它们。

JSP声明的语法格式:

<%! declaration; [ declaration; ]+ ... %>

或者,您也可以编写与其等价的XML语句,就像下面这样:

<jsp:declaration>   
代码片段
</jsp:declaration>

程序示例:

<%! int i = 0; %> 
<%! int a, b, c; %>
<%! Circle a = new Circle(2.0); %>

JSP表达式

一个JSP表达式中包含的脚本语言表达式,先被转化成String,然后插入到表达式出现的地方。

由于表达式的值会被转化成String,所以您可以在一个文本行中使用表达式而不用去管它是否是HTML标签。

表达式元素中可以包含任何符合Java语言规范的表达式,但是不能使用分号来结束表达式。

JSP表达式的语法格式:

<%= 表达式 %>

同样,您也可以编写与之等价的XML语句:

<jsp:expression>   
表达式
</jsp:expression>

程序示例:

<html> 
<head>
<title>A Comment Test</title>
</head>
<body>
<p>
Today's date: <%= (new java.util.Date()).toLocaleString()%>
</p>
</body>
</html>

运行后得到以下结果:

Today's date: 11-Sep-2013 21:24:25

JSP注释

JSP注释主要有两个作用:为代码作注释以及将某段代码注释掉。

JSP注释的语法格式:

<%-- 这里可以填写 JSP 注释 --%>

程序示例:

<html> 
<head>
<title>A Comment Test</title>
</head>
<body>
<h2>A Test of Comments</h2>
<%-- 该部分注释在网页中不会被显示--%>
</body>
</html>

运行后得到以下结果:

A Test of Comments

不同情况下使用注释的语法规则:

语法 描述
<%-- 注释 --%> JSP注释,注释内容不会被发送至浏览器甚至不会被编译
<!-- 注释 --> HTML注释,通过浏览器查看网页源代码时可以看见注释内容
<\% 代表静态 <%常量
%> 代表静态 %> 常量
' 在属性中使用的单引号
" 在属性中使用的双引号

JSP指令

JSP指令用来设置与整个JSP页面相关的属性。

JSP指令语法格式:

<%@ directive attribute="value" %>

这里有三种指令标签:

指令 描述
<%@ page ... %> 定义页面的依赖属性,比如脚本语言、error页面、缓存需求等等
<%@ include ... %> 包含其他文件
<%@ taglib ... %> 引入标签库的定义,可以是自定义标签

JSP行为

JSP行为标签使用XML语法结构来控制servlet引擎。它能够动态插入一个文件,重用JavaBean组件,引导用户去另一个页面,为Java插件产生相关的HTML等等。

行为标签只有一种语法格式,它严格遵守XML标准:

<jsp:action_name attribute="value" />

行为标签基本上是一些预先就定义好的函数,下表罗列出了一些可用的JSP行为标签::

语法 描述
jsp:include 用于在当前页面中包含静态或动态资源
jsp:useBean 寻找和初始化一个JavaBean组件
jsp:setProperty 设置 JavaBean组件的值
jsp:getProperty 将 JavaBean组件的值插入到 output中
jsp:forward 从一个JSP文件向另一个文件传递一个包含用户请求的request对象
jsp:plugin 用于在生成的HTML页面中包含Applet和JavaBean对象
jsp:element 动态创建一个XML元素
jsp:attribute 定义动态创建的XML元素的属性
jsp:body 定义动态创建的XML元素的主体
jsp:text 用于封装模板数据

JSP隐含对象

JSP支持九个自动定义的变量,江湖人称隐含对象。这九个隐含对象的简介见下表:

对象 描述
request HttpServletRequest类的实例
response HttpServletResponse类的实例
out PrintWriter类的实例,用于把结果输出至网页上
session HttpSession类的实例
application ServletContext类的实例,与应用上下文有关
config ServletConfig类的实例
pageContext PageContext类的实例,提供对JSP页面所有对象以及命名空间的访问
page 类似于Java类中的this关键字
Exception Exception类的对象,代表发生错误的JSP页面中对应的异常对象

控制流语句

JSP提供对Java语言的全面支持。您可以在JSP程序中使用Java API甚至建立Java代码块,包括判断语句和循环语句等等。

判断语句

If…else块,请看下面这个例子:

<%! int day = 3; %> 
<html>
<head>
<title>IF...ELSE Example</title>
</head>
<body>
<% if (day == 1 | day == 7) { %>
<p> Today is weekend</p>
<% } else { %>
<p> Today is not weekend</p>
<% } %>
</body>
</html>

运行后得到以下结果:

Today is not weekend

现在来看看switch…case块,与if…else块有很大的不同,它使用out.println(),并且整个都装在脚本程序的标签中,就像下面这样:

<%! int day = 3; %> 
<html>
<head>
<title>SWITCH...CASE Example</title></head>
<body>
<%
switch(day) {
case 0:
out.println("It's Sunday.");
break;
case 1:
out.println("It's Monday.");
break;
case 2:
out.println("It's Tuesday.");
break;
case 3:
out.println("It's Wednesday.");
break;
case 4:
out.println("It's Thursday.");
break;
case 5:
out.println("It's Friday.");
break;
default:
out.println("It's Saturday.");
}
%>
</body>
</html>

运行后得出以下结果:

It's Wednesday.

循环语句

在JSP程序中可以使用Java的三个基本循环类型:for,while,和 do…while。

让我们来看看for循环的例子:

<%! int fontSize; %> 
<html>
<head>
<title>FOR LOOP Example</title>
</head>
<body>
<%for ( fontSize = 1; fontSize <= 3; fontSize++){ %>
<font color="green" size="<%= fontSize %>">
JSP Tutorial
</font><br />
<%}%>
</body>
</html>

运行后得到以下结果:

JSP Tutorial
JSP Tutorial
JSP Tutorial

将上例改用while循环来写:

<%! int fontSize; %> 
<html>
<head>
<title>WHILE LOOP Example</title>
</head>
<body>
<%while ( fontSize <= 3){ %>
<font color="green" size="<%= fontSize %>">
JSP Tutorial
</font><br />
<%fontSize++;%>
<%}%>
</body>
</html>

运行后得到同样的结果:


JSP Tutorial
JSP Tutorial
JSP Tutorial

JSP运算符

JSP支持所有Java逻辑和算术运算符。

下表罗列出了JSP常见运算符,优先级从高到底:

类别 操作符 结合性
后缀 () [] . (点运算符) 左到右
一元 ++ - - ! ~ 右到左
可乘性 * / %  左到右
可加性 + -  左到右
移位 >> >>> <<   左到右 
关系 > >= < <=   左到右
相等/不等 == !=  左到右
位与 左到右
位异或 左到右
位或 左到右
逻辑与 &&  左到右
逻辑或 ||  左到右
条件判断 ?:  右到左
赋值 = += -= *= /= %= >>= <<= &= ^= |=  右到左
逗号  左到右 

JSP常量

JSP语言定义了以下几个常量:

  • 布尔值(boolean):true 和 false;
  • 整型(int):与Java中的一样;
  • 浮点型(float):与Java中的一样;
  • 字符串(string):以单引号或双引号开始和结束;
  • Null:null。


JSP指令用来设置整个JSP页面相关的属性,如网页的编码方式和脚本语言。

语法格式如下:

<%@ directive attribute="value" %>

指令可以有很多个属性,它们以键值对的形式存在,并用逗号隔开。

JSP中的三种指令标签:

指令

描述
<%@ page ... %> 定义网页依赖属性,比如脚本语言、error页面、缓存需求等等
<%@ include ... %> 包含其他文件
<%@ taglib ... %> 引入标签库的定义

Page指令

Page指令为容器提供当前页面的使用说明。一个JSP页面可以包含多个page指令。

Page指令的语法格式:

<%@ page attribute="value" %>

等价的XML格式:

<jsp:directive.page attribute="value" />

属性

下表列出与Page指令相关的属性:

属性 描述
buffer 指定out对象使用缓冲区的大小
autoFlush 控制out对象的 缓存区
contentType 指定当前JSP页面的MIME类型和字符编码
errorPage 指定当JSP页面发生异常时需要转向的错误处理页面
isErrorPage 指定当前页面是否可以作为另一个JSP页面的错误处理页面
extends 指定servlet从哪一个类继承
import 导入要使用的Java类
info 定义JSP页面的描述信息
isThreadSafe 指定对JSP页面的访问是否为线程安全
language 定义JSP页面所用的脚本语言,默认是Java
session 指定JSP页面是否使用session
isELIgnored 指定是否执行EL表达式
isScriptingEnabled 确定脚本元素能否被使用

Include指令

JSP可以通过include指令来包含其他文件。被包含的文件可以是JSP文件、HTML文件或文本文件。包含的文件就好像是该JSP文件的一部分,会被同时编译执行。

Include指令的语法格式如下:

<%@ include file="relative url" %>

Include指令中的文件名实际上是一个相对的URL。如果您没有给文件关联一个路径,JSP编译器默认在当前路径下寻找。

等价的XML语法:

<jsp:directive.include file="relative url" />

Taglib指令

JSP API允许用户自定义标签,一个自定义标签库就是自定义标签的集合。

Taglib指令引入一个自定义标签集合的定义,包括库路径、自定义标签。

Taglib指令的语法:

<%@ taglib uri="uri" prefix="prefixOfTag" %>

uri属性确定标签库的位置,prefix属性指定标签库的前缀。

等价的XML语法:

<jsp:directive.taglib uri="uri" prefix="prefixOfTag" />


与JSP指令元素不同的是,JSP动作元素在请求处理阶段起作用。JSP动作元素是用XML语法写成的。

利用JSP动作可以动态地插入文件、重用JavaBean组件、把用户重定向到另外的页面、为Java插件生成HTML代码。

动作元素只有一种语法,它符合XML标准:

<jsp:action_name attribute="value" />

动作元素基本上都是预定义的函数,JSP规范定义了一系列的标准动作,它用JSP作为前缀,可用的标准动作元素如下:

语法 描述
jsp:include在页面被请求的时候引入一个文件。
jsp:useBean寻找或者实例化一个JavaBean。
jsp:setProperty设置JavaBean的属性。
jsp:getProperty输出某个JavaBean的属性。
jsp:forward把请求转到一个新的页面。
jsp:plugin根据浏览器类型为Java插件生成OBJECT或EMBED标记。
jsp:element定义动态XML元素
jsp:attribute设置动态定义的XML元素属性。
jsp:body设置动态定义的XML元素内容。
jsp:text在JSP页面和文档中使用写入文本的模板

常见的属性

所有的动作要素都有两个属性:id属性和scope属性。

  • id属性:

    id属性是动作元素的唯一标识,可以在JSP页面中引用。动作元素创建的id值可以通过PageContext来调用。

  • scope属性:

    该属性用于识别动作元素的生命周期。 id属性和scope属性有直接关系,scope属性定义了相关联id对象的寿命。 scope属性有四个可能的值: (a) page, (b)request, (c)session, 和 (d) application。


<jsp:include>动作元素

<jsp:include>动作元素用来包含静态和动态的文件。该动作把指定文件插入正在生成的页面。语法格式如下:

<jsp:include page="relative URL" flush="true" />

 前面已经介绍过include指令,它是在JSP文件被转换成Servlet的时候引入文件,而这里的jsp:include动作不同,插入文件的时间是在页面被请求的时候。

以下是include动作相关的属性列表。

属性 描述
page包含在页面中的相对URL地址。
flush布尔属性,定义在包含资源前是否刷新缓存区。

实例

以下我们定义了两个文件date.jsp和main.jsp,代码如下所示:

date.jsp文件代码:

<p>   Today's date: <%= (new java.util.Date()).toLocaleString()%></p>

main.jsp文件代码:

<html><head><title>The include Action Example</title></head><body><center><h2>The include action Example</h2><jsp:include page="date.jsp" flush="true" /></center></body></html>

现在将以上两个文件放在服务器的根目录下,访问main.jsp文件。显示结果如下:

The include action ExampleToday's date: 12-Sep-2013 14:54:22

<jsp:useBean>动作元素

 jsp:useBean动作用来装载一个将在JSP页面中使用的JavaBean。

这个功能非常有用,因为它使得我们既可以发挥Java组件重用的优势,同时也避免了损失JSP区别于Servlet的方便性。

jsp:useBean动作最简单的语法为:

<jsp:useBean id="name" class="package.class" />

在类载入后,我们既可以通过 jsp:setProperty 和 jsp:getProperty 动作来修改和检索bean的属性。

以下是useBean动作相关的属性列表。

属性 描述
class指定Bean的完整包名。
type指定将引用该对象变量的类型。
beanName通过 java.beans.Beans 的 instantiate() 方法指定Bean的名字。

在给出具体实例前,让我们先来看下 jsp:setProperty 和 jsp:getProperty 动作元素:


<jsp:setProperty>动作元素

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

<jsp:useBean id="myName" ... />...<jsp:setProperty name="myName" property="someProperty" .../>

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

<jsp:useBean id="myName" ... >...   <jsp:setProperty name="myName" property="someProperty" .../></jsp:useBean>

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

属性 描述
namename属性是必需的。它表示要设置属性的是哪个Bean。
propertyproperty属性是必需的。它表示要设置哪个属性。有一个特殊用法:如果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自己提供默认属性值,只有当请求参数明确指定了新值时才修改默认属性值。

<jsp:getProperty>动作元素

 jsp:getProperty动作提取指定Bean属性的值,转换成字符串,然后输出。语法格式如下:

<jsp:useBean id="myName" ... />...<jsp:getProperty name="myName" property="someProperty" .../>

下表是与getProperty相关联的属性:

属性 描述
name要检索的Bean属性名称。Bean必须已定义。
property表示要提取Bean属性的值

实例

以下实例我们使用了Bean:

/* 文件: TestBean.java */package action; public class TestBean {   private String message = "No message specified";    public String getMessage() {      return(message);   }   public void setMessage(String message) {      this.message = message;   }}

编译以上实例并生成 TestBean.class 文件,将该文件拷贝至服务器正式存放Java类的目录下,而不是保留给修改后能够自动装载的类的目录( 如:C:apache-tomcat-7.0.2webappsWEB-INFclassesaction目录中,CLASSPATH 变量必须包含该路径。 )。例如,对于Java Web Server来说,Bean和所有Bean用到的类都应该放入classes目录,或者封装进jar文件后放入lib目录,但不应该放到servlets 下。   下面是一个很简单的例子,它的功能是装载一个Bean,然后设置/读取它的message属性。

现在让我们在main.jsp文件中调用该Bean:

 <html><head><title>Using JavaBeans in JSP</title></head><body><center><h2>Using JavaBeans in JSP</h2> <jsp:useBean id="test" class="action.TestBean" /> <jsp:setProperty name="test"                      property="message"                      value="Hello JSP..." /> <p>Got message....</p> <jsp:getProperty name="test" property="message" /> </center></body></html>

执行以上文件,输出如下所示:

Using JavaBeans in JSPGot message....Hello JSP...

<jsp:forward> 动作元素

 jsp:forward动作把请求转到另外的页面。jsp:forward标记只有一个属性page。语法格式如下所示:

<jsp:forward page="Relative URL" />

以下是forward相关联的属性:

属性 描述
pagepage属性包含的是一个相对URL。page的值既可以直接给出,也可以在请求的时候动态计算,可以是一个JSP页面或者一个 Java Servlet.

实例

以下实例我们使用了两个文件,分别是: date.jsp 和 main.jsp。

date.jsp文件代码如下:

<p>   Today's date: <%= (new java.util.Date()).toLocaleString()%></p>

main.jsp文件代码:

<html><head><title>The forward Action Example</title></head><body><center><h2>The forward action Example</h2><jsp:forward page="date.jsp" /></center></body>

现在将以上两个文件放在服务器的根目录下,访问main.jsp文件。显示结果如下:

Today's date: 12-Sep-2010 14:54:22

<jsp:plugin>动作元素

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

如果需要的插件不存在,它会下载插件,然后执行Java组件。 Java组件可以是一个applet或一个JavaBean。

plugin动作有多个对应HTML元素的属性用于格式化Java 组件。param元素可用于向Applet 或 Bean 传递参数。

以下是使用plugin 动作元素的典型实例:

<jsp:plugin type="applet" codebase="dirname" code="MyApplet.class"                            width="60" height="80">   <jsp:param name="fontcolor" value="red" />   <jsp:param name="background" value="black" />    <jsp:fallback>      Unable to initialize Java Plugin   </jsp:fallback> </jsp:plugin>

如果你有兴趣可以尝试使用applet来测试jsp:plugin动作元素,<fallback>元素是一个新元素,在组件出现故障的错误是发送给用户错误信息。


<jsp:element> 、 <jsp:attribute>、 <jsp:body>动作元素

<jsp:element> 、 <jsp:attribute>、 <jsp:body>动作元素动态定义XML元素。动态是非常重要的,这就意味着XML元素在编译时是动态生成的而非静态。

以下实例动态定义了XML元素:

<%@page language="java" contentType="text/html"%><html xmlns="http://www.w3c.org/1999/xhtml"       xmlns:jsp="http://java.sun.com/JSP/Page"><head><title>Generate XML Element</title></head><body><jsp:element name="xmlElement"><jsp:attribute name="xmlElementAttr">   Value for the attribute</jsp:attribute><jsp:body>   Body for XML element</jsp:body></jsp:element></body></html>

执行时生成HTML代码如下:

<html xmlns="http://www.w3c.org/1999/xhtml"       xmlns:jsp="http://java.sun.com/JSP/Page"> <head><title>Generate XML Element</title></head><body><xmlElement xmlElementAttr="Value for the attribute">   Body for XML element</xmlElement></body></html>

<jsp:text>动作元素

<jsp:text>动作元素允许在JSP页面和文档中使用写入文本的模板,语法格式如下:

<jsp:text>Template data</jsp:text>

以上文本模板不能包含其他元素,只能只能包含文本和EL表达式(注:EL表达式将在后续章节中介绍)。请注意,在XML文件中,您不能使用表达式如 ${whatever > 0},因为>符号是非法的。 你可以使用 ${whatever gt 0}表达式或者嵌入在一个CDATA部分的值。

<jsp:text><![CDATA[<br>]]></jsp:text>

如果你需要在 XHTML 中声明 DOCTYPE,必须使用到<jsp:text>动作元素,实例如下:

<jsp:text><![CDATA[<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "DTD/xhtml1-strict.dtd">]]></jsp:text><head><title>jsp:text action</title></head><body><books><book><jsp:text>      Welcome to JSP Programming</jsp:text></book></books></body></html>

你可以对以上实例尝试使用<jsp:text>及不使用该动作元素执行结果的区别。


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-name>元素中的servlet名字,注意,<servlet-name>元素在 WEB-INFweb.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 对象包装了从先前页面中抛出的异常信息。它通常被用来产生对出错条件的适当响应。


当浏览器请求一个网页时,它会向网络服务器发送一系列不能被直接读取的信息,因为这些信息是作为HTTP信息头的一部分来传送的。您可以查阅HTTP协议来获得更多的信息。

下表列出了浏览器端信息头的一些重要内容,在以后的网络编程中将会经常见到这些信息:

信息 描述
Accept指定浏览器或其他客户端可以处理的MIME类型。它的值通常为 image/png 或 image/jpeg
Accept-Charset指定浏览器要使用的字符集。比如 ISO-8859-1
Accept-Encoding指定编码类型。它的值通常为 gzip 或compress
Accept-Language指定客户端首选语言,servlet会优先返回以当前语言构成的结果集,如果servlet支持这种语言的话。比如 en,en-us,ru等等
Authorization在访问受密码保护的网页时识别不同的用户
Connection表明客户端是否可以处理HTTP持久连接。持久连接允许客户端或浏览器在一个请求中获取多个文件。Keep-Alive 表示启用持久连接
Content-Length仅适用于POST请求,表示 POST 数据的字节数
Cookie返回先前发送给浏览器的cookies至服务器
Host指出原始URL中的主机名和端口号
If-Modified-Since表明只有当网页在指定的日期被修改后客户端才需要这个网页。 服务器发送304码给客户端,表示没有更新的资源
If-Unmodified-Since与If-Modified-Since相反, 只有文档在指定日期后仍未被修改过,操作才会成功
Referer标志着所引用页面的URL。比如,如果你在页面1,然后点了个链接至页面2,那么页面1的URL就会包含在浏览器请求页面2的信息头中
User-Agent用来区分不同浏览器或客户端发送的请求,并对不同类型的浏览器返回不同的内容

HttpServletRequest类

request对象是javax.servlet.http.HttpServletRequest类的实例。每当客户端请求一个页面时,JSP引擎就会产生一个新的对象来代表这个请求。

request对象提供了一系列方法来获取HTTP信息头,包括表单数据,cookies,HTTP方法等等。

接下来将会介绍一些在JSP编程中常用的获取HTTP信息头的方法。详细内容请见下表:

序号 方法& 描述
1 Cookie[] getCookies()

返回客户端所有的Cookie的数组
2 Enumeration getAttributeNames()

返回request对象的所有属性名称的集合
3 Enumeration getHeaderNames()

返回所有HTTP头的名称集合
4 Enumeration getParameterNames()

返回请求中所有参数的集合
5 HttpSession getSession()

返回request对应的session对象,如果没有,则创建一个
6 HttpSession getSession(boolean create)

返回request对应的session对象,如果没有并且参数create为true,则返回一个新的session对象
7 Locale getLocale()

返回当前页的Locale对象,可以在response中设置
8 Object getAttribute(String name)

返回名称为name的属性值,如果不存在则返回null。
9 ServletInputStream getInputStream()

返回请求的输入流
10 String getAuthType()

返回认证方案的名称,用来保护servlet,比如 "BASIC" 或者 "SSL" 或 null 如果 JSP没设置保护措施
11 String getCharacterEncoding()

返回request的字符编码集名称
12 String getContentType()

返回request主体的MIME类型,若未知则返回null
13 String getContextPath()

返回request URI中指明的上下文路径
14 String getHeader(String name)

返回name指定的信息头
15 String getMethod()

返回此request中的HTTP方法,比如 GET,,POST,或PUT
16 String getParameter(String name)

返回此request中name指定的参数,若不存在则返回null
17 String getPathInfo()

返回任何额外的与此request URL相关的路径
18 String getProtocol()

返回此request所使用的协议名和版本
19 String getQueryString()

返回此 request URL包含的查询字符串
20 String getRemoteAddr()

返回客户端的IP地址
21 String getRemoteHost()

返回客户端的完整名称
22 String getRemoteUser()

返回客户端通过登录认证的用户,若用户未认证则返回null
23 String getRequestURI()

返回request的URI
24 String getRequestedSessionId()

返回request指定的session ID
25 String getServletPath()

返回所请求的servlet路径
26 String[] getParameterValues(String name)

返回指定名称的参数的所有值,若不存在则返回null
27 boolean isSecure()

返回request是否使用了加密通道,比如HTTPS
28 int getContentLength()

返回request主体所包含的字节数,若未知的返回-1
29 int getIntHeader(String name)

返回指定名称的request信息头的值
30 int getServerPort()

返回服务器端口号

HTTP信息头示例

在这个例子中,我们会使用HttpServletRequest类的getHeaderNames()方法来读取HTTP信息头。这个方法以枚举的形式返回当前HTTP请求的头信息。

获取Enumeration对象后,用标准的方式来遍历Enumeration对象,用hasMoreElements()方法来确定什么时候停止,用nextElement()方法来获得每个参数的名字。

<%@ page import="java.io.*,java.util.*" %><html><head><title>HTTP Header Request Example</title></head><body><center><h2>HTTP Header Request Example</h2><table width="100%" border="1" align="center"><tr bgcolor="#949494"><th>Header Name</th><th>Header Value(s)</th></tr><%    Enumeration headerNames = request.getHeaderNames();    while(headerNames.hasMoreElements()) {       String paramName = (String)headerNames.nextElement();       out.print("<tr><td>" + paramName + "</td>
");      String paramValue = request.getHeader(paramName);      out.println("<td> " + paramValue + "</td></tr>
");   }%></table></center></body></html>

访问main.jsp,将会得到以下结果:

HTTP Header Request Example

Header NameHeader Value(s)
accept*/*
accept-languageen-us
user-agentMozilla/4.0 (compatible; MSIE 7.0; Windows NT 5.1; Trident/4.0; InfoPath.2; MS-RTC LM 8)
accept-encodinggzip, deflate
hostlocalhost:8080
connectionKeep-Alive
cache-controlno-cache

您可以在上面代码中尝试HttpServletRequest类的其它方法。


Response响应对象主要将JSP容器处理后的结果传回到客户端。可以通过response变量设置HTTP的状态和向客户端发送数据,如Cookie、HTTP文件头信息等。

一个典型的响应看起来就像下面这样:

HTTP/1.1 200 OKContent-Type: text/htmlHeader2: ......HeaderN: ...  (Blank Line)<!doctype ...><html><head>...</head><body>...</body></html>

状态行包含HTTP版本信息,比如HTTP/1.1,一个状态码,比如200,还有一个非常短的信息对应着状态码,比如OK。

下表摘要出了HTTP1.1响应头中最有用的部分,在网络编程中您将会经常见到它们:

响应头 描述
Allow 指定服务器支持的request方法(GET,POST等等)
Cache-Control 指定响应文档能够被安全缓存的情况。通常取值为 publicprivate 或no-cache 等等。 Public意味着文档可缓存,Private意味着文档只为单用户服务并且只能使用私有缓存。No-cache 意味着文档不被缓存。
Connection 命令浏览器是否要使用持久的HTTP连接。close 命令浏览器不使用持久HTTP连接,而keep-alive 意味着使用持久化连接。
Content-Disposition 让浏览器要求用户将响应以给定的名称存储在磁盘中
Content-Encoding 指定传输时页面的编码规则
Content-Language 表述文档所使用的语言,比如en, en-us,,ru等等
Content-Length 表明响应的字节数。只有在浏览器使用持久化 (keep-alive) HTTP 连接时才有用
Content-Type 表明文档使用的MIME类型
Expires 指明啥时候过期并从缓存中移除
Last-Modified 指明文档最后修改时间。客户端可以 缓存文档并且在后续的请求中提供一个 If-Modified-Since请求头
Location 在300秒内,包含所有的有一个状态码的响应地址,浏览器会自动重连然后检索新文档
Refresh 指明浏览器每隔多久请求更新一次页面。
Retry-After 与503 (Service Unavailable)一起使用来告诉用户多久后请求将会得到响应
Set-Cookie 指明当前页面对应的cookie

HttpServletResponse类

response对象是javax.servlet.http.HttpServletResponse类的一个实例。就像服务器会创建request对象一样,它也会创建一个客户端响应。

response对象定义了处理创建HTTP信息头的接口。通过使用这个对象,开发者们可以添加新的cookie或时间戳,还有HTTP状态码等等。

下表列出了用来设置HTTP响应头的方法,这些方法由HttpServletResponse 类提供:

S.N. 方法 & 描述
1 String encodeRedirectURL(String url)

对sendRedirect()方法使用的URL进行编码
2 String encodeURL(String url)

将URL编码,回传包含Session ID的URL
3 boolean containsHeader(String name)

返回指定的响应头是否存在
4 boolean isCommitted()

返回响应是否已经提交到客户端
5 void addCookie(Cookie cookie)

添加指定的cookie至响应中
6 void addDateHeader(String name, long date)

添加指定名称的响应头和日期值
7 void addHeader(String name, String value)

添加指定名称的响应头和值
8 void addIntHeader(String name, int value)

添加指定名称的响应头和int值
9 void flushBuffer()

将任何缓存中的内容写入客户端
10 void reset()

清除任何缓存中的任何数据,包括状态码和各种响应头
11 void resetBuffer()

清除基本的缓存数据,不包括响应头和状态码
12 void sendError(int sc)

使用指定的状态码向客户端发送一个出错响应,然后清除缓存
13 void sendError(int sc, String msg)

使用指定的状态码和消息向客户端发送一个出错响应
14 void sendRedirect(String location)

使用指定的URL向客户端发送一个临时的间接响应
15 void setBufferSize(int size)

设置响应体的缓存区大小
16 void setCharacterEncoding(String charset)

指定响应的编码集(MIME字符集),例如UTF-8
17 void setContentLength(int len)

指定HTTP servlets中响应的内容的长度,此方法用来设置 HTTP Content-Length 信息头
18 void setContentType(String type)

设置响应的内容的类型,如果响应还未被提交的话
19 void setDateHeader(String name, long date)

使用指定名称和值设置响应头的名称和内容
20 void setHeader(String name, String value)

使用指定名称和值设置响应头的名称和内容
21 void setIntHeader(String name, int value)

使用指定名称和值设置响应头的名称和内容
22 void setLocale(Locale loc)

设置响应的语言环境,如果响应尚未被提交的话
23 void setStatus(int sc)

设置响应的状态码

HTTP响应头程序示例

接下来的例子使用setIntHeader()方法和setRefreshHeader()方法来模拟一个数字时钟:

<%@ page import="java.io.*,java.util.*" %><html><head><title>Auto Refresh Header Example</title></head><body><center><h2>Auto Refresh Header Example</h2><%    // 设置每隔5秒自动刷新    response.setIntHeader("Refresh", 5);    // 获取当前时间    Calendar calendar = new GregorianCalendar();    String am_pm;    int hour = calendar.get(Calendar.HOUR);    int minute = calendar.get(Calendar.MINUTE);    int second = calendar.get(Calendar.SECOND);    if(calendar.get(Calendar.AM_PM) == 0)       am_pm = "AM";    else       am_pm = "PM";    String CT = hour+":"+ minute +":"+ second +" "+ am_pm;    out.println("Current Time is: " + CT + "
"); %></center></body></html>

将以上代码保存为main.jsp,然后通过浏览器访问它。它将会每隔5秒显示一下系统当前时间。

运行结果如下:

Auto Refresh Header ExampleCurrent Time is: 9:44:50 PM

您也可以自己动手修改以上代码,试试使用其他的方法,将能得到更深的体会。


HTTP请求与HTTP响应的格式相近,都有着如下结构:

  • 以状态行+CRLF(回车换行)开始
  • 零行或多行头模块+CRLF
  • 一个空行,比如CRLF
  • 可选的消息体比如文件,查询数据,查询输出

举例来说,一个服务器响应头看起来就像下面这样:

HTTP/1.1 200 OKContent-Type: text/htmlHeader2: ......HeaderN: ...  (Blank Line)<!doctype ...><html><head>...</head><body>...</body></html>

状态行包含HTTP版本,一个状态码,和状态码相对应的短消息。

下表列出了可能会从服务器返回的HTTP状态码和与之关联的消息:

状态码 消息 描述
100Continue只有一部分请求被服务器接收,但只要没被服务器拒绝,客户端就会延续这个请求
101Switching Protocols服务器交换机协议
200OK请求被确认
201Created请求已完成,新的资源被创建
202Accepted请求被接受,但未处理完
203Non-authoritative Information 
204No Content 
205Reset Content 
206Partial Content 
300Multiple Choices一个超链接表,用户可以选择一个超链接并访问,最大支持5个超链接
301Moved Permanently被请求的页面已经移动到了新的URL下
302Found被请求的页面暂时性地移动到了新的URL下
303See Other被请求的页面可以在一个不同的URL下找到
304Not Modified 
305Use Proxy 
306 Unused已经不再使用此状态码,但状态码被保留
307Temporary Redirect被请求的页面暂时性地移动到了新的URL下
400Bad Request服务器无法识别请求
401Unauthorized被请求的页面需要用户名和密码
402Payment Required 目前还不能使用此状态码
403Forbidden禁止访问所请求的页面
404Not Found服务器无法找到所请求的页面
405Method Not Allowed请求中所指定的方法不被允许
406Not Acceptable服务器只能创建一个客户端无法接受的响应
407Proxy Authentication Required在请求被服务前必须认证一个代理服务器
408Request Timeout请求时间超过了服务器所能等待的时间,连接被断开
409Conflict请求有矛盾的地方
410Gone被请求的页面不再可用
411Length Required"Content-Length"没有被定义,服务器拒绝接受请求
412Precondition Failed请求的前提条件被服务器评估为false
413Request Entity Too Large因为请求的实体太大,服务器拒绝接受请求
414Request-url Too Long服务器拒绝接受请求,因为URL太长。多出现在把"POST"请求转换为"GET"请求时所附带的大量查询信息
415Unsupported Media Type服务器拒绝接受请求,因为媒体类型不被支持
417Expectation Failed 
500Internal Server Error请求不完整,服务器遇见了出乎意料的状况
501Not Implemented请求不完整,服务器不提供所需要的功能
502Bad Gateway请求不完整,服务器从上游服务器接受了一个无效的响应
503Service Unavailable请求不完整,服务器暂时重启或关闭
504Gateway Timeout网关超时
505HTTP Version Not Supported服务器不支持所指定的HTTP版本

设置HTTP状态码的方法

下表列出了HttpServletResponse 类中用来设置状态码的方法:

S.N. 方法 & 描述
1 public void setStatus ( int statusCode )

此方法可以设置任意的状态码。如果您的响应包含一个特殊的状态码和一个文档,请确保在用PrintWriter返回任何内容前调用setStatus方法
2 public void sendRedirect(String url)

此方法产生302响应,同时产生一个 Location 头告诉URL 一个新的文档
3 public void sendError(int code, String message)

此方法将一个状态码(通常为 404)和一个短消息,自动插入HTML文档中并发回给客户端

HTTP状态码程序示例

接下来的例子将会发送407错误码给浏览器,然后浏览器将会告诉您"Need authentication!!!"。

<html><head><title>Setting HTTP Status Code</title></head><body><%    // 设置错误代码,并说明原因    response.sendError(407, "Need authentication!!!" ); %></body></html>

访问以上JSP页面,将会得到以下结果:

js_http_status_codes

您也可以试试使用其他的状态码,看会不会得到什么意想不到结果。


我们在浏览网页的时候,经常需要向服务器提交信息,并让后台程序处理。浏览器中使用 GET 和 POST 方法向服务器提交数据。


GET 方法

GET方法将请求的编码信息添加在网址后面,网址与编码信息通过"?"号分隔。如下所示:

//www.51coolma.cn/hello?key1=value1&key2=value2

GET方法是浏览器默认传递参数的方法,一些敏感信息,如密码等建议不使用GET方法。

用get时,传输数据的大小有限制 (注意不是参数的个数有限制),最大为1024字节。


POST 方法

一些敏感信息,如密码等我们可以同过POST方法传递,post提交数据是隐式的。

POST提交数据是不可见的,GET是通过在url里面传递的(可以看一下你浏览器的地址栏)。

JSP使用getParameter()来获得传递的参数,getInputStream()方法用来处理客户端的二进制数据流的请求。


JSP 读取表单数据

  • getParameter(): 使用 request.getParameter() 方法来获取表单参数的值。

  • getParameterValues(): 获得如checkbox类(名字相同,但值有多个)的数据。 接收数组变量 ,如checkbox类型

  • getParameterNames():该方法可以取得所有变量的名称,该方法返回一个Emumeration。

  • getInputStream():调用此方法来读取来自客户端的二进制数据流。


使用URL的 GET 方法实例

以下是一个简单的URL,并使用GET方法来传递URL中的参数:

http://localhost:8080/main.jsp?first_name=ZARA&last_name=ALI

以下是main.jsp文件的JSP程序用于处理客户端提交的表单数据,我们使用getParameter()方法来获取提交的数据:

<html><head><title>Using GET Method to Read Form Data</title></head><body><center><h1>Using GET Method to Read Form Data</h1><ul><li><p><b>First Name:</b>   <%= request.getParameter("first_name")%></p></li><li><p><b>Last  Name:</b>   <%= request.getParameter("last_name")%></p></li></ul></body></html>

接下来我们通过浏览器访问http://localhost:8080/main.jsp?first_name=ZARA&last_name=ALI 输出结果如下所示:

Using GET Method to Read Form DataFirst Name: ZARALast Name: ALI

使用表单的 GET 方法实例

以下是一个简单的HTML表单,该表单通过GET方法将客户端数据提交 到main.jsp文件中:

<html><body><form action="main.jsp" method="GET">First Name: <input type="text" name="first_name"><br />Last Name: <input type="text" name="last_name" /><input type="submit" value="Submit" /></form></body></html>

将以上HTML代码保存到Hello.htm文件中。 将该文件放置于/webapps/ROOT 目录下。 通过访问 http://localhost:8080/Hello.htm,输出界面如下所示:

form-1

在"First Name" 与 "Last Name"两个表单中填入信息,并点击"Submit"按钮,它将输出结果。


使用表单的 POST 方法实例

接下来让我们使用POST方法来传递表单数据,修改main.jsp与Hello.htm文件代码,如下所示:

main.jsp文件代码:

<html><head><title>Using GET and POST Method to Read Form Data</title></head><body><center><h1>Using GET Method to Read Form Data</h1><ul><li><p><b>First Name:</b>   <%= request.getParameter("first_name")%></p></li><li><p><b>Last  Name:</b>   <%= request.getParameter("last_name")%></p></li></ul></body></html>

以下是Hello.htm修改后的代码:

<html><body><form action="main.jsp" method="POST">First Name: <input type="text" name="first_name"><br />Last Name: <input type="text" name="last_name" /><input type="submit" value="Submit" /></form></body></html>

通过浏览器访问 http://localhost:8080/Hello.htm,输出如下:

form-1

在"First Name" 与 "Last Name"两个表单中填入信息,并点击"Submit"按钮,它将输出结果。


传递 Checkbox 数据到JSP程序

复选框 checkbox 可以传递一个甚至多个数据。

以下是一个简单的HTML代码,并将代码保存在CheckBox.htm文件中:

<html><body><form action="main.jsp" method="POST" target="_blank"><input type="checkbox" name="maths" checked="checked" /> Maths<input type="checkbox" name="physics"  /> Physics<input type="checkbox" name="chemistry" checked="checked" />                                                 Chemistry<input type="submit" value="Select Subject" /></form></body></html>

以下为main.jsp文件代码,用于处理复选框数据:

<html><head><title>Reading Checkbox Data</title></head><body><center><h1>Reading Checkbox Data</h1><ul><li><p><b>Maths Flag:</b>   <%= request.getParameter("maths")%></p></li><li><p><b>Physics Flag:</b>   <%= request.getParameter("physics")%></p></li><li><p><b>Chemistry Flag:</b>   <%= request.getParameter("chemistry")%></p></li></ul></body></html>

以上实例输出结果为:

form-2


读取所有表单参数

以下我们将使用 HttpServletRequest 的getParameterNames()来读取所有可用的表单参数,该方法可以取得所有变量的名称,该方法返回一个Emumeration。

一旦我们有了一个Enumeration(枚举),我们就可以调用hasMoreElements()方法来确定何时停止使用和nextElement()方法来获得每个参数的名称。

<%@ page import="java.io.*,java.util.*" %><html><head><title>HTTP Header Request Example</title></head><body><center><h2>HTTP Header Request Example</h2><table width="100%" border="1" align="center"><tr bgcolor="#949494"><th>Param Name</th><th>Param Value(s)</th></tr><%    Enumeration paramNames = request.getParameterNames();     while(paramNames.hasMoreElements()) {       String paramName = (String)paramNames.nextElement();       out.print("<tr><td>" + paramName + "</td>
");      String paramValue = request.getParameterValues(paramName);      out.println("<td> " + paramValue + "</td></tr>
");   }%></table></center></body></html>

以下是Hello.htm文件的内容:

<html><body><form action="main.jsp" method="POST" target="_blank"><input type="checkbox" name="maths" checked="checked" /> Maths<input type="checkbox" name="physics"  /> Physics<input type="checkbox" name="chemistry" checked="checked" /> Chem<input type="submit" value="Select Subject" /></form></body></html>

现在我们通过浏览器访问 Hello.htm 文件并提交数据,输出结果如下:

form-3

你可以尝试使用以上的JSP代码读取其它对象,如文本框,单选按钮或下拉框等等其他形式的数据。


Servlet和JSP中的过滤器都是Java类,它们存在的目的如下:

  • 在请求访问后端资源时拦截它
  • 管理从服务器返回给客户端的响应

下面列出了多种常用的过滤器类型:

  • 认证过滤器
  • 数据压缩过滤器
  • 加密过滤器
  • 触发资源访问事件的过滤器
  • 图像转换过滤器
  • 登录和验证过滤器
  • MIME类型链过滤器
  • 令牌过滤器
  • 转换XML内容的XSL/T过滤器

过滤器将会被插入进web.xml文件中,然后映射servlet、JSP文件的名字,或URL模式。部署描述文件web.xml可以在 <Tomcat-installation-directory>conf 目录下找到。

当JSP容器启动网络应用程序时,它会创建每一个过滤器的实例,这些过滤器必须在部署描述文件web.xml中声明,并且按声明的顺序执行。


Servlet过滤器方法

一个过滤器就是一个Java类,它实现了javax.servlet.Filter 接口。javax.servlet.Filter接口定义了三个方法:

序号 方法 &描述
1 public void doFilter (ServletRequest, ServletResponse, FilterChain)

每当 request/response要通过过滤链时容器会调用这个方法,因为客户端请求链尾的资源
2 public void init(FilterConfig filterConfig)

容器调用这个方法来表明一个过滤器被安置在服务中
3 public void destroy()

容器调用这个方法来表明一个过滤器正在从服务中移除

JSP过滤器示例

这个例子将会打印IP地址和每次访问JSP文件的日期时间。当然,这只是个简单的例子,让您了解一些简单的过滤器用法,但是可以使用这些概念来自行构造更复杂的程序。

//  引入Java包import java.io.*;import javax.servlet.*;import javax.servlet.http.*;import java.util.*; // 实现 Filter 类public class LogFilter implements Filter  {   public void  init(FilterConfig config)                          throws ServletException{      // 获取初始化参数      String testParam = config.getInitParameter("test-param");        //打印初始化参数      System.out.println("Test Param: " + testParam);    }   public void  doFilter(ServletRequest request,                  ServletResponse response,                 FilterChain chain)                  throws java.io.IOException, ServletException {       // 获取客户端ip地址        String ipAddress = request.getRemoteAddr();       // 输出ip地址及当前时间      System.out.println("IP "+ ipAddress + ", Time "                                       + new Date().toString());       // 传递请求道过滤器链      chain.doFilter(request,response);   }   public void destroy( ){      /* 在Filter实例在服务器上被移除前调用。*/   }}

编译LogFilter.java文件,然后将编译后的class文件放在<Tomcat安装目录>/webapps/ROOT/WEB-INF/classes目录下。


web.xml文件中的JSP过滤器映射

过滤器被定义,然后映射成一个URL或JSP文件名,与servlet被定义然后映射的方式差不多。在部署描述文件web.xml中,使用<filter>标签来进行过滤器映射:

<filter>   <filter-name>LogFilter</filter-name>   <filter-class>LogFilter</filter-class>   <init-param>	  <param-name>test-param</param-name>	  <param-value>Initialization Paramter</param-value>   </init-param></filter><filter-mapping>   <filter-name>LogFilter</filter-name>   <url-pattern>/*</url-pattern></filter-mapping>

上述过滤器将会应用在所有servlet和JSP程序中,因为我们在配置中指定了" /*"。您也可以指定一个servlet或JSP路径,如果您只想要将过滤器应用在少数几个servlet或JSP程序中的话。

现在,像平常一样访问servlet或JSP页面,您就会发现服务器日志中产生了关于此次访问的记录。您也可以使用Log4J记录器来把日志记录在其它文件中。


使用多重过滤器

您的网络应用程序可以定义很多不同的过滤器。现在,您定义了两个过滤器,AuthenFilter和LogFilter,其它的步骤与前面讲的一样,除非要创建一个不同的映射,就像下面这样:

<filter>   <filter-name>LogFilter</filter-name>   <filter-class>LogFilter</filter-class>   <init-param>	  <param-name>test-param</param-name>	  <param-value>Initialization Paramter</param-value>   </init-param></filter> <filter>   <filter-name>AuthenFilter</filter-name>   <filter-class>AuthenFilter</filter-class>   <init-param>	  <param-name>test-param</param-name>	  <param-value>Initialization Paramter</param-value>   </init-param></filter> <filter-mapping>   <filter-name>LogFilter</filter-name>   <url-pattern>/*</url-pattern></filter-mapping> <filter-mapping>   <filter-name>AuthenFilter</filter-name>   <url-pattern>/*</url-pattern></filter-mapping>

过滤器的应用顺序

在web.xml中<filter>元素的映射顺序决定了容器应用这些过滤器的顺序。要反转应用的顺序,您只需要反转web.xml中<filter>元素的定义顺序就行了。

比如,上面的例子会首先应用 LogFilter然后再应用AuthenFilter,但是下面这个例子将会反转应用的顺序:

<filter-mapping>   <filter-name>AuthenFilter</filter-name>   <url-pattern>/*</url-pattern></filter-mapping> <filter-mapping>   <filter-name>LogFilter</filter-name>   <url-pattern>/*</url-pattern></filter-mapping>


Cookies是存储在客户机的文本文件,它们保存了大量轨迹信息。在servlet技术基础上,JSP显然能够提供对HTTP cookies的支持。

通常有三个步骤来识别回头客:

  • 服务器脚本发送一系列cookies至浏览器。比如名字,年龄,ID号码等等。
  • 浏览器在本地机中存储这些信息,以备不时之需。
  • 当下一次浏览器发送任何请求至服务器时,它会同时将这些cookies信息发送给服务器,然后服务器使用这些信息来识别用户或者干些其它事情。

本章节将会传授您如何去设置或重设cookie的方法,还有如何访问它们及如何删除它们。


Cookie剖析

Cookies通常在HTTP信息头中设置(虽然JavaScript能够直接在浏览器中设置cookies)。在JSP中,设置一个cookie需要发送如下的信息头给服务器:

HTTP/1.1 200 OKDate: Fri, 04 Feb 2000 21:03:38 GMTServer: Apache/1.3.9 (UNIX) PHP/4.0b3Set-Cookie: name=xyz; expires=Friday, 04-Feb-07 22:03:38 GMT;                  path=/; domain=tutorialspoint.comConnection: closeContent-Type: text/html

正如您所见,Set-Cookie信息头包含一个键值对,一个GMT(格林尼治标准)时间,一个路径,一个域名。键值对会被编码为URL。有效期域是个指令,告诉浏览器在什么时候之后就可以清除这个cookie。

如果浏览器被配置成可存储cookies,那么它将会保存这些信息直到过期。如果用户访问的任何页面匹配了cookie中的路径和域名,那么浏览器将会重新将这个cookie发回给服务器。浏览器端的信息头长得就像下面这样:

GET / HTTP/1.0Connection: Keep-AliveUser-Agent: Mozilla/4.6 (X11; I; Linux 2.2.6-15apmac ppc)Host: zink.demon.co.uk:1126Accept: image/gif, */*Accept-Encoding: gzipAccept-Language: enAccept-Charset: iso-8859-1,*,utf-8Cookie: name=xyz

JSP脚本通过request对象中的getCookies()方法来访问这些cookies,这个方法会返回一个Cookie对象的数组。


Servlet Cookies 方法

下表列出了Cookie对象中常用的方法:

序号 方法 & 描述
1 public void setDomain(String pattern)

设置cookie的域名,比如51coolma.cn
2 public String getDomain()

获取cookie的域名,比如51coolma.cn
3 public void setMaxAge(int expiry)

设置cookie有效期,以秒为单位,默认有效期为当前session的存活时间
4 public int getMaxAge()

获取cookie有效期,以秒为单位,默认为-1 ,表明cookie会活到浏览器关闭为止
5 public String getName()

返回 cookie的名称,名称创建后将不能被修改
6 public void setValue(String newValue)

设置 cookie的值
7 public String getValue()

获取cookie的值
8 public void setPath(String uri)

设置cookie 的路径,默认为当前页面目录下的所有URL,还有此目录下的所有子目录
9 public String getPath()

获取cookie 的路径
10 public void setSecure(boolean flag)

指明cookie是否要加密传输
11 public void setComment(String purpose)

设置注释描述 cookie的目的。当浏览器将cookie展现给用户时,注释将会变得非常有用
12 public String getComment()

返回描述cookie目的的注释,若没有则返回null

使用JSP设置Cookies

使用JSP设置cookie包含三个步骤:

(1)创建一个Cookie对象: 调用Cookie的构造函数,使用一个cookie名称和值做参数,它们都是字符串。

Cookie cookie = new Cookie("key","value");

请务必牢记,名称和值中都不能包含空格或者如下的字符:

[ ] ( ) = , " / ? @ : ;

(2) 设置有效期:调用setMaxAge()函数表明cookie在多长时间(以秒为单位)内有效。下面的操作将有效期设为了24小时。

cookie.setMaxAge(60*60*24); 

(3) 将cookie发送至HTTP响应头中:调用response.addCookie()函数来向HTTP响应头中添加cookies。

response.addCookie(cookie);

实例演示

<%    
// 为 first_name 和 last_name设置cookie
Cookie firstName = new Cookie("first_name", request.getParameter("first_name"));
Cookie lastName = new Cookie("last_name",request.getParameter("last_name"));
// 设置cookie过期时间为24小时。
firstName.setMaxAge(60*60*24);
lastName.setMaxAge(60*60*24);
// 在响应头部添加cookie
response.addCookie( firstName );
response.addCookie( lastName );
%><html><head><title>Setting Cookies</title></head><body>
<center><h1>Setting Cookies</h1></center><ul><li><p><b>First Name:</b><%= request.getParameter("first_name")%></p></li><li><p><b>Last Name:</b> <%= request.getParameter("last_name")%></p></li></ul></body></html>

将上面的文件放在<Tomcat安装目录>/webapps/ROOT目录下,然后访问http://localhost:8080/hello.jsp,将会得到如下输出结果:

试着输入First Name和Last Name,然后点击提交按钮,它将会在您的屏幕中显示first name和last name,并且设置first name和last name两个cookie,下一次点击提交按钮时会发给服务器。


使用JSP读取Cookies

想要读取cookies,您就需要调用request.getCookies()方法来获得一个javax.servlet.http.Cookie对象的数组,然后遍历这个数组,使用getName()方法和getValue()方法来获取每一个cookie的名称和值。

让我们来读取上个例子中的cookies。

<html><head><title>Reading Cookies</title></head><body><center><h1>Reading Cookies</h1></center><%    
Cookie cookie = null;
Cookie[] cookies = null;
// 获取cookies的数据,是一个数组
cookies = request.getCookies();
if( cookies != null ){
out.println("<h2> Found Cookies Name and Value</h2>"); for (int i = 0; i < cookies.length; i++){
cookie = cookies[i];

out.print("Name : " + cookie.getName( ) + ", ");
out.print("Value: " + cookie.getValue( )+" <br/>"); } }else{ out.println("<h2>No cookies founds</h2>"); }%></body></html>

如果您把first name cookie设置成"John",last name设置成"Player",访问 http://localhost:8080/main.jsp,将会得到如下输出结果:

Found Cookies Name and ValueName : first_name, Value: John Name : last_name, Value: Player

使用JSP删除Cookies

删除cookies非常简单。如果您想要删除一个cookie,按照下面给的步骤来做就行了:

  • 获取一个已经存在的cookie然后存储在Cookie对象中。
  • 将cookie的有效期设置为0。
  • 将这个cookie重新添加进响应头中。

实例演示

下面的程序删除一个名为"first_name"的cookie,当您下次运行main.jsp时,first_name将会为null。

<html><head><title>Reading Cookies</title></head><body><center>  <h1>Reading Cookies</h1></center><%    
Cookie cookie = null;
Cookie[] cookies = null;
// 获取当前域名下的cookies,是一个数组
cookies = request.getCookies();
if( cookies != null ){
out.println("<h2> Found Cookies Name and Value</h2>"); for (int i = 0; i < cookies.length; i++){
cookie = cookies[i];
if((cookie.getName( )).compareTo("first_name") == 0 ){
cookie.setMaxAge(0);
response.addCookie(cookie);
out.print("Deleted cookie: " +
cookie.getName( ) + "<br/>"); } out.print("Name : " + cookie.getName( ) + ", "); out.print("Value: " + cookie.getValue( )+" <br/>"); } }else{ out.println( "<h2>No cookies founds</h2>"); }%></body></html>

访问它,将会得到如下输出结果:

Cookies Name and ValueDeleted cookie : first_nameName : first_name, Value: JohnName : last_name, Value: Player

再次访问http://localhost:8080/main.jsp,将会得到如下结果:

Found Cookies Name and ValueName : last_name, Value: Player

您也可以手动在浏览器中删除cookies。点击Tools菜单项,然后选择Internet Options,点击Delete Cookies,就能删除所有cookies了。


HTTP是无状态协议,这意味着每次客户端检索网页时,都要单独打开一个服务器连接,因此服务器不会记录下先前客户端请求的任何信息。

有三种方法来维持客户端与服务器的会话:


Cookies

网络服务器可以指定一个唯一的session ID作为cookie来代表每个客户端,用来识别这个客户端接下来的请求。

这可能不是一种有效的方式,因为很多时候浏览器并不一定支持cookie,所以我们不建议使用这种方法来维持会话。


隐藏表单域

一个网络服务器可以发送一个隐藏的HTML表单域和一个唯一的session ID,就像下面这样:

<input type="hidden" name="sessionid" value="12345">

这个条目意味着,当表单被提交时,指定的名称和值将会自动包含在GET或POST数据中。每当浏览器发送一个请求,session_id的值就可以用来保存不同浏览器的轨迹。

这种方式可能是一种有效的方式,但点击<A HREF>标签中的超链接时不会产生表单提交事件,因此隐藏表单域也不支持通用会话跟踪。


重写URL

您可以在每个URL后面添加一些额外的数据来区分会话,服务器能够根据这些数据来关联session标识符。

举例来说,http://51coolma.cn/file.htm;sessionid=12345, session标识符为sessionid=12345,服务器可以用这个数据来识别客户端。

相比而言,重写URL是更好的方式来,就算浏览器不支持cookies也能工作,但缺点是您必须为每个URL动态指定session ID,就算这是个简单的HTML页面。


session对象

除了以上几种方法外,JSP利用servlet提供的HttpSession接口来识别一个用户,存储这个用户的所有访问信息。

默认情况下,JSP允许会话跟踪,一个新的HttpSession对象将会自动地为新的客户端实例化。禁止会话跟踪需要显式地关掉它,通过将page指令中session属性值设为false来实现,就像下面这样:

<%@ page session="false" %>

JSP引擎将隐含的session对象暴露给开发者。由于提供了session对象,开发者就可以方便地存储或检索数据。

下表列出了session对象的一些重要方法:

S.N. 方法 & 描述
1 public Object getAttribute(String name)

返回session对象中与指定名称绑定的对象,如果不存在则返回null
2 public Enumeration getAttributeNames()

返回session对象中所有的对象名称
3 public long getCreationTime()

返回session对象被创建的时间, 以毫秒为单位,从1970年1月1号凌晨开始算起
4 public String getId()

返回session对象的ID
5 public long getLastAccessedTime()

返回客户端最后访问的时间,以毫秒为单位,从1970年1月1号凌晨开始算起
6 public int getMaxInactiveInterval()

返回最大时间间隔,以秒为单位,servlet 容器将会在这段时间内保持会话打开
7 public void invalidate()

将session无效化,解绑任何与该session绑定的对象
8 public boolean isNew(

返回是否为一个新的客户端,或者客户端是否拒绝加入session
9 public void removeAttribute(String name)

移除session中指定名称的对象
10 public void setAttribute(String name, Object value) 

使用指定的名称和值来产生一个对象并绑定到session中
11 public void setMaxInactiveInterval(int interval)

用来指定时间,以秒为单位,servlet容器将会在这段时间内保持会话有效

JSP Session应用

这个例子描述了如何使用HttpSession对象来获取创建时间和最后一次访问时间。我们将会为request对象关联一个新的session对象,如果这个对象尚未存在的话。

<%@ page import="java.io.*,java.util.*" %><%    // 获取session创建时间    Date createTime = new Date(session.getCreationTime());    // 获取最后访问页面的时间    Date lastAccessTime = new Date(session.getLastAccessedTime());     String title = "Welcome Back to my website";    Integer visitCount = new Integer(0);    String visitCountKey = new String("visitCount");    String userIDKey = new String("userID");    String userID = new String("ABCD");     // 检测网页是否由新的访问用户    if (session.isNew()){       title = "Welcome to my website";       session.setAttribute(userIDKey, userID);       session.setAttribute(visitCountKey,  visitCount);    }     visitCount = (Integer)session.getAttribute(visitCountKey);    visitCount = visitCount + 1;    userID = (String)session.getAttribute(userIDKey);    session.setAttribute(visitCountKey,  visitCount); %><html><head><title>Session Tracking</title></head><body><center><h1>Session Tracking</h1></center><table border="1" align="center"> <tr bgcolor="#949494">   <th>Session info</th>   <th>Value</th></tr> <tr>   <td>id</td>   <td><% out.print( session.getId()); %></td></tr> <tr>   <td>Creation Time</td>   <td><% out.print(createTime); %></td></tr> <tr>   <td>Time of Last Access</td>   <td><% out.print(lastAccessTime); %></td></tr> <tr>   <td>User ID</td>   <td><% out.print(userID); %></td></tr> <tr>   <td>Number of visits</td>   <td><% out.print(visitCount); %></td></tr> </table> </body></html>

试着访问http://localhost:8080/main.jsp ,第一次运行时将会得到如下结果:


再次访问,将会得到如下结果:



删除Session数据

当处理完一个用户的会话数据后,您可以有如下选择:

  • 移除一个特定的属性:

    调用public void removeAttribute(String name)  方法来移除指定的属性。

  • 删除整个会话:

    调用public void invalidate() 方法来使整个session无效。

  • 设置会话有效期:

    调用 public void setMaxInactiveInterval(int interval)  方法来设置session超时。

  • 登出用户:

    支持servlet2.4版本的服务器,可以调用 logout()方法来登出用户,并且使所有相关的session无效。

  • 配置web.xml文件:

    如果使用的是Tomcat,可以向下面这样配置web.xml文件:

  <session-config>    <session-timeout>15</session-timeout>  </session-config>

超时以分钟为单位,Tomcat中的默认的超时时间是30分钟。

Servlet中的getMaxInactiveInterval( ) 方法以秒为单位返回超时时间。如果在web.xml中配置的是15分钟,则getMaxInactiveInterval( ) 方法将会返回900。


使用JSP最重要的优势之一,就是可以使用所有Java  API。本章将会详细地讲述Java中的Date类,它在java.util包下,封装了当前日期和时间。

Date类有两个构造函数。第一个构造函数使用当前日期和时间来初始化对象。

Date( )

第二个构造函数接受一个参数,这个参数表示从1970年1月1日凌晨至所要表示时间的毫秒数。

Date(long millisec)

获取Date对象后,您就能够使用下表列出的所有方法:

序号 方法 & 描述
1 boolean after(Date date)

如果比给定的日期晚,则返回true,否则返回false
2 boolean before(Date date)

如果比给定的日期早,则返回true,否则返回false
3 Object clone( )

获取当前对象的一个副本
4 int compareTo(Date date)

如果与给定日期相等,则返回0,如果比给定日期早,则返回一个负数,如果比给定日期晚,则返回一个正数
5 int compareTo(Object obj)

与 compareTo(Date) 方法相同,如果 obj 不是Date类或其子类的对象,抛出ClassCastException异常
6 boolean equals(Object date)

如果与给定日期相同,则返回true,否则返回false
7 long getTime( )

返回从1970年1月1日凌晨至此对象所表示时间的毫秒数
8 int hashCode( )

返回此对象的哈希码
9 void setTime(long time)

使用给定参数设置时间和日期,参数time表示从1970年1月1日凌晨至time所经过的毫秒数
10 String toString( )

将此对象转换为字符串并返回这个字符串

获取当前日期和时间

使用JSP编程可以很容易的获取当前日期和时间,只要使用Date对象的toString()方法就行了,就像下面这样:

<%@ page import="java.io.*,java.util.*, javax.servlet.*" %><html><head><title>Display Current Date & Time</title></head><body><center><h1>Display Current Date & Time</h1></center><%    Date date = new Date();    out.print( "<h2 align="center">" +date.toString()+"</h2>");%></body></html>

将上面的代码保存在CurrentDate.jsp文件中,然后访问http://localhost:8080/CurrentDate.jsp,运行结果如下:

Display Current Date & TimeMon Jun 21 21:46:49 GMT+04:00 2013

刷新http://localhost:8080/CurrentDate.jsp,就可以发现每次刷新所得到的秒数都不相同。


日期比较

就像我在开头所提到的,您可以在JSP脚本中使用任何Java方法。如果您想要比较两个日期,

可以参照下面的方法来做:

  • 使用getTime()方法得到毫秒数,然后比较毫秒数就行了。
  • 使用before(),after(),equals()方法。比如,new Date(99,2,12).before(new Date(99,2,18))返回true。
  • 使用compareTo()方法,这个方法在Comparable接口中定义,在Date中实现。

使用SimpleDateFormat格式化日期

SimpleDateFormat使用一种地区敏感的方式来格式化和解析日期,它允许您使用自定义的模式来格式化日期和时间。

对CurrentDate.jsp稍作修改,得到如下修改后的代码:

<%@ page import="java.io.*,java.util.*" %><%@ page import="javax.servlet.*,java.text.*" %><html><head><title>Display Current Date & Time</title></head><body><center><h1>Display Current Date & Time</h1></center><%    Date dNow = new Date( );    SimpleDateFormat ft = new SimpleDateFormat ("E yyyy.MM.dd 'at' hh:mm:ss a zzz");    out.print( "<h2 align="center">" + ft.format(dNow) + "</h2>");%></body></html>

再次编译CurrentDate.jsp,然后访问http://localhost:8080/CurrentDate.jsp,就可以得到如下结果:

Display Current Date & TimeMon 2013.06.21 at 10:06:44 PM GMT+04:00

SimpleDateFormat格式码

要指定模式字符串,需要使用下表列出的格式码:

字符 描述 示例
G 时代标识符 AD
y 4位数年份 2001
M July or 07
d 10
h 12小时制, A.M./P.M. (1~12) 12
H 24小时制 22
m 分钟 30
s 55
S 毫秒 234
E 星期 Tuesday
D 一年中的某天 360
F 一个月中某星期的某天 2 (second Wed. in July)
w 一年中的某星期 40
W 一个月中的某星期 1
a A.M./P.M. 标记 PM
k 一天中的某个小时 (1~24) 24
K 一天中的某个小时,A.M./P.M. (0~11) 10
z 时区 Eastern Standard Time
' 文本分隔 Delimiter
" 单引号 `

更多关于Date类的详细信息请查阅Java API文档。


当需要将文档移动到一个新的位置时,就需要使用JSP重定向了。

最简单的重定向方式就是使用response对象的sendRedirect()方法。这个方法的签名如下:

public void response.sendRedirect(String location)throws IOException 

这个方法将状态码和新的页面位置作为响应发回给浏览器。您也可以使用setStatus()和setHeader()方法来得到同样的效果:

....String site = "http://www.51coolma.cn" ;response.setStatus(response.SC_MOVED_TEMPORARILY);response.setHeader("Location", site); ....

实例演示

这个例子表明了JSP如何进行页面重定向:

<%@ page import="java.io.*,java.util.*" %><html><head><title>Page Redirection</title></head><body><center><h1>Page Redirection</h1></center><%    // 重定向到新地址    String site = new String("http://www.51coolma.cn");    response.setStatus(response.SC_MOVED_TEMPORARILY);    response.setHeader("Location", site);  %></body></html>

将以上代码保存在PageRedirecting.jsp文件中,然后访问http://localhost:8080/PageRedirect.jsp,它将会把您带至//www.51coolma.cn/


有时候我们需要知道某个页面被访问的次数,这时我们就需要在页面上添加页面统计器,页面访问的统计一般在用户第一次载入时累加该页面的访问数上。

要实现一个计数器,您可以利用应用程序隐式对象和相关方法getAttribute()和setAttribute()来实现。

这个对象表示JSP页面的整个生命周期中。当JSP页面初始化时创建此对象,当JSP页面调用jspDestroy()时删除该对象。

以下是在应用中创建变量的语法:

application.setAttribute(String Key, Object Value);

您可以使用上述方法来设置一个计数器变量及更新该变量的值。读取该变量的方法如下:

application.getAttribute(String Key);

在页面每次被访问时,你可以读取计数器的当前值,并递增1,然后重新设置,在下一个用户访问时就将新的值显示在页面上。


实例演示

该实例将介绍如何使用JSP来计算特定页面访问的总人数。如果你要计算你网站使用页面的总点击量,那么你就必须将该代码放在所有的JSP页面上。

<%@ page import="java.io.*,java.util.*" %><html><head><title>Applcation object in JSP</title></head><body><%     Integer hitsCount = (Integer)application.getAttribute("hitCounter");     if( hitsCount ==null || hitsCount == 0 ){            /* 第一次访问 */            out.println("Welcome to my website!");            hitsCount = 1;     }else{            /* 返回访问值 */            out.println("Welcome back to my website!");            hitsCount += 1;     }         application.setAttribute("hitCounter", hitsCount); %><center><p>Total number of visits: <%= hitsCount%></p></center></body></html>

现在我们将上面的代码放置于main.jsp文件上,并访问http://localhost:8080/main.jsp文件。你会看到页面会生成个计数器,在我们每次刷新页面时,计数器都会发生变化(每次刷新增加1)。 你也可以通过不同的浏览器访问,计数器会在每次访问后增加1。如下所示:

Welcome back to my website!Total number of visits: 12

复位计数器

使用以上方法,在web服务器重启后,计数器会被复位为0,即前面保留的数据都会消失,你可以使用一下几种方式解决该问题:

  • 在数据库中定义一个用于统计网页访问量的数据表count,字段为hitcount,hitcount默认值为0,将统计数据写入到数据表中。
  • 在每次访问时我们读取表中hitcount字段。

  • 每次访问时让hitcount自增1。
  • 在页面上显示新的 hitcount 值作为页面的访问量。

  • 如果你需要统计每个页面的访问量,你可以使用以上逻辑将代码添加到所有页面上。


想象一下,如果要直播比赛的比分,或股票市场的实时状态,或当前的外汇配给,该怎么实现呢?显然,要实现这种实时功能,您就不得不规律性地刷新页面。

JSP提供了一种机制来使这种工作变得简单,它能够定时地自动刷新页面。

刷新一个页面最简单的方式就是使用response对象的setIntHeader()方法。这个方法的签名如下:

public void setIntHeader(String header, int headerValue)

这个方法通知浏览器在给定的时间后刷新,时间以秒为单位。


页面自动刷新程序示例

这个例子使用了setIntHeader()方法来设置刷新头,模拟一个数字时钟:

<%@ page import="java.io.*,java.util.*" %><html><head><title>Auto Refresh Header Example</title></head><body><center><h2>Auto Refresh Header Example</h2><%    // Set refresh, autoload time as 5 seconds    response.setIntHeader("Refresh", 5);    // Get current time    Calendar calendar = new GregorianCalendar();    String am_pm;    int hour = calendar.get(Calendar.HOUR);    int minute = calendar.get(Calendar.MINUTE);    int second = calendar.get(Calendar.SECOND);    if(calendar.get(Calendar.AM_PM) == 0)       am_pm = "AM";    else       am_pm = "PM";    String CT = hour+":"+ minute +":"+ second +" "+ am_pm;    out.println("Crrent Time: " + CT + "
"); %></center></body></html>

把以上代码保存在main.jsp文件中,访问它。它会每隔5秒钟刷新一次页面并获取系统当前时间。运行结果如下:

Auto Refresh Header ExampleCurrent Time is: 9:44:50 PM

您也可以自己动手写个更复杂点的程序。


虽然使用JSP实现邮件发送功能很简单,但是需要有JavaMail API,并且需要安装JavaBean Activation Framework。

下载并解压这些文件,在根目录下,您将会看到一系列jar包。将mail.jar包和activation.jar包加入CLASSPATH变量中。

发送一封简单的邮件

这个例子展示了如何从您的机器发送一封简单的邮件。它假定localhost已经连接至网络并且有能力发送一封邮件。与此同时,请再一次确认mail.jar包和activation.jar包已经添加进CLASSPATH变量中。

<%@ page import="java.io.*,java.util.*,javax.mail.*"%><%@ page import="javax.mail.internet.*,javax.activation.*"%><%@ page import="javax.servlet.http.*,javax.servlet.*" %><%    String result;    // 收件人的电子邮件    String to = "abcd@gmail.com";     // 发件人的电子邮件    String from = "mcmohd@gmail.com";     // 假设你是从本地主机发送电子邮件    String host = "localhost";     // 获取系统属性对象    Properties properties = System.getProperties();     // 设置邮件服务器    properties.setProperty("mail.smtp.host", host);     // 获取默认的Session对象。    Session mailSession = Session.getDefaultInstance(properties);     try{       // 创建一个默认的MimeMessage对象。       MimeMessage message = new MimeMessage(mailSession);       // 设置 From: 头部的header字段       message.setFrom(new InternetAddress(from));       // 设置 To: 头部的header字段       message.addRecipient(Message.RecipientType.TO,                                new InternetAddress(to));       // 设置 Subject: header字段       message.setSubject("This is the Subject Line!");       // 现在设置的实际消息       message.setText("This is actual message");       // 发送消息       Transport.send(message);       result = "Sent message successfully....";    }catch (MessagingException mex) {       mex.printStackTrace();       result = "Error: unable to send message....";    } %><html><head><title>Send Email using JSP</title></head><body><center><h1>Send Email using JSP</h1></center><p align="center"><%     out.println("Result: " + result + "
"); %></p></body></html>

现在访问http://localhost:8080/SendEmail.jsp,它将会发送一封邮件给abcd@gmail.com 并显示如下结果:

Send Email using JSPResult: Sent message successfully....

如果想要把邮件发送给多人,下面列出的方法可以用来指明多个邮箱地址:

void addRecipients(Message.RecipientType type,                    Address[] addresses)throws MessagingException

参数的描述如下:

  • type:这个值将会被设置成TO,CC,或BCC。CC代表副本,BCC代表黑色副本,例子程序中使用的是TO。
  • addresses:这是一个邮箱地址的数组,当指定邮箱地址时需要使用InternetAddress()方法。

发送一封HTML邮件

这个例子发送一封简单的HTML邮件。它假定您的localhost已经连接至网络并且有能力发送邮件。与此同时,请再一次确认mail.jar包和activation.jar包已经添加进CLASSPATH变量中。

这个例子和前一个例子非常相似,不过在这个例子中我们使用了setContent()方法,将"text/html"做为第二个参数传给它,用来表明消息中包含了HTML内容。

<%@ page import="java.io.*,java.util.*,javax.mail.*"%><%@ page import="javax.mail.internet.*,javax.activation.*"%><%@ page import="javax.servlet.http.*,javax.servlet.*" %><%    String result;    // 收件人的电子邮件    String to = "abcd@gmail.com";     // 发件人的电子邮件    String from = "mcmohd@gmail.com";     // 假设你是从本地主机发送电子邮件    String host = "localhost";     // 获取系统属性对象    Properties properties = System.getProperties();     // 设置邮件服务器    properties.setProperty("mail.smtp.host", host);     // 获取默认的Session对象。    Session mailSession = Session.getDefaultInstance(properties);     try{       // 创建一个默认的MimeMessage对象。       MimeMessage message = new MimeMessage(mailSession);       // 设置 From: 头部的header字段       message.setFrom(new InternetAddress(from));       // 设置 To: 头部的header字段       message.addRecipient(Message.RecipientType.TO,                                new InternetAddress(to));       // 设置 Subject: header字段       message.setSubject("This is the Subject Line!");             // 设置 HTML消息       message.setContent("<h1>This is actual message</h1>","text/html" );      // 发送消息      Transport.send(message);      result = "Sent message successfully....";   }catch (MessagingException mex) {      mex.printStackTrace();      result = "Error: unable to send message....";   }%><html><head><title>Send HTML Email using JSP</title></head><body><center><h1>Send Email using JSP</h1></center><p align="center"><%     out.println("Result: " + result + "
"); %></p></body></html>

现在你可以尝试使用以上JSP文件来发送HTML消息的电子邮件。


在邮件中包含附件

这个例子告诉我们如何发送一封包含附件的邮件。

<%@ page import="java.io.*,java.util.*,javax.mail.*"%><%@ page import="javax.mail.internet.*,javax.activation.*"%><%@ page import="javax.servlet.http.*,javax.servlet.*" %><%    String result;    // 收件人的电子邮件    String to = "abcd@gmail.com";     // 发件人的电子邮件    String from = "mcmohd@gmail.com";     // 假设你是从本地主机发送电子邮件    String host = "localhost";     // 获取系统属性对象    Properties properties = System.getProperties();     // 设置邮件服务器    properties.setProperty("mail.smtp.host", host);     // 获取默认的Session对象。    Session mailSession = Session.getDefaultInstance(properties);     try{       // 创建一个默认的MimeMessage对象。       MimeMessage message = new MimeMessage(mailSession);        // 设置 From: 头部的header字段       message.setFrom(new InternetAddress(from));        // 设置 To: 头部的header字段       message.addRecipient(Message.RecipientType.TO,                                new InternetAddress(to));        // 设置 Subject: header字段       message.setSubject("This is the Subject Line!");        // 创建消息部分       BodyPart messageBodyPart = new MimeBodyPart();        // 填充消息       messageBodyPart.setText("This is message body");              // 创建多媒体消息       Multipart multipart = new MimeMultipart();        // 设置文本消息部分       multipart.addBodyPart(messageBodyPart);        // 附件部分       messageBodyPart = new MimeBodyPart();       String filename = "file.txt";       DataSource source = new FileDataSource(filename);       messageBodyPart.setDataHandler(new DataHandler(source));       messageBodyPart.setFileName(filename);       multipart.addBodyPart(messageBodyPart);        // 发送完整消息       message.setContent(multipart );        // 发送消息       Transport.send(message);       String title = "Send Email";       result = "Sent message successfully....";    }catch (MessagingException mex) {       mex.printStackTrace();       result = "Error: unable to send message....";    } %><html><head><title>Send Attachement Email using JSP</title></head><body><center><h1>Send Attachement Email using JSP</h1></center><p align="center"><%     out.println("Result: " + result + "
"); %></p></body></html>

用户认证部分

如果邮件服务器需要用户名和密码来进行用户认证的话,可以像下面这样来设置:

 props.setProperty("mail.user", "myuser"); props.setProperty("mail.password", "mypwd");

使用表单发送邮件

使用HTML表单接收一封邮件,并通过request对象获取所有邮件信息:

String to = request.getParameter("to");String from = request.getParameter("from");String subject = request.getParameter("subject");String messageText = request.getParameter("body");

获取以上信息后,您就可以使用前面提到的例子来发送邮件了。


JSP标准标签库(JSTL)是一个JSP标签集合,它封装了JSP应用的通用核心功能。

JSTL支持通用的、结构化的任务,比如迭代,条件判断,XML文档操作,国际化标签,SQL标签。 除了这些,它还提供了一个框架来使用集成JSTL的自定义标签。

根据JSTL标签所提供的功能,可以将其分为5个类别。

  • 核心标签
  • 格式化标签
  • SQL 标签
  • XML 标签
  • JSTL 函数

JSTL 库安装

Apache Tomcat安装JSTL 库步骤如下:

  • 从Apache的标准标签库中下载的二进包(jakarta-taglibs-standard-current.zip)。下载地址:http://archive.apache.org/dist/jakarta/taglibs/standard/binaries/
  • 下载jakarta-taglibs-standard-1.1.1.zip 包并解压,将jakarta-taglibs-standard-1.1.1/lib/下的两个jar文件:standard.jar和jstl.jar文件拷贝到/WEB-INF/lib/下。
  • 接下来我们在 web.xml 文件中添加以下配置:

    ……	<jsp-config>	<taglib>	<taglib-uri>http://java.sun.com/jstl/fmt</taglib-uri>	<taglib-location>/WEB-INF/fmt.tld</taglib-location>	</taglib>	<taglib>	<taglib-uri>http://java.sun.com/jstl/fmt-rt</taglib-uri>	<taglib-location>/WEB-INF/fmt-rt.tld</taglib-location>	</taglib>	<taglib>	<taglib-uri>http://java.sun.com/jstl/core</taglib-uri>	<taglib-location>/WEB-INF/c.tld</taglib-location>	</taglib>	<taglib>	<taglib-uri>http://java.sun.com/jstl/core-rt</taglib-uri>	<taglib-location>/WEB-INF/c-rt.tld</taglib-location>	</taglib>	<taglib>	<taglib-uri>http://java.sun.com/jstl/sql</taglib-uri>	<taglib-location>/WEB-INF/sql.tld</taglib-location>	</taglib>	<taglib>	<taglib-uri>http://java.sun.com/jstl/sql-rt</taglib-uri>	<taglib-location>/WEB-INF/sql-rt.tld</taglib-location>	</taglib>	<taglib>	<taglib-uri>http://java.sun.com/jstl/x</taglib-uri>	<taglib-location>/WEB-INF/x.tld</taglib-location>	</taglib>	<taglib>	<taglib-uri>http://java.sun.com/jstl/x-rt</taglib-uri>	<taglib-location>/WEB-INF/x-rt.tld</taglib-location>	</taglib>	</jsp-config>……

    使用任何库,你必须在每个JSP文件中的头部包含<taglib>标签。


核心标签

核心标签是最常用的JSTL标签。引用核心标签库的语法如下:

<%@ taglib prefix="c"                       uri="http://java.sun.com/jsp/jstl/core" %>
标签 描述
<c:out> 用于在JSP中显示数据,就像<%= ... >
<c:set> 用于保存数据
<c:remove> 用于删除数据
<c:catch> 用来处理产生错误的异常状况,并且将错误信息储存起来
<c:if> 与我们在一般程序中用的if一样
<c:choose> 本身只当做<c:when>和<c:otherwise>的父标签
<c:when> <c:choose>的子标签,用来判断条件是否成立
<c:otherwise> <c:choose>的子标签,接在<c:when>标签后,当<c:when>标签判断为false时被执行
<c:import> 检索一个绝对或相对 URL,然后将其内容暴露给页面
<c:forEach> 基础迭代标签,接受多种集合类型
<c:forTokens> 根据指定的分隔符来分隔内容并迭代输出
<c:param> 用来给包含或重定向的页面传递参数
<c:redirect> 重定向至一个新的URL.
<c:url> 使用可选的查询参数来创造一个URL

格式化标签

JSTL格式化标签用来格式化并输出文本、日期、时间、数字。引用格式化标签库的语法如下:

<%@ taglib prefix="fmt"            uri="http://java.sun.com/jsp/jstl/fmt" %>

标签 描述
<fmt:formatNumber> 使用指定的格式或精度格式化数字
<fmt:parseNumber> 解析一个代表着数字,货币或百分比的字符串
<fmt:formatDate> 使用指定的风格或模式格式化日期和时间
<fmt:parseDate> 解析一个代表着日期或时间的字符串
<fmt:bundle> 绑定资源
<fmt:setLocale> 指定地区
<fmt:setBundle> 绑定资源
<fmt:timeZone> 指定时区
<fmt:setTimeZone> 指定时区
<fmt:message> 显示资源配置文件信息
<fmt:requestEncoding> 设置request的字符编码

SQL标签

JSTL SQL标签库提供了与关系型数据库(Oracle,MySQL,SQL Server等等)进行交互的标签。引用SQL标签库的语法如下:

<%@ taglib prefix="sql"                        uri="http://java.sun.com/jsp/jstl/sql" %>
标签 描述
<sql:setDataSource> 指定数据源
<sql:query> 运行SQL查询语句
<sql:update> 运行SQL更新语句
<sql:param> 将SQL语句中的参数设为指定值
<sql:dateParam> 将SQL语句中的日期参数设为指定的java.util.Date 对象值
<sql:transaction> 在共享数据库连接中提供嵌套的数据库行为元素,将所有语句以一个事务的形式来运行

XML 标签

JSTL XML标签库提供了创建和操作XML文档的标签。引用XML标签库的语法如下:

<%@ taglib prefix="x"                        uri="http://java.sun.com/jsp/jstl/xml" %>

在使用xml标签前,你必须将XML 和 XPath 的相关包拷贝至你的<Tomcat 安装目录>lib下:

标签 描述
<x:out> 与<%= ... >,类似,不过只用于XPath表达式
<x:parse> 解析 XML 数据
<x:set> 设置XPath表达式
<x:if> 判断XPath表达式,若为真,则执行本体中的内容,否则跳过本体
<x:forEach> 迭代XML文档中的节点
<x:choose> <x:when>和<x:otherwise>的父标签
<x:when> <x:choose>的子标签,用来进行条件判断
<x:otherwise> <x:choose>的子标签,当<x:when>判断为false时被执行
<x:transform> 将XSL转换应用在XML文档中
<x:param> 与<x:transform>共同使用,用于设置XSL样式表

JSTL函数

JSTL包含一系列标准函数,大部分是通用的字符串处理函数。引用JSTL函数库的语法如下:

<%@ taglib prefix="fn"                        uri="http://java.sun.com/jsp/jstl/functions" %>
函数 描述
fn:contains() 测试输入的字符串是否包含指定的子串
fn:containsIgnoreCase() 测试输入的字符串是否包含指定的子串,大小写不敏感
fn:endsWith() 测试输入的字符串是否以指定的后缀结尾
fn:escapeXml() 跳过可以作为XML标记的字符
fn:indexOf() 返回指定字符串在输入字符串中出现的位置
fn:join() 将数组中的元素合成一个字符串然后输出
fn:length() 返回字符串长度
fn:replace() 将输入字符串中指定的位置替换为指定的字符串然后返回
fn:split() 将字符串用指定的分隔符分隔然后组成一个子字符串数组并返回
fn:startsWith() 测试输入字符串是否以指定的前缀开始
fn:substring() 返回字符串的子集
fn:substringAfter() 返回字符串在指定子串之后的子集
fn:substringBefore() 返回字符串在指定子串之前的子集
fn:toLowerCase() 将字符串中的字符转为小写
fn:toUpperCase() 将字符串中的字符转为大写
fn:trim() 移除首位的空白符


本章节假设您已经对JDBC有一定的了解。在开始学习JSP数据库访问前,请确保JDBC环境已经正确配置。

首先,让我们按照下面的步骤来创建一个简单的表并插入几条简单的记录:


创建表

在数据库中创建一个Employees表,步骤如下:

步骤1:

打开CMD,然后进入数据库安装目录:

C:>C:>cd Program FilesMySQLinC:Program FilesMySQLin>

步骤2:

C:Program FilesMySQLin>mysql -u root -pEnter password: ********mysql>

步骤3:

用create database语句建立一个新的数据库TEST:

mysql> create database TEST

步骤4:

在TEST数据库中创建Employee表:

mysql> use TEST;mysql> create table Employees    (     id int not null,     age int not null,     first varchar (255),     last varchar (255)    );Query OK, 0 rows affected (0.08 sec)mysql>

插入数据记录

创建好Employee表后,往表中插入几条记录:

mysql> INSERT INTO Employees VALUES (100, 18, 'Zara', 'Ali');Query OK, 1 row affected (0.05 sec) mysql> INSERT INTO Employees VALUES (101, 25, 'Mahnaz', 'Fatma');Query OK, 1 row affected (0.00 sec) mysql> INSERT INTO Employees VALUES (102, 30, 'Zaid', 'Khan');Query OK, 1 row affected (0.00 sec) mysql> INSERT INTO Employees VALUES (103, 28, 'Sumit', 'Mittal');Query OK, 1 row affected (0.00 sec) mysql>

SELECT操作

接下来的这个例子告诉我们如何使用JSTL SQL标签来运行SQL SELECT语句:

<%@ page language="java" contentType="text/html; charset=UTF-8"    pageEncoding="UTF-8"%><%@ page import="java.io.*,java.util.*,java.sql.*"%><%@ page import="javax.servlet.http.*,javax.servlet.*" %><%@ taglib uri="http://java.sun.com/jsp/jstl/core" prefix="c"%><%@ taglib uri="http://java.sun.com/jsp/jstl/sql" prefix="sql"%> <html><head><title>SELECT 操作</title></head><body> <sql:setDataSource var="snapshot" driver="com.mysql.jdbc.Driver"     url="jdbc:mysql://localhost:3306/TEST"     user="root"  password="pass123"/> <sql:query dataSource="${snapshot}" var="result">SELECT * from Employees;</sql:query> <table border="1" width="100%"><tr>   <th>Emp ID</th>   <th>First Name</th>   <th>Last Name</th>   <th>Age</th></tr><c:forEach var="row" items="${result.rows}"><tr>   <td><c:out value="${row.id}"/></td>   <td><c:out value="${row.first}"/></td>   <td><c:out value="${row.last}"/></td>   <td><c:out value="${row.age}"/></td></tr></c:forEach></table> </body></html>

访问这个JSP例子,运行结果如下:

mysql-access-1


INSERT操作

这个例子告诉我们如何使用JSTL SQL标签来运行SQL INSERT语句:

<%@ page language="java" contentType="text/html; charset=UTF-8"    pageEncoding="UTF-8"%><%@ page import="java.io.*,java.util.*,java.sql.*"%><%@ page import="javax.servlet.http.*,javax.servlet.*" %><%@ taglib uri="http://java.sun.com/jsp/jstl/core" prefix="c"%><%@ taglib uri="http://java.sun.com/jsp/jstl/sql" prefix="sql"%> <html><head><title>INSERT 操作</title></head><body> <sql:setDataSource var="snapshot" driver="com.mysql.jdbc.Driver"     url="jdbc:mysql://localhost/TEST"     user="root"  password="pass123"/><sql:update dataSource="${snapshot}" var="result">INSERT INTO Employees VALUES (104, 2, 'Nuha', 'Ali');</sql:update> <sql:query dataSource="${snapshot}" var="result">SELECT * from Employees;</sql:query> <table border="1" width="100%"><tr>   <th>Emp ID</th>   <th>First Name</th>   <th>Last Name</th>   <th>Age</th></tr><c:forEach var="row" items="${result.rows}"><tr>   <td><c:out value="${row.id}"/></td>   <td><c:out value="${row.first}"/></td>   <td><c:out value="${row.last}"/></td>   <td><c:out value="${row.age}"/></td></tr></c:forEach></table> </body></html>

访问这个JSP例子,运行结果如下:

mysql-access-2


DELETE操作

这个例子告诉我们如何使用JSTL SQL标签来运行SQL DELETE语句:

<%@ page language="java" contentType="text/html; charset=UTF-8"    pageEncoding="UTF-8"%><%@ page import="java.io.*,java.util.*,java.sql.*"%><%@ page import="javax.servlet.http.*,javax.servlet.*" %><%@ taglib uri="http://java.sun.com/jsp/jstl/core" prefix="c"%><%@ taglib uri="http://java.sun.com/jsp/jstl/sql" prefix="sql"%> <html><head><title>DELETE 操作</title></head><body> <sql:setDataSource var="snapshot" driver="com.mysql.jdbc.Driver"     url="jdbc:mysql://localhost/TEST"     user="root"  password="pass123"/> <c:set var="empId" value="103"/> <sql:update dataSource="${snapshot}" var="count">  DELETE FROM Employees WHERE Id = ?  <sql:param value="${empId}" /></sql:update> <sql:query dataSource="${snapshot}" var="result">   SELECT * from Employees;</sql:query> <table border="1" width="100%"><tr>   <th>Emp ID</th>   <th>First Name</th>   <th>Last Name</th>   <th>Age</th></tr><c:forEach var="row" items="${result.rows}"><tr>   <td><c:out value="${row.id}"/></td>   <td><c:out value="${row.first}"/></td>   <td><c:out value="${row.last}"/></td>   <td><c:out value="${row.age}"/></td></tr></c:forEach></table> </body></html>

访问这个JSP例子,运行结果如下:

mysql-access-3


UPDATE操作

这个例子告诉我们如何使用JSTL SQL标签来运行SQL UPDATE语句:

<%@ page language="java" contentType="text/html; charset=UTF-8"    pageEncoding="UTF-8"%><%@ page import="java.io.*,java.util.*,java.sql.*"%><%@ page import="javax.servlet.http.*,javax.servlet.*" %><%@ taglib uri="http://java.sun.com/jsp/jstl/core" prefix="c"%><%@ taglib uri="http://java.sun.com/jsp/jstl/sql" prefix="sql"%> <html><head><title>UPDATE 操作</title></head><body> <sql:setDataSource var="snapshot" driver="com.mysql.jdbc.Driver"     url="jdbc:mysql://localhost/TEST"     user="root"  password="pass123"/> <c:set var="empId" value="102"/> <sql:update dataSource="${snapshot}" var="count">  UPDATE Employees SET last = 'Ali' WHERE Id = ?  <sql:param value="${empId}" /></sql:update> <sql:query dataSource="${snapshot}" var="result">   SELECT * from Employees;</sql:query> <table border="1" width="100%"><tr>   <th>Emp ID</th>   <th>First Name</th>   <th>Last Name</th>   <th>Age</th></tr><c:forEach var="row" items="${result.rows}"><tr>   <td><c:out value="${row.id}"/></td>   <td><c:out value="${row.first}"/></td>   <td><c:out value="${row.last}"/></td>   <td><c:out value="${row.age}"/></td></tr></c:forEach></table> </body></html>

访问这个JSP例子,运行结果如下:



当通过HTTP发送XML数据时,就有必要使用JSP来处理传入和流出的XML文档了,比如RSS文档。作为一个XML文档,它仅仅只是一堆文本而已,使用JSP创建XML文档并不比创建一个HTML文档难。


使用JSP发送XML

使用JSP发送XML内容就和发送HTML内容一样。唯一的不同就是您需要把页面的context属性设置为text/xml。要设置context属性,使用<%@page % >命令,就像这样:

<%@ page contentType="text/xml" %>

接下来这个例子向浏览器发送XML内容:

<%@ page contentType="text/xml" %><books>   <book>      <name>Padam History</name>      <author>ZARA</author>      <price>100</price>   </book></books>

使用不同的浏览器来访问这个例子,看看这个例子所呈现的文档树。


在JSP中处理XML

在使用JSP处理XML之前,您需要将与XML 和XPath相关的两个库文件放在<Tomcat Installation Directory>lib目录下:

books.xml文件:

<books><book>  <name>Padam History</name>  <author>ZARA</author>  <price>100</price></book><book>  <name>Great Mistry</name>  <author>NUHA</author>  <price>2000</price></book></books>

main.jsp文件:

<%@ page language="java" contentType="text/html; charset=UTF-8"    pageEncoding="UTF-8"%><%@ taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core" %><%@ taglib prefix="x" uri="http://java.sun.com/jsp/jstl/xml" %> <html><head>  <title>JSTL x:parse Tags</title></head><body><h3>Books Info:</h3><c:import var="bookInfo" url="http://localhost:8080/books.xml"/> <x:parse xml="${bookInfo}" var="output"/><b>The title of the first book is</b>: <x:out select="$output/books/book[1]/name" /><br><b>The price of the second book</b>: <x:out select="$output/books/book[2]/price" /> </body></html>

访问http://localhost:8080/main.jsp,运行结果如下:

BOOKS INFO:The title of the first book is:Padam History The price of the second book: 2000

使用JSP格式化XML

这个是XSLT样式表style.xsl文件:

<?xml version="1.0"?><xsl:stylesheet xmlns:xsl= "http://www.w3.org/1999/XSL/Transform" version="1.0"> <xsl:output method="html" indent="yes"/> <xsl:template match="/">  <html>  <body>   <xsl:apply-templates/>  </body>  </html></xsl:template> <xsl:template match="books">  <table border="1" width="100%">    <xsl:for-each select="book">      <tr>        <td>          <i><xsl:value-of select="name"/></i>        </td>        <td>          <xsl:value-of select="author"/>        </td>        <td>          <xsl:value-of select="price"/>        </td>      </tr>    </xsl:for-each>  </table></xsl:template></xsl:stylesheet>

这个是main.jsp文件:

<%@ taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core" %><%@ taglib prefix="x" uri="http://java.sun.com/jsp/jstl/xml" %> <html><head>  <title>JSTL x:transform Tags</title></head><body><h3>Books Info:</h3><c:set var="xmltext">  <books>    <book>      <name>Padam History</name>      <author>ZARA</author>      <price>100</price>    </book>    <book>      <name>Great Mistry</name>      <author>NUHA</author>      <price>2000</price>    </book>  </books></c:set> <c:import url="http://localhost:8080/style.xsl" var="xslt"/><x:transform xml="${xmltext}" xslt="${xslt}"/> </body></html>

运行结果如下:

更多关于使用JSTL处理XML的内容请查阅JSP标准标签库


JavaBean是特殊的Java类,是用Java语言写成的可重用组件,并且遵守JavaBeans API规范。

接下来给出的是JavaBean与其它Java类相比而言独一无二的特征:

  • 提供一个默认的无参构造函数。
  • 需要被序列化并且实现了Serializable接口。
  • 可能有一系列可读写属性。
  • 可能有一系列的"getter"或"setter"方法。

JavaBeans属性

一个JavaBean对象的属性应该是可访问的。这个属性可以是任意合法的Java数据类型,包括自定义Java类。

一个JavaBean对象的属性可以是可读写,或只读,或只写。JavaBean对象的属性通过JavaBean实现类中提供的两个方法来访问:

方法 描述
getPropertyName() 举例来说,如果属性的名称为myName,那么这个方法的名字就要写成getMyName()来读取这个属性。这个方法也称为访问器。
setPropertyName() 举例来说,如果属性的名称为myName,那么这个方法的名字就要写成setMyName()来写入这个属性。这个方法也称为写入器。

一个只读的属性只提供getPropertyName()方法,一个只写的属性只提供setPropertyName()方法。


JavaBeans程序示例

这是StudentBean.java文件:

package com.tutorialspoint;public class StudentsBean implements java.io.Serializable{   private String firstName = null;   private String lastName = null;   private int age = 0;   public StudentsBean() {   }   public String getFirstName(){      return firstName;   }   public String getLastName(){      return lastName;   }   public int getAge(){      return age;   }   public void setFirstName(String firstName){      this.firstName = firstName;   }   public void setLastName(String lastName){      this.lastName = lastName;   }   public void setAge(Integer age){      this.age = age;   }}

编译StudentBean.java文件,在本章最后的例子中将会使用到它。


访问JavaBeans

<jsp:useBean>标签可以在JSP中声明一个JavaBean,然后使用。声明后,JavaBean对象就成了脚本变量,可以通过脚本元素或其他自定义标签来访问。<jsp:useBean>标签的语法格式如下:

<jsp:useBean id="bean's name" scope="bean's scope" typeSpec/>

其中,根据具体情况,scope的值可以是page,request,session或application。id值可任意只要不和同一JSP文件中其它<jsp:useBean>中id值一样就行了。

接下来给出的是<jsp:useBean>标签的一个简单的用法:

<html><head><title>useBean Example</title></head><body><jsp:useBean id="date" class="java.util.Date" /> <p>The date/time is <%= date %></body></html>

它将会产生如下结果:

The date/time is Thu Sep 30 11:18:11 GST 2013

访问JavaBeans对象的属性

在<jsp:useBean>标签主体中使用<jsp:getProperty/>标签来调用getter方法,使用<jsp:setProperty/>标签来调用setter方法,语法格式如下:

<jsp:useBean id="id" class="bean's class" scope="bean's scope">   <jsp:setProperty name="bean's id" property="property name"                       value="value"/>   <jsp:getProperty name="bean's id" property="property name"/>   ...........</jsp:useBean>

name属性指的是Bean的id属性。property属性指的是想要调用的getter或setter方法。

接下来给出使用以上语法进行属性访问的一个简单例子:

<html><head><title>get and set properties Example</title></head><body><jsp:useBean id="students"                      class="com.tutorialspoint.StudentsBean">    <jsp:setProperty name="students" property="firstName"                     value="Zara"/>   <jsp:setProperty name="students" property="lastName"                      value="Ali"/>   <jsp:setProperty name="students" property="age"                      value="10"/></jsp:useBean><p>Student First Name:    <jsp:getProperty name="students" property="firstName"/></p><p>Student Last Name:    <jsp:getProperty name="students" property="lastName"/></p><p>Student Age:    <jsp:getProperty name="students" property="age"/></p></body></html>

将StudentBean.class加入CLASSPATH环境变量中,然后访问以上JSP,运行结果如下:

Student First Name: Zara Student Last Name: Ali Student Age: 10 


自定义标签是用户定义的JSP语言元素。当JSP页面包含一个自定义标签时将被转化为servlet,标签转化为对被 称为tag handler的对象的操作,即当servlet执行时Web container调用那些操作。

JSP标签扩展可以让你创建新的标签并且可以直接插入到一个JSP页面。 JSP 2.0规范中引入Simple Tag Handlers来编写这些自定义标记。

你可以继承SimpleTagSupport类并重写的doTag()方法来开发一个最简单的自定义标签。


创建"Hello"标签

接下来,我们想创建一个自定义标签叫作<ex:Hello>,标签格式为:

<ex:Hello />

要创建自定义的JSP标签,你首先必须创建处理标签的Java类。所以,让我们创建一个HelloTag类,如下所示:

package com.tutorialspoint;import javax.servlet.jsp.tagext.*;import javax.servlet.jsp.*;import java.io.*;public class HelloTag extends SimpleTagSupport {  public void doTag() throws JspException, IOException {    JspWriter out = getJspContext().getOut();    out.println("Hello Custom Tag!");  }}

以下代码重写了doTag()方法,方法中使用了getJspContext()方法来获取当前的JspContext对象,并将"Hello Custom Tag!"传递给JspWriter对象。

编译以上类,并将其复制到环境变量CLASSPATH目录中。最后创建如下标签库:<Tomcat安装目录>webappsROOTWEB-INFcustom.tld。

<taglib>  <tlib-version>1.0</tlib-version>  <jsp-version>2.0</jsp-version>  <short-name>Example TLD</short-name>  <tag>    <name>Hello</name>    <tag-class>com.tutorialspoint.HelloTag</tag-class>    <body-content>empty</body-content>  </tag></taglib>

接下来,我们就可以在JSP文件中使用Hello标签:

<%@ taglib prefix="ex" uri="WEB-INF/custom.tld"%><html>  <head>    <title>A sample custom tag</title>  </head>  <body>    <ex:Hello/>  </body></html>

以上程序输出结果为:

Hello Custom Tag!

访问标签体

你可以像标准标签库一样在标签中包含消息内容。如我们要在我们自定义的Hello中包含内容,格式如下:

<ex:Hello>   This is message body</ex:Hello>

我们可以修改标签处理类文件,代码如下:

package com.tutorialspoint;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文件,如下所示:

<taglib>  <tlib-version>1.0</tlib-version>  <jsp-version>2.0</jsp-version>  <short-name>Example TLD with Body</short-name>  <tag>    <name>Hello</name>    <tag-class>com.tutorialspoint.HelloTag</tag-class>    <body-content>scriptless</body-content>  </tag></taglib>

现在我们可以在JSP使用修改后的标签,如下所示:

<%@ taglib prefix="ex" uri="WEB-INF/custom.tld"%><html>  <head>    <title>A sample custom tag</title>  </head>  <body>    <ex:Hello>        This is message body    </ex:Hello>  </body></html>

以上程序输出结果如下所示:

This is message body

自定义标签属性

你可以在自定义标准中设置各种属性,要接收属性,值自定义标签类必须实现setter方法, JavaBean 中的setter方法如下所示:

package com.tutorialspoint;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文件中使用的<attribute>元素添加此属性:

<taglib>  <tlib-version>1.0</tlib-version>  <jsp-version>2.0</jsp-version>  <short-name>Example TLD with Body</short-name>  <tag>    <name>Hello</name>    <tag-class>com.tutorialspoint.HelloTag</tag-class>    <body-content>scriptless</body-content>    <attribute>       <name>message</name>    </attribute>  </tag></taglib>

现在我们就可以在JSP文件中使用message属性了,如下所示:

<%@ taglib prefix="ex" uri="WEB-INF/custom.tld"%><html>  <head>    <title>A sample custom tag</title>  </head>  <body>    <ex:Hello message="This is custom tag" />  </body></html>

以上实例数据输出结果为:

This is custom tag

你还可以包含以下属性:

属性 描述
name定义属性的名称。每个标签的是属性名称必须是唯一的。
required指定属性是否是必须的或者可选的,如果设置为false为可选。
rtexprvalue声明在运行表达式时,标签属性是否有效。
type定义该属性的Java类类型 。默认指定为 String
description描述信息
fragment如果声明了该属性,属性值将被视为一个 JspFragment

以下是指定相关的属性实例:

.....    <attribute>      <name>attribute_name</name>      <required>false</required>      <type>java.util.Date</type>      <fragment>false</fragment>    </attribute>.....

如果你使用了两个属性,修改TLD文件,如下所示:

.....    <attribute>      <name>attribute_name1</name>      <required>false</required>      <type>java.util.Boolean</type>      <fragment>false</fragment>    </attribute>    <attribute>      <name>attribute_name2</name>      <required>true</required>      <type>java.util.Date</type>    </attribute>.....


JSP 表达式语言(EL)使得访问存储在 JavaBean 中的数据变得非常简单。JSP EL 既可以用来创建算术表达式也可以用来创建逻辑表达式。在 JSP EL 表达式内可以使用整型数,浮点数,字符串,常量 true、false,还有 null。


一个简单的语法

典型的,当您需要在 JSP 标签中指定一个属性值时,只需要简单地使用字符串即可:

<jsp:setProperty name="box" property="perimeter" value="100"/>

JSP EL 允许您指定一个表达式来表示属性值。一个简单的表达式语法如下:

${expr}

其中,​expr​ 指的是表达式。在 JSP EL 中通用的操作符是​"."​和​"[]"​。这两个操作符允许您通过内嵌的 JSP 对象访问各种各样的 ​JavaBean​ 属性。

举例来说,上面的​<jsp:setProperty>​标签可以使用表达式语言改写成如下形式:

<jsp:setProperty name="box" property="perimeter"                   value="${2*box.width+2*box.height}"/>

当 JSP 编译器在属性中见到"​${}​"格式后,它会产生代码来计算这个表达式,并且产生一个替代品来代替表达式的值。

您也可以在标签的模板文本中使用表达式语言。比如​<jsp:text>​标签简单地将其主体中的文本插入到 JSP 输出中:

<jsp:text><h1>Hello JSP!</h1></jsp:text>

现在,在​<jsp:text>​标签主体中使用表达式,就像这样:

<jsp:text>Box Perimeter is: ${2*box.width + 2*box.height}</jsp:text>

在EL表达式中可以使用圆括号来组织子表达式。比如​${(1 + 2) * 3}​等于9,但是​${1 + (2 * 3)} ​等于7。

想要停用对 EL 表达式的评估的话,需要使用 ​page ​指令将 ​isELIgnored​ 属性值设为​ true​:

<%@ page isELIgnored ="true|false" %>

这样,EL 表达式就会被忽略。若设为​false​,则容器将会计算 EL 表达式。


EL中的基础操作符

EL表达式支持大部分Java所提供的算术和逻辑操作符:

操作符 描述
. 访问一个​Bean​属性或者一个映射条目
[] 访问一个数组或者链表的元素
( ) 组织一个子表达式以改变优先级
+
- 减或负
*
/ or div
% or mod 取模
== or eq 测试是否相等
!= or ne 测试是否不等
< or lt 测试是否小于
> or gt 测试是否大于
<= or le 测试是否小于等于
>= or ge 测试是否大于等于
&& or and 测试逻辑与
|| or or 测试逻辑或
! or not 测试取反
empty 测试是否空值

JSP EL中的函数

JSP EL 允许您在表达式中使用函数。这些函数必须被定义在自定义标签库中。函数的使用语法如下:

${ns:func(param1, param2, ...)}

ns 指的是命名空间(namespace),​func​指的是函数的名称,​param1​指的是第一个参数,​param2​ 指的是第二个参数,以此类推。比如,有函数​fn:length​,在 JSTL 库中定义,可以像下面这样来获取一个字符串的长度:

${fn:length("Get my length")}

要使用任何标签库中的函数,您需要将这些库安装在服务器中,然后使用​<taglib>​标签在 JSP 文件中包含这些库。


JSP EL隐含对象

JSP EL支持下表列出的隐含对象:

隐含对象 描述
pageScope page 作用域
requestScope request 作用域
sessionScope session 作用域
applicationScope application 作用域
param Request 对象的参数,字符串
paramValues Request对象的参数,字符串集合
header HTTP 信息头,字符串
headerValues HTTP 信息头,字符串集合
initParam 上下文初始化参数
cookie Cookie值
pageContext 当前页面的pageContext

您可以在表达式中使用这些对象,就像使用变量一样。接下来会给出几个例子来更好的理解这个概念。


pageContext对象

pageContext​ 对象是 JSP 中 ​pageContext​ 对象的引用。通过 ​pageContext​ 对象,您可以访问 ​request​ 对象。比如,访问 ​request​ 对象传入的查询字符串,就像这样:

${pageContext.request.queryString}

Scope对象

pageScope​,​requestScope​,​sessionScope​,​applicationScope​ 变量用来访问存储在各个作用域层次的变量。

举例来说,如果您需要显式访问在 ​applicationScope​ 层的 ​box ​变量,可以这样来访问: ​applicationScope.box​。


param和paramValues对象

param​ 和 ​paramValues​ 对象用来访问参数值,通过使用 ​request.getParameter​ 方法和​ request.getParameterValues​ 方法。

举例来说,访问一个名为​ order​ 的参数,可以这样使用表达式:​${param.order}​,或者​${param["order"]}​。

接下来的例子表明了如何访问 request 中的​ username​ 参数:

<%@ page import="java.io.*,java.util.*" %><%     String title = "Accessing Request Param"; %><html><head><title><% out.print(title); %></title></head><body><center><h1><% out.print(title); %></h1></center><div align="center"><p>${param["username"]}</p></div></body></html>

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"; %><html><head><title><% out.print(title); %></title></head><body><center><h1><% out.print(title); %></h1></center><div align="center"><p>${header["user-agent"]}</p></div></body></html>

运行结果如下:

jsp-expression-language

header对象返回单一值,而headerValues则返回一个字符串数组。


当编写JSP程序的时候,程序员可能会遗漏一些BUG,这些BUG可能会出现在程序的任何地方。JSP代码中通常有以下几类异常:

  • 检查型异常:检查型异常就是一个典型的用户错误或者一个程序员无法预见的错误。举例来说,如果一个文件将要被打开,但是无法找到这个文件,则一个异常被抛出。这些异常不能再编译期被简单地忽略。
  • 运行时异常:一个运行时异常可能已经被程序员避免,这种异常在编译期将会被忽略。
  • 错误:这里没有异常,但问题是它超出了用户或者程序员的控制范围。错误通常会在代码中被忽略,您几乎不能拿它怎么样。举例来或,栈溢出错误。这些错误都会在编译期被忽略。

本节将会给出几个简单而优雅的方式来处理运行时异常和错误。


使用Exception对象

exception对象是Throwable子类的一个实例,只在错误页面中可用。下表列出了Throwable类中一些重要的方法:

序号 方法&描述
1 public String getMessage()

返回异常的信息。这个信息在Throwable构造函数中被初始化
2 public ThrowablegetCause()

返回引起异常的原因,类型为Throwable对象
3 public String toString()

返回类名
4 public void printStackTrace()

将异常栈轨迹输出至System.err
5 public StackTraceElement [] getStackTrace()

以栈轨迹元素数组的形式返回异常栈轨迹
6 public ThrowablefillInStackTrace()

使用当前栈轨迹填充Throwable对象

JSP提供了可选项来为每个JSP页面指定错误页面。无论何时页面抛出了异常,JSP容器都会自动地调用错误页面。

接下来的例子为main.jsp指定了一个错误页面。使用<%@page errorPage="XXXXX"%>指令指定一个错误页面。

<%@ page errorPage="ShowError.jsp" %><html><head>   <title>Error Handling Example</title></head><body><%    // Throw an exception to invoke the error page    int x = 1;    if (x == 1)    {       throw new RuntimeException("Error condition!!!");    } %></body></html>

现在,编写ShowError.jsp文件如下:

<%@ page isErrorPage="true" %><html><head><title>Show Error Page</title></head><body><h1>Opps...</h1><p>Sorry, an error occurred.</p><p>Here is the exception stack trace: </p><pre><% exception.printStackTrace(response.getWriter()); %>

注意到,ShowError.jsp文件使用了<%@page isErrorPage="true"%>指令,这个指令告诉JSP编译器需要产生一个异常实例变量。

现在试着访问main.jsp页面,它将会产生如下结果:

java.lang.RuntimeException: Error condition!!!......Opps...Sorry, an error occurred.Here is the exception stack trace:

在错误页面中使用JSTL标签

可以利用JSTL标签来编写错误页面ShowError.jsp。这个例子中的代码与上例代码的逻辑几乎一样,但是本例的代码有更好的结构,并且能够提供更多信息:

<%@ taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core" %><%@page isErrorPage="true" %><html><head><title>Show Error Page</title></head><body><h1>Opps...</h1><table width="100%" border="1"><tr valign="top"><td width="40%"><b>Error:</b></td><td>${pageContext.exception}</td></tr><tr valign="top"><td><b>URI:</b></td><td>${pageContext.errorData.requestURI}</td></tr><tr valign="top"><td><b>Status code:</b></td><td>${pageContext.errorData.statusCode}</td></tr><tr valign="top"><td><b>Stack trace:</b></td><td><c:forEach var="trace"           items="${pageContext.exception.stackTrace}"><p>${trace}</p></c:forEach></td></tr></table></body></html>

运行结果如下:

jsp-exeception-1


使用 try…catch块

如果您想要将异常处理放在一个页面中,并且对不同的异常进行不同的处理,那么您就需要使用try…catch块了。

接下来的这个例子显示了如何使用try…catch块,将这些代码放在main.jsp中:

<html><head>   <title>Try...Catch Example</title></head><body><%    try{       int i = 1;       i = i / 0;       out.println("The answer is " + i);    }    catch (Exception e){       out.println("An exception occurred: " + e.getMessage());    } %></body></html>

试着访问main.jsp,它将会产生如下结果:

An exception occurred: / by zero 


要测试/调试一个JSP或servlet程序总是那么的难。JSP和Servlets程序趋向于牵涉到大量客户端/服务器之间的交互,这很有可能会产生错误,并且很难重现出错的环境。

接下来将会给出一些小技巧和小建议,来帮助您调试程序。


使用System.out.println()

System.out.println()可以很方便地标记一段代码是否被执行。当然,我们也可以打印出各种各样的值。此外:

  • 自从System对象成为Java核心对象后,它便可以使用在任何地方而不用引入额外的类。使用范围包括Servlets,JSP,RMI,EJB's,Beans,类和独立应用。
  • 与在断点处停止运行相比,用System.out进行输出不会对应用程序的运行流程造成重大的影响,这个特点在定时机制非常重要的应用程序中就显得非常有用了。

接下来给出了使用System.out.println()的语法:

System.out.println("Debugging message");

这是一个使用System.out.print()的简单例子:

<%@taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core" %><html><head><title>System.out.println</title></head><body><c:forEach var="counter" begin="1" end="10" step="1" >   <c:out value="${counter-5}"/></br>   <% System.out.println( "counter= " +                       pageContext.findAttribute("counter") ); %></c:forEach></body></html>

现在,如果运行上面的例子的话,它将会产生如下的结果:

-4-3-2-1012345

如果使用的是Tomcat服务器,您就能够在logs目录下的stdout.log文件中发现多出了如下内容:

counter=1counter=2counter=3counter=4counter=5counter=6counter=7counter=8counter=9counter=10

使用这种方法可以将变量和其它的信息输出至系统日志中,用来分析并找出造成问题的深层次原因。


使用JDB Logger

J2SE日志框架可为任何运行在JVM中的类提供日志记录服务。因此我们可以利用这个框架来记录任何信息。

让我们来重写以上代码,使用JDK中的 logger API:

<%@taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core" %><%@page import="java.util.logging.Logger" %><html><head><title>Logger.info</title></head><body><% Logger logger=Logger.getLogger(this.getClass().getName());%><c:forEach var="counter" begin="1" end="10" step="1" >   <c:set var="myCount" value="${counter-5}" />   <c:out value="${myCount}"/></br>   <% String message = "counter="                   + pageContext.findAttribute("counter")                   + " myCount="                   + pageContext.findAttribute("myCount");                   logger.info( message );    %></c:forEach></body></html>

它的运行结果与先前的类似,但是,它可以获得额外的信息输出至stdout.log文件中。在这我们使用了logger中的info方法。下面我们给出stdout.log文件中的一个快照:

24-Sep-2013 23:31:31 org.apache.jsp.main_jsp _jspServiceINFO: counter=1 myCount=-424-Sep-2013 23:31:31 org.apache.jsp.main_jsp _jspServiceINFO: counter=2 myCount=-324-Sep-2013 23:31:31 org.apache.jsp.main_jsp _jspServiceINFO: counter=3 myCount=-224-Sep-2013 23:31:31 org.apache.jsp.main_jsp _jspServiceINFO: counter=4 myCount=-124-Sep-2013 23:31:31 org.apache.jsp.main_jsp _jspServiceINFO: counter=5 myCount=024-Sep-2013 23:31:31 org.apache.jsp.main_jsp _jspServiceINFO: counter=6 myCount=124-Sep-2013 23:31:31 org.apache.jsp.main_jsp _jspServiceINFO: counter=7 myCount=224-Sep-2013 23:31:31 org.apache.jsp.main_jsp _jspServiceINFO: counter=8 myCount=324-Sep-2013 23:31:31 org.apache.jsp.main_jsp _jspServiceINFO: counter=9 myCount=424-Sep-2013 23:31:31 org.apache.jsp.main_jsp _jspServiceINFO: counter=10 myCount=5

消息可以使用各种优先级发送,通过使用sever(),warning(),info(),config(),fine(),finer(),finest()方法。finest()方法用来记录最好的信息,而sever()方法用来记录最严重的信息。

使用Log4J 框架来将消息记录在不同的文件中,这些消息基于严重程度和重要性来进行分类。


调试工具

NetBeans是树形结构,是开源的Java综合开发环境,支持开发独立的Java应用程序和网络应用程序,同时也支持JSP调试。

NetBeans支持如下几个基本的调试功能:

  • 断点
  • 单步跟踪
  • 观察点

详细的信息可以查看NetBeans使用手册。


使用JDB Debugger

可以在JSP和servlets中使用jdb命令来进行调试,就像调试普通的应用程序一样。

通常,我们直接调试sun.servlet.http.HttpServer 对象来查看HttpServer在响应HTTP请求时执行JSP/Servlets的情况。这与调试applets非常相似。不同之处在于,applets程序实际调试的是sun.applet.AppletViewer。

大部分调试器在调试applets时都能够自动忽略掉一些细节,因为它知道如何调试applets。如果想要将调试对象转移到JSP身上,就需要做好以下两点:

  • 设置调试器的classpath,让它能够找到sun.servlet.http.Http-Server  和相关的类。
  • 设置调试器的classpath,让它能够找到您的JSP文件和相关的类。

设置好classpath后,开始调试sun.servlet.http.Http-Server 。您可以在JSP文件的任意地方设置断点,只要你喜欢,然后使用浏览器发送一个请求给服务器就应该可以看见程序停在了断点处。


使用注释

程序中的注释在很多方面都对程序的调试起到一定的帮助作用。注释可以用在调试程序的很多方面中。

JSP使用Java注释。如果一个BUG消失了,就请仔细查看您刚注释过的代码,通常都能找出原因。


客户端和服务器的头模块

有时候,当JSP没有按照预定的方式运行时,查看未加工的HTTP请求和响应也是很有用的。如果对HTTP的结构很熟悉的话,您可以直接观察request和response然后看看这些头模块到底怎么了。


重要调试技巧

这里我们再透露两个调试JSP的小技巧:

  • 使用浏览器显示原始的页面内容,用来区分是否是格式问题。这个选项通常在View菜单下。
  • 确保浏览器在强制重新载入页面时没有捕获先前的request输出。若使用的是Netscape Navigator浏览器,则用Shift-Reload;若使用的是IE浏览器,则用Shift-Refresh。


在开始前,需要解释几个重要的概念:

  • 国际化(i18n):表明一个页面根据访问者的语言或国家来呈现不同的翻译版本。
  • 本地化(l10n):向网站添加资源,以使它适应不同的地区和文化。比如网站的印度语版本。
  • 区域:这是一个特定的区域或文化,通常认为是一个语言标志和国家标志通过下划线连接起来。比如"en_US"代表美国英语地区。

如果想要建立一个全球化的网站,就需要关心一系列项目。本章将会详细告诉您如何处理国际化问题,并给出了一些例子来加深理解。

JSP容器能够根据request的locale属性来提供正确地页面版本。接下来给出了如何通过request对象来获得Locale对象的语法:

java.util.Locale request.getLocale() 

检测Locale

下表列举出了Locale对象中比较重要的方法,用于检测request对象的地区,语言,和区域。所有这些方法都会在浏览器中显示国家名称和语言名称:

序号 方法 & 描述
1 String getCountry()

返回国家/地区码的英文大写,或 ISO 3166 2-letter 格式的区域
2 String getDisplayCountry()

返回要显示给用户的国家名称
3 String getLanguage()

返回语言码的英文小写,或ISO 639 格式的区域
4 String getDisplayLanguage()

返回要给用户看的语言名称
5 String getISO3Country()

返回国家名称的3字母缩写
6 String getISO3Language()

返回语言名称的3字母缩写

实例演示

这个例子告诉我们如何在JSP中显示语言和国家:

<%@ page import="java.io.*,java.util.Locale" %><%@ page import="javax.servlet.*,javax.servlet.http.* "%><%    //获取客户端本地化信息    Locale locale = request.getLocale();    String language = locale.getLanguage();    String country = locale.getCountry(); %><html><head><title>Detecting Locale</title></head><body><center><h1>Detecting Locale</h1></center><p align="center"><%     out.println("Language : " + language  + "<br />");   out.println("Country  : " + country   + "<br />");%></p></body></html>

语言设置

JSP可以使用西欧语言来输出一个页面,比如英语,西班牙语,德语,法语,意大利语等等。由此可见,设置Content-Language信息头来正确显示所有字符是很重要的。

第二点就是,需要使用HTML字符实体来显示特殊字符,比如"&#241;" 代表的是"?","&#161;"代表的是 "?" :

<%@ page import="java.io.*,java.util.Locale" %><%@ page import="javax.servlet.*,javax.servlet.http.* "%><%     // Set response content type     response.setContentType("text/html");     // Set spanish language code.     response.setHeader("Content-Language", "es");     String title = "En Espa?ol";  %><html><head><title><%  out.print(title); %></title></head><body><center><h1><%  out.print(title); %></h1></center><div align="center"><p>En Espa?ol</p><p>?Hola Mundo!</p></div></body></html>

区域特定日期

可以使用java.text.DateFormat类和它的静态方法getDateTimeInstance()来格式化日期和时间。接下来的这个例子显示了如何根据指定的区域来格式化日期和时间:

<%@ page import="java.io.*,java.util.Locale" %><%@ page import="javax.servlet.*,javax.servlet.http.* "%><%@ page import="java.text.DateFormat,java.util.Date" %><%     String title = "Locale Specific Dates";     //Get the client's Locale     Locale locale = request.getLocale( );     String date = DateFormat.getDateTimeInstance(                                   DateFormat.FULL,                                    DateFormat.SHORT,                                    locale).format(new Date( )); %><html><head><title><% out.print(title); %></title></head><body><center><h1><% out.print(title); %></h1></center><div align="center"><p>Local Date: <%  out.print(date); %></p></div></body></html>

区域特定货币

可以使用java.text.NumberFormat类和它的静态方法getCurrencyInstance()来格式化数字。比如在区域特定货币中的long型和double型。接下来的例子显示了如何根据指定的区域来格式化货币:

<%@ page import="java.io.*,java.util.Locale" %><%@ page import="javax.servlet.*,javax.servlet.http.* "%><%@ page import="java.text.NumberFormat,java.util.Date" %><%     String title = "Locale Specific Currency";     //Get the client's Locale     Locale locale = request.getLocale( );     NumberFormat nft = NumberFormat.getCurrencyInstance(locale);     String formattedCurr = nft.format(1000000); %><html><head><title><% out.print(title); %></title></head><body><center><h1><% out.print(title); %></h1></center><div align="center"><p>Formatted Currency: <%  out.print(formattedCurr); %></p></div></body></html>

区域特定百分比

可以使用java.text.NumberFormat类和它的静态方法getPercentInstance()来格式化百分比。接下来的例子告诉我们如何根据指定的区域来格式化百分比:

<%@ page import="java.io.*,java.util.Locale" %><%@ page import="javax.servlet.*,javax.servlet.http.* "%><%@ page import="java.text.NumberFormat,java.util.Date" %><%     String title = "Locale Specific Percentage";     //Get the client's Locale     Locale locale = request.getLocale( );     NumberFormat nft = NumberFormat.getPercentInstance(locale);     String formattedPerc = nft.format(0.51); %><html><head><title><% out.print(title); %></title></head><body><center><h1><% out.print(title); %></h1></center><div align="center"><p>Formatted Percentage: <%  out.print(formattedPerc); %></p></div></body></html>


JSP可以通过HTML的form表单上传文件到服务器。 文件类型可以是文本文件、二进制文件、图像文件等其他任何文档。


创建文件上传表单

接下来我们使用HTML标签来创建文件上传表单,以下为要注意的点:

  • form表单 method 属性必须设置为 POST 方法 ,不能使用 GET 方法。
  • form表单 enctype 属性需要设置为 multipart/form-data。
  • form表单 action 属性需要设置为提交到后台处理文件上传的jsp文件地址。例如 uploadFile.jsp 程序文件用来处理上传的文件。
  • 上传文件元素需要使用 <input .../> 标签,属性设置为 type="file"。如果需要上传多个文件,可以在 <input .../>标签中设置不同的名称。

以下是一个上传文件的表单,实例如下:

<html><head><title>File Uploading Form</title></head><body><h3>File Upload:</h3>Select a file to upload: <br /><form action="UploadServlet" method="post"                        enctype="multipart/form-data"><input type="file" name="file" size="50" /><br /><input type="submit" value="Upload File" /></form></body></html>

在你本地浏览器访问该文件,显示界面如下所示,在你点击"Upload File"会弹出一个窗口让你选择要上传的文件:

文件


后台JSP处理脚本

首先我们先定义文件上传后存储在服务上的位置,你可以将路径写在你的程序当中,或者我们可以在web.xml配置文件中通过设置 context-param 元素来设置文件存储的目录,如下所示:

<web-app>....<context-param>     <description>文件上传地址</description>     <param-name>file-upload</param-name>     <param-value>         c:apache-tomcat-5.5.29webappsdata     </param-value> </context-param>....</web-app>

以下脚本文件UploadFile.jsp可以处理多个上传的文件,在使用该脚本前,我们需要注意以下几点:

  • 以下实例依赖 FileUpload, 所以你需要在你的classpath中引入最新的 commons-fileupload.x.x.jar 包文件。 下载地址为:http://commons.apache.org/fileupload/
  • FileUpload 依赖 Commons IO, 所以你需要在你的classpath中引入最新的 commons-io-x.x.jar 。 下载地址为:http://commons.apache.org/io/
  • 在测试以下实例时,你需要上传确认上传的文件大小小于 maxFileSize 变量设置的大小 ,否则文件无法上传成功。
  • 确保你已经创建了目录 c: emp 和 c:apache-tomcat-5.5.29webappsdata 。
<%@ page import="java.io.*,java.util.*, javax.servlet.*" %><%@ page import="javax.servlet.http.*" %><%@ page import="org.apache.commons.fileupload.*" %><%@ page import="org.apache.commons.fileupload.disk.*" %><%@ page import="org.apache.commons.fileupload.servlet.*" %><%@ page import="org.apache.commons.io.output.*" %><%   File file ;   int maxFileSize = 5000 * 1024;   int maxMemSize = 5000 * 1024;   ServletContext context = pageContext.getServletContext();   String filePath = context.getInitParameter("file-upload");   // 验证上传内容了类型   String contentType = request.getContentType();   if ((contentType.indexOf("multipart/form-data") >= 0)) {      DiskFileItemFactory factory = new DiskFileItemFactory();      // 设置内存中存储文件的最大值      factory.setSizeThreshold(maxMemSize);      // 本地存储的数据大于 maxMemSize.      factory.setRepository(new File("c:	emp"));      // 创建一个新的文件上传处理程序      ServletFileUpload upload = new ServletFileUpload(factory);      // 设置最大上传的文件大小      upload.setSizeMax( maxFileSize );      try{          // 解析获取的文件         List fileItems = upload.parseRequest(request);         // 处理上传的文件         Iterator i = fileItems.iterator();         out.println("<html>");         out.println("<head>");         out.println("<title>JSP File upload</title>");           out.println("</head>");         out.println("<body>");         while ( i.hasNext () )          {            FileItem fi = (FileItem)i.next();            if ( !fi.isFormField () )	            {            // 获取上传文件的参数            String fieldName = fi.getFieldName();            String fileName = fi.getName();            boolean isInMemory = fi.isInMemory();            long sizeInBytes = fi.getSize();            // 写入文件            if( fileName.lastIndexOf("") >= 0 ){            file = new File( filePath ,             fileName.substring( fileName.lastIndexOf(""))) ;            }else{            file = new File( filePath ,            fileName.substring(fileName.lastIndexOf("")+1)) ;            }            fi.write( file ) ;            out.println("Uploaded Filename: " + filePath +             fileName + "<br>");            }         }         out.println("</body>");         out.println("</html>");      }catch(Exception ex) {         System.out.println(ex);      }   }else{      out.println("<html>");      out.println("<head>");      out.println("<title>Servlet upload</title>");        out.println("</head>");      out.println("<body>");      out.println("<p>No file uploaded</p>");       out.println("</body>");      out.println("</html>");   }%>

接下来让我们通过浏览器访问 http://localhost:8080/UploadFile.htm,界面如下所示,并上传文件:

jsp
如果你的JSP脚本运行正常,文件将被上传至 c:apache-tomcat-5.5.29webappsdata ,你可以打开文件夹看看是否上传成功。


JSP可以通过HTML的form表单上传文件到服务器。 文件类型可以是文本文件、二进制文件、图像文件等其他任何文档。


创建文件上传表单

接下来我们使用HTML标签来创建文件上传表单,以下为要注意的点:

  • form表单 method 属性必须设置为 POST 方法 ,不能使用 GET 方法。
  • form表单 enctype 属性需要设置为 multipart/form-data。
  • form表单 action 属性需要设置为提交到后台处理文件上传的jsp文件地址。例如 uploadFile.jsp 程序文件用来处理上传的文件。
  • 上传文件元素需要使用 <input .../> 标签,属性设置为 type="file"。如果需要上传多个文件,可以在 <input .../>标签中设置不同的名称。

以下是一个上传文件的表单,实例如下:

<html><head><title>File Uploading Form</title></head><body><h3>File Upload:</h3>Select a file to upload: <br /><form action="UploadServlet" method="post"                        enctype="multipart/form-data"><input type="file" name="file" size="50" /><br /><input type="submit" value="Upload File" /></form></body></html>

在你本地浏览器访问该文件,显示界面如下所示,在你点击"Upload File"会弹出一个窗口让你选择要上传的文件:

文件


后台JSP处理脚本

首先我们先定义文件上传后存储在服务上的位置,你可以将路径写在你的程序当中,或者我们可以在web.xml配置文件中通过设置 context-param 元素来设置文件存储的目录,如下所示:

<web-app>....<context-param>     <description>文件上传地址</description>     <param-name>file-upload</param-name>     <param-value>         c:apache-tomcat-5.5.29webappsdata     </param-value> </context-param>....</web-app>

以下脚本文件UploadFile.jsp可以处理多个上传的文件,在使用该脚本前,我们需要注意以下几点:

  • 以下实例依赖 FileUpload, 所以你需要在你的classpath中引入最新的 commons-fileupload.x.x.jar 包文件。 下载地址为:http://commons.apache.org/fileupload/
  • FileUpload 依赖 Commons IO, 所以你需要在你的classpath中引入最新的 commons-io-x.x.jar 。 下载地址为:http://commons.apache.org/io/
  • 在测试以下实例时,你需要上传确认上传的文件大小小于 maxFileSize 变量设置的大小 ,否则文件无法上传成功。
  • 确保你已经创建了目录 c: emp 和 c:apache-tomcat-5.5.29webappsdata 。
<%@ page import="java.io.*,java.util.*, javax.servlet.*" %><%@ page import="javax.servlet.http.*" %><%@ page import="org.apache.commons.fileupload.*" %><%@ page import="org.apache.commons.fileupload.disk.*" %><%@ page import="org.apache.commons.fileupload.servlet.*" %><%@ page import="org.apache.commons.io.output.*" %><%   File file ;   int maxFileSize = 5000 * 1024;   int maxMemSize = 5000 * 1024;   ServletContext context = pageContext.getServletContext();   String filePath = context.getInitParameter("file-upload");   // 验证上传内容了类型   String contentType = request.getContentType();   if ((contentType.indexOf("multipart/form-data") >= 0)) {      DiskFileItemFactory factory = new DiskFileItemFactory();      // 设置内存中存储文件的最大值      factory.setSizeThreshold(maxMemSize);      // 本地存储的数据大于 maxMemSize.      factory.setRepository(new File("c:	emp"));      // 创建一个新的文件上传处理程序      ServletFileUpload upload = new ServletFileUpload(factory);      // 设置最大上传的文件大小      upload.setSizeMax( maxFileSize );      try{          // 解析获取的文件         List fileItems = upload.parseRequest(request);         // 处理上传的文件         Iterator i = fileItems.iterator();         out.println("<html>");         out.println("<head>");         out.println("<title>JSP File upload</title>");           out.println("</head>");         out.println("<body>");         while ( i.hasNext () )          {            FileItem fi = (FileItem)i.next();            if ( !fi.isFormField () )	            {            // 获取上传文件的参数            String fieldName = fi.getFieldName();            String fileName = fi.getName();            boolean isInMemory = fi.isInMemory();            long sizeInBytes = fi.getSize();            // 写入文件            if( fileName.lastIndexOf("") >= 0 ){            file = new File( filePath ,             fileName.substring( fileName.lastIndexOf(""))) ;            }else{            file = new File( filePath ,            fileName.substring(fileName.lastIndexOf("")+1)) ;            }            fi.write( file ) ;            out.println("Uploaded Filename: " + filePath +             fileName + "<br>");            }         }         out.println("</body>");         out.println("</html>");      }catch(Exception ex) {         System.out.println(ex);      }   }else{      out.println("<html>");      out.println("<head>");      out.println("<title>Servlet upload</title>");        out.println("</head>");      out.println("<body>");      out.println("<p>No file uploaded</p>");       out.println("</body>");      out.println("</html>");   }%>

接下来让我们通过浏览器访问 http://localhost:8080/UploadFile.htm,界面如下所示,并上传文件:

jsp
如果你的JSP脚本运行正常,文件将被上传至 c:apache-tomcat-5.5.29webappsdata ,你可以打开文件夹看看是否上传成功。