Jsp自定义tag标签

自定义tag标签的好处

程序员可以自定义一些特定功能的标签, 用来达到封装代码, 分工, 重用性等多种好处.

如何存放tag标签

通常在web工程WEB-INF文件夹下创建tags文件夹来存放自定义的tag，如/WEB-INF/tags

tag标签的语法

要知道怎样定义tag标签就需要知道tag标签的基本属性，例如：

<%@ tag body-content="empty" trimDirectiveWhitespaces="true" pageEncoding="UTF-8"%>

通常我们在.tag文件的开头加上以上的代码来告诉jsp容器这是一个tag标记文件。
body-content有以下三种属性：

1. empty：这个是一个空标记.
2. scriptless：标记主体可以有内容, 并且jsp容器会去处理里面的jsp元素, 这些内容可以是文本, EL表达式, 标准动作甚至另一个自定义标记.
3. tagdependent：标记主体可以有内容, 而jsp容器会把它们当作纯文件处理

trimDirectiveWhitespaces=“true”表示删除多余的空行
pageEncoding=”UTF-8” 表示page的编码格式

标记中也可以定义attribute，例如：

<%@ attribute name="x" required="true" rtexprvalue="true" %>
<%@ attribute name="y" required="true" rtexprvalue="true" %>

attribute的属性介绍如下：

1. name ：这个attribute的名称.
2. required : true/false, 是否必须的.
3. rtexprvalue : true/false, 这个attribute可否使用EL表达式, 否则为纯文本.
4. type : 设定这个attribute的类型, jsp容器会把结果自动转换成这个类.

我们看一下index.jsp的代码：

<%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%>
<%@ taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core" %>
<%@ taglib tagdir="/WEB-INF/tags/" prefix="yu" %> 
 
 
 

该index.jsp中引用了add.tag文件，看一下add.tag文件的定义：

<%@ tag body-content="empty" trimDirectiveWhitespaces="true" pageEncoding="UTF-8"%>
<%@ taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core" %>
<%@ attribute name="x" required="true" rtexprvalue="true" %>
<%@ attribute name="y" required="true" rtexprvalue="true" %>

The result of x+y is
 
    result = ${x+y}

运行起来程序我们看看运行结果：

至此，基本上已经理解了tag文件的使用了吧，那我们做进一步的学习。继续编写index.jsp代码，来验证body-content=”scriptless”的tag文件：

1 
2 
3 This tag's body-content is [scriptless], let's have a test, i'm here.

4 contextPath: ${pageContext.request.contextPath}
5 

那我们来看一下scriptless_tag.tag文件的定义：

1 <%@ tag body-content="scriptless" trimDirectiveWhitespaces="true" pageEncoding="UTF-8"%>
2 
my backgroud color is red
3 
4 
my backgroud color is blue

细心的朋友发现这里面多了一个<\jsp:doBody>标签,该标签的作用就是讲index.jsp中该标记文件标记的主体显示在该处，来看一下程序运行结果吧，一目了然：

在index.jsp文件中scriptless_tag标签标记的主体显示在了红色背景和蓝色背景之间，并且将代码${pageContext.request.contextPath}解析成了 /yuTestTag

继续编写index.jsp代码，来验证body-content=”tagindependent”的tag文件：

1 
2 
3 This tag's body-content is [tagindependent], let's have a test, i'm here.
4 contextPath: ${pageContext.request.contextPath}
5 

scriptless_tag.tag文件的定义和scriptless_tag.tag的内容基本一样：

1 <%@ tag body-content="tagdependent" trimDirectiveWhitespaces="true" language="java" pageEncoding="UTF-8"%>
2 
my backgroud color is red
3 
4 
my backgroud color is blue

继续看看运行结果：

代码${pageContext.request.contextPath}没有被解析，只是当做纯文本文件
最后附上index.jsp的完整代码：

 1 <%@ page language="java" contentType="text/html; charset=UTF-8" 
2  pageEncoding="UTF-8"%> 
3 <%@ taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core" %> 
4 <%@ taglib tagdir="/WEB-INF/tags/" prefix="yu" %> 
5  
6  
7  
8  
9 
10 
11 
12 
13 
14 
15 

16 
17 
18 
19 This tag's body-content is [scriptless], let's have a test, i'm here.

20 contextPath: ${pageContext.request.contextPath}
21 
22 
23 

24 
25 
26 
27  This tag's body-content is [tagindependent], let's have a test, i'm here.
28 contextPath: ${pageContext.request.contextPath}
29 
30 
31