javascript
javaweb学习总结(十六)——JSP指令
一、JSP指令簡(jiǎn)介
JSP指令(directive)是為JSP引擎而設(shè)計(jì)的,它們并不直接產(chǎn)生任何可見輸出,而只是告訴引擎如何處理JSP頁(yè)面中的其余部分。
在JSP 2.0規(guī)范中共定義了三個(gè)指令:
- page指令
- Include指令
- taglib指令
JSP指令的基本語法格式:<%@ 指令 屬性名="值" %>
例如:
如果一個(gè)指令有多個(gè)屬性,這多個(gè)屬性可以寫在一個(gè)指令中,也可以分開寫。
例如:
也可以寫作:
1 <%@ page contentType="text/html;charset=gb2312" import="java.util.Date"%>二、Page指令
page指令用于定義JSP頁(yè)面的各種屬性,無論page指令出現(xiàn)在JSP頁(yè)面中的什么地方,它作用的都是整個(gè)JSP頁(yè)面,為了保持程序的可讀性和遵循良好的編程習(xí)慣,page指令最好是放在整個(gè)JSP頁(yè)面的起始位置。例如:
JSP 2.0規(guī)范中定義的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頁(yè)面中,Jsp引擎會(huì)自動(dòng)導(dǎo)入下面的包
- java.lang.*
- javax.servlet.*
- javax.servlet.jsp.*
- javax.servlet.http.*
可以在一條page指令的import屬性中引入多個(gè)類或包,其中的每個(gè)包或類之間使用逗號(hào)(,)分隔
例如:
1 <%@ page import="java.util.*,java.io.*,java.sql.*"%>上面的語句也可以改寫為使用多條page指令的import屬性來分別引入各個(gè)包或類
例如:
1 <%@ page import="java.util.Date"%> 2 <%@ page import="java.io.*" %> 3 <%@ page import="java.sql.*" %>2.2、page指令的errorPage屬性
- errorPage屬性的設(shè)置值必須使用相對(duì)路徑,如果以“/”開頭,表示相對(duì)于當(dāng)前Web應(yīng)用程序的根目錄(注意不是站點(diǎn)根目錄),否則,表示相對(duì)于當(dāng)前頁(yè)面
- 可以在web.xml文件中使用<error-page>元素為整個(gè)Web應(yīng)用程序設(shè)置錯(cuò)誤處理頁(yè)面。
- <error-page>元素有3個(gè)子元素,<error-code>、<exception-type>、<location>
- <error-code>子元素指定錯(cuò)誤的狀態(tài)碼,例如:<error-code>404</error-code>
- <exception-type>子元素指定異常類的完全限定名,例如:<exception-type>java.lang.ArithmeticException</exception-type>
- <location>子元素指定以“/”開頭的錯(cuò)誤處理頁(yè)面的路徑,例如:<location>/ErrorPage/404Error.jsp</location>
- 如果設(shè)置了某個(gè)JSP頁(yè)面的errorPage屬性,那么在web.xml文件中設(shè)置的錯(cuò)誤處理將不對(duì)該頁(yè)面起作用。
2.3、使用errorPage屬性指明出錯(cuò)后跳轉(zhuǎn)的錯(cuò)誤頁(yè)面
比如Test.jsp頁(yè)面有如下的代碼:
1 <%@ page language="java" import="java.util.*" errorPage="/ErrorPage/error.jsp" pageEncoding="UTF-8"%>2 <html>3 <head>4 <title>測(cè)試page指令的errorPage屬性</title>5 </head>6 <body>7 <%8 //這行代碼肯定會(huì)出錯(cuò),因?yàn)槌龜?shù)是0,一運(yùn)行就會(huì)拋出異常9 int x = 1/0; 10 %> 11 </body> 12 </html>在Test.jsp中,page指令的errorPage屬性指明了出錯(cuò)后跳轉(zhuǎn)到"/ErrorPage/error.jsp",error.jsp頁(yè)面代碼如下:
1 <%@ page language="java" import="java.util.*" pageEncoding="UTF-8"%> 2 <html> 3 <head> 4 <title>錯(cuò)誤信息友好提示頁(yè)面</title> 5 </head> 6 <body> 7 對(duì)不起,出錯(cuò)了,請(qǐng)聯(lián)系管理員解決! 8 </body> 9 </html>運(yùn)行結(jié)果如下:
2.4、在web.xml中使用<error-page>標(biāo)簽為整個(gè)web應(yīng)用設(shè)置錯(cuò)誤處理頁(yè)面
例如:使用<error-page>標(biāo)簽配置針對(duì)404錯(cuò)誤的處理頁(yè)面
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 <!-- 針對(duì)404錯(cuò)誤的處理頁(yè)面 --> 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錯(cuò)誤友好提示頁(yè)面</title>5 <!-- 3秒鐘后自動(dòng)跳轉(zhuǎn)回首頁(yè) -->6 <meta http-equiv="refresh" content="3;url=${pageContext.request.contextPath}/index.jsp">7 </head>8 <body>9 <img alt="對(duì)不起,你要訪問的頁(yè)面沒有找到,請(qǐng)聯(lián)系管理員處理!" 10 src="${pageContext.request.contextPath}/img/404Error.png"/><br/> 11 3秒鐘后自動(dòng)跳轉(zhuǎn)回首頁(yè),如果沒有跳轉(zhuǎn),請(qǐng)點(diǎn)擊<a href="${pageContext.request.contextPath}/index.jsp">這里</a> 12 </body> 13 </html>當(dāng)訪問一個(gè)不存在的web資源時(shí),就會(huì)跳轉(zhuǎn)到在web.xml中配置的404錯(cuò)誤處理頁(yè)面404Error.jsp,如下圖所示:
2.5、關(guān)于在web.xml中使用<error-page>標(biāo)簽為整個(gè)web應(yīng)用設(shè)置錯(cuò)誤處理頁(yè)面在IE下無法跳轉(zhuǎn)的解決辦法
這里需要注意的是,如果錯(cuò)誤頁(yè)面比較小,那么當(dāng)訪問服務(wù)器上不存在的web資源或者訪問服務(wù)器出錯(cuò)時(shí)在IE瀏覽器下是無法跳轉(zhuǎn)到錯(cuò)誤頁(yè)面的,顯示的是ie自己的錯(cuò)誤頁(yè)面,而在火狐和google瀏覽器下(其他瀏覽器沒有測(cè)試過)是不存在注意的問題的。
我們可以通過下面的實(shí)驗(yàn)來證明
在web.xml中配置500錯(cuò)誤時(shí)的錯(cuò)誤友好提示頁(yè)面
1 <!-- 針對(duì)500錯(cuò)誤的處理頁(yè)面 --> 2 <error-page> 3 <error-code>500</error-code> 4 <location>/ErrorPage/500Error.jsp</location> 5 </error-page>500Error.jsp頁(yè)面的代碼如下:
1 <%@ page language="java" import="java.util.*" pageEncoding="UTF-8"%>2 <html>3 <head>4 <title>500(服務(wù)器錯(cuò)誤)錯(cuò)誤友好提示頁(yè)面</title>5 <!-- 3秒鐘后自動(dòng)跳轉(zhuǎn)回首頁(yè) -->6 <meta http-equiv="refresh" content="3;url=${pageContext.request.contextPath}/index.jsp">7 </head>8 <body>9 <img alt="對(duì)不起,服務(wù)器出錯(cuò)!" 10 src="${pageContext.request.contextPath}/img/500Error.png"/><br/> 11 3秒鐘后自動(dòng)跳轉(zhuǎn)回首頁(yè),如果沒有跳轉(zhuǎn),請(qǐng)點(diǎn)擊<a href="${pageContext.request.contextPath}/index.jsp">這里</a> 12 </body> 13 </html>500Error.jsp頁(yè)面的字節(jié)大小
?在IE8瀏覽器下的運(yùn)行結(jié)果:
在IE下訪問Test.jsp出現(xiàn)500錯(cuò)誤后,顯示的是ie自己的錯(cuò)誤頁(yè)面,而不是我們定制的那個(gè)500錯(cuò)誤頁(yè)面,而在google和火狐下卻是可以正常跳轉(zhuǎn)到我們自己定制的那個(gè)500錯(cuò)誤頁(yè)面的,如下圖所示:
很多人遇到這個(gè)問題,而解決這個(gè)問題的辦法有兩種:
1、修改IE瀏覽器的設(shè)置(不推薦)
操作步驟:在IE【工具】->【Internet選項(xiàng)】->【高級(jí)】中勾掉【顯示友好http錯(cuò)誤提示】
經(jīng)過這樣的設(shè)置之后,訪問服務(wù)器出錯(cuò)后就可以直接跳轉(zhuǎn)到我們定制的500錯(cuò)誤頁(yè)面了,如下圖所示:
這種做法需要修改客戶端瀏覽器的配置,不推薦這樣的方式。
2.不修改IE瀏覽器的設(shè)置下確保定制的錯(cuò)誤頁(yè)面的大小>1024字節(jié)
修改500Error.jsp,多添加一些內(nèi)容,讓頁(yè)面的字節(jié)數(shù)大一些,修改后的500Error.jsp的代碼如下:
1 <%@ page language="java" import="java.util.*" pageEncoding="UTF-8"%>2 <html>3 <head>4 <title>500(服務(wù)器錯(cuò)誤)錯(cuò)誤友好提示頁(yè)面</title>5 <!-- 3秒鐘后自動(dòng)跳轉(zhuǎn)回首頁(yè) -->6 <meta http-equiv="refresh" content="3;url=${pageContext.request.contextPath}/index.jsp">7 </head>8 <body>9 <img alt="對(duì)不起,服務(wù)器出錯(cuò)了,請(qǐng)聯(lián)系管理員解決!" 10 src="${pageContext.request.contextPath}/img/500Error.png"/><br/> 11 3秒鐘后自動(dòng)跳轉(zhuǎn)回首頁(yè),如果沒有跳轉(zhuǎn),請(qǐng)點(diǎn)擊<a href="${pageContext.request.contextPath}/index.jsp">這里</a> 12 </body> 13 </html>也就多加了幾個(gè)中文,讓500Error.jsp多了幾個(gè)字節(jié),500Error.jsp現(xiàn)在的字節(jié)數(shù)如下:
在IE下訪問,當(dāng)服務(wù)器出錯(cuò)時(shí),就可以正常跳轉(zhuǎn)到500Error.jsp這個(gè)定制的錯(cuò)誤頁(yè)面了,如下圖所示:
經(jīng)過測(cè)試,當(dāng)定制的錯(cuò)誤頁(yè)面的size=617bytes時(shí),在IE8下已經(jīng)可以跳轉(zhuǎn)到定制的錯(cuò)誤頁(yè)面了,其他版本的IE瀏覽器沒有經(jīng)過測(cè)試,不過為了保險(xiǎn)起見,定制的錯(cuò)誤頁(yè)面的size最好超過1024bytes。
2.6、使用page指令的的isErrorPage屬性顯式聲明頁(yè)面為錯(cuò)誤頁(yè)面
如果某一個(gè)jsp頁(yè)面是作為系統(tǒng)的錯(cuò)誤處理頁(yè)面,那么建議將page指令的isErrorPage屬性(默認(rèn)為false)設(shè)置為"true"來顯式聲明這個(gè)Jsp頁(yè)面是一個(gè)錯(cuò)誤處理頁(yè)面。
例如:將error.jsp頁(yè)面顯式聲明為錯(cuò)誤處理頁(yè)面
1 <%@ page language="java" import="java.util.*" pageEncoding="UTF-8" isErrorPage="true"%>2 <html>3 <head>4 <title>錯(cuò)誤信息友好提示頁(yè)面</title>5 </head>6 7 <body>8 對(duì)不起,出錯(cuò)了,請(qǐng)聯(lián)系管理員解決!9 </body> 10 </html>將error.jsp頁(yè)面顯式聲明為錯(cuò)誤處理頁(yè)面后,有什么好處呢,好處就是Jsp引擎在將jsp頁(yè)面翻譯成Servlet的時(shí)候,在Servlet的 _jspService方法中會(huì)聲明一個(gè)exception對(duì)象,然后將運(yùn)行jsp出錯(cuò)的異常信息存儲(chǔ)到exception對(duì)象中,如下所示:
由于Servlet的_jspService方法中聲明了exception對(duì)象,那么就可以在error.jsp頁(yè)面中使用exception對(duì)象,這樣就可以在Jsp頁(yè)面中拿到出錯(cuò)的異常信息了,如下:
如果沒有設(shè)置isErrorPage="true",那么在jsp頁(yè)面中是無法使用exception對(duì)象的,因?yàn)樵赟ervlet的_jspService方法中不會(huì)聲明一個(gè)exception對(duì)象,如下所示:
Jsp有9大內(nèi)置對(duì)象,而一般情況下exception對(duì)象在Jsp頁(yè)面中是獲取不到的,只有設(shè)置page指令的isErrorPage屬性為"true"來顯式聲明Jsp頁(yè)面是一個(gè)錯(cuò)誤處理頁(yè)面之后才能夠在Jsp頁(yè)面中使用exception對(duì)象。
三、include指令
在JSP中對(duì)于包含有兩種語句形式:
3.1、@include指令
@include可以包含任意的文件,當(dāng)然,只是把文件的內(nèi)容包含進(jìn)來。
include指令用于引入其它JSP頁(yè)面,如果使用include指令引入了其它JSP頁(yè)面,那么JSP引擎將把這兩個(gè)JSP翻譯成一個(gè)servlet。所以include指令引入通常也稱之為靜態(tài)引入。
語法:<%@ include file="relativeURL"%>,其中的file屬性用于指定被引入文件的路徑。路徑以“/”開頭,表示代表當(dāng)前web應(yīng)用。
include指令細(xì)節(jié)注意問題:
?include指令使用范例:
新建head.jspf頁(yè)面和foot.jspf頁(yè)面,分別作為jsp頁(yè)面的頭部和尾部,存放于WebRoot下的jspfragments文件夾中,代碼如下:
head.jspf代碼:
1 <%@ page language="java" import="java.util.*" pageEncoding="UTF-8"%> 2 <h1 style="color:red;">網(wǎng)頁(yè)頭部</h1>foot.jspf代碼:
1 <%@ page language="java" import="java.util.*" pageEncoding="UTF-8"%> 2 <h1 style="color:blue;">網(wǎng)頁(yè)尾部</h1>在WebRoot文件夾下創(chuàng)建一個(gè)IncludeTagTest.jsp頁(yè)面,在IncludeTagTest.jsp頁(yè)面中使用@include指令引入head.jspf頁(yè)面和foot.jspf頁(yè)面,代碼如下:
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指令測(cè)試</title>6 </head>7 8 <body>9 <%--使用include標(biāo)簽引入引入其它JSP頁(yè)面--%> 10 <%@include file="/jspfragments/head.jspf" %> 11 <h1>網(wǎng)頁(yè)主體內(nèi)容</h1> 12 <%@include file="/jspfragments/foot.jspf" %> 13 </body> 14 </html>運(yùn)行結(jié)果如下:
我們查看一下jsp引擎將IncludeTagTest.jsp翻譯成IncludeTagTest_jsp類之后的源代碼,找到Tomcat服務(wù)器的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指令測(cè)試</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;\">網(wǎng)頁(yè)頭部</h1>\r\n"); 75 out.write("\r\n"); 76 out.write(" <h1>網(wǎng)頁(yè)主體內(nèi)容</h1>\r\n"); 77 out.write(" "); 78 out.write("\r\n"); 79 out.write("<h1 style=\"color:blue;\">網(wǎng)頁(yè)尾部</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頁(yè)面的內(nèi)容都使用out.write輸出到瀏覽器顯示了。
3.2、總結(jié)@include指令
使用@include可以包含任意的內(nèi)容,文件的后綴是什么都無所謂。這種把別的文件內(nèi)容包含到自身頁(yè)面的@include語句就叫作靜態(tài)包含,作用只是把別的頁(yè)面內(nèi)容包含進(jìn)來,屬于靜態(tài)包含。
3.3、jsp:include指令
jsp:include指令為動(dòng)態(tài)包含,如果被包含的頁(yè)面是JSP,則先處理之后再將結(jié)果包含,而如果包含的是非*.jsp文件,則只是把文件內(nèi)容靜態(tài)包含進(jìn)來,功能與@include類似。后面再具體介紹
http://www.cnblogs.com/xdp-gacl/p/3778993.html
總結(jié)
以上是生活随笔為你收集整理的javaweb学习总结(十六)——JSP指令的全部?jī)?nèi)容,希望文章能夠幫你解決所遇到的問題。
- 上一篇: 花呗显示更换金融机构
- 下一篇: javaweb学习总结(十八)——JSP