澳门新葡亰平台官网下载-平台游戏app > 前端 >
十一、JSP及语法概要

12.1 JSP脚本元素

11.1 概述

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

   JavaServer Pages(JSP)使得我们能够分离页面的静态HTML和动态部分。HTML可以用任何通常使用的Web制作工具编写,编写方式也和原来的一样;动态部分的代码放入特殊标记之内,大部分以“<%”开始,以“%>”结束。例如,下面是一个JSP页面的片断,如果我们用 for ordering Core Web Programming”。
Thanks for ordering
<I><%= request.getParameter("title") %></I>

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

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

   12.1.1 JSP表达式

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

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

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

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

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

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

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

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

   11.2 JSP语法概要表 JSP元素  语法  说明  备注  
JSP表达式  <%= expression %>  计算表达式并输出结果。  等价的XML表达是:
<jsp:expression>
expression
</jsp:expression>

   最后,如果使用XML的话,JSP表达式也可以写成下面这种形式:
<jsp:expression>
Java Expression
</jsp:expression>

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

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

JSP Scriptlet  <% code %>  插入到service方法的代码。  等价的XML表达是:
<jsp:scriptlet>
code
</jsp:scriptlet>

   12.1.2 JSP Scriptlet

JSP声明  <%! code %>  代码被插入到Servlet类(在service方法之外)。  等价的XML表达是:
<jsp:declaration>
code
</jsp:declaration>

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

page指令  <%@ page att="val" %>  作用于Servlet引擎的全局性指令。  等价的XML表达是
<jsp:directive.page att="val"\>。

   和JSP表达式一样,Scriptlet也可以访问所有预定义的变量。例如,如果你要向结果页面输出内容,可以使用out变量:
<%
String queryData = request.getQueryString();
out.println("Attached GET data: " + queryData);
%>

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

   注意Scriptlet中的代码将被照搬到Servlet内,而Scriptlet前面和后面的静态HTML(模板文本)将被转换成println语句。这就意味着,Scriptlet内的Java语句并非一定要是完整的,没有关闭的块将影响Scriptlet外的静态HTML。例如,下面的JSP片断混合了模板文本和Scriptlet:
<% if (Math.random() < 0.5) { %>
Have a <B>nice</B> day!
<% } else { %>
Have a <B>lousy</B> day!
<% } %>

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

   上述JSP代码将被转换成如下Servlet代码:
if (Math.random() < 0.5) {
  out.println("Have a <B>nice</B> day!");
} else {
  out.println("Have a <B>lousy</B> day!");
}

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

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

<jsp:directive.include
file="url"\>.

   12.1.3 JSP声明

其中URL必须是相对URL。

   JSP声明用来定义插入Servlet类的方法和成员变量,其语法如下:
<%! Java Code %>

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

   由于声明不会有任何输出,因此它们往往和JSP表达式或Scriptlet结合在一起使用。例如,下面的JSP代码片断输出自从服务器启动(或Servlet类被改动并重新装载以来)当前页面被请求的次数:
<%! private int accessCount = 0; %>
自从服务器启动以来页面访问次数为:
<%= ++accessCount %>

JSP注释  <%-- comment --%>  注释;JSP转换成Servlet时被忽略。  如果要把注释嵌入结果HTML文档,使用普通的HTML注释标记<-- comment -->。  
jsp:include动作  <jsp:include
page="relative URL"
flush="true"/>  当Servlet被请求时,引入指定的文件。  如果你希望在页面转换的时候包含某个文件,使用JSP include指令。
注意:在某些服务器上,被包含文件必须是HTML文件或JSP文件,具体由服务器决定(通常根据文件扩展名判断)。

   和Scriptlet一样,如果要使用字符串“%>”,必须使用“%\>”代替。最后,<%! code %>的XML等价表达方式为:
<jsp:declaration>
Code
</jsp:declaration>

jsp:useBean动作  <jsp:useBean att=val*/> 或者
<jsp:useBean att=val*>
...
</jsp:useBean>  寻找或实例化一个Java Bean。  可能的属性包括:
id="name"
scope="page|request
|session|application"
class="package.class"
type="package.class"
beanName="package.class"

   12.2 JSP指令

jsp:setProperty动作  <jsp:setProperty att=val*/>  设置Bean的属性。既可以设置一个确定的值,也可以指定属性值来自请求参数。  合法的属性包括:
name="beanName"
property="propertyName|*"
param="parameterName"
value="val"

   JSP指令影响Servlet类的整体结构,它的语法一般如下:
<%@ directive attribute="value" %>

jsp:getProperty动作  <jsp:getProperty
name="propertyName"
value="val"/>  提取并输出Bean的属性。     
jsp:forward动作  <jsp:forward
page="relative URL"/>  把请求转到另外一个页面。     
jsp:plugin动作  <jsp:plugin
attribute="value"*>
...
</jsp:plugin>  根据浏览器类型生成OBJECT或者EMBED标记,以便通过Java Plugin运行Java Applet。     

   另外,也可以把同一指令的多个属性结合起来,例如:
<%@ directive attribute1="value1"
         attribute2="value2"
         ...
         attributeN="valueN" %>

   11.3 关于模板文本(静态HTML)

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

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

   12.2.1 page指令

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

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

import="package.class",或者import="package.class1,...,package.classN":

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

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

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

isThreadSafe="true|false"

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

session="true|false"

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

buffer="size kb|none"

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

autoflush="true|false"

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

extends="package.class"

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

info="message"

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

errorPage="url"

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

isErrorPage="true|false"

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

language="java"

该属性用来指示所使用的语言。目前没有必要关注这个属性,因为默认的Java是当前唯一可用的语言。
   定义指令的XML语法为:
<jsp:directive.directiveType attribute=value />

   例如,下面这个指令:
<%@ page import="java.util.*" %>

   它的XML等价表达是:
<jsp:directive.page import="java.util.*" />

   12.2.2 include指令

   include指令用于JSP页面转换成Servlet时引入其他文件。该指令语法如下:
<%@ include file="relative url" %>

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

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

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

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

   下面是一个使用JSP表达式、Scriptlet、声明、指令的简单例子。
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<HTML>
<HEAD>
<TITLE>JavaServer Pages</TITLE>
</HEAD>

<BODY BGCOLOR="#FDF5E6" TEXT="#000000" LINK="#0000EE"
      VLINK="#551A8B" ALINK="#FF0000">
<CENTER>
<TABLE BORDER=5 BGCOLOR="#EF8429">
  <TR><TH CLASS="TITLE">
      JSP应用实例</TABLE>
</CENTER>
<P>
下面是一些利用各种JSP功能生成的动态内容:
<UL>
  <LI><B>表达式.</B><BR>
      你的主机名: <%= request.getRemoteHost() %>.
  <LI><B>JSP Scriptlet.</B><BR>
      <% out.println("查询字符串: " +
                     request.getQueryString()); %>
  <LI><B>声明(和表达式).</B><BR>
      <%! private int accessCount = 0; %>
      服务器启动以来访问次数: <%= ++accessCount %>
  <LI><B>指令(和表达式).</B><BR>
      <%@ page import = "java.util.*" %>
      当前日期: <%= new Date() %>
</UL>

</BODY>
</HTML>

   12.4 JSP预定义变量

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

   12.4.1 request

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

   12.4.2 response

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

   12.4.3 out

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

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

   12.4.4 session

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

   12.4.5 application

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

   12.4.6 config

   这是当前页面的ServletConfig对象。

   12.4.7 pageContext

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

   12.4.8 page

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