自定义标签的最大的特点:
利用 自定义标签,软件开发人员和页面设计人员可以独立地自由工作.页面设计人员可以把精力集中在使用标签(HTML,XML或者JSP)创建网站上,而软件开 发人员则可以将精力集中在实现底层功能上面,若国际化等等,这样,页面设计人员可以使用自定义标签的形式来实现具体的功能.
下面我们来指定一个简单的标签,步骤如下
- 扩张TagSupport
- 写自定义Tag的tld文件
- web.xml中指定你的tld文件
- 在JSP页面使用自定义标签
说明:
一般不会去实现Tag接口,而是通过TagSupport类是实现了Tag的接口继承过来的字段,这些字段用做public int doStartTag(),public int doEndTag()返回值
Tag.EVAL_BODY_INCLUDE 包含主体内容
Tag.SKIP_BODY 不包含主体内容
Tag.EVAL_PAGE 包含后面的页面内容
Tag.SKIP_PAGE 不包含主体的内容
实现一个简单实现代码:
java 代码
- package com.mercyblitz;
- import java.io.IOException;
- import javax.servlet.jsp.JspException;
- import javax.servlet.jsp.JspWriter;
- import javax.servlet.jsp.tagext.TagSupport;
-
- public class MyTags extends TagSupport {
- public int doStartTag()throws JspException
- {
- JspWriter out=pageContext.getOut();
- try
- {
- out.println("Hello,World"); //页面中显示的内容
- }catch(IOException e)
- {
- throw new JspException(e);
- }
- return SKIP_BODY; //不包含主体内容
- }
- }
xml 代码
- <?xml version="1.0" encoding="UTF-8"?>
- <!DOCTYPE taglib PUBLIC "-//Sun Microsystems, Inc.//DTD JSP Tag Library 1.2//EN" "web-jsptaglibrary_1_2.dtd" >
- <taglib>
- <tlibversion>tlibversion</tlibversion> <!-- 你自定义标签的版本数 -->
- <jsp-version>1.2</jsp-version> <!-- 指定你的JSP版本,扩张标签是在JSP1.2之后兼容的 --?>
- <shortname>shortname</shortname> <!-- 标签的简写 -->
- <tag>
- <name>tags</name> <!-- 标签名字 -->
- <tagclass>com.mercyblitz.mytags</tagclass> <!-- 指定你的标签的类 -->
- </tag>
- </taglib>
标签库元素<taglib>属性:表格如下
属性表格 属性 | 描述 |
tlib-version | 本标签库实现版本 |
jsp-version | 标签库依赖的JSP版本 |
short-name | 被JSP创作工具使用的一个短的默认名词 |
uri | 指定这个标签库的uri信息 |
display-name | 被工具使用的显示用的名字 |
small-icon | 被工具使用的小图标 |
large-icon | 被工具使用的大图标 |
description | 本标签的描述 |
validator | TLD验证信息 |
listener | 实践监听器规范 |
tag标签相关属性:
tag标签相关属性表 属性 | 描述 |
name | tag标签唯一的名称 |
tag-class | tag标签的处理类 |
tei-class | tag标签的TagExtraInfo类 |
body-content | 标签主体的内容 |
display-name | 显示的名称 |
small-icon | 被工具使用的小图标 |
large-icon | 被工具使用的大图标 |
description | 本标签的描述 |
variable | 脚本变量的信息 |
attribute | 标签属性的信息 |
这些呢,是为以后高级内容说要提到的!
- web.xml中指定你的tld文件
xml 代码
- <?xml version="1.0" encoding="UTF-8"?>
- <web-app version="2.4"
- xmlns="http://java.sun.com/xml/ns/j2ee"
- xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
- xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee
- http://java.sun.com/xml/ns/j2ee/web-app_2_4.xsd">
- <welcome-file-list>
- <welcome-file>/WEB-INF/mytag.jsp</welcome-file> <!-- 设置欢迎页面 -->
- </welcome-file-list>
- <jsp-config>
- <taglib>
- <taglib-uri>http://mercyblitz.blog.ccidnet.com/taglibs.tld</taglib-uri> <!-- 设置自定义标签的uri(不一定存在,但是一定要唯一),为页面的部署做好准备
- <taglib-location>/WEB-INF/taglibs.tld</taglib-location> <!--定位你的tld文件的相对路径 -->
- </taglib>
- </jsp-config>
- </web-app>
- 页面部署:mytag.jsp
html 代码
- <%@ page language="java" import="java.util.*" pageEncoding="GBK"%>
- <%@ taglib uri="http://mercyblitz.blog.ccidnet.com/taglibs.tld" prefix="out" %>
- <html>
- <head>
- <title>mytag.jsp</title>
- </head>
- <body>
- <out:tags/> <!-- 页面执行的结构,就是: Hello,World -->
- </body>
- </html>