javaweb學習總結(十六)——JSP指令 - shanheyongmu－IT工程師數位筆記本

文章出處

一、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類似。后面再具體介紹

文章列表

大師兄

IT工程師數位筆記本

大師兄發表在痞客邦留言(0) 人氣()

IT工程師數位筆記本

If you give someone a program , you will frustrate them for a day; if you teach them how to program, you will frustrate them for a lifetime.IT 這段話的意思是，如果你交給某人一隻程式，你將折磨他一整天;如果你教會某人如何寫程式，你將折磨他一輩子。

BloggerAds