JSP2自定义标签

su - bc

于 2019-06-09 14:23:35 发布

阅读量168

点赞数

分类专栏： jsp 文章标签：自定义标签库 JSP2

本文链接：https://blog.csdn.net/chen_bin_/article/details/90815934

版权

jsp 专栏收录该内容

1 篇文章 0 订阅

订阅专栏

为什么要使用自定义标签呢？
主要是为了取代丑陋的jsp脚本。
在jsp2中开发标签库需要以下几个步骤：
1、开发自定义标签处理类
2、建立一个*.tld文件，每个tld文件对应一个标签库，每个标签库可包含多个标签
3、在jsp文件中使用自定义标签

1、开发自定义标签类

要求：
1、标签类若有属性，则必须有getter和setter方法
2、重写doTag方法
3、继承父类：javax.servlet.jsp.tagext.SimpleTagSupport
例如：
\src\helloworld.java

public class HelloWorld extends SimpleTagSupport
{
//该标签负责在页面上输出helloworld
public void doTag()throws JspException,IoException
{
getJspContext().getOut().write("helloworld"+new java.util.Date());
}
}

建立TLD文件

标签库定义文件根元素taglib，可以包含多个tag子元素，每个tag定义一个标签。
如下自定义一个标签库：
\src\mytaglib.tld

<?xml version="1.0" encoding="UTF-8"?>
<taglib 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"
    version="2.0">
    <tlib-version>1.0</tlib-version>
    <short-name>MyTaglib</short-name>
    <uri>MyTaglib</uri>
    <tag>
        <name>helloWorld</name>
        <tag-class>\src\helloworld.java</tag-class>
        <!--定义标签体为空-->
        <body-content>empty</body-content>
    </tag>
</taglib>

taglib下有如下三个子元素
1、tlib-version：指定该标签库实现的版本，没有太大的用处。
2、short-name：该标签库的默认短名，没啥用
3、uri:非常重要，该标签库的唯一标识，通过它找到使用的标签库
tag元素定义一个标签，有以下几个常用子元素：
1、name:该标签的名称，jsp页面根据该名称使用该标签。
2、tag-class:指定标签的处理类
3、body-content:重要，它指定了标签体内容，该元素的值有

tagdependent:指定标签处理类子集处理标签体
empty:该标签只能作为空标签使用
scriptless:该标签的标签体可以是静态的HTML元素、表达式语言，但不允许出现jsp脚本
JSP:可以使用JSP脚本，JSP2规范中不再使用

4、dynamic-attributes:指定该标签体是否支持动态属性。

使用标签库

1、导入标签库
2、使用标签

导入标签库

<%@ taglib uri="MyTaglib" prefix="s" %>

uri就是标签库中的URI
prefix指定标签库前缀，即在使用标签时使用该前缀将由此标签库处理

使用标签库

<前缀：标签名属性名=属性值
属性名=属性值
·······>
<标签体/>
</前缀：标签名>
属性和标签体没有可省略
例子如下所示：

<%@ page language="java" contentType="text/html; charset=UTF-8"
    pageEncoding="UTF-8" %>
<%@ taglib uri="MyTaglib" prefix="s" %>
<html>
<head>
<meta content="text/html" charset="UTF-8" http-equiv="Content-Type">
<title>自定义标签库</title>
</head>
<body>							
<s:helloworld />
</body>
</html>

即可输出在标签处理类中的内容

2、带有属性的标签

介绍一个示例：
和简单标签一样，三大步骤
标签处理类，要有getter和setter方法
\src\mytaglib.java

//此标签类从数据库中取出数据放在表格
public class mytaglib extends SimpleSupport
//定义成员变量代表标签属性
private String driver;
private String url;
private String user;
private String pass;
private String sql;
//执行数据库访问的对象
private Connection conn=null;
private Statement stmt=null;
private ResultSet rs=null;
private ResultMetaDta rsmd=null;
//省略了getter和setter方法
·······
public void doTag()throws JSPException,IOException
{
try{
//注册驱动
Class.forName(driver);
//获取数据库连接
conn=DriverManager.getConnection(url,user,pass);
//创建Statement对象
stmt=conn.CreateStatement();
//执行查询
rs=stmt.executeQuery(sql);
rsmd=rs.getMetaData();
//获取列目数
int columnCount=rsmd.getColumnCount();
//获取页面输出流
Write out=getJspContext().getOut();
//在页面输出表格，在后面Struts2可以使用自带的标签库输出表格
out.write("<table border='1' bgColor='#9999cc' width='400'>");
//遍历结果集
while(rs.next())
{
out.write("<tr>");
for(int i=0;i<columnCount;i++)
{
out.write("<td>");
out.write(rs.getString(i));
out.write("</td>");
}
out.write("</tr>");
}
}catch(ClassNotFoundException e)
{
e.printStackTrace();
throw new JspExcepton("自定义标签错误"+e.getMessage());
}catch(SQLException e)
{
e.printStackTrace();
throw new JspException("自定义标签错误"+e.getMessage());
}
finally{
try
{
if(rs!=null)
rs.close();
if(stmt!=null)
stmt.close();
if(conn!=null)
conn.close();
}catch(SQLException e)
{
e.printStackTrace();
}
}
}

建立tld标签库
带有属性的标签库配置与普通标签库有所不同
在上面的标签库中增加一个标签
\src\mytaglib.tld

<!--定义第二个标签-->
<tag>
<name>query</name>
<tag-class>src.mytaglib</tag-class>
<body-content>empty</body-content>
<!-- 定义属性-->
<attribute>
<name>driver</name>
<required>true</required>
<fragment>true</fragment>
</attribute>
<attribute>
<name>url</name>
<required>true</required>
<fragment>true</fragment>
</attribute>
<attribute>
<name>user</name>
<required>true</required>
<fragment>true</fragment>
</attribute>
<attribute>
<name>pass</name>
<required>true</required>
<fragment>true</fragment>
</attribute>
<attribute>
<name>sql</name>
<required>true</required>
<fragment>true</fragment>
</attribute>
</tag>

required:设置该属性是否是必须属性
fragment:设置该属性是否支持JSP，表达式等动态内容
使用标签
主要代码

<%@  taglib uri="MyTaglib"  prefix="s"%>
<!-- 省略html内容-->
····
<s:query 
             driver="com.mysql.jdbc.Driver"
             uri="jdbc:mysql://localhost:3306/mydata"
             user="root"
             pass="123456"
             sql="select *from student"
\>

不推荐在标签处理类中使用访问数据库，标签库是表现层，不该有业务逻辑
JSTL是sun提供的一套标签库。
DisplayTag是Apache组织下的一套开源标签库

3、带有标签体的标签

可以在标签内嵌入其他内容（包括静态的html内容和动态的JSP脚本）
下面以一个迭代器标签为例,每循环一次，为表格添加一行，并填入内容
标签处理类
\src\iterator.java

public class iterator extends SimpleTagSupport
{
private String jihe;   //将表现层集合的属性名赋给jihe
private String item;  //将集合中值作为属性值保存在此属性中
······  //省略getter和setter方法
public void doTag()throw JspException,IoException
{
Collection itemList=(Collection)getJspContext().getAttribute(jihe);
for(Object s:itemList)
{
getJspContext().setAttribute(item,s);  //将集合中的元素设置到page范围内
getJspBody().invoke(null);  //输出标签体，执行JspFragment对象的invoke方法
}
}
}

建立tld标签库
\src\mytaglib.tld

<!-- 在标签库中定义第三个标签-->
<tag>
<name>iterator</name>
<tag-class>src.iterator</tag-class>
<!--该标签的标签体可以是静态的HTML元素、表达式语言，但不允许出现jsp脚本-->
<body-content>scriptless</body-content>
<!-- 定义属性-->
<attribute>
<name>jihe</name>
<required>true</required>
<fragment>true</fragment>
</attribute>
<attribute>
<name>item</name>
<required>true</required>
<fragment>true</fragment>
</attribute>
</tag>

使用标签

···
<body>
<% 
//创建一个集合
List<String> a=new ArrayList<String>();
a.add("你的酒馆对我打了洋")；
a.add("子弹在我心头上了膛")；
a.add("请告诉我今后怎么抗")
//将List对象放入Page范围内
pageContext.setAttribute("a",a);
%>
<table border="1" bgcolor="#aaaadd" width="300">
<s:iterator jihe="a"  item="item">
<tr>
<td>${pageScope.item}</td>
</tr>
</s:iterator>
</table>
</body>

4、以页面片段作为属性的标签

标签处理类
在标签处理类中定义一个JspFragment类型的属性，即表明该标签允许使用页面片段类型的属性
\src\fragmentTag.java

public class fragmentTag extends SimpleTagSupport
{
private JspFragment fragment;
//省略setter和getter方法
···
public void doTag()throw IoException,JspException
{
JspWriter out=getJspContext().getOut();
out.println("<div style='padding:10px;border:1px soild black;'>");
//调用并输出页面片段
fragment.invoke(null);
out.println("</div>");
}
}

建立tld标签库
\src\mytaglib.tld

<!-- 在标签库中定义第四个标签-->
<tag>
<name>fragment</name>
<tag-class>src.fragmentTag</tag-class>
<body-content>empty</body-content>
<!-- 定义属性-->
<attribute>
<name>fragment</name>
<required>true</required>
<fragment>true</fragment>
</tag>

使用标签
在使用标签，传入属性值时，要用到<jsp:attribute …>动作指令

···
<s:fragment>
<jsp:attribute name="fragment">
<!-- 动态的jsp页面片段-->
<s:helloworld/>
</jsp:attribute>
</s:fragment>

注意，由于标签体为空，所以<s:fragment></s:fragment>中只能有<jsp:attribute …>，注释都不允许

5、动态属性的标签

传入自定义的标签数量和标签名不确定
动态属性标签比普通标签多了两个额外的要求：
1、标签处理类要实现DynamicAttribute接口
2、配置标签时通过<dynamic-attribute…/>指定标签支持动态属性
标签处理类
\src\dynamicTag.java

public class dynamicTag extends SimpleTagSupport implements DynamicAttribute
{
//设置一个集合保存属性名
private ArrayList<String> keys=new ArrayList<String>();
//设置一个集合保存属性值
private ArrayList<String>values=new ArrayList<String>();
@Override
public void doTag()throw IoException,JspException
{
JspWriter out=getJspContext().getOut();
out.println("<ol>");
for(int i=0;i<keys.size();i++)
{
String key=keys.get(i);
Object value=values.get(i);
out.println("<li>"+key+"="+value+"</li>");
}
out.println("</ol>");
}
@Override
public void setDynamicAttribute(String uri,String localName,Object value)
{
//添加属性名
keys.add(localName);
//添加属性值
values.add(value);
}
}

建立tld标签库
\src\mytablib.tld

···
<tag>
<name>dynamic</name>
<tag-class>src.dynamicTag</tag-class>
<body-content>empty</body-content>
<dynamic-attributes>true</dynamic-attributes>
</tag>

使用标签

···
<s:dynamic firstatt="11" secondatt="222">
<s:dynamic oneatt="1111"  twoatt="2222" threeatt="3333">

Tag File的支持

Tag File是自定义标签的简易用法，无需定义标签处理类和标签库文件

1、建立一个tag文件

tag代替了标签处理类，格式如Jsp文件
Tag File有5个编译指令
1、taglib:用于导入其他标签库
2、include:用于导入其他jsp或者静态页面
3、tag:类似于page指令，用于设置页面编码等属性
4、attribute:设置自定义标签的属性
5、variable:用于设置自定义标签的变量
只有如下几个内置对象
request、response、session、application、config、out
与jsp脚本中对象对应
下面定义了一个简单的迭代器标签
/weballpication/iterator.tag

<%@tag pageEncoding="GBK" import="java.util.List"%>
<%@ attribute name="bgColor">
<table border="1" bgcolor="${bgColor}">
<% List <String> list=(List<String>request.getAtrribute("a"));
for(Object value:list)
{
%>
<tr>
<td><%=value></td>
</tr>
<%}%>
</table>

2、Jsp中使用标签

···
<!-- 导入标签库-->
<%@taglib prefix="s" tagdir="/weballpication/iterator" %>
···
···
<!--使用标签-->
List<String> list=new List<String>();
list.add("first");
list.add("second");
request.setAttribute("a",list);
<s:iterator bgColor="#99dd99">

su - bc

关注

0
点赞
踩
0

收藏

觉得还不错? 一键收藏
0
评论
JSP2自定义标签

Struts2提供了大量标签帮助开发表现层页面，Struts2标签库与Struts1相比，不依赖于任何表现层技术，大部分可以在各种表现层技术中使用，包括最常用的jsp页面，也可以在Velocity和FreeMarker等模板技术中使用。注：极小部分在某些表现层中收到限制还记得如何自定义标签库吗？为什么要使用自定义标签呢？主要是为了取代丑陋的jsp脚本。在jsp2中开发标签库需要以下几个步...
复制链接

扫一扫