1. 程式人生 > >深入分析JavaWeb Item13 -- jsp指令具體解釋

深入分析JavaWeb Item13 -- jsp指令具體解釋

性能 異常信息 content ... pin 簡單 markdown 分隔 一個

一、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>子元素指定以“/”開頭的錯誤處理頁面的路徑,比如:<location>/ErrorPage/404Error.jsp</location>

<error-page>
    <exception-type>com.sun.jersey.api.container.ContainerException:</exception-type>
    <location>/errorr.jsp</location>
  </error-page>
    <error-page>
    <error-code>404</error-code>
    <location>/notFound.jsp</location>
  </error-page>

假設設置了某個JSP頁面的errorPage屬性,那麽在web.xml文件裏設置的錯誤處理將不正確該頁面起作用。

2.3、使用errorPage屬性指明出錯後跳轉的錯誤頁面

比方Test.jsp頁面有例如以下的代碼:

<%@ page language="java" import="java.util.*" errorPage="/ErrorPage/error.jsp" pageEncoding="UTF-8"%>
<html>
  <head>
    <title>測試page指令的errorPage屬性</title>
  </head>
  <body>
    <%
      //這行代碼肯定會出錯,由於除數是0,一執行就會拋出異常
        int x = 1/0;
    %>
  </body>
</html>

  在Test.jsp中,page指令的errorPage屬性指明了出錯後跳轉到"/ErrorPage/error.jsp“。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應用設置錯誤處理頁面

比如:使用<error-page>標簽配置針對404錯誤的處理頁面

web.xml的代碼下:

<?

xml version="1.0" encoding="UTF-8"?

> <web-app version="3.0" xmlns="http://java.sun.com/xml/ns/javaee" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_3_0.xsd"> <display-name></display-name> <welcome-file-list> <welcome-file>index.jsp</welcome-file> </welcome-file-list> <!-- 針對404錯誤的處理頁面 --> <error-page> <error-code>404</error-code> <location>/ErrorPage/404Error.jsp</location> </error-page> </web-app>

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>
    <img alt="對不起。你要訪問的頁面沒有找到,請聯系管理員處理!" 
    src="${pageContext.request.contextPath}/img/404Error.png"/><br/>
    3秒鐘後自己主動跳轉回首頁,假設沒有跳轉,請點擊<a href="${pageContext.request.contextPath}/index.jsp">這裏</a>
  </body>
</html>

當訪問一個不存在的web資源時。就會跳轉到在web.xml中配置的404錯誤處理頁面404Error.jsp。例如以下圖所看到的:

  技術分享

2.5、關於在web.xml中使用<error-page>標簽為整個web應用設置錯誤處理頁面在IE下無法跳轉的解決的方法

  這裏須要註意的是,假設錯誤頁面比較小,那麽當訪問server上不存在的web資源或者訪問server出錯時在IE瀏覽器下是無法跳轉到錯誤頁面的,顯示的是ie自己的錯誤頁面,而在火狐和google瀏覽器下(其他瀏覽器沒有測試過)是不存在註意的問題的。

我們能夠通過以下的實驗來證明

  在web.xml中配置500錯誤時的錯誤友好提示頁面

 <!-- 針對500錯誤的處理頁面 -->
 <error-page>
       <error-code>500</error-code>
      <location>/ErrorPage/500Error.jsp</location>
</error-page>

500Error.jsp頁面的代碼例如以下:

<%@ page language="java" import="java.util.*" pageEncoding="UTF-8"%>
<html>
  <head>
    <title>500(server錯誤)錯誤友好提示頁面</title>
    <!-- 3秒鐘後自己主動跳轉回首頁 -->
    <meta http-equiv="refresh" content="3;url=${pageContext.request.contextPath}/index.jsp">
  </head>
  <body>
    <img alt="對不起,server出錯!" 
    src="${pageContext.request.contextPath}/img/500Error.png"/><br/>
    3秒鐘後自己主動跳轉回首頁,假設沒有跳轉。請點擊<a href="${pageContext.request.contextPath}/index.jsp">這裏</a>
  </body>
</html>

500Error.jsp頁面的字節大小

技術分享

在IE8瀏覽器下的執行結果:

技術分享

  在IE下訪問Test.jsp出現500錯誤後,顯示的是ie自己的錯誤頁面,而不是我們定制的那個500錯誤頁面,而在google和火狐下卻是能夠正常跳轉到我們自己定制的那個500錯誤頁面的。例如以下圖所看到的:

技術分享
技術分享

非常多人遇到這個問題,而解決問題的辦法有兩種:

1、改動IE瀏覽器的設置(不推薦)

  操作步驟:在IE【工具】->【Internet選項】->【高級】中勾掉【顯示友好http錯誤提示】

  技術分享

  經過這種設置之後,訪問server出錯後就能夠直接跳轉到我們定制的500錯誤頁面了。例如以下圖所看到的:

  技術分享

  這種做法須要改動client瀏覽器的配置,不推薦這種方式。

2.不改動IE瀏覽器的設置下確保定制的錯誤頁面的大小>1024字節

  改動500Error.jsp,多加入一些內容,讓頁面的字節數大一些,改動後的500Error.jsp的代碼例如以下:

<%@ page language="java" import="java.util.*" pageEncoding="UTF-8"%>
<html>
  <head>
    <title>500(server錯誤)錯誤友好提示頁面</title>
    <!-- 3秒鐘後自己主動跳轉回首頁 -->
    <meta http-equiv="refresh" content="3;url=${pageContext.request.contextPath}/index.jsp">
  </head>
  <body>
    <img alt="對不起,server出錯了,請聯系管理員解決!" 
    src="${pageContext.request.contextPath}/img/500Error.png"/><br/>
    3秒鐘後自己主動跳轉回首頁,假設沒有跳轉,請點擊<a href="${pageContext.request.contextPath}/index.jsp">這裏</a>
  </body>
</html>

  也就多加了幾個中文,讓500Error.jsp多了幾個字節。500Error.jsp如今的字節數例如以下:

  技術分享

  在IE下訪問。當server出錯時,就能夠正常跳轉到500Error.jsp這個定制的錯誤頁面了,例如以下圖所看到的:

  技術分享

  經過測試。當定制的錯誤頁面的size=617bytes時,在IE8下已經能夠跳轉到定制的錯誤頁面了。其他版本號的IE瀏覽器沒有經過測試。只是為了保險起見。定制的錯誤頁面的size最好超過1024bytes。

2.6、使用page指令的的isErrorPage屬性顯式聲明頁面為錯誤頁面

  假設某一個jsp頁面是作為系統的錯誤處理頁面,那麽建議將page指令的isErrorPage屬性(默覺得false)設置為”true”來顯式聲明這個Jsp頁面是一個錯誤處理頁面。

比如:將error.jsp頁面顯式聲明為錯誤處理頁面

<%@ page language="java" import="java.util.*" pageEncoding="UTF-8" isErrorPage="true"%>
<html>
  <head>
    <title>錯誤信息友好提示頁面</title>
  </head>

  <body>
           對不起。出錯了,請聯系管理員解決。
  </body>
</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指令 –靜態包括。編譯時包括,全部文件編譯成一個Servlet;
  • <jsp:include>指令–動態包括,執行時包括。每一個文件單獨編譯成一個.class文件。

[email protected]

  @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代碼:

 <%@ page language="java" import="java.util.*" pageEncoding="UTF-8"%>
 <h1 style="color:red;">網頁頭部</h1>

foot.jspf代碼:

 <%@ page language="java" import="java.util.*" pageEncoding="UTF-8"%>
<h1 style="color:blue;">網頁尾部</h1>

  在WebRoot文件夾下創建一個IncludeTagTest.jsp頁面,在IncludeTagTest.jsp頁面中使用@include指令引入head.jspf頁面和foot.jspf頁面,代碼例如以下:

<%@ 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頁面--%>
    <[email protected] file="/jspfragments/head.jspf" %>
    <h1>網頁主體內容</h1>
    <[email protected] file="/jspfragments/foot.jspf" %>
  </body>
</html>

執行結果例如以下:

  技術分享

  我們查看一下jsp引擎將IncludeTagTest.jsp翻譯成IncludeTagTest_jsp類之後的源碼,找到Tomcatserver的work\Catalina\localhost\JavaWeb_Jsp_Study_20140603\org\apache\jsp文件夾下找到IncludeTagTest_jsp.java,例如以下圖所看到的:

  技術分享

打開IncludeTagTest_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 IncludeTagTest_jsp extends org.apache.jasper.runtime.HttpJspBase
    implements org.apache.jasper.runtime.JspSourceDependent {

  private static final JspFactory _jspxFactory = JspFactory.getDefaultFactory();

  private static java.util.List _jspx_dependants;

  static {
    _jspx_dependants = new java.util.ArrayList(2);
    _jspx_dependants.add("/jspfragments/head.jspf");
    _jspx_dependants.add("/jspfragments/foot.jspf");
  }

  private javax.el.ExpressionFactory _el_expressionfactory;
  private org.apache.AnnotationProcessor _jsp_annotationprocessor;

  public Object getDependants() {
    return _jspx_dependants;
  }

  public void _jspInit() {
    _el_expressionfactory = _jspxFactory.getJspApplicationContext(getServletConfig().getServletContext()).getExpressionFactory();
    _jsp_annotationprocessor = (org.apache.AnnotationProcessor) getServletConfig().getServletContext().getAttribute(org.apache.AnnotationProcessor.class.getName());
  }

  public void _jspDestroy() {
  }

  public void _jspService(HttpServletRequest request, HttpServletResponse response)
        throws java.io.IOException, ServletException {

    PageContext pageContext = null;
    HttpSession session = null;
    ServletContext application = null;
    ServletConfig config = null;
    JspWriter out = null;
    Object page = this;
    JspWriter _jspx_out = null;
    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("  \r\n");
      out.write("    <title>jsp的Include指令測試</title>\r\n");
      out.write("  \r\n");
      out.write("  </head>\r\n");
      out.write("  \r\n");
      out.write("  <body>\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>\r\n");
      out.write("\r\n");
      out.write("  </body>\r\n");
      out.write("</html>\r\n");
    } catch (Throwable t) {
      if (!(t instanceof 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);
      }
    } finally {
      _jspxFactory.releasePageContext(_jspx_page_context);
    }
  }
}

  能夠看到,head.jspffoot.jspf頁面的內容都使用out.write輸出到瀏覽器顯示了。

[email protected]

  使用@include能夠包括隨意的內容,文件的後綴是什麽都無所謂。

這種把別的文件內容包括到自身頁面的@include語句就叫作靜態包括,作用僅僅是把別的頁面內容包括進來,屬於靜態包括。

3.3、<jsp:include>指令

  jsp:include指令為動態包括,假設被包括的頁面是JSP,則先處理之後再將結果包括,而假設包括的是非*.jsp文件,則僅僅是把文件內容靜態包括進來,功能與@include相似。後面再詳細介紹

深入分析JavaWeb Item13 -- jsp指令具體解釋