Java jsp 自定义标签

1 自定义标签

1.1 引入

需求： 向浏览器输出当前客户的IP地址 （只能使用jsp标签）

 

1.2 第一个自定义标签开发步骤

1）编写一个普通的java类，继承SimpleTagSupport类，叫标签处理器类

 

/**  * 标签处理器类  * @author APPle  * 1）继承SimpleTagSupport  *  */ public class ShowIpTag extends SimpleTagSupport{ private JspContext context;   /**  * 传入pageContext  */ @Override public void setJspContext(JspContext pc) { this.context = pc; }   /**  * 2）覆盖doTag方法  */ @Override public void doTag() throws JspException, IOException { //向浏览器输出客户的ip地址 PageContext pageContext = (PageContext)context;   HttpServletRequest request = (HttpServletRequest)pageContext.getRequest();   String ip = request.getRemoteHost();   JspWriter out = pageContext.getOut();   out.write("使用自定义标签输出客户的IP地址："+ip);   } }

 

2）在web项目的WEB-INF目录下建立itcast.tld文件，这个tld叫标签库的声明文件。（参考核心标签库的tld文件）

 

<?xml version="1.0" encoding="UTF-8" ?>   <taglib xmlns="http://java.sun.com/xml/ns/javaee"     xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"     xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-jsptaglibrary_2_1.xsd"     version="2.1">   <!-- 标签库的版本 -->   <tlib-version>1.1</tlib-version>   <!-- 标签库前缀 -->   <short-name>tagshow</short-name>   <!-- tld文件的唯一标记 -->   <uri>tag.com</uri>     <!-- 一个标签的声明 -->   <tag>     <!-- 标签名称 -->     <name>showIp</name>     <!-- 标签处理器类的全名 -->     <tag-class>tag.com.ShowIpTag</tag-class>     <!-- 输出标签体内容格式 -->     <body-content>scriptless</body-content>   </tag>   </taglib>

 

3） 在jsp页面的头部导入自定义标签库

    <%@taglib uri="tag.com" prefix="tagshow"%>

 

4） 在jsp中使用自定义标签

<tagshow:showIp></tagshow:showIp>

 

1.3 自定义标签的执行过程

问题： http://localhost:8080/day14/01.hellotag.jsp  如何访问到自定义标签？

 

前提： tomcat服务器启动时，加载到每个web应用，加载每个web应用的WEB-INF目录下的所有文件！！！例如。web.xml, tld文件！！！

1）访问01.hellotag.jsp资源

2）tomcat服务器把jsp文件翻译成java源文件->编译class->构造类对象->调用_jspService（）方法

3）检查jsp文件的taglib指令，是否存在一个名为http://gz.itcast.cn的tld文件。如果没有，则报错

4）上一步已经读到itcast.tld文件

5）读到<itcast:showIp> 到itcast.tld文件中查询是否存在<name>为showIp的<tag>标签

6）找到对应的<tag>标签，则读到<tag-class>内容

7）得到 gz.itcast.a_tag.ShowIpTag

 

构造ShowIpTag对象，然后调用ShowIpTag里面的方法

 

1.4 自定义标签处理器类的生命周期

SimpleTag接口：

void setJspContext(JspContext pc)  --设置pageContext对象，传入pageContext（一定调用）

通过getJspCotext()方法得到pageContext对象

void setParent(JspTag parent)  --设置父标签对象，传入父标签对象，如果没有父标签，则不 调用此方法。通过getParent()方法得到父标签对象。

void     setXXX(值)             --设置属性值。

void setJspBody(JspFragment jspBody) --设置标签体内容。标签体内容封装到JspFragment对象 中，然后传入JspFragment对象。通过getJspBody()方法 得到标签体内容。如果没有标签体内容，则不会调 用此方法

void doTag()                     --执行标签时调用的方法。（一定调用）

 

1.5 自定义标签的作用

1）控制标签体内容是否输出

2）控制标签余下内容是否输出

3）控制重复输出标签体内容

4）改变标签体内容

5）带属性的标签

步骤：

5.1 在标签处理器中添加一个成语变量和setter方法

 

//1.声明属性的成员变量 private Integer num;   //2.关键点： 必须提供公开的setter方法，用于给属性赋值 public void setNum(Integer num) { this.num = num; }

 

1.6 输出标签体内容格式

JSP：   在传统标签中使用的。可以写和执行jsp的java代码。

scriptless:  标签体不可以写jsp的java代码

empty:    必须是空标签。

tagdependent : 标签体内容可以写jsp的java代码，但不会执行。