学习编写标记文件(tagfile).docVIP

学习编写标记文件(tag):自定义标记的用途就是给程序员可以自定一些特定功能的标记, 以及封装代码, 达到分工重用性等多种好处.JSP规范2.0中新增了标记文件(tag file)的使用, 免除以前自定义标记必须为一个Java类, 以及必须加上一个标记描述文件(tld)的编码难度.以下我们来看标签文件的使用.存放:一个标记文件以tag为後缀名, 以同一类型的检签放到同一个文件夹中组成一个标记库, 再放到/WEB-INF/tags/中保存.例如接下来我打算建立一组有关数学的标记库, 我在/WEB-INF/tags/下建立一个maths文件夹, 然後就可以在/WEB-INF/tags/maths/下建立後缀名为tag的标记文件了.现在我想先做一个数字相加的标记, 起名为add.tag, 放到maths标记库下.语法:标记文件其实就是一个jsp文件, 所以语法基本上跟jsp是一样的, 在第一行加上以下这个元素来告诉服务器它是一个标记文件:%@ tag % 我们还要加上一些属性来告诉服务器这个标记文件的设定:1) body-content - 设定这个标记的主体内容类型:A. empty 这个是一个空标记.B. scriptless 主体可以有内容, 而jsp容器会去处理里面的jsp元素, 换句话就是可以是文本, EL表达式, 标准动作甚至另一个自定义标记.C. tagdependent主体可以有内容, 而jsp容器会把它们当作纯文件处理 .2) pageEncoding - 设定这个标记的编码我们的add标记是个空标记, 而编码是UTF-8, 所以加上这样的一句:%@ tag body-content=empty pageEncoding=UTF-8 % 标记中使用以下这个元素来声明属性:%@ attribute % attribute元素也有几个属性:1) name - 这个attribute的名称.2) required - true/false, 是否必须的.3) rtexprvalue - true/false, 这个attribute可否使用EL表达式, 否则为纯文本.4) type - 设定这个attribute的类型, jsp容器会把结果自动转换成这个类.我们的add.tag有两个属性, 分别代表两个要相加的数字, x跟y, 它们都是必须的, 可以用EL表达式:%@ attribute name=x required=true rtexprvalue=true % %@ attribute name=y required=true rtexprvalue=true % 那这个标记都设定好了, 那我们应该怎样读取这些传入的属性呢? 其实很简单, 标记文件就是一个jsp文件, 这些输入的属性值都存放在作用域中, 所以利用EL表达式就可以了:${x + y} 这个标记文件就完成了, 以下为完整代码, 你也可以直接打开/WEB-INF/tags/maths/add.tag:%-- maths标记库add标记功能: 把传入参数相加参数:x, 数字1, 必须y, 数字2, 必须--% %@ tag body-content=empty pageEncoding=UTF-8 % %-- 声明属性 --%%@ attribute name=x required=true rtexprvalue=true % %@ attribute name=y required=true rtexprvalue=true % %-- 内容 --%${x + y} 标记文件完成了, 那我们要怎样在jsp文件中调用它呢? 首先我们导入maths标记库, 跟调用标准动作一样使用taglib指令, 但是把url属性换成tagdir, 指定我们自定义标记库的位置, 并给它一个前缀名, 以下我们用maths:%@ taglib tagdir=/WEB-INF/tags/maths/ prefix=maths % 然後我们就可以调用标准动作一样去使用它啦, 当然必须的属性一定要有, 不然会报错:maths:add x=10 y=10/ 以下为调用add标记的jsp页的完整代码, 同样的你可以直接打开/add.jsp:%-- maths标记库add标记的演试 --%%@ page contentType=text/html; charset=UTF-8 language=java % %-- 调用自定义标记库maths --%%@ taglib tagdir=/WEB-INF/tags/maths prefix=maths % html head titleMaths标记库add标记演试/title/head body 结果:br/%-- 使用add标记