javaweb学习总结(十六)——JSP指令-Java极客技术学习

一、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页面的字节大小