JSTL自定义标签

​ 

1. /*
2. *作者：呆萌老师
3. *☑csdn认证讲师
4. *☑51cto高级讲师
5. *☑腾讯课堂认证讲师
6. *☑网易云课堂认证讲师
7. *☑华为开发者学堂认证讲师
8. *☑爱奇艺千人名师计划成员
9. *在这里给大家分享技术、知识和生活
10. *各种干货，记得关注哦！
11. *vx：it_daimeng
12. */

复制代码

　　
1　自定义标签概述
1.1　自定义标签的步骤
其实我们在JSP页面中使用标签就等于调用某个对象的某个方法一样，例如：，这就是在调用对象的方法一样。自定义标签其实就是自定义类一样！

• 定义标签处理类：必须是Tag或SimpleTag的实现类；
  
• 编写标签库描述符文件（TLD）；
  

 
SimpleTag接口是JSP2.0中新给出的接口，用来简化自定义标签，所以现在我们基本上都是使用SimpleTag。
Tag是老的，传统的自定义标签时使用的接口，现在不建议使用它了。
 
1.2　SimpleTag接口介绍
SimpleTag接口内容如下：

• void doTag()：标签执行方法；
  
• JspTag getParent()：获取父标签；
  
• void setParent(JspTag parent)：设置父标签
  
• void setJspContext(JspContext context)：设置PageContext
  
• void setJspBody(JspFragment jspBody)：设置标签体对象；
  

 
请记住，万物皆对象！在JSP页面中的标签也是对象！你可以通过查看JSP的“真身”清楚的知道，所有标签都会变成对象的方法调用。标签对应的类我们称之为“标签处理类”！
标签的生命周期：

• 当容器（Tomcat）第一次执行到某个标签时，会创建标签处理类的实例；
  
• 然后调用setJspContext(JspContext)方法，把当前JSP页面的pageContext对象传递给这个方法；
  
• 如果当前标签有父标签，那么使用父标签的标签处理类对象调用setParent(JspTag)方法；
  
• 如果标签有标签体，那么把标签体转换成JspFragment对象，然后调用setJspBody()方法；
  
• 每次执行标签时，都调用doTag()方法，它是标签处理方法。
  

 
HelloTag.java

1. public class HelloTag implements SimpleTag {
3.     private JspTag parent;
5.     private PageContext pageContext;
7.     private JspFragment jspBody;
9.    
11.     public void doTag() throws JspException, IOException {
13.         pageContext.getOut().print("Hello Tag!!!");
15.     }
17.     public void setParent(JspTag parent) {
19.         this.parent = parent;
21.     }
23.     public JspTag getParent() {
25.         return this.parent;
27.     }
29.     public void setJspContext(JspContext pc) {
31.         this.pageContext = (PageContext) pc;
33.     }
35.     public void setJspBody(JspFragment jspBody) {
37.         this.jspBody = jspBody;
39.     }
41. }

复制代码

　　
1.3　标签库描述文件（TLD）
标签库描述文件是用来描述当前标签库中的标签的！标签库描述文件的扩展名为tld，你可以把它放到WEB-INF下，这样就不会被客户端直接访问到了。
hello.tld

1. <?xml version="1.0" encoding="UTF-8"?>
3. <taglib version="2.0" xmlns="http://java.sun.com/xml/ns/j2ee"
5.     xmlns:xml="http://www.w3.org/XML/1998/namespace"
7.     xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
9.     xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee
11.                         http://java.sun.com/xml/ns/j2ee/web-jsptaglibrary_2_0.xsd ">
15.     <tlib-version>1.0</tlib-version>
17.     <short-name>eduask</short-name>
19.     <uri>http://www.eduask.cn/tags</uri>
21.     <tag>
23.         <name>hello</name>
25.         <tag-class>cn.eduask.tag.HelloTag</tag-class>
27.         <body-content>empty</body-content>
29.     </tag>
31. </taglib>

复制代码

　　
1.4　使用标签
在页面中使用标签分为两步：

• 使用taglib导入标签库；
  
• 使用标签；
  

1. <%@ taglib prefix="eduask" uri="/WEB-INF/hello.tld" %>
3. ......
5. <it:hello/>

复制代码

　　
 
2　自定义标签进阶
2.1　继承SimpleTagSupport
　　继承SimpleTagSuppport要比实现SimpleTag接口方便太多了，现在你只需要重写doTag()方法，其他方法都已经被SimpleTagSuppport完成了。
 

1. public class HelloTag extends SimpleTagSupport {
3.     public void doTag() throws JspException, IOException {
5.         this.getJspContext().getOut().write("<p>Hello SimpleTag!</p>");
7.     }
9. }

复制代码

　　
 
2.2　有标签体的标签
我们先来看看标签体内容的可选值：
元素的可选值有：

• empty：无标签体。
  
• JSP：传统标签支持它，SimpleTag已经不再支持使用JSP。标签体内容可以是任何东西：EL、JSTL、、，以及html；
  
• scriptless：标签体内容不能是Java脚本，但可以是EL、JSTL等。在SimpleTag中，如果需要有标签体，那么就使用该选项；
  
• tagdependent：标签体内容不做运算，由标签处理类自行处理，无论标签体内容是EL、JSP、JSTL，都不会做运算。这个选项几乎没有人会使用！
  

 
自定义有标签体的标签需要：

• 获取标签体对象：JspFragment jspBody = getJspBody();；
  
• 把标签体内容输出到页面：jspBody.invoke(null)；
  
• tld中指定标签内容类型：scriptless。
  

 

public class HelloTag extends SimpleTagSupport {     public void doTag() throws JspException, IOException {         PageContext pc = (PageContext) this.getJspContext();         HttpServletRequest req = (HttpServletRequest) pc.getRequest();         String s = req.getParameter("exec");         if(s != null && s.endsWith("true")) {             JspFragment body = this.getJspBody();             body.invoke(null);         }     } }

hello         cn.eduask.tags.HelloTag         scriptless

哈哈哈~

 
2.3　不执行标签下面的页面内容
　　如果希望在执行了自定义标签后，不再执行JSP页面下面的东西，那么就需要在doTag()方法中使用SkipPageException。

public class SkipTag extends SimpleTagSupport {     public void doTag() throws JspException, IOException {         this.getJspContext().getOut().print("只能看到我！ ");         throw new SkipPageException();     } }

skip         cn.eduask.tags.SkipTag         empty

看不见我！

 
2.4　带有属性的标签
　　一般标签都会带有属性，例如，其中test就是一个boolean类型的属性。完成带有属性的标签需要：

• 在处理类中给出JavaBean属性（提供get/set方法）；
  
• 在TLD中部属相关属性。
  

 

public class IfTag extends SimpleTagSupport {     private boolean test;     public boolean isTest() {         return test;     }     public void setTest(boolean test) {         this.test = test;     }     @Override     public void doTag() throws JspException, IOException {         if(test) {             this.getJspBody().invoke(null);         }     } }

if         cn.eduask.tag.IfTag         scriptless                     test             true             true

xixi haha hehe

 
 
​
免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！