（二十三）JSP指令
一、JSP指令
1.1 JSP指令
-
JSP指令（directive）是为JSP引擎而设计的，它们并不直接产生任何可见输出，而只是告诉引擎如何处理JSP页面中的其余部分
1.2 在JSP 2.0规范中共定义了三个指令：
- page指令
- Include指令
- taglib指令
1.3 JSP指令的基本语法格式：<%@ 指令 属性名="值" %>
1.4 共有三种指令
-
Page指令
1. page指令用于定义JSP页面的各种属性，无论page指令出现在JSP页面中的什么地方，它作用的都是整个JSP页面，为了保持程序的可读性和遵循良好的编程习惯，page指令最好是放在整个JSP页面的起始位置。
2. 属性：
（1） import属性 ：Jsp引擎会自动导入下面的包
- java.lang.*
- javax.servlet.*
- javax.servlet.jsp.*
- javax.servlet.http.*
可以在一条page指令的import属性中引入多个类或包，其中的每个包或类之间使用逗号(,)分隔。
（2） errorPage属性：指明出错后跳转的错误页面。
1 <%@ page language="java" import="java.util.*" errorPage="/ErrorPage/error.jsp" pageEncoding="UTF-8"%>
2 <html>
3 <head>
4 <title>测试page指令的errorPage属性</title>
5 </head>
6 <body>
7 <%
8 //这行代码肯定会出错，因为除数是0，一运行就会抛出异常
9 int x = 1/0;
10 %>
11 </body>
12 </html>
page指令的errorPage属性指明了出错后跳转到"/ErrorPage/error.jsp"，error.jsp页面代码如下：
1 <%@ page language="java" import="java.util.*" pageEncoding="UTF-8"%>
2 <html>
3 <head>
4 <title>错误信息友好提示页面</title>
5 </head>
6 <body>
7 对不起，出错了，请联系管理员解决！
8 </body>
9 </html>
- 在web.xml中使用<error-page>标签为整个web应用设置错误处理页面，web.xml页面如下：
1 <error-page>
2 <error-code>404</error-code>
3 <location>/index.jsp</location>
4 </error-page>
当网站发生页面找不到的时候（404状态码）就会跳转到index.jsp这个错误处理页面。
关于在web.xml中使用<error-page>标签为整个web应用设置错误处理页面在IE下无法跳转的解决办法：因为ie浏览器默认错误处理页面内容的大小必须大于1024字节 ，否则将跳转到ie自己的错误页面。
（3）isErrorPage属性：显式声明页面为错误页面，错误处理页面最好加上这个属性。
如果某一个jsp页面是作为系统的错误处理页面，那么建议将page指令的isErrorPage属性(默认为false)设置为"true"来显式声明这个Jsp页面是一个错误处理页面。
error.jsp页面显式声明为错误处理页面后，Jsp引擎在将jsp页面翻译成Servlet的时候，在Servlet的 _jspService方法中会声明一个exception对象，然后将运行jsp出错的异常信息存储到exception对象中，就可以在error.jsp页面中使用exception对象，这样就可以在Jsp页面中拿到出错的异常信息了。如果没有设置isErrorPage="true"，那么在jsp页面中是无法使用exception对象的，因为在Servlet的_jspService方法中不会声明一个exception对象.
（4）pageEncoding属性和contentType属性
pageEncoding是jsp文件本身的编码。
contentType的charset是指服务器发送给客户端时的内容编码。
JSP要经过两次的“编码”，第一阶段会用pageEncoding，第二阶段会用utf-8至utf-8，第三阶段就是由Tomcat出来的网页， 用的是contentType。
-
include指令
- @include可以包含任意的文件，当然，只是把文件的内容包含进来。
- 语法：<%@ include file="relativeURL"%>，其中的file属性用于指定被引入文件的路径。路径以“/”开头，表示代表当前web应用。
index.jsp:
<%@ page language="java" import="java.util.Date" pageEncoding="UTF-8"%>
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<title>First Jsp</title>
</head>
<body>
<h>我是时钟A</h>
<%@ include file="html/a.jsp" %>
</body>
</html>
html/a.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>
我是时钟B！！
</body>
</html>
结果：
- include指令用于引入其它JSP页面，如果使用include指令引入了其它JSP页面，那么JSP引擎将把这两个JSP编译成一个servlet。所以include指令引入通常也称之为静态引入。查看index_jsp.java文件可知道：
package org.apache.jsp;
import javax.servlet.*;
import javax.servlet.http.*;
import javax.servlet.jsp.*;
import java.util.Date;
public final class index_jsp extends org.apache.jasper.runtime.HttpJspBase
implements org.apache.jasper.runtime.JspSourceDependent {
private static final JspFactory _jspxFactory = JspFactory.getDefaultFactory();
private static java.util.List _jspx_dependants;
static {
_jspx_dependants = new java.util.ArrayList(1);
_jspx_dependants.add("/html/a.jsp");
}
private javax.el.ExpressionFactory _el_expressionfactory;
private org.apache.AnnotationProcessor _jsp_annotationprocessor;
public Object getDependants() {
return _jspx_dependants;
}
public void _jspInit() {
_el_expressionfactory = _jspxFactory.getJspApplicationContext(getServletConfig().getServletContext()).getExpressionFactory();
_jsp_annotationprocessor = (org.apache.AnnotationProcessor) getServletConfig().getServletContext().getAttribute(org.apache.AnnotationProcessor.class.getName());
}
public void _jspDestroy() {
}
public void _jspService(HttpServletRequest request, HttpServletResponse response)
throws java.io.IOException, ServletException {
PageContext pageContext = null;
HttpSession session = null;
ServletContext application = null;
ServletConfig config = null;
JspWriter out = null;
Object page = this;
JspWriter _jspx_out = null;
PageContext _jspx_page_context = null;
try {
response.setContentType("text/html; charset=UTF-8");
pageContext = _jspxFactory.getPageContext(this, request, response,
null, true, 8192, true);
_jspx_page_context = pageContext;
application = pageContext.getServletContext();
config = pageContext.getServletConfig();
session = pageContext.getSession();
out = pageContext.getOut();
_jspx_out = out;
out.write("\r\n");
out.write("<!DOCTYPE HTML PUBLIC \"-//W3C//DTD HTML 4.01 Transitional//EN\">\r\n");
out.write("<html>\r\n");
out.write(" <head>\r\n");
out.write(" <title>First Jsp</title>\r\n");
out.write(" </head>\r\n");
out.write(" <body>\r\n");
out.write(" <h>我是时钟A</h>\r\n");
out.write(" ");
out.write("\r\n");
out.write("<!DOCTYPE html PUBLIC \"-//W3C//DTD HTML 4.01 Transitional//EN\" \"http://www.w3.org/TR/html4/loose.dtd\">\r\n");
out.write("<html>\r\n");
out.write("<head>\r\n");
out.write("<meta http-equiv=\"Content-Type\" content=\"text/html; charset=UTF-8\">\r\n");
out.write("<title>Insert title here</title>\r\n");
out.write("</head>\r\n");
out.write("<body>\r\n");
out.write("\t我是时钟B！！\r\n");
out.write("</body>\r\n");
out.write("</html>");
out.write("\r\n");
out.write(" </body>\r\n");
out.write("</html>");
} catch (Throwable t) {
if (!(t instanceof SkipPageException)){
out = _jspx_out;
if (out != null && out.getBufferSize() != 0)
try { out.clearBuffer(); } catch (java.io.IOException e) {}
if (_jspx_page_context != null) _jspx_page_context.handlePageException(t);
else log(t.getMessage(), t);
}
} finally {
_jspxFactory.releasePageContext(_jspx_page_context);
}
}
}
-
taglib指令
- 声明用户使用自定义的标签，将标签库描述符文件导入到jsp页面。
- taglib指令语法：
<%@ taglib (uri="tigLibURL" 或 tagDir="tagDir") prefix="tagPrefix" %>
- uri属性:定位标签库描述符的位置。唯一标识和前缀相关的标签库描述符，可以使用绝对或相对URL。
- tagDir属性：指示前缀将被用于标识在WEV-INF/tags目录下的标签文件。
- prefix属性：标签的前缀，区分多个自定义标签。不可以使用保留前缀和空前缀，遵循XML命名空间的命名约定。
