JavaWeb学习之JSTL自定义标签库的使用、JSTL自定义函数库（7）

一、自定义标签，步骤 * 确定需求 * <my:date /> 输出当前系统的时间 yyyy-MM-dd hh:mm:ss:SSS * 编写Java类 新建包名：com.yxl.tag,新建类MyDateTag，实现SimpleTag接口 * 只要与此接口有关的实现类，javax.servlet.jsp.tagext.JspTag * 需要实现具体的接口 * javax.servlet.jsp.tagext.SimpleTag,简单标签，JSP2.0**，选择这个 * javax.servlet.jsp.tagext.Tag，经典标签 package com.yxl.tag;  import java.io.IOException;         import java.text.SimpleDateFormat;         import java.util.Date;  import javax.servlet.jsp.JspContext;         import javax.servlet.jsp.JspException;         import javax.servlet.jsp.PageContext;         import javax.servlet.jsp.tagext.JspFragment;         import javax.servlet.jsp.tagext.JspTag;         import javax.servlet.jsp.tagext.SimpleTag;  public class MyDateTag implements SimpleTag { public MyDateTag(){ System.out.println("默认构造");  } private PageContext pageContext;  /** * 1、被调用的方法，tomcat调用 */ public void setJspContext(JspContext pc) { // System.out.println(pc);         //        System.out.println("setJspContext");                 this.pageContext = (PageContext) pc;  } /** * 2、tomcat调用 * 建议，在doTage方法中完成整个tag的功能 * 需要再doTage方法之前，完成准备工作 */ public void doTag() throws JspException, IOException { // System.out.println("doTag");  //输出当前系统的时间 yyyy-MM-dd hh:mm:ss:SSS SimpleDateFormat format = new SimpleDateFormat("yyyy-MM-dd hh:mm:ss:SSS");                 String date = format.format(new Date());  //将获得的时间输出到浏览器 this.pageContext.getOut().print(date);  } @Override public JspTag getParent() { // TODO Auto-generated method stub return null;  } @Override public void setJspBody(JspFragment arg0) { // TODO Auto-generated method stub } @Override public void setParent(JspTag arg0) { // TODO Auto-generated method stub } } * 编写tld文件 在WEB-INF下新建文件夹tld，在tld文件夹下新建mytag.tld * tld文件是xml文档 * 扩展名为*.tld * 位置：必须放置到WEB-INF目录下 * 内容： <taglib xmlns="http://java.sun.com/xml/ns/javaee" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-jsptaglibrary_2_1.xsd" version="2.1"> <!-- 确定当前标签库的版本 --> <tlib-version>1.0</tlib-version> <!-- 建议引入当前便签库是，使用的简写 @taglib prefix="my" --> <short-name>my</short-name> <!-- 为当前标签库配置文件，起一个名称 * 内容：自定义，全球唯一 --> <uri>http://www.yxl.cn/jsp/mytag</uri> <!-- <my:date / > 注册标签 --> <tag> <!-- 确定标签名称 --> <name>date</name> <!-- 确定实现类 --> <tag-class>com.yxl.tag.MyDateTag</tag-class> <!-- 格式化当前标签的body内容 * empty：当前标签没有标签体 --> <body-content>empty</body-content> </tag> </taglib> * 在JSP页面引入 * <%@ taglib uri="http://www.yxl.cn/jsp/mytag" prefix="my"%> * 测试 * <my:date /> 二、案例 * 需求：<my:maxVal num1="12" num2="13" /> package com.yxl.tag;  import java.io.IOException;     import java.text.SimpleDateFormat;     import java.util.Date;  import javax.servlet.jsp.JspContext;     import javax.servlet.jsp.JspException;     import javax.servlet.jsp.PageContext;     import javax.servlet.jsp.tagext.JspFragment;     import javax.servlet.jsp.tagext.JspTag;     import javax.servlet.jsp.tagext.SimpleTag;  public class MyMaxValueTag implements SimpleTag { public MyMaxValueTag() { System.out.println("默认构造");  } private PageContext pageContext;         private Integer num1;         private Integer num2;  // num1 public void setNum1(Integer num) { this.num1 = num;  } public void setNum2(Integer num) { this.num2 = num;  } /** * 1、被调用的方法，tomcat调用 */ public void setJspContext(JspContext pc) { // System.out.println(pc);             // System.out.println("setJspContext");             this.pageContext = (PageContext) pc;  } /** * 2、tomcat调用 建议，在doTage方法中完成整个tag的功能 需要再doTage方法之前，完成准备工作 */ public void doTag() throws JspException, IOException { System.out.println(this.num1);             System.out.println(this.num2);  // 判断两个数据的大小，然后输出 if (this.num1 > this.num2) { this.pageContext.getOut().print(num1 + "大于" + num2);  } else if (this.num1 < this.num2){ this.pageContext.getOut().print(num1 + "小于" + num2);  } else{ this.pageContext.getOut().print(num1 + "等于" + num2);  } } @Override public JspTag getParent() { // TODO Auto-generated method stub return null;  } @Override public void setJspBody(JspFragment arg0) { // TODO Auto-generated method stub } @Override public void setParent(JspTag arg0) { // TODO Auto-generated method stub } } <taglib xmlns="http://java.sun.com/xml/ns/javaee" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-jsptaglibrary_2_1.xsd" version="2.1"> <!-- 确定当前标签库的版本 --> <tlib-version>1.0</tlib-version> <!-- 建议引入当前便签库是，使用的简写 @taglib prefix="my" --> <short-name>my</short-name> <!-- 为当前标签库配置文件，起一个名称 * 内容：自定义，全球唯一 --> <uri>http://www.yxl.cn/jsp/mytag</uri> <!-- <my:date / > 注册标签 --> <tag> <!-- 确定标签名称 --> <name>date</name> <!-- 确定实现类 --> <tag-class>com.yxl.tag.MyDateTag</tag-class> <!-- 格式化当前标签的body内容 * empty：当前标签没有标签体 --> <body-content>empty</body-content> </tag> <!-- <my:maxValue / > 注册标签 --> <tag> <!-- 确定标签名称 --> <name>maxValue</name> <!-- 确定实现类 --> <tag-class>com.yxl.tag.MyMaxValueTag</tag-class> <!-- 格式化当前标签的body内容 * empty：当前标签没有标签体 --> <body-content>empty</body-content> <!-- 确定当前标签使用了哪些属性 --> <attribute> <!-- 设置属性名称 --> <name>num1</name> <!-- 设置属性是否必须 * true/false * yes/no --> <required>true</required> <!-- rtexprvalue 运行时表达式的值 * runtime expression value --> <rtexprvalue>true</rtexprvalue> <!-- 确定标签类型 --> <type>java.lang.Integer</type> </attribute> <attribute> <!-- 设置属性名称 --> <name>num2</name> <!-- 设置属性是否必须 * true/false * yes/no --> <required>true</required> <!-- rtexprvalue 运行时表达式的值 * runtime expression value --> <rtexprvalue>true</rtexprvalue> </attribute> </tag> </taglib> * 需求：<my:toUpperCase>xxYYdfsdDFwerd</my:toUpperCase> 标签体 package com.yxl.tag;  import java.io.IOException;     import java.io.StringWriter;     import java.text.SimpleDateFormat;     import java.util.Date;  import javax.servlet.jsp.JspContext;     import javax.servlet.jsp.JspException;     import javax.servlet.jsp.PageContext;     import javax.servlet.jsp.tagext.JspFragment;     import javax.servlet.jsp.tagext.JspTag;     import javax.servlet.jsp.tagext.SimpleTag;  public class MyToUpperCaseTag implements SimpleTag { public MyToUpperCaseTag() { System.out.println("默认构造");  } private PageContext pageContext;  private JspFragment jspBody;  /** * 1、被调用的方法，tomcat调用 */ public void setJspContext(JspContext pc) { this.pageContext = (PageContext) pc;  } public void setJspBody(JspFragment jspBody){ this.jspBody = jspBody;  } /** * 2、tomcat调用 建议，在doTage方法中完成整个tag的功能 需要再doTage方法之前，完成准备工作 */ public void doTag() throws JspException, IOException { StringWriter stringWriter = new StringWriter();             this.jspBody.invoke(stringWriter);             String data = stringWriter.toString();             this.pageContext.getOut().print(data.toUpperCase());  } @Override public JspTag getParent() { // TODO Auto-generated method stub return null;  } @Override public void setParent(JspTag arg0) { // TODO Auto-generated method stub } } <!-- <my:toUpperCase / > 转换为大写 --> <tag> <!-- 确定标签名称 --> <name>toUpperCase</name> <!-- 确定实现类 --> <tag-class>com.yxl.tag.MyToUpperCaseTag</tag-class> <!-- 格式化当前标签的body内容 * empty：当前标签没有标签体 --> <!-- JSP：支持JSP所有的语法，在Tag中使用 scriptless：对于JSP页面的脚本不支持 tagdependent：标签体不做处理，原样输出 --> <body-content>scriptless</body-content> </tag> <my:toUpperCase>abcd</my:toUpperCase> * 需求：循环 使用extends SimpleTagSupport这种方式实现标签类，SimpleTagSupport已经实现了SimpleTag接口 三种循环遍历 <taglib xmlns="http://java.sun.com/xml/ns/javaee" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-jsptaglibrary_2_1.xsd" version="2.1"> <!-- 确定当前标签库的版本 --> <tlib-version>1.0</tlib-version> <!-- 建议引入当前便签库是，使用的简写 @taglib prefix="my" --> <short-name>my</short-name> <!-- 为当前标签库配置文件，起一个名称 * 内容：自定义，全球唯一 --> <uri>http://www.yxl.cn/jsp/mytag</uri> <!-- <my:myeach start="0" end="9" step="1" var="ss"> ${ss} ** <br/> </my:myeach> --> <tag> <name>myeach</name> <tag-class>com.yxl.tag.MyEachTag</tag-class> <body-content>scriptless</body-content> <attribute> <name>start</name> <required>true</required> <rtexprvalue>true</rtexprvalue> </attribute> <attribute> <name>end</name> <required>true</required> <rtexprvalue>true</rtexprvalue> </attribute> <attribute> <name>step</name> <required>true</required> <rtexprvalue>true</rtexprvalue> </attribute> <attribute> <name>var</name> <required>true</required> <rtexprvalue>true</rtexprvalue> </attribute> </tag> <!-- <my:myList items="${listObj}" var="yyyyy"> ${yyyyy} ## <br/> </my:myList> --> <tag> <name>myList</name> <tag-class>com.yxl.tag.MyListTag</tag-class> <body-content>scriptless</body-content> <attribute> <name>items</name> <required>true</required> <rtexprvalue>true</rtexprvalue> </attribute> <attribute> <name>var</name> <required>true</required> <rtexprvalue>true</rtexprvalue> </attribute> </tag> <tag> <name>forEach</name> <tag-class>com.yxl.tag.ForEachTag</tag-class> <body-content>scriptless</body-content> <attribute> <name>items</name> <required>true</required> <rtexprvalue>true</rtexprvalue> </attribute> <attribute> <name>var</name> <required>true</required> <rtexprvalue>true</rtexprvalue> </attribute> </tag> </taglib> package com.yxl.tag;  import java.io.IOException;  import javax.servlet.jsp.JspException;     import javax.servlet.jsp.tagext.SimpleTagSupport;  public class MyEachTag extends SimpleTagSupport{ /* * <my:myeach start="0" end="9" step="1" var="ss"> ${ss} ** <br/> </my:myeach> */ private Integer start;         private Integer end;         private Integer step;         private String var;  public void setStart(Integer start) { this.start = start;  } public void setEnd(Integer end) { this.end = end;  } public void setStep(Integer step) { this.step = step;  } public void setVar(String var) { this.var = var;  } public void doTag() throws JspException, IOException { //完成功能：将获得的变量信息，输出到浏览器 for(int i = start ; i <= end ; i +=step){

 //从父类中，获得pagecontext对象 this.getJspContext().setAttribute(var, i);  //将el表达式的结果发送到浏览器 // * el表达式的位置 // * 如何发送 this.getJspBody().invoke(null);                 //this.getJspBody().invoke(this.getJspContext().getOut());  } } } package com.yxl.tag;  import java.io.IOException;     import java.util.Iterator;     import java.util.List;  import javax.servlet.jsp.JspException;     import javax.servlet.jsp.tagext.SimpleTagSupport;  public class MyListTag extends SimpleTagSupport { /* <my:myList items="${listObj}" var="yyyyy"> ${yyyyy} ## <br/> </my:myList> */ private List items;         private String var;  public void setItems(List items) { this.items = items;  } public void setVar(String var) { this.var = var;  } @Override public void doTag() throws JspException, IOException { //完成功能：将获得的list信息遍历输出到浏览器 Iterator it = items.iterator();  while(it.hasNext()){ Object str = it.next();  //将结果放置到作用域 this.getJspContext().setAttribute(var, str);  //将el表达式的结果数据到浏览器 this.getJspBody().invoke(null);  } } } package com.yxl.tag;  import java.io.IOException;     import java.util.Arrays;     import java.util.Iterator;     import java.util.List;     import java.util.Map;  import javax.servlet.jsp.JspException;     import javax.servlet.jsp.tagext.SimpleTagSupport;  public class ForEachTag extends SimpleTagSupport { /* <my:myList items="${listObj}" var="yyyyy"> ${yyyyy} ## <br/> </my:myList> */ private Iterator<Object> items;         private String var;  public void setItems(Object items) { //list if(items instanceof List){ this.items = ((List)items).iterator();  } //map if(items instanceof Map){ this.items = ((Map)items).entrySet().iterator();  } //object[] if(items instanceof Object[]){ this.items = Arrays.asList((Object[])items).iterator();  } } public void setVar(String var) { this.var = var;  } @Override public void doTag() throws JspException, IOException { //完成功能：将获得的list信息遍历输出到浏览器 while(items.hasNext()){ Object str = items.next();  //将结果放置到作用域 this.getJspContext().setAttribute(var, str);  //将el表达式的结果数据到浏览器 this.getJspBody().invoke(null);  } } } <my:myeach start="0" end="9" step="1" var="eeee"> ${eeee} ** <br/> </my:myeach> <% List<String> list = new ArrayList<String>();         list.add("abc");         list.add("123");         list.add("wasd");  pageContext.setAttribute("listObj",list);  %> myList<br/> <my:myList items="${listObj}" var="yyyyy"> ${yyyyy} ## <br/> </my:myList> <my:forEach items="${listObj}" var="mm"> ${mm} <br/> </my:forEach> <hr/> <% Map<String,String> map = new HashMap<String,String>();         map.put("11111","11111");         map.put("22222","222222");         map.put("33333","33333");  pageContext.setAttribute("mapObj",map);  %> 遍历Map<br/> <my:forEach items="${mapObj}" var="map"> ${map.key} ---- ${map.value} <br/> </my:forEach> 三、自定义函数 * 创建类，但方法必须是静态的 package com.yxl.domain;  public class Calculator { private String firstNum;         private String operator;         private String secondNum;         private String result;  public String getFirstNum() { return firstNum;  } public void setFirstNum(String firstNum) { this.firstNum = firstNum;  } public String getOperator() { return operator;  } public void setOperator(String operator) { this.operator = operator;  } public String getSecondNum() { return secondNum;  } public void setSecondNum(String secondNum) { this.secondNum = secondNum;  } public String getResult() { return result;  } public void setResult(String result) { this.result = result;  } public Calculator() { } //计算方法 public static void calculator(Calculator cal){ //通过运算符，将firstNum和secondNum处理的结果，存放到result double first = Double.valueOf(cal.firstNum);             double second = Double.valueOf(cal.secondNum);             char ope = cal.operator.charAt(0);  switch (ope) { case '+': cal.result = String.valueOf(first + second);                     break;  case '-': cal.result = String.valueOf(first - second);                     break;  case '*': cal.result = String.valueOf(first * second);  break;  case '/': cal.result = String.valueOf(first / second);                     break;  default: throw new RuntimeException("非法操作符");  } } } * 书写配置文件tld 新建myFun.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>myfn</short-name> <uri>http://www.yxl.cn/mytag/functions</uri> <!-- 确定当前函数 myfn:calculator(cal) --> <function> <name>calculator</name> <function-class>com.yxl.domain.Calculator</function-class> <!-- 当前使用函数的声明 public static void calculator(Calculator cal) --> <function-signature>void calculator(com.yxl.domain.Calculator)</function-signature> </function> </taglib> * 引用 * <%@ taglib uri="http://www.yxl.cn/mytag/functions" prefix="myFn" %> * 测试 <jsp:useBean id="cal" class="com.yxl.domain.Calculator"></jsp:useBean> <jsp:setProperty property="firstNum" value="1" name="cal"/> <jsp:setProperty property="operator" value="+" name="cal"/> <jsp:setProperty property="secondNum" value="4" name="cal"/> ${myFn:calculator(cal)} ${cal.result} 四、总结 * 共同点： * 需要引入 * <%@ taglib uri="http://www.yxl.cn/mytag/myeach" prefix="my" %> * 都需要配置tld文件 * 区别： * 自定义标签 * 创建一个类，完成一个功能或一组功能。 * 可以选择el表达式 * 自定义函数 * 创建一个静态方法，完成一个操作。 * 必须与EL表达式结合使用 ${fn:xxxx}