开发大致步骤:
【1】写一个自定义标签处理类。(其实就是编写一个java类实现Tag接口或者继承它的子类,这些接口或者类在javax.servlet.jsp.servlet包中)
提示:
继承TagSupport或者扩展了SimpleTag接口,通过这个类可以实现自定义JSP标签的具体功能。
可以继承SimpleTagSupport类并重写的doTag()方法来开发一个最简单的自定义标签。
package com.cjh.tag;
import java.io.IOException;
import javax.servlet.ServletRequest;
import javax.servlet.jsp.JspException;
import javax.servlet.jsp.JspWriter;
import javax.servlet.jsp.PageContext;
import javax.servlet.jsp.tagext.Tag;
public class ShowNameTag implements Tag {
// 页面上下文
private PageContext pageContext = null;
// 读取到一个标签结束会调用这个方法
public int doEndTag() throws JspException {
/*
* 这里可以取两种类型的值,EVAL_PAGE和SKIP_PAGE EVAL_PAGE:读取后面剩余的内容
* SKIP_PAGE:跳过,不读去剩余内容
*/
return SKIP_PAGE;
}
// 开始读取到一个标签会调用这个方法
public int doStartTag() throws JspException {
JspWriter out = pageContext.getOut();
try {
out.write("你好");// 打印输出一个你好
} catch (IOException e) {
e.printStackTrace();
}
/*
* 这里可以取两种类型的值,EVAL_BODY_INCLUDE和SKIP_BODY EVAL_BODY_INCLUDE:读取标签体
* SKIP_BODY:跳过,不读去标签体
*/
return SKIP_BODY;
}
public Tag getParent() {
return null;
}
public void release() {
}
// 这个类会先调用这个方法
public void setPageContext(PageContext arg0) {
this.pageContext = arg0;
}
public void setParent(Tag arg0) {
}
}
【2】写一个标签库描述文件(tld文件)。
如果是在 Eclipse ,那么可以在项目右键单击 WEB-INF 目录弹出选项框,依次选:
->New->Other->XML->XML File->next->要取的文件名.tld
->next->Create XML File from an XML schema file
->next->Select XML Catalog entry
选择 http://xmlns.jcp.org/xml/ns/j2ee/web-jsptaglibrary_2_1.xsd 这一项,点击 Finish 即可。
<?xml version="1.0" encoding="UTF-8"?>
<taglib version="2.0" 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-jsptaglibrary_2_0.xsd">
<!-- 当按键 alt+? 时,没有提示的时候,一般是这里的缘故
xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee web-jsptaglibrary_2_0.xsd">
需要改成如下:
xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee http://java.sun.com/xml/ns/j2ee/web-jsptaglibrary_2_0.xsd">
-->
<tlib-version>1.0</tlib-version><!-- 标签库的版本号 -->
<short-name>MyTag</short-name>
<uri>http://www.mytag.com</uri><!-- 访问的uri -->
<tag>
<!-- 以下几元素个是必须要写的,否则会报错 -->
<name>mytag</name><!-- 该自定义标签唯一的名字,在jsp页面中根据这个名字来引用这个标签对象 -->
<tag-class>com.cjh.tag.ShowNameTag</tag-class><!-- 该标签处理类的完整的路径 -->
<body-content>JSP</body-content><!-- 标签体中的内容类型是什么样的,有这几种jsp,empty,scriptless,tagdependent -->
</tag>
</taglib>
说明:
标签库元素用来设定标签库的相关信息,它的常用属性有:
-A、shortname:指定Tag Library默认的前缀名(prefix);
-B、uri:设定Tag Library的唯一访问地址。
标签元素:用来定义一个标签,它的常见属性有:
-A、name:设定Tag的名字;
-B、tagclass:设定Tag的处理类;
-C、bodycontent:设定标签的主体(body)内容。
--(1)empty:表示标签中没有body;
--(2)JSP:表示标签的body中可以加入JSP程序代码;
--(3)tagdependent:表示标签中的内容由标签自己去处理。
标签属性元素:用来定义标签的属性,它的常见属性有:
-A、name:属性名称;
-B、required:属性是否必需的,默认为false;
-C、rtexprvalue:属性值是否可以为表达式,也就是类似于< %= %>的表达式。
【3】在jsp页面中到如标签库,就可以使用自定义标签了。
<%@ taglib uri="/WEB-INF/tags/MyTag.tld" prefix="my" %>
其中 uri:访问路径。
其中 prefix:前缀。
这样我们就可以正常使用了
<body>
这是我自定义的标签:<my:mytag>好</my:mytag> <!--前缀:标签名-->
</body>