【轉載】Java Web學習(十六) ---- JSP指令

時間 2020-05-22

標籤轉載 java web 學習十六 jsp 指令欄目 Java 简体版

原文原文鏈接

轉載自：https://www.cnblogs.com/xdp-gacl/p/3778993.html

1、JSP指令簡介

　　JSP指令（directive）是爲JSP引擎而設計的，它們並不直接產生任何可見輸出，而只是告訴引擎如何處理JSP頁面中的其他部分。html

　　在JSP 2.0規範中共定義了三個指令：java

page指令
Include指令
taglib指令

　　JSP指令的基本語法格式：<%@ 指令屬性名="值" %>
　　例如：web

1 <%@ page contentType="text/html;charset=gb2312"%>

　　若是一個指令有多個屬性，這多個屬性能夠寫在一個指令中，也能夠分開寫。
　　例如：sql

1 <%@ page contentType="text/html;charset=gb2312"%>
2 <%@ page import="java.util.Date"%>

也能夠寫做：express

1 <%@ page contentType="text/html;charset=gb2312" import="java.util.Date"%>

2、Page指令

　　page指令用於定義JSP頁面的各類屬性，不管page指令出如今JSP頁面中的什麼地方，它做用的都是整個JSP頁面，爲了保持程序的可讀性和遵循良好的編程習慣，page指令最好是放在整個JSP頁面的起始位置。例如：apache

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.一、page指令的import屬性

　　在Jsp頁面中，Jsp引擎會自動導入下面的包瀏覽器

java.lang.*
javax.servlet.*
javax.servlet.jsp.*
javax.servlet.http.*

　　能夠在一條page指令的import屬性中引入多個類或包，其中的每一個包或類之間使用逗號(,)分隔服務器

例如：session

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.二、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.三、使用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.四、在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.五、關於在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錯誤頁面的，以下圖所示：

不少人遇到這個問題，而解決這個問題的辦法有兩種：

一、修改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.六、使用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對象。

3、include指令

　　在JSP中對於包含有兩種語句形式：

@include指令
<jsp:include>指令

3.一、@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輸出到瀏覽器顯示了。