自定义标签

案例

问题的提出：现在要显示所有员工的资料，提出解决方案

传统方法：1. 在JSP里面写JDBC查询；2. 在JavaBean中写JDBC查询，在JSP中使用查询结果。

新的方法：能否使用一个标签（类似于html标签）嵌入到JSP文件中，让它自动显示这些信息？

答案：能。技术基础：XML。

标签种类

1. 空标签，没有属性，也没有体

    例：<html:submit/>

2. 空体标签，有属性，没有体

    <bean:writename=”student”/>

3. 有属性有体标签

    <logic:iterateid=”book” name=”books”>

           <bean:write name=”book”/>

    </logic:iterate>

自定义标签的要素

1. 标签处理程序（一个java文件，已经被编译）：使用不同的方法与对象来定义标签的行为i，即认识某属性的不同值能做不同的事情。

2. 标签库描述符（TLD）文件（一个XML格式文件）：包含客户标签的描述性列表的XML文件，即识别不同的属性能做不同的事情。

3. JSP文件（为了嵌入自定义的标签）：包含标签以及表示内容的HTML代码。

标签处理程序（一个java文件）

作用：包含类和方法的定义，定义标签的功能

对于空体标签，需要继承：javax.servlet.jsp.tagext.TagSupport

对于有体标签，需要继承：javax.servlet.jsp.tagext.BodyTagSupport

以上两个类都实现：Javax.servlet.jsp.tagext.Tag接口

Tag接口中的方法：

doStartTag():初始化标签的一些内容，如连数据库

doEndTag():作一些善后工作，如关数据库

release():释放这个标签对象

doAfterBody():完成标签体求值之后的调用

doBeforeBody():开始标签体求值之前调用

一般，无体标签doStartTag()返回SKIP_BODY，让标签不要对体求值，doEndTag()返回EVAL_PAGE，让标签后面的JSP继续执行；有体标签doStartTag()返回EVAL_BODY_TAG，让标签对体求值，doEndTag()返回EVAL_PAGE，让标签后面的JSP继续执行；对于标签里面的属性，类似于JavaBean中给它们编写get和set方法。

一般情况下的标签处理程序包含以下函数：

构造函数：用于进行这个标签解释时的初始化，如连接数据库

doStartTag()：返回对这个标签的处理方法

doEndTag()：做一些善后工作，如数据输出，关闭数据库等各种属性的get，set函数

最厉害的角色：pageContext保护成员。

标签库描述符（TLD）文件（一个XML文件）

TLD文件：为包含标签库描述的xml文件；包含库中所有客户标签的列表与描述。

实现空标签

新建MyTag项目，编写标签程序处理类DisplayAllTag，代码如下

package wang.tags;import java.io.IOException;import java.util.ArrayList;import javax.servlet.jsp.JspException;import javax.servlet.jsp.JspWriter;import javax.servlet.jsp.tagext.TagSupport;import wang.dao.EmployeeDao;import wang.po.Employee;// 显示所有员工的资料public class DisplayAllTag extends TagSupport {public DisplayAllTag() {System.out.println("DisplayAllTag构造函数");}public int doStartTag() throws JspException {// 系统开始运行这个标签时自动调用System.out.println("doStartTag");return this.SKIP_BODY; //空体标签，不要对体求值}public int doEndTag() throws JspException {// 系统结束运行这个标签时自动调用System.out.println("doEndTag");EmployeeDao employeeDao = new EmployeeDao();ArrayList<Employee> employees = employeeDao.queryEmployees();//显示为表格JspWriter out = pageContext.getOut();try {out.print("<table>");out.print("<tr>");out.print("<td>ID</td>");out.print("<td>Name</td>");out.print("<td>Email</td>");out.print("<td>Birthday</td>");out.print("<td>JobID</td>");out.print("</tr>");for(Employee employee:employees){out.print("<tr>");out.print("<td>"+employee.getEmployeeId()+"</td>");out.print("<td>"+employee.getFirstName()+" "+employee.getLastName()+"</td>");out.print("<td>"+employee.getEmail()+"</td>");out.print("<td>"+employee.getHireDate()+"</td>");out.print("<td>"+ employee.getJboId()+"</td>");out.print("</tr>");}out.print("</table>");} catch (IOException e) {e.printStackTrace();}return this.EVAL_PAGE; //让标签后面的JSP继续执行}}  编写EmployeeDao类，代码如下

package wang.dao;import java.sql.Connection;import java.sql.DriverManager;import java.sql.ResultSet;import java.sql.SQLException;import java.util.ArrayList;import wang.po.Employee;public class EmployeeDao {private Connection conn = null;public void initialConnection() {try {Class.forName("oracle.jdbc.driver.OracleDriver").newInstance(); String url="jdbc:oracle:thin:@localhost:1521:xe"; conn = DriverManager.getConnection(url, "hr", "hr"); } catch (Exception e) {e.printStackTrace();} }public ArrayList<Employee> queryEmployees() {ArrayList<Employee> employees = new ArrayList<Employee>();String sql = "select * from employees";try {this.initialConnection();ResultSet rs = conn.createStatement().executeQuery(sql);while(rs.next()) {Employee employee = new Employee();employee.setEmployeeId(rs.getString("EMPLOYEE_ID"));employee.setFirstName(rs.getString("FIRST_NAME"));employee.setLastName(rs.getString("LAST_NAME"));employee.setEmail(rs.getString("EMAIL"));employee.setHireDate(rs.getString("HIRE_DATE"));employee.setJboId(rs.getString("JOB_ID"));employees.add(employee);}} catch (SQLException e) {e.printStackTrace();} finally {this.closeConnection();}return employees;}public void closeConnection() {try {if(conn!=null) {conn.close();conn = null;}} catch (SQLException e) {e.printStackTrace();}}}  编写Employee类，代码如下

public class Employee {private String employeeId;private String firstName;private String lastName;private String email;private String hireDate;private String jboId; public String getEmployeeId() {return employeeId;}public void setEmployeeId(String employeeId) {this.employeeId = employeeId;}public String getFirstName() {return firstName;}public void setFirstName(String firstName) {this.firstName = firstName;}public String getLastName() {return lastName;}public void setLastName(String lastName) {this.lastName = lastName;}public String getEmail() {return email;}public void setEmail(String email) {this.email = email;}public String getHireDate() {return hireDate;}public void setHireDate(String hireDate) {this.hireDate = hireDate;}public String getJboId() {return jboId;}public void setJboId (String jboId) {this.jboId = jboId;}} 编写emp.tld文件，一般是放在WEB-INF目录下面，系统自动识别到，代码如下

<?xml version="1.0" encoding="UTF-8"?><taglib> <!-- 标签库定义文件根节点：taglib --><tlibversion>1.2</tlibversion> <!-- 标签库版本 --><jspversion>1.1</jspversion> <!-- Jsp版本 --><shortname>emp</shortname> <!-- 标签库名称 --><uri>http://wang.mytag.emp</uri> <!-- 外界导入标签库认识时的名称 --><!-- 定义标签 --><tag><name>displayAll</name><tagclass>wang.tags.DisplayAllTag</tagclass></tag></taglib> 编写displayAll.jsp文件，代码如下

<%@ page language="java" import="java.util.*" pageEncoding="ISO-8859-1"%><%@ taglib uri="http://wang.mytag.emp" prefix="emp"%><!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"><html> <head> <title>My JSP 'displayAll.jsp' starting page</title> </head> <body> <emp:displayAll></emp:displayAll> </body></html> 部署项目，启动服务器，运行页面，得到正确的结果。

实现空体标签（不显示所有员工，比如按部门显示）

编写标签程序处理类DisplayByJobIDTag，代码如下

package wang.tags;import java.io.IOException;import java.util.ArrayList;import javax.servlet.jsp.JspException;import javax.servlet.jsp.JspWriter;import javax.servlet.jsp.tagext.TagSupport;import wang.dao.EmployeeDao;import wang.po.Employee;//通过性别属性来显示public class DisplayByJobIDTag extends TagSupport {private String jobID;public DisplayByJobIDTag() {System.out.println("DisplayAllTag构造函数");}public int doStartTag() throws JspException {// 系统开始运行这个标签时自动调用System.out.println("doStartTag");return this.SKIP_BODY; //空体标签，不要对体求值}public int doEndTag() throws JspException {// 系统结束运行这个标签时自动调用System.out.println("doEndTag");EmployeeDao employeeDao = new EmployeeDao();ArrayList<Employee> employees = employeeDao.queryEmployeesByJobID(jobID);//显示为表格JspWriter out = pageContext.getOut();try {out.print("<table>");out.print("<tr>");out.print("<td>ID</td>");out.print("<td>Name</td>");out.print("<td>Email</td>");out.print("<td>Birthday</td>");out.print("<td>JobID</td>");out.print("</tr>");for(Employee employee:employees){out.print("<tr>");out.print("<td>"+employee.getEmployeeId()+"</td>");out.print("<td>"+employee.getFirstName()+" "+employee.getLastName()+"</td>");out.print("<td>"+employee.getEmail()+"</td>");out.print("<td>"+employee.getHireDate()+"</td>");out.print("<td>"+employee.getJboId()+"</td>");out.print("</tr>");}out.print("</table>");} catch (IOException e) {e.printStackTrace();}return this.EVAL_PAGE; //让标签后面的JSP继续执行}public String getJobID() {return jobID;}public void setJobID(String jobID) {this.jobID = jobID;}} 在EmployeeDao中添加按JobID查询的方法，代码如下

public ArrayList<Employee> queryEmployeesByJobID(String jobID) {ArrayList<Employee> employees = new ArrayList<Employee>();String sql = "";if(jobID == null) {sql = "select * from employees";}else {sql = "select * from employees where JOB_ID='"+jobID+"'";}try {this.initialConnection();ResultSet rs = conn.createStatement().executeQuery(sql);while(rs.next()) {Employee employee = new Employee();employee.setEmployeeId(rs.getString("EMPLOYEE_ID"));employee.setFirstName(rs.getString("FIRST_NAME"));employee.setLastName(rs.getString("LAST_NAME"));employee.setEmail(rs.getString("EMAIL"));employee.setHireDate(rs.getString("HIRE_DATE"));employee.setJboId(rs.getString("JOB_ID"));employees.add(employee);}} catch (SQLException e) {e.printStackTrace();} finally {this.closeConnection();}return employees;} 在emp.tld中新增标签项，代码如下

<tag><name>displayByJobID</name><tagclass>wang.tags.DisplayByJobIDTag</tagclass><attribute> <!-- 注册属性 --><name>jobID</name><required>false</required> <!-- 是否必需 --></attribute></tag> 编写displayByJobID.jsp文件，代码如下

<%@ page language="java" import="java.util.*" pageEncoding="ISO-8859-1"%><%@ taglib uri="http://wang.mytag.emp" prefix="emp"%><!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"><html> <head> <title>My JSP 'displayAll.jsp' starting page</title> </head> <body> <emp:displayByJobID jobID="IT_PROG"></emp:displayByJobID> </body></html> 部署项目，启动服务器，运行页面，得到正确的结果。