J2EE复习(六)JSP自定义标签

数据加载中……

一、JSP自定义标签简介
标签是一种XML元素，通过标签可以使JSP网页变得简洁并且易于维护，还可以方便地实现同一个JSP文件支持多种语言版本。由于标签是XML元素，所以它的名称和属性都是大小写敏感的
标准JSP标签是用来调用JavaBean组件的操作，处理定向请求以简化JSP页面开发与维护。JSP技术提供了一种封装其它动态类型的机制——自定义标签，它扩展了JSP语言。自定义标签通常发布在标签库中，该库定义了一个自定义标签集并包含实现标签的对象。
自定义标签是用户定义的JSP语言元素。当JSP页面包含一个自定义标签时被转化为servlet，标签转化为对称为tag handler的对象的操作。接着当servlet执行时Web container调用那些操作。

二、两种标签
可以定义两种类型的标签：
javax.servlet.jsp.tagext.Tag
javax.servlet.jsp.tagext.BodyTag

有标签体的标签必须实现 BodyTag 接口。

<jsptag:map scope=“session” name=“tagMap”>
body
</jsptag:map>

也可能没有标签体：

<jsptag:map/>

无标签体的简单标签可以实现 Tag 接口。

三、标签处理程序
int doStartTag() throws JspException---处理开始标签
int doEndTag() throws JspException---处理结束标签
Tag getParent()/void setParent(Tag t)---获得/设置标签的父标签
void setPageContext(PageContext pc)--- pageContext 属性的 setter 方法
void release() 释放获得的所有资源

doStartTag()和doEndTag()方法的返回值说明：
SKIP_BODY      表示不用处理标签体，直接调用doEndTag()方法。
SKIP_PAGE      忽略标签后面的jsp(SUN企业级应用的首选)内容。
EVAL_PAGE      处理标签后，继续处理jsp(SUN企业级应用的首选)后面的内容。
EVAL_BODY_BUFFERED 表示需要处理标签体，且需要重新创建一个缓冲(调用setBodyContent方法)。
EVAL_BODY_INCLUDE  表示在现有的输出流对象中处理标签体，但绕过setBodyContent()和doInitBody()方法
EVAL_BODY_AGAIN     对标签体循环处理。(存在于javax.servlet.jsp.tagext.IterationTag接口中)

实现javax.servlet.jsp.tagext.Tag接口
扩展javax.servlet.jsp.tagext.TagSupport类
TagSupport 类定义了 get/setParent() 和 setPageContext()，这与所有标签处理程序几乎相同。
get/setParent() 方法允许标签嵌套。
TagSupport 类还定义了一个可以被子类使用的 pageContext 实例变量（protected PageContext pageContext），这个变量是由 setPageContext() 方法设置的。

在创建自定义标签之前，需要创建一个标签处理程序。标签处理程序是一个执行自定义标签操作的 Java 对象。在使用自定义标签时，要导入一个标签库 —— 即一组标签/标签处理程序对。通过在 Web 部署描述符中声明库导入它，然后用指令 taglib 将它导入 JSP 页。

如果 JSP 容器在转换时遇到了自定义标签，那么它就检查标签库描述符（tag library descriptor）（TLD）文件以查询相应的标签处理程序。TLD 文件对于自定义标签处理程序，就像 Web 部署描述符对于 servlet 一样。

在运行时，JSP 页生成的 servlet 得到对应于这一页面所使用的标签的标签处理程序的一个实例。生成的 servlet 用传递给它的属性初始化标签处理程序。
标签处理程序实现了生存周期方法。生成的 servlet 用这些方法通知标签处理程序应当启动、停止或者重复自定义标签操作。生成的 servlet 调用这些生存周期方法执行标签的功能。

四、TLD 文件
TLD 文件的根元素是 taglib。taglib 描述了一个标签库 —— 即一组标签/标签处理程序对。
因为我们使用的是 JSP 版本 1.2，所以在这个例子中需要 tlib-version 和 short-name 元素。
tlib-version 元素对应于标签库版本。
jsp-version 对应于标签库所依赖的 JSP 技术的版本。
short-name 元素定义了 IDE 和其他开发工具可以使用的标签库的简单名。
taglib 元素包含许多 tag 元素，标签库中每一个标签有一个 tag 元素。
在JSP中导入TLD文件：

<%@ taglib uri="firstTag" prefix="my"%>

五、编写自定义迭代标签和el表达式调用类的静态方法实例

循环标签体类：ForEach.java

import java.util.Collection;
2

import java.util.Iterator;
3

import javax.servlet.jsp.JspException;
5

import javax.servlet.jsp.tagext.BodyContent;
6

import javax.servlet.jsp.tagext.BodyTagSupport;
7

public class ForEach extends BodyTagSupport
9

{
10

private String id;
11

private String collection;
12

private Iterator iter;
13

public void setCollection(String collection)
15

{
16

this.collection = collection;
17

}
18

public void setId(String id)
19

{
20

this.id = id;
21

}
22

//遇到开始标签执行
24

public int doStartTag() throws JspException
25

{
26

Collection coll = (Collection) pageContext.findAttribute(collection);
27

// 表示如果未找到指定集合，则不用处理标签体，直接调用doEndTag()方法。
28

if(coll==null||coll.isEmpty()) return SKIP_BODY;
29

iter = coll.iterator();
31

pageContext.setAttribute(id, iter.next());
32

// 表示在现有的输出流对象中处理标签体，但绕过setBodyContent()和doInitBody()方法
33

// 这里一定要返回EVAL_BODY_INCLUDE，否则标签体的内容不会在网页上输出显示
34

return EVAL_BODY_INCLUDE;
35

}
36

//在doInitBody方法之前执行，在这里被绕过不执行
38

@Override
39

public void setBodyContent(BodyContent arg0)
40

{
41

System.out.println("setBodyContent

");
42

super.setBodyContent(arg0);
43

}
44

//此方法被绕过不会被执行
45

@Override
46

public void doInitBody() throws JspException
47

{
48

System.out.println("doInitBody

");
49

super.doInitBody();
50

}
51

//遇到标签体执行
53

public int doAfterBody() throws JspException
54

{
55

if(iter.hasNext())
56

{
57

pageContext.setAttribute(id, iter.next());
58

return EVAL_BODY_AGAIN;// 如果集合中还有对像，则循环执行标签体
59

}
60

return SKIP_BODY;//迭代完集合后，跳过标签体，调用doEndTag()方法。
61

}
62

//遇到结束标签执行
64

public int doEndTag() throws JspException
65

{
66

System.out.println("doEndTag

");
67

return EVAL_PAGE;
68

}
69

}

获取VO属性类：GetProperty.java

import java.lang.reflect.Method;
2

import javax.servlet.jsp.JspException;
4

import javax.servlet.jsp.tagext.BodyTagSupport;
5

public class GetProperty extends BodyTagSupport
7

{
8

private String name;
10

private String property;
11

public void setName(String name)
13

{
14

this.name = name;
15

}
16

public void setProperty(String property)
18

{
19

this.property = property;
20

}
21

@SuppressWarnings("unchecked")
23

public int doStartTag() throws JspException
24

{
25

try
26

{
27

Object obj = pageContext.findAttribute(name);
28

if (obj == null) return SKIP_BODY;
30

Class c = obj.getClass();
32

//构造GET方法名字 get+属性名(属性名第一个字母大写)
33

String getMethodName = "get" + property.substring(0, 1).toUpperCase()
34

+ property.substring(1, property.length());
35

Method getMethod = c.getMethod(getMethodName, new Class[]{});
36

pageContext.getOut().print(getMethod.invoke(obj));
38

System.out.print(property + ":" + getMethod.invoke(obj) + "\t");
39

} catch (Exception e)
40

{
41

e.printStackTrace();
42

}
43

return SKIP_BODY;
44

}
45

public int doEndTag() throws JspException
47

{
48

return EVAL_PAGE;
49

}
50

}
51

表达式直接访问此类中静态的方法：ELFunction.java
53

public class ELFunction
54

{
55

public static int add( int i,int j )
56

{
57

return i+j;
58

}
59

}

写一个测试用的VO类：UserVo.java

public class UserVo
2

{
3

private String name;
4

private String password;
5

public String getName()
7

{
8

return name;
9

}
10

public void setName(String name)
11

{
12

this.name = name;
13

}
14

public String getPassword()
15

{
16

return password;
17

}
18

public void setPassword(String password)
19

{
20

this.password = password;
21

}
22

}

建好TLD文件tag.tld，放在WEB-INF目录下

<?xml version="1.0" encoding="utf-8"?>
2

<taglib version="2.0"
3

xmlns="http://java.sun.com/xml/ns/j2ee"
4

xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
5

xmlns:shcemalocation="http://java.sun.com/xml/ns/j2ee
6

http://java.sun.com/xml/ns/j2ee/web-app_2_4.xsd">
7

<description>自定义标签</description>
9

<display-name>JSTL core</display-name>
10

<tlib-version>1.1</tlib-version>
11

<short-name>firstLabel</short-name>
12

<uri>http://java.sun.com/jsp/jstl/core</uri>
13

15

<tag>
16

<name>forEach</name>
17

<tag-class>exercise.taglib.ForEach</tag-class>
18

19

<body-content>JSP</body-content>
20

<attribute>
21

<name>id</name>
22

<required>true</required>
23

<rtexprvalue>true</rtexprvalue>
24

</attribute>
25

<attribute>
26

<name>collection</name>
27

<required>true</required>
28

<rtexprvalue>true</rtexprvalue>
29

</attribute>
30

</tag>
31

33

<tag>
34

<name>getProperty</name>
35

<tag-class>exercise.taglib.GetProperty</tag-class>
36

<body-content>empty</body-content>
37

<attribute>
38

<name>name</name>
39

<required>true</required>
40

<rtexprvalue>true</rtexprvalue>
41

</attribute>
42

<attribute>
43

<name>property</name>
44

<required>true</required>
45

<rtexprvalue>true</rtexprvalue>
46

</attribute>
47

</tag>
48

50

<function>
51

<name>add</name>
52

<function-class>exercise.taglib.ELFunction</function-class>
53

<function-signature>int add(int,int)</function-signature>
54

</function>
55

</taglib>

在web.xml文件中配置自定义标签

<jsp-config>
2

<taglib>
3

<taglib-uri>firstTag</taglib-uri>
4

<taglib-location>/WEB-INF/tag.tld</taglib-location>
5

</taglib>
6

</jsp-config>

在jsp文件中使用标签：tag.jsp

<%@ page language="java" import="java.util.*" pageEncoding="utf-8"%>
2

<%@ taglib uri="firstTag" prefix="my"%>
3

<jsp:useBean id="userVo1" class="exercise.vo.UserVo" scope="request">
5

<jsp:setProperty name="userVo1" property="name" value="Hackiller"/>
6

<jsp:setProperty name="userVo1" property="password" value="123"/>
7

</jsp:useBean>
8

<jsp:useBean id="userVo2" class="exercise.vo.UserVo" scope="request">
10

<jsp:setProperty name="userVo2" property="name" value="YangYang"/>
11

<jsp:setProperty name="userVo2" property="password" value="456"/>
12

</jsp:useBean>
13

<%
15

List list = new ArrayList();
16

list.add(userVo1);
17

list.add(userVo2);
18

pageContext.setAttribute("voList",list);
19

%>
20

<html>
22

<head>
23

<title>My JSP 'tag.jsp' starting page</title>
24

</head>
25

<body>
27

<h2 align="center">This is my JSP page:测试taglib.</h2>
28

<hr>
29

<h2>自定义迭代标签：</h2>
31

<table>
32

<tr><td>姓名</td><td>密码</td></tr>
33

<my:forEach collection="voList" id="uservo">
34

<tr>
35

<td><my:getProperty name="uservo" property="name"/></td>
36

<td><my:getProperty name="uservo" property="password"/></td>
37

</tr>
38

</my:forEach>
39

</table>
40

<hr>
41

<h2>表达式调用类的静态方法：</h2>
43

2+5=${my:add(2,5)}
44

</body>
45

</html>

posted on 2009-04-14 12:01 hackiller 阅读(2488) 评论(2) 编辑收藏所属分类: J2EE第一次复习

# re: J2EE复习(六)JSP自定义标签 2009-08-06 16:34 人称K哥

不错好东西

回复更多评论

# re: J2EE复习(六)JSP自定义标签 2012-05-08 09:35 0o明天会更好o0

你好，请问你在标签方法实现类里，这样去定义public static String getXml(String file,String culonm)

在.tld文件里这样去配置的，
<function-signature>String getXml(String,String)</function-signature> name和class文件都没什么

在映射的方法enum里抱这个错，求指导！

Syntax error on token "String", ; expected after this token

回复更多评论

新用户注册刷新评论列表


只有注册用户登录后才能发表评论。




网站导航: 博客园 IT新闻知识库 C++博客博问管理
相关文章: J2EE复习(七)JSTL(JSP标准标签库) J2EE复习(六)JSP自定义标签 J2EE复习(五)JSP基础 J2EE复习(四)servlet J2EE复习(三)JavaScript(下)--实战应用 J2EE复习(三)JavaScript(上)--基础 J2EE复习(一)HTML J2EE复习(二)XML(下)--xml解析 J2EE复习(二)XML(上)

# re: J2EE复习(六)JSP自定义标签 2009-08-06 16:34 人称K哥

# re: J2EE复习(六)JSP自定义标签 2012-05-08 09:35 0o明天会更好o0

JAVADREAM

J2EE复习(六)JSP自定义标签

评论

统计

常用链接

留言簿(2)

随笔分类

随笔档案

搜索

最新评论

阅读排行榜

评论排行榜