JavaWeb學習（十二）JSP指令簡介
阿新 • • 發佈：2018-12-28
一、JSP指令簡介
JSP指令（directive）是為JSP引擎而設計的，它們並不直接產生任何可見輸出，而只是告訴引擎如何處理JSP頁面中的其餘部分。
在JSP 2.0規範中共定義了三個指令：
- page指令
- Include指令
- taglib指令
JSP指令的基本語法格式：<%@ 指令 屬性名="值" %>
例如：
<%@ page contentType="text/html;charset=gb2312"%> 如果一個指令有多個屬性，這多個屬性可以寫在一個指令中，也可以分開寫。
例如：
<%@ page contentType="text/html;charset=gb2312"%> <%@ page import="java.util.Date"%>
也可以寫作：
<%@ page contentType="text/html;charset=gb2312" import="java.util.Date"%>二、Page指令
page指令用於定義JSP頁面的各種屬性，無論page指令出現在JSP頁面中的什麼地方，它作用的都是整個JSP頁面，為了保持程式的可讀性和遵循良好的程式設計習慣，page指令最好是放在整個JSP頁面的起始位置。例如：
JSP 2.0規範中定義的page指令的完整語法：
<%@ page [ language="java" ] [ extends="package.class" ] [ import="{package.class | package.*}, ..." ] [ session="true | false" ] [ buffer="none | 8kb | sizekb" ] [ autoFlush="true | false" ] [ isThreadSafe="true | false" ] [ info="text" ] [ errorPage="relative_url" ] [ isErrorPage="true | false" ] [ contentType="mimeType [ ;charset=characterSet ]" | "text/html ; charset=ISO-8859-1" ] [ pageEncoding="characterSet | ISO-8859-1" ] [ isELIgnored="true | false" ] %>
2.1、page指令的import屬性
在Jsp頁面中，Jsp引擎會自動匯入下面的包
- java.lang.*
- javax.servlet.*
- javax.servlet.jsp.*
- javax.servlet.http.*
可以在一條page指令的import屬性中引入多個類或包，其中的每個包或類之間使用逗號(,)分隔
例如：
<%@ page import="java.util.*,java.io.*,java.sql.*"%>上面的語句也可以改寫為使用多條page指令的import屬性來分別引入各個包或類
例如：
<%@ page import="java.util.Date"%>
<%@ page import="java.io.*" %>
<%@ 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>子元 s素指定以“/”開頭的錯誤處理頁面的路徑，例如：<location>/ErrorPage/404Error.jsp</location>
- 如果設定了某個JSP頁面的errorPage屬性，那麼在web.xml檔案中設定的錯誤處理將不對該頁面起作用。
2.3、使用errorPage屬性指明出錯後跳轉的錯誤頁面
比如index.jsp頁面有如下的程式碼：
<%@ page language="java" import="java.util.*" errorPage="/error.jsp" pageEncoding="UTF-8"%>
<html>
<head>
<title>測試page指令的errorPage屬性</title>
</head>
<body>
<%
//這行程式碼肯定會出錯，因為除數是0，一執行就會丟擲異常
int x = 1/0;
%>
</body>
</html>error.jsp
<%@ page language="java" import="java.util.*" pageEncoding="UTF-8"%>
<html>
<head>
<title>錯誤資訊友好提示頁面</title>
</head>
<body>
對不起，出錯了，請聯絡管理員解決！
</body>
</html>執行結果：
2.4、在web.xml中使用<error-page>標籤為整個web應用設定錯誤處理頁面
專案工程樹：
web.xml插入：
<!-- 針對404錯誤的處理頁面 -->
<error-page>
<error-code>404</error-code>
<location>/404Error.jsp</location>
</error-page>404Error.jsp
<%@ page language="java" import="java.util.*" pageEncoding="UTF-8" %>
<html>
<head>
<title> 404錯誤友好提示頁面生生世世生生世世生生世世生生世世生生世世</title>
<!-- 3秒鐘後自動跳轉回首頁 -->
<meta http-equiv="refresh" content="3;url=${pageContext.request.contextPath}/index.jsp">
</head>
<body><br>
<img alt="對不起，你要訪問的頁面沒有找到!" src="${pageContext.request.contextPath}/test/1.jpg"/><br/>
3秒鐘後自動跳轉回首頁，如果沒有跳轉，請點選 <a href="${pageContext.request.contextPath}/index.jsp">這裡</a>
</body>
</html>當訪問一個不存在的web資源時，就會跳轉到在web.xml中配置的404錯誤處理頁面404Error.jsp，如下圖所示：
index.jsp:
PS: WEB-INF是Java的WEB應用的安全目錄。所謂安全就是客戶端無法訪問，只有服務端可以訪問的目錄。如果想在頁面中直接訪問其中的檔案，必須通過web.xml檔案對要訪問的檔案進行相應對映才能訪問。不可直接將圖片放入WEB-INF下。
三、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.jsp頁面和foot.jsp頁面，分別作為jsp頁面的頭部和尾部，存放於WebRoot中，程式碼如下：
專案工程樹：
head.jsp:
<%@ page language="java" import="java.util.*" pageEncoding="UTF-8"%>
<h1 style="color:red;">網頁頭部</h1>
foot.jsp:
<%@ page language="java" import="java.util.*" pageEncoding="UTF-8"%>
<h1 style="color:blue;">網頁尾部</h1>index.jsp:
<%@ page language="java" import="java.util.*" pageEncoding="UTF-8"%>
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<title>jsp的Include指令測試</title>
</head>
<body>
<%--使用include標籤引入引入其它JSP頁面--%>
<%@include file="/head.jsp" %>
<h1>網頁主體內容</h1>
<%@include file="/foot.jsp" %>
</body>
</html>執行結果：
我們檢視一下jsp引擎將index.jsp翻譯成index_jsp類之後的原始碼，找到Tomcat伺服器的MyWorkspaces\.metadata\.me_tcat7\work\Catalina\localhost\ServletStudy0809\org\apache\jsp目錄下找到index_jsp.java，如下圖所示：
package org.apache.jsp;
import javax.servlet.*;
import javax.servlet.http.*;
import javax.servlet.jsp.*;
import java.util.*;
import java.util.*;
import java.util.*;
public final class index_jsp extends org.apache.jasper.runtime.HttpJspBase
implements org.apache.jasper.runtime.JspSourceDependent {
private static final javax.servlet.jsp.JspFactory _jspxFactory =
javax.servlet.jsp.JspFactory.getDefaultFactory();
private static java.util.Map<java.lang.String,java.lang.Long> _jspx_dependants;
static {
_jspx_dependants = new java.util.HashMap<java.lang.String,java.lang.Long>(2);
_jspx_dependants.put("/foot.jsp", Long.valueOf(1535680777587L));
_jspx_dependants.put("/head.jsp", Long.valueOf(1535680780039L));
}
private javax.el.ExpressionFactory _el_expressionfactory;
private org.apache.tomcat.InstanceManager _jsp_instancemanager;
public java.util.Map<java.lang.String,java.lang.Long> getDependants() {
return _jspx_dependants;
}
public void _jspInit() {
_el_expressionfactory = _jspxFactory.getJspApplicationContext(getServletConfig().getServletContext()).getExpressionFactory();
_jsp_instancemanager = org.apache.jasper.runtime.InstanceManagerFactory.getInstanceManager(getServletConfig());
}
public void _jspDestroy() {
}
public void _jspService(final javax.servlet.http.HttpServletRequest request, final javax.servlet.http.HttpServletResponse response)
throws java.io.IOException, javax.servlet.ServletException {
final javax.servlet.jsp.PageContext pageContext;
javax.servlet.http.HttpSession session = null;
final javax.servlet.ServletContext application;
final javax.servlet.ServletConfig config;
javax.servlet.jsp.JspWriter out = null;
final java.lang.Object page = this;
javax.servlet.jsp.JspWriter _jspx_out = null;
javax.servlet.jsp.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>jsp的Include指令測試</title>\r\n");
out.write(" </head>\r\n");
out.write(" \r\n");
out.write(" <body>\r\n");
out.write(" ");
out.write("\r\n");
out.write(" ");
out.write("\r\n");
out.write("<h1 style=\"color:red;\">網頁頭部</h1>\r\n");
out.write("\r\n");
out.write(" <h1>網頁主體內容</h1>\r\n");
out.write(" ");
out.write("\r\n");
out.write("<h1 style=\"color:blue;\">網頁尾部</h1>");
out.write("\r\n");
out.write(" </body>\r\n");
out.write("</html>");
} catch (java.lang.Throwable t) {
if (!(t instanceof javax.servlet.jsp.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 throw new ServletException(t);
}
} finally {
_jspxFactory.releasePageContext(_jspx_page_context);
}
}
}
3.2、總結@include指令
使用@include可以包含任意的內容，檔案的字尾是什麼都無所謂。這種把別的檔案內容包含到自身頁面的@include語句就叫作靜態包含，作用只是把別的頁面內容包含進來，屬於靜態包含。
3.3、jsp:include指令
jsp:include指令為動態包含，如果被包含的頁面是JSP，則先處理之後再將結果包含，而如果包含的是非*.jsp檔案，則只是把檔案內容靜態包含進來，功能與@include類似。後面再具體介紹