使用springmvc作为开发环境。
1,概述
自定义标签库是jsp api下的内容。通常一个自定义标签会包含3部分内容:标签处理类,tld标签描述文件,jsp文件(使用)。
*标签处理类:继承自 SimpleTagSupport类即可,重写其doTag()方法。我们在页面写了一个自定义标签,这个标签的最终输出内容就是在doTag方法里面实现的,调用getJspContext得到JspContext,即这个jsp页面的上下文环境,然后再从上下文环境中得到jspwriter,就是用这个jspwriter来绘制最终显示的内容的。
*tld描述文件:这个文件对应了一个标签库,即很多的标签。跟元素是taglib,taglib下会包含很多的tag子元素,用来描述该标签库下的各种标签,除此之外还有uri元素,很重要,本质是定义了这个标签库的名字。
*要先指定标签库的uri和前缀,然后用前缀:标签名的方式来调用该库内的标签
下面看例子
2,先定义最简单的标签,显示hello world:
package Tag;
import java.io.IOException;
import javax.servlet.jsp.JspWriter;
import javax.servlet.jsp.tagext.SimpleTagSupport;
public class SimpleTag1 extends SimpleTagSupport{
@Override
public void doTag(){
JspWriter out = getJspContext().getOut();
try {
out.write("hello world");
} catch (IOException e) {
e.printStackTrace();
}
}
}
只打印helloworld字符串。
<?xml version="1.0" encoding="GBK"?>
<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 web-jsptaglibrary_2_0.xsd"
version="2.0">
<tlib-version>1.0</tlib-version>
<short-name>mytaglib</short-name>
<!-- 定义该标签库的URI -->
<uri>http://www.ly.org/mytaglib</uri>
<!-- 定义第一个标签 -->
<tag>
<!-- 定义标签名 -->
<name>helloWorld</name>
<!-- 定义标签处理类 -->
<tag-class>Tag.SimpleTag1</tag-class>
<!-- 定义标签体为空 -->
<body-content>empty</body-content>
</tag>
</taglib>
body-content指的是标签内的内容,只能为empty或者scriptless两个属性,前者表明没有内容,后者表明有非jsp的内容,如el表达式,html等。
<%@ page language="java" contentType="text/html; charset=ISO-8859-1"
pageEncoding="ISO-8859-1"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<%@ taglib uri="http://www.ly.org/mytaglib" prefix="ly" %>
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
<title>Insert title here</title>
</head>
<body>
<h3>hello</h3>
<ly:helloWorld ></ly:helloWorld>
</body>
</html>
使用时,要指定标签库url和前缀。
最终:
3,带有属性的标签:
属性用来向后台的标签处理类传递参数。如果带了属性,那么在处理类中要加上属性,同时有getter setter,按照javabean命名规范。同时在tld文件中加入属性描述,即在tag元素下添加attribute元素。
package Tag;
import java.io.IOException;
import javax.servlet.jsp.JspWriter;
import javax.servlet.jsp.tagext.SimpleTagSupport;
public class SimpleTag1 extends SimpleTagSupport{
private String fontSize;
@Override
public void doTag(){
JspWriter out = getJspContext().getOut();
String str = "<h"+fontSize+">"+"hello world"+"</h"+fontSize+">";
try {
out.write(str);
} catch (IOException e) {
e.printStackTrace();
}
}
public String getFontSize() {
return fontSize;
}
public void setFontSize(String fontSize) {
this.fontSize = fontSize;
}
}
把字号传来
<?xml version="1.0" encoding="GBK"?>
<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 web-jsptaglibrary_2_0.xsd"
version="2.0">
<tlib-version>1.0</tlib-version>
<short-name>mytaglib</short-name>
<!-- 定义该标签库的URI -->
<uri>http://www.ly.org/mytaglib</uri>
<!-- 定义第一个标签 -->
<tag>
<!-- 定义标签名 -->
<name>helloWorld</name>
<!-- 定义标签处理类 -->
<tag-class>Tag.SimpleTag1</tag-class>
<!-- 定义标签体为空 -->
<body-content>empty</body-content>
<attribute>
<name>fontSize</name>
<required>true</required>
</attribute>
</tag>
</taglib>
<%@ page language="java" contentType="text/html; charset=ISO-8859-1"
pageEncoding="ISO-8859-1"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<%@ taglib uri="http://www.ly.org/mytaglib" prefix="ly" %>
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
<title>Insert title here</title>
</head>
<body>
<h3>hello</h3>
<ly:helloWorld fontSize="1"></ly:helloWorld>
<ly:helloWorld fontSize="3"></ly:helloWorld>
</body>
</html>
结果:
4,带有内容的标签:
标签的内容指的是尖括号之间的内容。如果有内容,那么要在tld中的对标签进行修改,即<body-content>不是emtpy而是scriptless。在处理类中,调用jspfragment
的invoke方法就会显示一次body的内容,调用两次就会显示两次,以此类推。当然如果是多次显示,那么会在标签之间重复显示,而不是多个标签。
<?xml version="1.0" encoding="GBK"?>
<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 web-jsptaglibrary_2_0.xsd"
version="2.0">
<tlib-version>1.0</tlib-version>
<short-name>mytaglib</short-name>
<!-- 定义该标签库的URI -->
<uri>http://www.ly.org/mytaglib</uri>
<!-- 定义第一个标签 -->
<tag>
<!-- 定义标签名 -->
<name>helloWorld</name>
<!-- 定义标签处理类 -->
<tag-class>Tag.SimpleTag1</tag-class>
<!-- 定义标签体为空 -->
<body-content>scriptless</body-content>
<attribute>
<name>fontSize</name>
<required>true</required>
</attribute>
</tag>
</taglib>
<%@ page language="java" contentType="text/html; charset=ISO-8859-1"
pageEncoding="ISO-8859-1"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<%@ taglib uri="http://www.ly.org/mytaglib" prefix="ly" %>
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
<title>Insert title here</title>
</head>
<body>
<h3>hello</h3>
<ly:helloWorld fontSize="1">gg</ly:helloWorld>
</body>
</html>
package Tag;
import java.io.IOException;
import javax.servlet.jsp.JspException;
import javax.servlet.jsp.JspWriter;
import javax.servlet.jsp.tagext.SimpleTagSupport;
public class SimpleTag1 extends SimpleTagSupport{
private String fontSize;
@Override
public void doTag(){
JspWriter out = getJspContext().getOut();
String str = "<h"+fontSize+">"+"hello world"+"</h"+fontSize+">";
try {
out.write(str);
getJspBody().invoke(null);
getJspBody().invoke(null);
getJspBody().invoke(null);
} catch (IOException e) {
e.printStackTrace();
} catch (JspException e) {
// TODO Auto-generated catch block
e.printStackTrace();
}
}
public String getFontSize() {
return fontSize;
}
public void setFontSize(String fontSize) {
this.fontSize = fontSize;
}
}
调用三次invoke,显示了三个gg