1、page指令
page指令用户定义JSP页面中的全局属性,它的语法格式如下:
<%@ page
{language=”Java”}
{extends=”package.class”}
{import=”{package.class|package.*},…”}
{session=”true | false”}
{buffer=”none | 8kb | sizekb”}
{ false”}
{isThreadSafe=”true | false”}
{info=”text”}
{errorPage=”relativeURL”}
{contentType=”mimeType [;charset=characterSet]” | “text/html ; charset=ISO-8859-1”}
{isErrorPage=”true | false”}
{pageEncoding=”charset=characrerSet | ISO-8859-1”}
%>
page指令对整个页面有效,包括静态的包含文件,但page指令不能用于被动态包含的文件,例如使用包含的文件。在一个JSP页面中可以使用多个page指令,但page指令中的属性只能出现一次(import属性除外)。
Example:
<%@ page contentType=”text/html; charset=gb2312” language=”Java” import=”java.sql.*” buffer=”5kb” autoFlush=”false” errorPage=” error.jsp ” %>
通过Page命令,你可以为整个JSP页面定义上面提到的全局属性,其中除了“import”之外,其他的都只能引用一次,import属性和Java语言中的import非常相似,可以在JSP页面中多次使用它。
关于<%@ page %>的位置可以不去考虑,放在任何地方都可以很好的工作,但出于良好的编程习惯,建议放在JSP页面的顶部。几乎所有的JSP页面顶部都可以找到指令page。
1.language属性
定义JSP页面使用的脚本语言,若使用JSP引擎支持Java以外的语言,可指定所使用的语言种类。默认语言为Java
language=”java”
指明JSP文件中使用的脚本语言,目前只能使用Java。
2.contentType属性
contentType属性定义了JSP页面字符编码和页面响应的MIME类型。默认的MIME类型是text/html,默认的字符集是ISO-8859-1。例如:
<%@ page contentType=”text/html; charset=gb2312” language=”java” import=”java.sql.*” %>
3.import属性
该属性用于JSP引入Java包中的类,如果你要包含多个包的话,将这些包的名称用逗号隔开放在一个import中,或者使用多个import分别声明。它是唯一可以多次指定的属性。
在使用Java包中的元素之前一定要先声明该包的import引用。下面一些Java包,是默认包含的,不用再在JSP页面中声明。
java.lang.*
javax.servlet.*
javax.servlet.jsp.*
javax.servlet.http.*
4.extends属性
定义此JSP页面产生的Servlet是继承自哪个父类。请特别谨慎使用这一功能,因为,服务器也许已经定义了一个。JSP规范对不完全理解其隐意的情况下使用此属性提出警告。
5.isErrorPage属性
isErrorPage=”true|false”
默认值为“true”,设置是否显示错误信息。如果为true,可以看到出错信息,如果为false,就看不到了。
6.errorPage属性
errorPage=”relativeURL”
设置处理异常事件的JSP文件的位置。表示如果发生异常错误,网页会被重新指向一个URL页面。错误页面必须在其page指令元素中指定isErrorPage=”true”。
7.session属性
session=”true|false”
默认值为“true”,定义是否在JSP页面使用HTTP的session。如果值为true,则可以使用session对象;如果值为false,那么JSP页面就不被加入到session中,session内置对象则不能使用,而同时会造成Bean的scope属性值只能是“page”。
8.Buffer属性
buffer=”none|8kb|sizekb”
为内置对象out指定发送信息到客户端浏览器的信息缓存大小。以kb为单位。默认值是8kb.你也可以自行指定缓存的大小。也可以设置为“none”,那么就没有缓冲区,所有的输出都不经缓存而直接输出。
9.autoFlush属性
autoFlush=”true|false”
指定是否当缓存填满时自动刷新,输出缓存中的内容。如果为true,则自动刷新。否则,当缓存填满后,可能会出现严重的错误。当你把buffer设置为none时,就不能将autoFlush设置为false。
10.isThreadSafe属性
isThreadSafe=”true|false”
指定JSP页面是否支持多线程访问。默认值是ture,表示可以同时处理多个客户请求,但是你应该在JSP页面中添加处理多线程的同步控制代码。如果设置为false,JSP页面在一个时刻就只能响应一个请求。
11.info属性
info=”text”
指定任何一段字符串,该字符串被直接加入到翻译好的页面中。可以通过Servlet.getServletInfo()方法得到。
2、include指令
Include指令的功能是在JSP编译时插入包含的文件。包含的过程是静态的。它可以把内容分成更多可管理的元素,如包括普通页面的页眉或页脚的元素。包含的文件可以是JSP、HTML、文本或是Java程序。
include指令的语法:
<%@ include file=”relativeURL” %>
其中只有一个file属性,这个属性指定了被包含文件的路径。
如果路径是以”/”开头的,那么这个路径应该就是相对于JSP应用程序上下文而言的。而如果以目录名或文件名开头则是以JSP文件所在路径为当前路径而言。例如:
“header.jsp”
“/templates/onlinestore.html”
“/beans/calendar.jsp”
在JSP中,你可以用Include指令将JSP文件,HTML文件,或Text文件包含到一个JSP文件中,这种包含是静态包含,也就是说当使用这种方法包含文件的时候,会将被包含文件的内容插入包含文件中,替换掉<%@ include %>这行语句。如果你包含的是一个JSP文件,那么包含在这个文件中的JSP程序将被执行。
当你使用Include包含一个文件的时候,一定要注意,在被包含文件中不能含有,,,等HTML元素,否则的话会导致执行错误。因为被包含的文件会整个加入到JSP文件中去,这些标记会与JSP文件中类似的标记相冲突。
使用包含文件有以下一些优点:
(1)被包含文件可以在多个文件中被使用,实现了代码共享和重用。
(2)当被包含文件修改后,包含此文件的JSP文件的执行结果也发生变化,这样就提高修改效率,为维护提供方便。
Example:
include.jsp
An Include Test
The current date and time are
<%@ include file=”date.jsp” %>
date.jsp
<%@ page import =”java.util.*” %>
<%= (new java.util.Date()).toLocaleString() %>
上面的例子在执行后,会在客户端的浏览器中显示和下面类似的信息:
The current date and time are
Aug 30,1999 2:38:40
3、taglib指令
taglib指令中的uri属性用于根据标签的前缀对自定义的标签进行唯一的命名,其值可以是相对路径,就对路径或标签库描述文件。属性prefix制定了标签的前缀。
taglib指令的语法:
<%@ taglib uri=”URIToTagLibrary” prefix=”tagPrefix” %>
例如
<%@ taglib uri=”http://www.jspcentral.com/tags” prefix=”public” %>
<% @ taglib %>指令声明此JSP文件使用了自定义的标签,同时引用标签库,也指定了标签的前缀。
这里自定义的标签有标签和元素之分。因为JSP文件能够转化为XML,所以了解标签和元素之间的联系很重要。标签只不过是一个在意义上被抬高了点的标记,是JSP元素的一部分。JSP元素是JSP语法的一部分,和HTML一样有开始标记和结束标记。元素可以包含其它的文本,标记,元素。使用自定义标签之前必须使用<% @ taglib %>指令,而且可以在一个页面中多次使用,但是同一前缀只能引用一次。
URI根据标签的前缀对自定义的标签进行唯一的命名prefix=”tagPrefix”,在自定义标签前的前缀,比如,在中的public,如果不写public,就是不合法的。请不要用jsp, jspx, java, javax, servlet, sun, 和sunw作为前缀。
顶