JSP指令
为了设置JSP页面中的一些信息,Sun公司提供了JSP指令。JSP2.0 中共定义了page、include、taglib三种指令,每种指令都定义了各自的属性。
语法格式如下:
<%&#64; directive attribute&#61;"value" %>
指令可以有很多个属性&#xff0c;它们以键值对的形式存在&#xff0c;并用逗号隔开。
JSP中三种指令标签&#xff1a;
指令 | 描述 |
---|
<%&#64; page … %> | 定义网页依赖属性&#xff0c;比如脚本语言&#xff0c;error页面、缓存需求等等 |
<%&#64; include … %> | 包含其他文件 |
<%&#64; taglib … %> | 引入标签库的定义 |
Page指令
Page指令为容器提供当前页面的使用说明。一个JSP页面可以包含多个page指令。
在JSP页面中&#xff0c;经常需要对页面的某些特性进行描述&#xff0c;例如&#xff0c;页面的编码方式&#xff0c;JSP页面采用的语言等&#xff0c;这时&#xff0c;可以通过page指令来实现。
Page指令的具体语法格式如下所示&#xff1a;
<%&#64; page attribute&#61;"value" %>
等价的XML格式&#xff1a;
<jsp:directive.page attribute&#61;"value" />
Page指令的常用属性
属性名称 | 取值 or 范围 | 描述 |
---|
pageEncoding | 当前页面 | 指定页面的编码格式 |
contentType | 有效的文档类型 | 客户端浏览器根据该属性判断文档类型&#xff0c;例如&#xff1a; HTML格式为 text/html 纯文本格式为 text/plain JPG图像为 image/jpeg GIF图像为 image/gif Word文档为 application/msword |
buffer | 8kb | jsp缓存大小 |
autoFlush | true / false | 是否自动刷新 |
errorPage | 某个JSP页面的相对路径 | 指定一个错误页面&#xff0c;如果该JSP程序抛出一个未捕捉的异常&#xff0c;则转到errorPage指定的页面。eooroPage指定页面的isErrorPage属性为true&#xff0c;且内置的exception对象为未捕捉的异常。 |
isErrorPage | true / false | 指定该页面是否为错误处理页面&#xff0c;如果为true&#xff0c;则该JSP内置有一个Exception对象的exception&#xff0c;可直接使用。默认情况下&#xff0c;isErrorPage的值为false |
import | 任何包名、类名 | 指定在JSP页面翻译成的Servlet源文件中导入的包或类。import是唯一可以声明多次的page指令属性。一个import属性可以引用多个类&#xff0c;中间用英文逗号隔开 |
language | java | 指明解释该JSP文件时采用的语言&#xff0c;默认为Java |
session | true / false | 指明该JSP内是否内置Session对象&#xff0c;如果为true&#xff0c;则说明内置Session对象&#xff0c;可以直接使用&#xff0c;否则没有内置Session对象。默认情况下&#xff0c;sessiion属性为true。需要注意的是&#xff0c;JSP引擎自动导入以下4个包&#xff1a; java.lang. javax.servlet. javax.servlet.jsp. javax.servlet.http. |
<%&#64; page language&#61;"java" contentType&#61;"text/html; charset&#61;UTF-8"pageEncoding&#61;"UTF-8"buffer&#61;"8kb"autoFlush&#61;"true"session&#61;"true"errorPage&#61;"/error.jsp"isErrorPage&#61;"false"isThreadSafe&#61;"true" %>
<%&#64; page import&#61;"java.io.*" %>
include 指令
在实际开发时&#xff0c;有时需要在JSP页面静态包含一个文件&#xff0c;例如HTML文件&#xff0c;文本文件等&#xff0c;这时&#xff0c;可以通过include指令来实现。
包含的文件就好像是该JSP文件的一部分&#xff0c;会被同时编译执行。
include指令的具体语法格式如下所示&#xff1a;
- 静态包含&#xff08;jsp include指令&#xff09;
<%&#64; include file&#61;"被包含的文件相对url地址" %>
- 动态包含&#xff08;jsp include动作&#xff09;
<jsp:include page&#61;"被包含的文件相对url地址" flush&#61;"true/false" %>
区别&#xff1a;
- 静态包含&#xff0c;两个jsp文件会编译成一个java文件&#xff0c;两个jsp文件中可以共享同一个变量&#xff0c;但不能定义重名变量。
- 动态包含&#xff0c;两个jsp文件会生成两个java文件&#xff0c;两个jsp文件中不可以共享同一个变量&#xff0c;可以定义重名的变量。
例子&#xff1a;
创建两个JSP页面文件date.jsp 和 include.jsp 在include.jsp文件中使用include指令将date.jsp
文件包含其中&#xff0c;如下图所示&#xff1a;
运行结果&#xff1a;
从图中可以看出&#xff0c;date.jsp 文件中用于输出当前日期的语句已显示出来&#xff0c;这说明include指令成功的将date.jsp 文件中的代码合并到了include.jsp 文件中。
关于include指令的具体应用&#xff0c;有很多问题需要注意&#xff0c;接下来&#xff0c;将这些问题进行列举&#xff0c;具体如下&#xff1a;
- 被引入的文件必须遵循JSP语法&#xff0c;其中的内容可以包含静态HTML、JSP脚本元素和JSP指令等普通JSP页面具有的一切内容。
- 除了指令元素之外&#xff0c;被引入的文件中的其它元素都被转换成相应的Java源代码&#xff0c;然后插入进当前JSP页面所翻译成的Srvlet源文件中&#xff0c;插入位置与include指令在当前JSP页面中的位置保持一致。
taglib指令
JSP API允许用户自定义标签&#xff0c;一个自定义标签库就是自定义标签的集合。
Taglib指令引入一个自定义标签集合的定义&#xff0c;包括库路径、自定义标签。
Taglib指令的语法&#xff1a;
<%&#64; taglib uri&#61;"uri" prefix&#61;"prefixOfTag" %>
uri属性确定标签库的位置&#xff0c;prefix属性指定标签库的前缀。
等价的XML语法&#xff1a;
<jsp:directive.taglib uri&#61;"uri" prefix&#61;"prefixOfTag" />