1自定义JSP标签概述
自定义JSP标签就是程序员定义的一种JSP标签,这种标签把那些信息显示逻辑封装在一个单独的Java类中,通过一个XML文件来描述它的使用。当页面中需要使用类似的显示逻辑时,就可以在页面中插入这个标签,从而完成相应的功能。
使用自定义标签,可以分离程序逻辑和表示逻辑,将Java代码从HTML中剥离,便于美工维护页面;自定义标签也提供了可重用的功能组件,能够提高工程的开发效率。
自定义标签主要用于移除Jsp页面中的java代码。
2自定义JSP标签的执行过程
当一个含有自定义标签的JSP页面被JSP引擎(Web容器)转译成Servlet时,JSP引擎遇到自定义的标签,会把这个自定义标签转化成对一个称为“标签处理类”的调用。之后,当这个JSP页面被执行时,JSP引擎就会调用这个“标签处理类”对象,并执行其内部定义的相应操作方法,从而完成相应的功能。
3自定义JSP标签的开发流程
使用Java处理类来开发自定义JSP标签时,主要分为下几个步骤。
a)创建标签的处理类(Tag Handle Class)。这个类实现Tag接口,用来定义标签的行为,并在JSP引擎遇到自定义标签时调用执行。
b)创建标签库描述(tld)文件(Tag Library Descriptor File),在tld文件中对标签处理器类进行描述。
c)在JSP文件中用taglib指令引入标签库,然后使用标签库描述文件中指定的标签名来使用它。
4 自定义标签功能扩展
• 开发人员在编写Jsp页面时,经常还需要在页面中引入一些逻辑,例如:
– 控制jsp页面某一部分内容是否执行。
– 控制整个jsp页面是否执行。
– 控制jsp页面内容重复执行。
– 修改jsp页面内容输出。
• 自定义标签除了可以移除jsp页面java代码外,它也可以实现以上功能。
– tld文件中的四种标签体类型
– EMPTY JSP scriptlesstagdepentend
二JSP标签API
• JSP 1.1和1.2规范中常用的接口主要有以下3个。
– Tag:此接口定义对于所有标签处理类都需要实现的方法。
– IterationTag:此接口扩展了Tag接口,增加了控制重复执行标签主体的方法。
– BodyTag:此接口扩展了IterationTag接口,并增加了访问和操作标签主体内容的方法。
2 标签库描述符
• 标签库描述符文件是一个以“.tld”结尾的标准XML文档,用来记录一个标签库内拥有哪些标签、每个标签包含哪些属性。
• 以下是一个JSP 2.0规范的标签库描述文件的内容:
• <taglib>元素是标签库描述符的根元素,它包含12个子元素,详细介绍如下。
– (1)<description>:标签库的一个文本描述。
– (2)<tlib-version>:指定标签库的版本。
– (3)<short-name>:为标签定义简短的名字,在taglib指令中可作为首选的前缀名使用。
– (4)<uri>:定义一个URI,用于唯一地标识此标签库。
– (5)<tag>:用于指定自定义标签的相关信息。
– (6)<display-name>:为标签库指定一个简短的别名。
– (7)<small-icon>:为标签库指定大小为16×16的小图标(gif或jpeg格式),该图标可在图形界面工具中显示。
– (8)<large-icon>:为标签库指定大小为32×32的大图标(gif或jpeg格式),该图标可在图形界面工具中显示。
– (9)<validator>:为标签库提供一个验证器。
– (10)<listener>:为标签库提供一个监听器。
– (11)<tag-file>:用于描述标签文件。
– (12)<function>:用于指定在表达式语言中使用的函数。
4用BodyTagSupport类开发自定义标签
BodyTagSupport类中增加了两个方法:
a)setBodyContent(BodyContent bc):容器在执行这个标签处理类的实例时,将调用该方法,把标签主体返回的内容缓存在BodyContent类的实例中。BodyContent除了从父类JspWriter继承提供用于向响应体中写入文本的方法,还提供了用于获取它缓冲的标签体内容。
b)doInitBody():计算标签主体之前调用该方法进行初始化共,可以向bodyContent对象中写入初始内容,这些内容会放置在标签主体内容之前。
BodyContent类专门用于缓存标签主体返回的内容,包括静态文本以及由嵌套标签或脚本元素所创建的动态内容。
1.编写一个实现tag接口的类
public class ViewIPTag extends TagSupport {
@Override
publicint doStartTag() throws JspException {
HttpServletRequest request = (HttpServletRequest)this.pageContext.getRequest();
JspWriterout =this.pageContext.getOut();
Stringip = request.getRemoteAddr();
try {
out.println(ip);
}catch (IOException e) {
thrownew RuntimeException(e);
}
returnsuper.doStartTag();
}
}
2.建立tld文件,对标签处理类进行描述。(放在WEB-INF文件夹下)
(C:\apache-tomcat-6.0.18\webapps\examples\WEB-INF\jsp2)
<?xml version="1.0"encoding="UTF-8" ?>
<taglibxmlns="http://java.sun.com/xml/ns/j2ee"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://java.sun.com/xml/ns/j2eehttp://java.sun.com/xml/ns/j2ee/web-jsptaglibrary_2_0.xsd"
version="2.0">
<description>A tag library exercising SimpleTaghandlers.</description>
<tlib-version>1.0</tlib-version>
<short-name>hbsi</short-name>
<uri>http://www.hbsi.com</uri>
<tag>
<name>viewIP</name>
<tag-class>com.hbsi.web.tag.ViewIPTag</tag-class>
<body-content>empty</body-content>
</tag>
</taglib>
3.在jsp文件中使用自定义的标签
<%@ tagliburi="http://www.hbsi.com" prefix="hbsi" %>
<body>
您的IP地址是:<hbsi:viewIP/>
</body>