Java Web学习总结（15）——JSP指令
一、JSP指令简介
JSP指令（directive）是为JSP引擎而设计的，它们并不直接产生任何可见输出，而只是告诉引擎如何处理JSP页面中的其余部分。
在JSP 2.0规范中共定义了三个指令：
- page指令
- Include指令
- taglib指令
JSP指令的基本语法格式：<%@ 指令 属性名="值" %>
例如：
1 <%@ page contentType="text/html;charset=gb2312"%>
如果一个指令有多个属性，这多个属性可以写在一个指令中，也可以分开写。
例如：
1 <%@ page contentType="text/html;charset=gb2312"%>
2 <%@ page import="java.util.Date"%>
也可以写作：
1 <%@ page contentType="text/html;charset=gb2312" import="java.util.Date"%>
二、Page指令
page指令用于定义JSP页面的各种属性，无论page指令出现在JSP页面中的什么地方，它作用的都是整个JSP页面，为了保持程序的可读性和遵循良好的编程习惯，page指令最好是放在整个JSP页面的起始位置。例如：
JSP 2.0规范中定义的page指令的完整语法：
1 <%@ page
2 [ language="java" ]
3 [ extends="package.class" ]
4 [ import="{package.class | package.*}, ..." ]
5 [ session="true | false" ]
6 [ buffer="none | 8kb | sizekb" ]
7 [ autoFlush="true | false" ]
8 [ isThreadSafe="true | false" ]
9 [ info="text" ]
10 [ errorPage="relative_url" ]
11 [ isErrorPage="true | false" ]
12 [ contentType="mimeType [ ;charset=characterSet ]" | "text/html ; charset=ISO-8859-1" ]
13 [ pageEncoding="characterSet | ISO-8859-1" ]
14 [ isELIgnored="true | false" ]
15 %>
2.1、page指令的import属性
在Jsp页面中，Jsp引擎会自动导入下面的包
- java.lang.*
- javax.servlet.*
- javax.servlet.jsp.*
- javax.servlet.http.*
可以在一条page指令的import属性中引入多个类或包，其中的每个包或类之间使用逗号(,)分隔
例如：
1 <%@ page import="java.util.*,java.io.*,java.sql.*"%>
上面的语句也可以改写为使用多条page指令的import属性来分别引入各个包或类
例如：
1 <%@ page import="java.util.Date"%>
2 <%@ page import="java.io.*" %>
3 <%@ page import="java.sql.*" %>
2.2、page指令的errorPage属性
- errorPage属性的设置值必须使用相对路径，如果以“/”开头，表示相对于当前Web应用程序的根目录(注意不是站点根目录)，否则，表示相对于当前页面
- 可以在web.xml文件中使用<error-page>元素为整个Web应用程序设置错误处理页面。
- <error-page>元素有3个子元素，<error-code>、<exception-type>、<location>
- <error-code>子元素指定错误的状态码，例如：<error-code>404</error-code>
- <exception-type>子元素指定异常类的完全限定名，例如：<exception-type>java.lang.ArithmeticException</exception-type>
- <location>子元素指定以“/”开头的错误处理页面的路径，例如：<location>/ErrorPage/404Error.jsp</location>
- 如果设置了某个JSP页面的errorPage属性，那么在web.xml文件中设置的错误处理将不对该页面起作用。
2.3、使用errorPage属性指明出错后跳转的错误页面
比如Test.jsp页面有如下的代码：
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>
在Test.jsp中，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>
运行结果如下：
2.4、在web.xml中使用<error-page>标签为整个web应用设置错误处理页面
例如：使用<error-page>标签配置针对404错误的处理页面
web.xml的代码下：
1 <?xml version="1.0" encoding="UTF-8"?>
2 <web-app version="3.0"
3 xmlns="http://java.sun.com/xml/ns/javaee"
4 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
5 xsi:schemaLocation="http://java.sun.com/xml/ns/javaee
6 http://java.sun.com/xml/ns/javaee/web-app_3_0.xsd">
7 <display-name></display-name>
8 <welcome-file-list>
9 <welcome-file>index.jsp</welcome-file>
10 </welcome-file-list>
11
12 <!-- 针对404错误的处理页面 -->
13 <error-page>
14 <error-code>404</error-code>
15 <location>/ErrorPage/404Error.jsp</location>
16 </error-page>
17
18 </web-app>
404Error.jsp代码如下：
1 <%@ page language="java" import="java.util.*" pageEncoding="UTF-8"%>
2 <html>
3 <head>
4 <title>404错误友好提示页面</title>
5 <!-- 3秒钟后自动跳转回首页 -->
6 <meta http-equiv="refresh" content="3;url=${pageContext.request.contextPath}/index.jsp">
7 </head>
8 <body>
9 <img alt="对不起，你要访问的页面没有找到，请联系管理员处理!"
10 src="${pageContext.request.contextPath}/img/404Error.png"/><br/>
11 3秒钟后自动跳转回首页，如果没有跳转，请点击<a href="${pageContext.request.contextPath}/index.jsp">这里</a>
12 </body>
13 </html>
当访问一个不存在的web资源时，就会跳转到在web.xml中配置的404错误处理页面404Error.jsp，如下图所示：
2.5、关于在web.xml中使用<error-page>标签为整个web应用设置错误处理页面在IE下无法跳转的解决办法
这里需要注意的是，如果错误页面比较小，那么当访问服务器上不存在的web资源或者访问服务器出错时在IE浏览器下是无法跳转到错误页面的，显示的是ie自己的错误页面，而在火狐和google浏览器下(其他浏览器没有测试过)是不存在注意的问题的。
我们可以通过下面的实验来证明
在web.xml中配置500错误时的错误友好提示页面
1 <!-- 针对500错误的处理页面 -->
2 <error-page>
3 <error-code>500</error-code>
4 <location>/ErrorPage/500Error.jsp</location>
5 </error-page>
500Error.jsp页面的代码如下：
1 <%@ page language="java" import="java.util.*" pageEncoding="UTF-8"%>
2 <html>
3 <head>
4 <title>500(服务器错误)错误友好提示页面</title>
5 <!-- 3秒钟后自动跳转回首页 -->
6 <meta http-equiv="refresh" content="3;url=${pageContext.request.contextPath}/index.jsp">
7 </head>
8 <body>
9 <img alt="对不起，服务器出错!"
10 src="${pageContext.request.contextPath}/img/500Error.png"/><br/>
11 3秒钟后自动跳转回首页，如果没有跳转，请点击<a href="${pageContext.request.contextPath}/index.jsp">这里</a>
12 </body>
13 </html>
500Error.jsp页面的字节大小
在IE8浏览器下的运行结果：
在IE下访问Test.jsp出现500错误后，显示的是ie自己的错误页面，而不是我们定制的那个500错误页面，而在google和火狐下却是可以正常跳转到我们自己定制的那个500错误页面的，如下图所示：
很多人遇到这个问题，而解决这个问题的办法有两种：
1、修改IE浏览器的设置（不推荐）
操作步骤：在IE【工具】->【Internet选项】->【高级】中勾掉【显示友好http错误提示】
经过这样的设置之后，访问服务器出错后就可以直接跳转到我们定制的500错误页面了，如下图所示：
这种做法需要修改客户端浏览器的配置，不推荐这样的方式。
2.不修改IE浏览器的设置下确保定制的错误页面的大小>1024字节
修改500Error.jsp，多添加一些内容，让页面的字节数大一些，修改后的500Error.jsp的代码如下：
1 <%@ page language="java" import="java.util.*" pageEncoding="UTF-8"%>
2 <html>
3 <head>
4 <title>500(服务器错误)错误友好提示页面</title>
5 <!-- 3秒钟后自动跳转回首页 -->
6 <meta http-equiv="refresh" content="3;url=${pageContext.request.contextPath}/index.jsp">
7 </head>
8 <body>
9 <img alt="对不起，服务器出错了，请联系管理员解决！"
10 src="${pageContext.request.contextPath}/img/500Error.png"/><br/>
11 3秒钟后自动跳转回首页，如果没有跳转，请点击<a href="${pageContext.request.contextPath}/index.jsp">这里</a>
12 </body>
13 </html>
也就多加了几个中文，让500Error.jsp多了几个字节，500Error.jsp现在的字节数如下：
在IE下访问，当服务器出错时，就可以正常跳转到500Error.jsp这个定制的错误页面了，如下图所示：
经过测试，当定制的错误页面的size=617bytes时，在IE8下已经可以跳转到定制的错误页面了，其他版本的IE浏览器没有经过测试，不过为了保险起见，定制的错误页面的size最好超过1024bytes。
2.6、使用page指令的的isErrorPage属性显式声明页面为错误页面
如果某一个jsp页面是作为系统的错误处理页面，那么建议将page指令的isErrorPage属性(默认为false)设置为"true"来显式声明这个Jsp页面是一个错误处理页面。
例如：将error.jsp页面显式声明为错误处理页面
1 <%@ page language="java" import="java.util.*" pageEncoding="UTF-8" isErrorPage="true"%>
2 <html>
3 <head>
4 <title>错误信息友好提示页面</title>
5 </head>
6
7 <body>
8 对不起，出错了，请联系管理员解决！
9 </body>
10 </html>
将error.jsp页面显式声明为错误处理页面后，有什么好处呢，好处就是Jsp引擎在将jsp页面翻译成Servlet的时候，在Servlet的 _jspService方法中会声明一个exception对象，然后将运行jsp出错的异常信息存储到exception对象中，如下所示：
由于Servlet的_jspService方法中声明了exception对象，那么就可以在error.jsp页面中使用exception对象，这样就可以在Jsp页面中拿到出错的异常信息了，如下：
如果没有设置isErrorPage="true"，那么在jsp页面中是无法使用exception对象的，因为在Servlet的_jspService方法中不会声明一个exception对象，如下所示：
Jsp有9大内置对象，而一般情况下exception对象在Jsp页面中是获取不到的，只有设置page指令的isErrorPage属性为"true"来显式声明Jsp页面是一个错误处理页面之后才能够在Jsp页面中使用exception对象。
三、include指令
在JSP中对于包含有两种语句形式：
- @include指令
- <jsp:include>指令
3.1、@include指令
@include可以包含任意的文件，当然，只是把文件的内容包含进来。
include指令用于引入其它JSP页面，如果使用include指令引入了其它JSP页面，那么JSP引擎将把这两个JSP翻译成一个servlet。所以include指令引入通常也称之为静态引入。
语法：<%@ include file="relativeURL"%>，其中的file属性用于指定被引入文件的路径。路径以“/”开头，表示代表当前web应用。
include指令细节注意问题：
- 被引入的文件必须遵循JSP语法。
- 被引入的文件可以使用任意的扩展名，即使其扩展名是html，JSP引擎也会按照处理jsp页面的方式处理它里面的内容，为了见明知意，JSP规范建议使用.jspf（JSP fragments(片段)）作为静态引入文件的扩展名。
- 由于使用include指令将会涉及到2个JSP页面，并会把2个JSP翻译成一个servlet，所以这2个JSP页面的指令不能冲突（除了pageEncoding和导包除外）。
include指令使用范例:
新建head.jspf页面和foot.jspf页面，分别作为jsp页面的头部和尾部，存放于WebRoot下的jspfragments文件夹中，代码如下：
head.jspf代码：
1 <%@ page language="java" import="java.util.*" pageEncoding="UTF-8"%>
2 <h1 style="color:red;">网页头部</h1>
foot.jspf代码：
1 <%@ page language="java" import="java.util.*" pageEncoding="UTF-8"%>
2 <h1 style="color:blue;">网页尾部</h1>
在WebRoot文件夹下创建一个IncludeTagTest.jsp页面，在IncludeTagTest.jsp页面中使用@include指令引入head.jspf页面和foot.jspf页面，代码如下：
1 <%@ page language="java" import="java.util.*" pageEncoding="UTF-8"%>
2 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
3 <html>
4 <head>
5 <title>jsp的Include指令测试</title>
6 </head>
7
8 <body>
9 <%--使用include标签引入引入其它JSP页面--%>
10 <%@include file="/jspfragments/head.jspf" %>
11 <h1>网页主体内容</h1>
12 <%@include file="/jspfragments/foot.jspf" %>
13 </body>
14 </html>
运行结果如下：
我们查看一下jsp引擎将IncludeTagTest.jsp翻译成IncludeTagTest_jsp类之后的源代码，找到Tomcat服务器的work\Catalina\localhost\JavaWeb_Jsp_Study_20140603\org\apache\jsp目录下找到IncludeTagTest_jsp.java，如下图所示：
打开IncludeTagTest_jsp.java，里面的代码如下所示：
1 package org.apache.jsp;
2
3 import javax.servlet.*;
4 import javax.servlet.http.*;
5 import javax.servlet.jsp.*;
6 import java.util.*;
7 import java.util.*;
8 import java.util.*;
9
10 public final class IncludeTagTest_jsp extends org.apache.jasper.runtime.HttpJspBase
11 implements org.apache.jasper.runtime.JspSourceDependent {
12
13 private static final JspFactory _jspxFactory = JspFactory.getDefaultFactory();
14
15 private static java.util.List _jspx_dependants;
16
17 static {
18 _jspx_dependants = new java.util.ArrayList(2);
19 _jspx_dependants.add("/jspfragments/head.jspf");
20 _jspx_dependants.add("/jspfragments/foot.jspf");
21 }
22
23 private javax.el.ExpressionFactory _el_expressionfactory;
24 private org.apache.AnnotationProcessor _jsp_annotationprocessor;
25
26 public Object getDependants() {
27 return _jspx_dependants;
28 }
29
30 public void _jspInit() {
31 _el_expressionfactory = _jspxFactory.getJspApplicationContext(getServletConfig().getServletContext()).getExpressionFactory();
32 _jsp_annotationprocessor = (org.apache.AnnotationProcessor) getServletConfig().getServletContext().getAttribute(org.apache.AnnotationProcessor.class.getName());
33 }
34
35 public void _jspDestroy() {
36 }
37
38 public void _jspService(HttpServletRequest request, HttpServletResponse response)
39 throws java.io.IOException, ServletException {
40
41 PageContext pageContext = null;
42 HttpSession session = null;
43 ServletContext application = null;
44 ServletConfig config = null;
45 JspWriter out = null;
46 Object page = this;
47 JspWriter _jspx_out = null;
48 PageContext _jspx_page_context = null;
49
50
51 try {
52 response.setContentType("text/html;charset=UTF-8");
53 pageContext = _jspxFactory.getPageContext(this, request, response,
54 null, true, 8192, true);
55 _jspx_page_context = pageContext;
56 application = pageContext.getServletContext();
57 config = pageContext.getServletConfig();
58 session = pageContext.getSession();
59 out = pageContext.getOut();
60 _jspx_out = out;
61
62 out.write("\r\n");
63 out.write("<!DOCTYPE HTML PUBLIC \"-//W3C//DTD HTML 4.01 Transitional//EN\">\r\n");
64 out.write("<html>\r\n");
65 out.write(" <head>\r\n");
66 out.write(" \r\n");
67 out.write(" <title>jsp的Include指令测试</title>\r\n");
68 out.write(" \r\n");
69 out.write(" </head>\r\n");
70 out.write(" \r\n");
71 out.write(" <body>\r\n");
72 out.write(" ");
73 out.write("\r\n");
74 out.write("<h1 style=\"color:red;\">网页头部</h1>\r\n");
75 out.write("\r\n");
76 out.write(" <h1>网页主体内容</h1>\r\n");
77 out.write(" ");
78 out.write("\r\n");
79 out.write("<h1 style=\"color:blue;\">网页尾部</h1>\r\n");
80 out.write("\r\n");
81 out.write(" </body>\r\n");
82 out.write("</html>\r\n");
83 } catch (Throwable t) {
84 if (!(t instanceof SkipPageException)){
85 out = _jspx_out;
86 if (out != null && out.getBufferSize() != 0)
87 try { out.clearBuffer(); } catch (java.io.IOException e) {}
88 if (_jspx_page_context != null) _jspx_page_context.handlePageException(t);
89 }
90 } finally {
91 _jspxFactory.releasePageContext(_jspx_page_context);
92 }
93 }
94 }
可以看到，head.jspf和foot.jspf页面的内容都使用out.write输出到浏览器显示了。
3.2、总结@include指令
使用@include可以包含任意的内容，文件的后缀是什么都无所谓。这种把别的文件内容包含到自身页面的@include语句就叫作静态包含，作用只是把别的页面内容包含进来，属于静态包含。
3.3、jsp:include指令
jsp:include指令为动态包含，如果被包含的页面是JSP，则先处理之后再将结果包含，而如果包含的是非*.jsp文件，则只是把文件内容静态包含进来，功能与@include类似。后面再具体介绍
Java Web学习总结（15）——JSP指令的更多相关文章
- Java Web学习笔记之---JSP
Java Web学习笔记之---JSP (一)JSP常用语法 (1)HTML注释 <!--所要注释的内容 --> 在客户端显示一个注释. (2)隐藏注释 <%--所要注释的内容--% ...
- [原创]java WEB学习笔记15：域对象的属性操作(pageContext,request,session,application) 及 请求的重定向和转发
本博客为原创:综合 尚硅谷(http://www.atguigu.com)的系统教程(深表感谢)和 网络上的现有资源(博客,文档,图书等),资源的出处我会标明 本博客的目的:①总结自己的学习过程,相当 ...
- java web学习之初识jsp
用java语言(+html语言)开发动态资源的技术: jsp的运行过程,1:tomcat服务器将jsp代码翻译成java代码,并且编译成class文件 2:tomcat服务器构造类对象 3:tomca ...
- java web学习笔记-jsp篇
1.java web简介 1.1静态页面与动态页面 表现形式 所需技术 静态网页 网页内容固定,不会更新 html,css 动态网页 网页内容由程序动态显示,自动更新 html,css,DB,ja ...
- Java web 学习之旅
java web学习之旅 来公司十天了,感觉已经慢慢地融入了这个环境中,几个学长人都很好,都是在他们帮助下,我才能比较顺利的开始了学习java web的旅途. 来这里学习的第一个阶段是做一个简单的用户 ...
- Java Web 学习路线
实际上,如果时间安排合理的话,大概需要六个月左右,有些基础好,自学能力强的朋友,甚至在四个月左右就开始找工作了.大三的时候,我萌生了放弃本专业的念头,断断续续学 Java Web 累计一年半左右,总算 ...
- [原创]java WEB学习笔记66：Struts2 学习之路--Struts的CRUD操作( 查看 / 删除/ 添加) 使用 paramsPrepareParamsStack 重构代码 ，PrepareInterceptor拦截器，paramsPrepareParamsStack 拦截器栈
本博客的目的:①总结自己的学习过程,相当于学习笔记 ②将自己的经验分享给大家,相互学习,互相交流,不可商用 内容难免出现问题,欢迎指正,交流,探讨,可以留言,也可以通过以下方式联系. 本人互联网技术爱 ...
- java web 学习笔记 编码问题总结
java web 学习笔记 编码问题总结 1.非form表单中提交的中文参数---------------------------传递给Servlet服务器时,默认以iso-8859-1解码 ...
- Java Web 学习笔记 1
Java Web 学习笔记 1 一.Web开发基础 1-1 Java Web 应用开发概述 1.1.1 C/S C/S(Client/Server)服务器通常采用高性能的PC机或工作站,并采用大型数据 ...
- Java Web学习笔记之---EL和JSTL
Java Web学习笔记之---EL和JSTL (一)EL (1)EL作用 Expression Language(表达式语言),目的是代替JSP页面中复杂的代码 (2)EL表达式 ${变量名} ( ...
随机推荐
- SpringBoot 增加 拦截器 判断是否登录
1.创建拦截器 package com.example.demo.interceptor; import org.slf4j.Logger; import org.slf4j.LoggerFactor ...
- Java Web学习总结（9）——servlet和Jsp生命周期解读
一.servlet的工作工程 Servlet是运行在Servlet容器(有时候也叫Servlet引擎,是web服务器和应用程序服务器的一部分,用于在发送的请求和响应之上提供网络服务,解码基于MIME的 ...
- FZU 1096 QS Network
QS Network Time Limit: 1000ms Memory Limit: 32768KB This problem will be judged on FZU. Original ID: ...
- [Python] Read and Parse Files in Python
This lesson will teach you how to read the contents of an external file from Python. You will also l ...
- 从设计到实现，一步步教你实现Android-Universal-ImageLoader-辅助类
通过前面几篇博文.我们分析了 AUI 的缓存.工具类.显示与载入这几个方面的代码.今天呢,我们继续研究 AUI 的源代码,学习当中的核心辅助工具类. 希望大家能在里面学到东西哈. Download 要 ...
- css3--简单的加载动画
.load-container { width: 30%; height: auto; position: relative; margin: 1rem auto; } .load { width: ...
- layui动态无限极菜单
ajax加jQuery实现 效果图 参考文章:https://www.wanpishe.top/detail?blogId=644aa177-9795-456a-8090-ee1264bf5d9d
- echarts插件-从后台请求的数据在页面显示空白的问题
最近的项目里面关于统计图方面的问题,有涉及到很多,也在博客里面更新了自己所遇到的问题,开发过程中会遇到很多问题,解决技术问题的方法也有千千万 图片.png 在百度上百度了一下,发现了问题所在之处,不得 ...
- POJ 4047 Garden
Garden Time Limit: 1000ms Memory Limit: 65536KB This problem will be judged on PKU. Original ID: 404 ...
- Codeforces Round #312 (Div. 2) E. A Simple Task 线段树 延时标记
E. A Simple Task time limit per test5 seconds memory limit per test512 megabytes inputstandard input ...