⑦JSP2.0的福利（標籤文件）

時間  2019-11-18
標籤 jsp2.0 jsp 標籤 文件 欄目 JSP 简体版
原文   原文鏈接

前言

　　本篇接着上一篇博客:[傳送門]html

　　此次講的是JSP2.0的特性之一，咱們能夠編寫標籤文件，指沒有標籤處理器和標籤類庫描述符的定製動做指令，不編譯，無標籤類描述符。java

　　　　本文結構：服務器

　　　　　　①標籤文件簡介

　　　　　　②第一個嘗試標籤文件

　　　　　　#重點：標籤文件指令

　　　　　　③doBody

　　　　　　④invoke

 

標籤文件簡介

　　tag文件只是以tag爲後綴名的文本文件。除了jsp頁面指令外，其餘JSP元素均可以出如今tag文件中頁面引用格式。一，不須要編譯，只要jsp語法便可，這意味不懂java的人也能夠編寫。二，不準須要面搜標籤庫描述符。less

 　　格式：jsp

　　<%@ taglib prefix="test" tagdir="/WEB-INF/tags" %>

      tagdir：用於指定tag文件目錄，當頁面使用<ui:xxxx>進，會查找該目錄下對應的xxxx.tag文件。工具

      prefix：指定使用時標籤前綴開發工具

 

　　使用：測試

<test:xxxx/>

 　

第一個標籤文件

　　包結構圖和效果圖（將服務器當前時間顯示）:ui

　　 　　             

　　　　感興趣不?往下看吧spa

 

　　firstTag.tag:

<%@ tag import="java.util.Date" import="java.text.DateFormat"%>
<%
    DateFormat dateFormat = DateFormat.getDateInstance(DateFormat.LONG);
    Date now = new Date(System.currentTimeMillis());
    out.println(dateFormat.format(now));
%>

　　firstTagTest.jsp

<%@ taglib prefix="easy" tagdir="/WEB-INF/tags" %>
Today is <easy:firstTag/>

　

#重點：標籤文件指令

　　taglib、include、attribute、variable。

1）

<%@ tag display-name="" body-content="" dynamic-attributes="" small-icon="" large-icon="" description="" example=""language="" import="" pageEncoding="" isELIgnored="">

　

　　#tag 指令如同JSP網頁的page指令，用來設定標籤文件。

　　#display-name表示圖形化開發工具顯示<display-name>所指定 的名稱；

　　#body-content表示可能的值有三種，分別是empty、scriptless、tagdependent、empty。

　　　　empty爲標 籤中沒有主體內容，

　　　　scriptlet爲標籤中的主體內容EL、JSP動做元素，但不能夠爲JSP腳本元素，

　　　　tagdependent表示標籤中的主體內 容交由tag本身去處理，默認值爲scriptless；

　　#dynamic-attributes表示設定標籤文件動態屬性的名稱,當dynamic- attributes設定時,將會產生一個Map類型的集合對象,用來存放屬性的名稱和值；

　　#small_icon表示在圖形化開發工具顯 示<small-icon>所指定的TLD相對路徑的小圖標，大小爲16X16；

　　#large-icon表示在圖形化開發工具顯 示<large-icon>所指定的TLD相對路徑的大圖標，大小爲32X32；

　　#description表示用來講明此標籤文件的相關信 息；

　　#example表示用來增長更多的標籤使用說明，包括標籤應用時的範例；

　　#language、import、pageEncoding、 isELIgnored這些屬性與page指令相對應的屬性相同。

 

2）

<%@ attribute name="" required="" fragment="" rtexprvalue="" type="" description=""%>

 

 

 

　　這 個指令用來設定自定義標籤的屬性。其中name表示屬性的名字；

　　required表示是否爲必要，默認爲false；

　　rtexprvalue表示屬性值是 否能夠爲run-time表達式。如爲true，表示屬性可用動態的方式來指定，如：<mytag:read num="${param.num}"/>，如爲false，則必定要用靜態的方式來指定屬性值；

　　type表示這個屬性的類型，默認值爲 java.lang.String；description用來講明此屬性的相關信息

 

3）

<%@ variable name-given="" name-from-attribute="" alias="" variable-class="" declare="" scope="" desription="">

 

 

 

　　這 個指令用來設定標籤文件的變量。其中name-given表示直接指定變量的名稱；

　　name-from-attribute表示以自定義標籤的某個屬性值 爲變量名稱；

　　alias表示聲明一個局部範圍屬性，用來接收變量的值；variable-class表示變量的類名稱，默認值爲 java.lang.String；

　　declare表示此變量是否聲明默認值爲true；scope表示此變量的範圍，範圍是：AT_BEGIN、 AT_END和NESTED，默認值爲NESTED；description用來講明此變量的相關信息

 

········variable案例引出 doBody

　　　jar結構 和 效果圖

　　　　　　      

 

doBodyDemo.tag

<%@ tag import="java.util.Date" import="java.text.DateFormat"%>
<%@ variable name-given="longDate" %>
<%@ variable name-given="shortDate" %>
<%
    Date now = new Date(System.currentTimeMillis());
    DateFormat longFormat = DateFormat.getDateInstance(DateFormat.LONG);
    DateFormat shortFormat = DateFormat.getDateInstance(DateFormat.SHORT);
    jspContext.setAttribute("longDate", longFormat.format(now));
    jspContext.setAttribute("shortDate", shortFormat.format(now));
%>
<jsp:doBody/>

 

doBodyTest.jsp

<%@ taglib prefix="easy" tagdir="/WEB-INF/tags" %>
<easy:doBodyDemo>
    In Long format: ${longDate}
    <br/>
    In Short format: ${shortDate}
</easy:doBodyDemo>

 

新知識點-doBody-invoke

　　<jsp:doBody>與<jsp:invoke>動做元素，前者是用來處理卷標本體文字，後者則是用來設 定標籤間的Fragment，下面兩個動做元素搭配着attribute與variable兩個指令元素。

　　

　　首先介紹<jsp:doBody>您能夠用它來決定是否顯示本體文字，例如撰寫以下的Tag File：

check.tag

<%@attribute name="password"%>
<% if(password.equals("1234")) { %> 
<jsp:doBody/> 
<% } else { %> 
密碼不正確 
<% } %>

　　必須先說明的是，這邊使用了Scriptlet，這並非一個良好的示範，若能搭配JSTL或自訂標籤庫來完成Tag File的撰寫會是比較好的，這邊純綷是爲了說明方便才使用了Scriptlet。

　　上面這個Tag File會檢查傳入的屬性password是否符合咱們設定的密碼，若是符合就執行<jsp:doBody>，表示顯示卷標之間的本體文字， 不然顯示密碼不正確的訊息，attribute指令元素能夠指定自訂卷標所使用的屬性文字，能夠使用下面的JSP網頁來測試：

 

test.jsp

<%@taglib prefix="caterpillar" tagdir="/WEB-INF/tags/" %> 
<html> 
<body> 
<caterpillar:check password="${ param.pwd }"> 
您的祕密禮物在此！ 
</caterpillar:check> 
</body> 
</html>

　　您能夠發現，Tag File即便是用來看成自訂標籤庫的簡便方式，也是十分的方便，不須要在tld檔中做額外的設定，也能夠獲得相關的功能。

attribute除了指定屬性文字以外，也能夠將屬性看成Fragment傳入，方便在Tag File中做個別的處理，例以下面撰寫一個table.tag：

 

table.tag

<%@attribute name="frag1" fragment="true"%> 
<%@attribute name="frag2" fragment="true"%>
<table border="1"> 
<tr> 
<td><b>frag1</b></td> 
<td><jsp:invoke fragment="frag1"/></td> 
</tr> 
<tr> 
<td><b>frag2</b></td> 
<td><jsp:invoke fragment="frag2"/></td> 
</tr> 
</table>

 

在這個Tag File中，將attribute的屬性設定爲Fragment，而後想取得指定的Fragment的話，就能夠使用<jsp: invoke>動做元素，並指定Fragment的名稱，使用下面這個JSP網頁來測試：

test.jsp

<%@taglib prefix="caterpillar" tagdir="/WEB-INF/tags/" %> 
<html> 
<body> 
<caterpillar:table> 
<jsp:attribute name="frag1"> 
Fragment 1 here 
</jsp:attribute> 
<jsp:attribute name="frag2"> 
Fragment 2 here 
</jsp:attribute> 
</caterpillar:table> 
</body> 
</html>

 

在JSP網頁中，一樣的是使用<jsp:attribute>來講定Fragment的文字內容，執行這個JSP網頁，會傳回如下的內容：

<html> 
<body>
<table border="1"> 
<tr> 
<td><b>frag1</b></td> 
<td>Fragment 1 here</td> 
</tr> 
<tr> 
<td><b>frag2</b></td> 
<td>Fragment 2 here</td> 
</tr> 
</table> 
</body> 
</html>

 

在Tag File與JSP網頁之間，能夠使用variable指令元素設定Scripting Variable，以在二者之間傳遞變量內容，例如撰寫如下的Tag File：

precode.tag

<%@attribute name="preserve" fragment="true" %> 
<%@variable name-given="code" scope="NESTED" %>
<jsp:doBody var="code" />
<table border="1"> 
<tr> 
<td> 
<pre><jsp:invoke fragment="preserve"/></pre> 
</td> 
</tr> 
</table>

 

在這個Tag File中，使用variable設定Scripting Variable爲"code"，做用範圍爲"NESTED"，也就是在起始卷標與結束卷標之間，而其中<jsp:doBody>中多了一項 屬性var，表示在JSP網頁中的<jsp:body>卷標中的文字內容將設定給"code"變量，能夠用下面這個JSP網頁來測試：

test.jsp

<%@ taglib prefix="caterpillar" tagdir="/WEB-INF/tags" %> 
<html> 
<body> 
<caterpillar:precode> 
<jsp:attribute name="preserve"> 
<b>${ code }</b> 
</jsp:attribute>
<jsp:body> 
PROGRAM MAIN 
PRINT 'HELLO' 
END 
</jsp:body> 
</caterpillar:precode> 
</body> 
</html>

 

<jsp:body>之間的虛擬程序代碼將會傳入給"code"變量，因爲它是Scripting Variable，能夠在標籤以內起做用，因此在<jsp:attribute>中的EL式${code}能夠取得Tag File中"code"的內容，也就是<jsp:body>傳入的文字，以後咱們將<jsp:attribute>的內容看成 Fragment在Tag File中做處理，結果將會如如下的網頁：

<html> 
<body> 
<table border="1"> 
<tr> 
<td> 
<pre><b> 
PROGRAM MAIN 
PRINT 'HELLO' 
END 
</b></pre> 
</td> 
</tr> 
</table> 
</body> 
</html>

 

總結

　　　　

　　　寄讀者，寄知識來源

　　　讀者，你好！你我不相識，謝謝大家支持。個人夢想會愈來愈接近。keep on，共勉！

　　　知識來源　http://book.douban.com/doulist/3575997/

相關文章
相關標籤/搜索
每日一句
    每一个你不满意的现在，都有一个你没有努力的曾经。
本站公眾號
   歡迎關注本站公眾號,獲取更多信息
聯繫我們 最近搜索 最新文章 沪ICP备13005482号-10 MyBatis教程 SQL 教程 MySQL教程 Java 教程 Thymeleaf 教程 Hibernate教程 Spring教程 Redis教程