目录
一.什么是标签
标记语言,是一种注释文本的语言,以便于计算机可以操作。很多与“ML”结尾的语言都是标记语言,比如:HTML,XML,XHTML,VML等等。
标记语言与其他语言一样,也需要运行它们的环境,比如HTML的运行环境时浏览器,XML也要自己的解析和运行的环境。
基本结构:
<开始标签>标签体</结束标签>
空标签:
<开始标签 属性名="属性值"/></结束标签>
<br/><br/>
<开始标签 属性名="属性值"/>
二. JSP自定义标签库
2.1JSP标签库是什么
是一个JSP标签集合,它封装了JSP应用的通用核心功能, 基于JSP标签我们可以理解为,是JSP应该通用功能的一种封装方式。
2.2 处理流程
2.3 如何自定义标签
常见自定义标签主要步骤:
- 编写助手类
- 编写标签库描述文件(tld)
- 在页面上引入标签使用
2.4 标签类型
- UI标签, 输出页面元素
- 控制标签, 如if标签,foreach标签等
- 数据标签,用于向页面输入数据
2.5 开发示例
2.5.1 out标签
1) 创建助手类
public class OutTag extends BodyTagSupport {
private String val;
private String defaultVal;
public String getVal() {
return val;
}
public void setVal(String val) {
this.val = val;
}
public String getDefaultVal() {
return defaultVal;
}
public void setDefaultVal(String defaultVal) {
this.defaultVal = defaultVal;
}
@Override
public int doStartTag() throws JspException {
//pageContext为页面上下文对象,用于和jsp共享数据
JspWriter out = this.pageContext.getOut();
try {
if(this.val == null || "".equals(this.val)) {
//利用JspWrite对象将val输出到页面
out.println(this.defaultVal);
} else {
//利用JspWrite对象将val输出到页面
out.println(this.val);
}
} catch (IOException e) {
throw new JspException("out标签异常", e);
}
return SKIP_BODY;
}
}
2) 编写tld文件,(必须放在WEB-INF目录或其目录下)
<!DOCTYPE taglib
PUBLIC "-//Sun Microsystems, Inc.//DTD JSP Tag Library 1.2//EN"
"http://java.sun.com/dtd/web-jsptaglibrary_1_2.dtd">
<!-- 标签库描述符 -->
<taglib xmlns="http://java.sun.com/JSP/TagLibraryDescriptor">
<tlib-version>1.0</tlib-version>
<jsp-version>1.2</jsp-version>
<short-name>Simple Tags</short-name>
<uri>/zking</uri>
<tag>
<!-- 标签名 -->
<name>out</name>
<!-- 标签助手类 -->
<tag-class>com.zking.mvc.tag.OutTag</tag-class>
<!-- 标签的内容类型:empty表示空标签,jsp表示可以为任何合法的JSP元素 -->
<body-content>empty</body-content>
<attribute>
<!-- 属性名, OutTag类中的val属性相匹配 -->
<name>val</name>
<!-- 表示该属性为必要的属性 -->
<required>true</required>
<!-- 该属性可以接受EL表示式的值 -->
<rtexprvalue>true</rtexprvalue>
<!-- 标签描述,用于说明标签的作用 -->
<description>out标签val属性,用于输出val的值</description>
</attribute>
<attribute>
<!-- 属性名, OutTag类中的defaultVal属性相匹配 -->
<name>defaultVal</name>
<!-- 表示该属性为必要的属性 -->
<required>false</required>
<!-- 该属性可以接受EL表示式的值 -->
<rtexprvalue>false</rtexprvalue>
<!-- 标签描述,用于说明标签的作用 -->
<description>out标签,如val属性值为空,则输出该默认值</description>
</attribute>
</tag>
</taglib>
3) 在页面上引入使用
<%@ page language="java" contentType="text/html; charset=utf-8"
pageEncoding="utf-8"%>
<%@taglib prefix="z" uri="/zking" %>
<!DOCTYPE html">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
<title>Insert title here</title>
</head>
<body>
<h1><%=System.currentTimeMillis()%></h1>
<z:hello/>
<!-- out -->
<z:out val="adb"/>
<%
request.setAttribute("name", null);
%>
<z:out val="${name}" defaultVal="test"/>
</body>
</html>
2.5.2 if标签
1)编写助手类
public class IfTag extends BodyTagSupport {
private boolean test;
public boolean isTest() {
return test;
}
public void setTest(boolean test) {
this.test = test;
}
@Override
public int doStartTag() {
if(this.test) {
return EVAL_BODY_INCLUDE;
}
return SKIP_BODY;
}
}
2) tld文件,在tld中加入if标签的声明
<tag>
<name>if</name>
<tag-class>com.zking.mvc.tag.IfTag</tag-class>
<!--该标签有标签体-->
<body-content>jsp</body-content>
<attribute>
<name>test</name>
<required>true</required>
<rtexprvalue>true</rtexprvalue>
</attribute>
</tag>
3) 在页面上使用
<%@ page language="java" contentType="text/html; charset=utf-8"
pageEncoding="utf-8"%>
<%@taglib prefix="z" uri="/zking" %>
<!DOCTYPE html">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
<title>Insert title here</title>
</head>
<body>
<h1><%=System.currentTimeMillis()%></h1>
<z:hello/>
<!-- out -->
<z:out val="adb"/>
<%
request.setAttribute("name", null);
%>
<z:out val="${name}" defaultVal="test"/>
<p>
<!-- if -->
<z:if test="${100 == 100}">
测试if(100 == 100)
</z:if>
<z:if test="${100 == 1}">
测试if(100 == 1)
</z:if>
</body>
</html>
2.5.3 foreach标签
1) 编写助手类
public class ForeachTag extends BodyTagSupport {
//存放数据源
private List<?> items;
//每次循环获取的对象放入pageContext中,并以var属性的值为key进行保存
//示例: 页面上标签var属性指定为item,则每次循环取出的对象(obj)将执行如下:
//pageContext.setAttribute("item", obj);
//页面中可以使用EL表达式取出对象中的属性, 如: ${item.name}
private String var;
public List<?> getItems() {
return items;
}
public void setItems(List<?> items) {
this.items = items;
}
public String getVar() {
return var;
}
public void setVar(String var) {
this.var = var;
}
@Override
public int doStartTag() {
if(Objects.isNull(this.items) || this.items.size() == 0) {
return SKIP_BODY;
}
Iterator<?> iterator = this.items.iterator();
Object obj = iterator.next();
this.pageContext.setAttribute(var, obj);
this.pageContext.setAttribute("iterator", iterator);
return EVAL_BODY_INCLUDE;
}
@Override
public int doAfterBody() {
Iterator<?> it = (Iterator<?>)this.pageContext.getAttribute("iterator");
if(it.hasNext()) {
this.pageContext.setAttribute(var, it.next());
return EVAL_BODY_AGAIN;
}
return SKIP_BODY;
}
}
测试数据辅助类
public class Book {
private int id;
private String name;
public int getId() {
return id;
}
public void setId(int id) {
this.id = id;
}
public String getName() {
return name;
}
public void setName(String name) {
this.name = name;
}
}
public class TestData {
public static List<Book> getBooks() {
List<Book> books = new ArrayList<>();
Book b1 = new Book();
b1.setId(1);
b1.setName("水浒传");
Book b2 = new Book();
b2.setId(2);
b2.setName("红楼梦");
Book b3 = new Book();
b3.setId(3);
b3.setName("西游记");
books.add(b1);
books.add(b2);
books.add(b3);
return books;
}
}
3) 在页面上使用标签
<%@page import="com.zking.mvc.test.*,java.util.List" %>
<%@ page language="java" contentType="text/html; charset=utf-8"
pageEncoding="utf-8"%>
<%@taglib prefix="z" uri="/zking" %>
<!DOCTYPE html">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
<title>Insert title here</title>
</head>
<body>
<h1><%=System.currentTimeMillis()%></h1>
<z:hello/>
<!-- out -->
<z:out val="adb"/>
<%
request.setAttribute("name", null);
%>
<z:out val="${name}" defaultVal="test"/>
<p>
<!-- if -->
<z:if test="${100 == 100}">
测试if(100 == 100)
</z:if>
<z:if test="${100 == 1}">
测试if(100 == 1)
</z:if>
<p>
<!-- foreach -->
<%
//获取测试数据
List<Book> books = TestData.getBooks();
//放入request对象中
request.setAttribute("books", books);
%>
<z:foreach items="${books}" var="book">
<p>${book.id } - ${book.name }</p>
</z:foreach>
</body>
</html>