HTML注释
在客户端显示一个注释。
JSP 语法
spacing="0" cellpadding="2" bordercolorlight = "black" bordercolordark = "#FFFFFF" align="center"><!-- comment [ <%= expression %> ] -->
例子 1
<!-- This file displays the user login screen -->
在客户端的HTML源代码中产生和上面一样的数据:
<!-- This file displays the user login screen -->
例子 2
<!-- This page was loaded on <%= (new java.util.Date()).toLocaleString() %> -->
在客户端的HTML源代码中显示为:
<!-- This page was loaded on January 1, 2000 -->
描述
这种注释和HTML中很像,也就是它可以在“查看源代码”中看到。
唯一有些不同的就是,你可以在这个注释中用表达式(例子2所示)。这个表达示是不定的,由页面不同而不同,你能够使用各种表达式,只要是合法的就行。
隐藏注释
写在JSP程序中,但不是发给客户。
JSP 语法
<%-- comment --%>
例子:
<%@ page language="java" %>
<html>
<head><title>A Comment Test</title></head>
<body>
<h2>A Test of Comments</h2>
<%-- This comment will not be visible in the page source --%>
</body>
</html>
描述
用隐藏注释标记的字符会在JSP编译时被忽略掉。这个注释在你希望隐藏或注释你的JSP程序时是很有用的。
JSP编译器是不会对%--and--%之间的语句进行编译的,它不会显示在客户的浏览器中,也不会在源代码中看到在%-- --%之间,你可以任意写注释语句,但是不能使用“--%>”,如果你非要使用请用“--%\>”。
声明
在JSP程序中声明合法的变量和方法。
JSP 语法
<%! declaration; [ declaration; ]+ ... %>
例子
<%! int i = 0; %>
<%! int a, b, c; %>
<%! Circle a = new Circle(2.0); %>
描述
声明你将要在JSP程序中用到的变量和方法。你也必须这样做,不然会出错。
你可以一次性声明多个变量和方法,只要以";"结尾就行,当然这些声明在Java中要是合法的。
当你声明方法或变量时,请注意以下的一些规则:
1 声明必须以";"结尾(Scriptlet有同样的规则,但是表达式就不同了)。
2 你可以直接使用在% @ page %中被包含进来的已经声明的变量和方法,不需要对它们重新进行声明。
3 一个声明仅在一个页面中有效。如果你想每个页面都用到一些声明,最好把它们写成一个单独的文件,然后用%@ include %或jsp:include元素包含进来。
表达式
包含一个符合JSP语法的表达式。
JSP 语法
<%= expression %>
例子
<font color="blue"><%= map.size() %></font>
<b><%= numguess.getHint() %></b>.
描述
表达式元素表示的是一个在脚本语言中被定义的表达式,在运行后被自动转化为字符串,然后插入到这个表达式在JSP文件的位置显示。因为这个表达式的值已经被转化为字符串,所以你能在一行文本中插入这个表达式(形式和ASP完全一样)。
当你在JSP中使用表达式时请记住以下几点:
1 你不能用一个分号(“;”)来作为表达式的结束符。但是同样的表达式用在scriptlet中就需要以分号来结尾了!查看Scriptlet这个表达式元素能够包括任何在Java Language Specification中有效的表达式。
2 有时候表达式也能作为其它JSP元素的属性值。一个表达式能够变得很复杂,它可能由一个或多个表达式组成,这些表达式的顺序是从左到右。
Scriptlet
包含一个有效的程序段。
JSP 语法
width="400" border="1" cellspacing="0" cellpadding="2" bordercolorlight = "black" bordercolordark = "#FFFFFF" align="center"><% code fragment %>
例子
<%
String name = null;
if (request.getParameter("name") == null) {
%>
<%@ include file="error.html" %>
<%
} else {
foo.setName(request.getParameter("name"));
if (foo.getName().equalsIgnoreCase("integra"))
name = "acura";
if (name.equalsIgnoreCase( "acura" )) {
%>
描述
一个scriptlet能够包含多个jsp语句、方法、变量、表达式。
因为有了scriptlet,我们便能做以下的事:
1 声明将要用到的变量或方法(参考 声明)。
2 编写JSP表达式(参考 表达式)。
3 使用任何隐含的对象和任何用jsp:useBean声明过的对象。
4 编写JSP语句(如果你在使用Java语言,这些语句必须遵从Java Language Specification)。
任何文本、HTML标记、JSP元素必须在scriptlet之外。
当JSP收到客户的请求时,scriptlet就会被执行,如果scriptlet有显示的内容,这些显示的内容就被存在out对象中。
Page 指令
定义JSP文件中的全局属性。
JSP 语法
<%@ page
[ language="java" ]
[ extends="package.class" ]
[ import="{package.class | package.*}, ..." ]
[ session="true | false" ]
[ buffer="none | 8kb | sizekb" ]
[ autoFlush="true | false" ]
[ isThreadSafe="true | false" ]
[ info="text" ]
[ errorPage="relativeURL" ]
[ contentType="mimeType [ ;charset=characterSet ]" | "text/html; charset=ISO-8859-1" ]
[ isErrorPage="true | false" ]
%>
例子
<%@ page import="java.util.*, java.lang.*" %>
<%@ page buffer="5kb" autoFlush="false" %>
<%@ page errorPage="error.jsp" %>
描述
%@ page %指令作用于整个JSP页面,同样包括静态的包含文件。但是% @ page %指令不能作用于动态的包含文件,比如jsp:include。
你可以在一个页面中用上多个% @ page %指令,但是其中的属性只能用一次,不过也有个例外,那就是import属性。因为import属性和Java中的import语句差不多(参照Java Language),所以你就能多用此属性几次了。
无论你把% @ page %指令放在JSP的文件的哪个地方,它的作用范围都是整个JSP页面。不过,为了JSP程序的可读性,以及好的编程习惯,最好还是把它放在JSP文件的顶部。
Taglib 指令
定义一个标签库以及其自定义标签的前缀。
JSP 语法
<%@ taglib uri="URIToTagLibrary" prefix="tagPrefix" %>
例子
<%@ taglib uri="http://www.jspcentral.com/tags" prefix="public" %>
<public:loop>
.
.
</public:loop>
描述
% @ taglib %指令声明此JSP文件使用了自定义的标签,同时引用标签库,也指定了他们的标签的前缀。
这里自定义的标签含有标签和元素之分。因为JSP文件能够转化为XML,所以了解标签和元素之间的联系很重要。标签只不过是一个在意义上被抬高了点的标记,是JSP元素的一部分。JSP元素是JSP语法的一部分,和XML一样有开始标记和结束标记。元素也可以包含其它的文本、标记、元素。比如,一个jsp:plugin元素有jsp:plugin开始标记和/jsp:plugin结束标记,同样也可以有jsp:params和jsp:fallback元素。
你必须在使用自定义标签之前使用% @ taglib %指令,而且你可以在一个页面中多次使用,但是前缀只能使用一次。
属性
uri="URIToTagLibrary"
Uniform Resource Identifier (URI)根据标签的前缀对自定义的标签进行惟一的命名,URI可以是以下的内容:
Uniform Resource Locator(URL),由RFC 2396定义,查看http://www.hut.fi/u/jkorpela/rfc/2396/full.html。
Uniform Resource Name(URN),由RFC 2396定义。
一个相对或绝对的路径
prefix="tagPrefix"
在自定义标签之前的前缀,比如,在中的public,如果这里不写public,那么这就是不合法的。请不要用jsp、jspx、java、javax、servlet、sun和sunw做你的前缀。
jsp:forward
重定向一个HTML文件、JSP文件、或者是一个程序段。
JSP 语法
<jsp:forward page={"relativeURL" | "<%= expression %>"} />
or
<jsp:forward page={"relativeURL" | "<%= expression %>"} >
<jsp:param name="parameterName"
value="{parameterValue | <%= expression %>}" />+
</jsp:forward>
例子
<jsp:forward page="/servlet/login" />
<jsp:forward page="/servlet/login">
<jsp:param name="username" value="jsmith" />
</jsp:forward>
描述
jsp:forward标签从一个JSP文件向另一个文件传递一个包含用户请求的request对象。jsp:forward标签以下的代码,将不能执行。
你能够向目标文件传送参数和值,在这个例子中我们传递的参数名为username,值为scott,如果你使用了jsp:param标签的话,目标文件必须是一个动态的文件,能够处理参数。
如果你使用了非缓冲输出的话,那么使用jsp:forward时就要小心。如果在你使用jsp:forward之前,jsp文件已经有了数据,那么文件执行就会出错。
属性
page="{relativeURL | <%= expression %>}"
这里是一个表达式或是一个字符串用于说明你将要定向的文件或URL。这个文件可以是JSP、程序段、或者其它能够处理request对象的文件(如asp、cgi、php)。
<jsp:param name="parameterName" value="{parameterValue | <%= expression %>}" />+
向一个动态文件发送一个或多个参数,这个文件一定是动态文件。
如果你想传递多个参数,你可以在一个JSP文件中使用多个jsp:param。name指定参数名,value指定参数值。
jsp:getProperty
获取Bean的属性值,用于显示在页面中。
JSP 语法
d_nobr> <jsp:getProperty name="beanInstanceName" property="propertyName" />
例子
<jsp:useBean id="calendar" scope="page" class="employee.Calendar" />
<h2>
Calendar of <jsp:getProperty name="calendar" property="username"/>
</h2>
描述
这个jsp:getProperty元素将获得Bean的属性值,并可以将其使用或显示在JSP页面中。在你使用jsp:getProperty之前,你必须用jsp:useBean创建它。
jsp:getProperty元素有一些限制:
1 你不能使用jsp:getProperty来检索一个已经被索引了的属性
2 你能够和JavaBeans组件一起使用jsp:getProperty,但是不能与Enterprise Bean一起使用。
属性
name="beanInstanceName"
bean的名字,由jsp:useBean指定。
property="propertyName"
所指定的Bean的属性名。
技巧:
在sun的JSP参考中提到,如果你使用jsp:getProperty来检索的值是空值,那么NullPointerException将会出现,同时如果使用程序段或表达式来检索其值,那么在浏览器上出现的是null(空)。
jsp:include
包含一个静态或动态文件。
JSP 语法
<jsp:include page="{relativeURL | <%= expression%>}" flush="true" />
or
<jsp:include page="{relativeURL | <%= expression %>}" flush="true" >
<jsp:param name="parameterName"
value="{parameterValue | <%= expression %>}" />+
</jsp:include>
例子
<jsp:include page="scripts/login.jsp" />
<jsp:include page="copyright.html" />
<jsp:include page="/index.html" />
<jsp:include page="scripts/login.jsp">
<jsp:param name="username" value="jsmith" />
</jsp:include>
描述
jsp:include元素允许你包含动态文件和静态,这两种包