码迷,mamicode.com
首页 > 编程语言 > 详细

JavaWeb学习——标签文件

时间:2018-09-08 16:56:04      阅读:140      评论:0      收藏:0      [点我收藏+]

标签:pen   编译   val   cti   脚本   rom   spl   color   script   

JSP 标签文件(tag file)


 

    前言:在之前我们介绍了自定义标签,通过写无脚本的JSP文件,可以促进分工,页面设计者可以和后台逻辑编码者同时进行工作。但是,编写自定义标签太过冗长琐碎。从JSP2.0开始,通过 tag file 的方式,无须编写标签处理类和标签描述文件,也能够自定义标签。   

一、tag file简介

    tag file 从两个方面简化了自定义标签的开发。首先,tag file 无须提前编译,直到第一次被调用才会编译。除此之外,仅仅使用JSP语法就可以完成标签的扩展定义。

    其次,标签库描述文件也不再需要了。

    JSP容器提供多种方式将 tag file 编译成Java的标签处理类。例如Tomcat将 tag file 翻译成继承于 javax.servlet.jsp.tagext.SimpleTag接口的标签处理类。

    一个 tag file 和JSP页面一样,拥有指令,脚本,EL表达式,动作元素以及自定义的标签。一个tag file以 tag 或者 tagx 为后缀,它们可以包含其他资源文件。一个被其他文件包含的 tag file 应该以 tagf 为后缀。

    tag file 中也有一些隐藏对象,通过脚本或者EL表达式可以访问这些隐藏对象。这些对象与JSP中的隐藏对象相似。

对象             类型                    
request javax.servlet.http.HttpServletRequest             
response javax.servlet.http.HttpServletResponse
out javax.servlet.jsp.JspWriter
session javax.servlet.http.HttpSession
appliction javax.servlet.ServletContext
config javax.servlet.ServletConfig
jspContext javax.servlet.jsp.JspContext

 

二、第一个 tag file

    下面这个例子包含一个 tag 文件和一个使用这个tag文件的JSP页面。这个tag file的名称是firstTag.tag,代码清单如下:

    firstTag.tag

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

    firstTagTest.jsp 页面

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

    效果如下:

技术分享图片

 

三、tag file 指令

    和JSP页面一样,tag file 可以使用指令来指挥JSP容器如何编译这个tag file。

    除了page指令,其他所有的JSP指令都可以用于tag file。在tag file 中,可以使用tag指令代替page指令。 另外,你还可以使用两个新指令:attribute 和 variable。

tag file指令
 指令                    描述                                           
tag 作用与JSP页面中的page指令类似
include 用于将其他资源导入tag file
taglib 用于将自定义标签库导入tag file
attribute 用于将自定义标签库导入tag file
variable 用于将自定义标签库导入tag file

1. tag指令

    tag指令与JSP中的page指令类似。以下是属性表。

属性     描述
display-name 在XML工具中显示的名称。默认值是不包含后缀的tag file
body-content 指定标签body的类型,body-content属性值有empty、tagdependent、scriptless,默认值是scriptless 
dynamic-attributes   指定tag file动态属性的名称。当dynamiattributes值被设定时,会产生一个Map来存放这些动态属性的名称和对应的值 
small-icon 指定一个图片路径,用于在XML上显示小图标
large-icon 指定一个图片路径,用于在XML上显示大图标
description 标签的描述信息
example 标签使用实例的描述
language tag file 中使用的脚本你语言类型。必须设为“java”
import  用于导入一个java类型,和JSP页面中的import相同
pageEncoding 指定tag file使用的编码格式

    除了import属性,其他所有的属性在一个tag指定或一个tag file 中都只能出现一次。

2. include指令

    tag file 中的include指令和JSP页面中的include是一样的。

3. taglib指令

    可以通过taglib指令在tag lib中使用自定义标签。taglib指令的语法如下:

<%@ taglib uri="taglibraryURI" prefix="tagPrefix" %>

4. attribute指令

    attribute 用于设定tag file中的标签的属性。它与标签库描述文件中的attribute元素等效。

    attributr 指令的的属性如下,其中只有name属性是必须的。

属性     描述
name 用于设定该属性的名称。在一个tag file中,每个属性的名称是唯一的   
required 用于设定该属性是否是必须的。值可以取TRUE和FALSE 
fragment 用于设定该属性是否是fragment。
rtexprvalue    用于设定该属性的值是否在运行时被动态计算
type 用于设定该属性的类型
description 用于设定该属性的描述信息

5. variable指令

    通过variable 可以将tag file 中的一些值传递到JSP页面。variable指令的语法如下:

<% variable (attribute="value")* %>

    variable 指令的属性参见下表:

属性     描述
name-given 变量名。
name-from-attribute   和name-given属性类似,由标签属性的值来决定变量的名称。如果两者属性同时出现或都不出现会出现错误  
alias 设定一个用来接收变量值的局部范围
variable-class 变量的类型
declare 设定该变量是否声明
scope 用于指定该变量的范围
description 用于描述该变量

    与JspWriter对比:JspWriter只能简单地将一个String传递到JSP页面,灵活性很差。

 

四、doBody

    doBody动作元素只能在tag file中使用,它用来调用一个标签的本体内容。

    doBody动作元素也可以有属性。你可以通过这些属性来指定某个变量来接收主题内容,如果不适用这些指令,那么doBody动作会把主体内容写到JSP页面的JspWriter上。

    doBody动作元素的属性如下表:

属性     描述     
var 用于保存标签主体内容的变量值,主体内容就会以String的类型保存这个变量内。var和varReader只能出现一个  
varReader 用于保存标签主体内容的变量值,主体内容就会以Reader的类型保存在这个变量内
scope 变量保存的作用域

 

五、invoke

    invoke动作元素和doBody类似,在tag file中,可以使用它来调用一个fragment。invoke动作元素的属性:

属性     描述       
fragment 要调用的fragment名称     
var 用于保存片段主体内容的变量值,主题内容就会以String类型保存在这个变量中,var和varReader属性只能出现一个  
varReader 用于保存片段主体内容的变量值,主题内容就会以Reader类型保存在这个变量中,var和varReader属性只能出现一个
scope 变量保存到的作用域

 

 

------   天若有情天亦老,人间正道是沧桑   ------

JavaWeb学习——标签文件

标签:pen   编译   val   cti   脚本   rom   spl   color   script   

原文地址:https://www.cnblogs.com/cardiolith/p/9593860.html

(0)
(0)
   
举报
评论 一句话评论(0
登录后才能评论!
© 2014 mamicode.com 版权所有  联系我们:gaon5@hotmail.com
迷上了代码!