码迷，mamicode.com
首页 > 其他好文 > 详细

EL的函数与标签

时间：2015-01-29 01:16:48      阅读：367      评论：0      收藏：0      [点我收藏+]

标签：

1　什么EL函数库

　　EL函数库是由第三方对EL的扩展，我们现在学习的EL函数库是由JSTL添加的。下面我们会学习JSTL标签库。

EL函数库就是定义一些有返回值的静态方法。然后通过EL语言来调用它们！当然，不只是JSTL可以定义EL函数库，我们也可以自定义EL函数库。

　　EL函数库中包含了很多对字符串的操作方法，以及对集合对象的操作。例如：${fn:length(“abc”)}会输出3，即字符串的长度。

 

2　导入函数库

　　因为是第三方的东西，所以需要导入。导入需要使用taglib指令！

<%@ taglib prefix="fn" uri="http://java.sun.com/jsp/jstl/functions" %>

3　EL函数库介绍

l  String toUpperCase(String input)：

l  String toLowerCase(String input)：

l  int indexOf(String input, String substring)：

l  boolean contains(String input, String substring)：

l  boolean containsIgnoreCase(String input, String substring)：

l  boolean startsWith(String input, String substring)：

l  boolean endsWith(String input, String substring)：

l  String substring(String input, int beginIndex, int endIndex)：

l  String substringAfter(String input, String substring)：

l  substringBefore(String input, String substring)：

l  String escapeXml(String input)：

l  String trim(String input)：

l  String replace(String input, String substringBefore, String substringAfter)：

l  String[] split(String input, String delimiters)：

l  int length(Object obj)：

l  String join(String array[], String separator)：

<%@taglib prefix="fn"   uri="http://java.sun.com/jsp/jstl/functions"   %>

…

String[] strs = {"a", "b","c"};

List list = new ArrayList();

list.add("a");

pageContext.setAttribute("arr", strs);

pageContext.setAttribute("list", list);

%>

${fn:length(arr)   }<br/><!--3-->

${fn:length(list)   }<br/><!--1-->

${fn:toLowerCase("Hello")   }<br/> <!-- hello -->

${fn:toUpperCase("Hello")   }<br/> <!-- HELLO -->

${fn:contains("abc",   "a")}<br/><!-- true -->

${fn:containsIgnoreCase("abc",   "Ab")}<br/><!-- true -->

${fn:contains(arr,   "a")}<br/><!-- true -->

${fn:containsIgnoreCase(list,   "A")}<br/><!-- true -->

${fn:endsWith("Hello.java",   ".java")}<br/><!-- true -->

${fn:startsWith("Hello.java",   "Hell")}<br/><!-- true -->

${fn:indexOf("Hello-World",   "-")}<br/><!-- 5 -->

${fn:join(arr,   ";")}<br/><!-- a;b;c -->

${fn:replace("Hello-World",   "-", "+")}<br/><!-- Hello+World -->

${fn:join(fn:split("a;b;c;",   ";"), "-")}<br/><!-- a-b-c -->

 

${fn:substring("0123456789",   6, 9)}<br/><!-- 678 -->

${fn:substring("0123456789",   5, -1)}<br/><!-- 56789 -->

${fn:substringAfter("Hello-World",   "-")}<br/><!-- World -->

${fn:substringBefore("Hello-World",   "-")}<br/><!-- Hello -->

${fn:trim("     a b c       ")}<br/><!-- a b c -->

${fn:escapeXml("<html></html>")}<br/> <!-- <html></html> -->

 

 

4　自定义EL函数库

l  写一个类，写一个有返回值的静态方法；

l  编写tld文件，可以参数fn.tld文件来写，把tld文件放到classes下（还可以自定义命名空间）；

l  在页面中添加taglib指令，导入自定义标签库。

 

ItcastFuncations.java

package cn.itcast.el.funcations;

 

public class ItcastFuncations {

    public static String test() {

       return "传智播客自定义EL函数库测试";

    }

}

 

itcast.tld（放到classes下）

<?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">

   

  <description>ITCAST 1.0 functions library</description>

  <display-name>ITCAST functions</display-name>

  <tlib-version>1.0</tlib-version>

  <short-name>itcast</short-name>

  <uri>http://www.itcast.cn/jsp/functions</uri>

 

  <function>

    <name>test</name>

    <function-class>cn.itcast.el.funcations.ItcastFuncations</function-class>

    <function-signature>String test()</function-signature>

  </function>

</taglib>

 

index.jsp

<%@ page language="java"   import="java.util.*" pageEncoding="UTF-8"%>

<%@ taglib prefix="itcast"   uri="/WEB-INF/classes/itcast.tld" %>

 

<!DOCTYPE HTML PUBLIC "-//W3C//DTD   HTML 4.01 Transitional//EN">

<html>

  <body>

    <h1>${itcast:test() }</h1>

  </body>

</html>

 

如果把itcast.tld文件放到classes\META-INF\itcast.tld，那么就可以把

<%@ taglib prefix="itcast" uri="/WEB-INF/classes/itcast.tld" %>

修改为

<%@ taglib prefix="itcast" uri="http://www.itcast.cn/jsp/functions" %>

对应itcast.tld文件中的<uri>元素内容。

一般这种方式都是打包成Jar时，在Jar中的META-INF目录中存放TLD文件。

 

自定义标签

Tag

 

1　什么是自定义标签

　　尽管JSP本身，以及第三方提供了很多标签库，但因为业务需要，我们有时还是需要自定义标签。因为JSP页面中不可以存在Java代码，所以我们需要自定义标签！

 2　标签的真身

其实我们现在应该可以了解了，真的是万物皆对象。JSP可以是一个对象，当然标签也可以是一个对象。其实在页面中使用的标签就是对一个对象的方法调用！

标签：

l  标签处理类：都有自己的标签处理类！所有标签处理类都必须去实现Tag或SimpleTag接口；

l  TLD（Tag Library Description）：一个TLD文件中可以部署多个标签！JSP会通过TLD文件找到标签！ （webapps\examples\WEB-INF\jsp2，这里有模板）

3　Hello Tag!

写一个类：MyTag，实现Tag接口。Tag接口中一共6个方法！我们只需要去实现两个方法即可，其他的方法当它不存在！

l  setPageContext(PageContext)：为本类添加PageContext属性，在本方法中把参数赋给本类属性。没错，就是用来保存PageContext中，因为doStartTag()方法中要用PageContext；

l  int doStartTag()：使用pageContext获取out对象，然后使用out向页面打印：“Hello Tag!”。本方法还有一个返回值，返回0就行了（先不用管返回值是干什么的）！

l  TLD：TLD文件中的一个<tag>对应一个标签的部署信息！现在中需要照猫画虎就OK了！没错，TLD是一个XML文件！（可以到webapps\examples\WEB-INF\jsp2中查找TLD文件）

 

MyTag.java

package cn.itcast.tags;

 

import java.io.IOException;

 

import javax.servlet.jsp.JspException;

import javax.servlet.jsp.PageContext;

import javax.servlet.jsp.tagext.Tag;

 

public class MyTag implements Tag  {

    private PageContext pageContext ;

    public void setPageContext(PageContext   pageContext) {

       this.pageContext = pageContext;

    }

    public int doStartTag() throws JspException {

       try {

           this.pageContext.getOut().write("Hello   Tag!"); 

       } catch (IOException e) {

           throw new JspException(e);

       }

       return 0 ;

    }

    public void setParent(Tag t) {}

    public Tag getParent() {return null;}

    public int doEndTag() throws JspException {return 0;}

    public void release() {  }

}

 mytld.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   web-jsptaglibrary_2_0.xsd"

    version="2.0">

 

    <description>xixi</description>

    <tlib-version>1.0</tlib-version>

    <jsp-version>2.0</jsp-version>

    <short-name>hello tag</short-name>

    <uri></uri>

    <small-icon></small-icon>

 

    <tag>

      <name>helloTag</name> 

      <tag-class>cn.itcast.tags.MyTag</tag-class>

      <body-content>empty </body-content>

    </tag>

</taglib>

 把mytld.tld文件放到/WEB-INF/classes/mytld.tld路径。

index.jsp

<%@taglib prefix="it"   uri="/WEB-INF/classes/mytld.tld" %>

……

<body>

    <h1><it:helloTag/> </h1>

</body>

4　标签的生命周期

　　在开始聊标签的生命周期之前，我们先来看看TLD的加载过程。

首次加载TLD文件

当index.jsp第一次被执行时，Tomcat会把index.jsp编译成index_jsp.java。在这个过程中，Tomcat会根据“<%@ taglib uir=”/WEB-INF/classes/mytld.tld”…%>”去加载mytld.tld文件。这个加载TLD文件的过程只执行一次，以后就不会再执行了。

 

实例化标签处理器对象

通过TLD找到标签的处理器类，然后实例化处理器对象，并把处理器对象放到“标签池”中。也就是说，每个标签的处理器类只会有一个实例！因为下一次访问这个标签就直接从池中获取处理器对象，而不需要再去创建了。

 

标签生命周期方法

l  调用setPageContext()方法，把当前页面的PageContext传递给标签处理器类；

l  调用setParent()方法，给标签器传递父标签。如果没有父标签就传递null；

l  在执行到开始标签时，调用doStartTag()方法，doStartTag()方法返回值：

  • 0（Tag.SKIP_BODY）：表示忽略标签体内容；
  • 1（Tag.EVAL_BODY_INCLUDE）：表示显示标签体内容；

l  在执行到标签标签时，调用doEndTag()方法，doEndTag()方法返回值：

  • 5（Tag.SKIP_PAGE）：表示忽略标签后面的页面东西；
  • 6（Tag.EVAL_PAGE）表示显示标签后面的页面东西。

l  release()方法会在重启Tomcat时被执行，即Tomcat从标签器池中移除标签时会调用这个方法。

必须实现Tag接口

添加PageContext属性

保存参数pageContext，在doStartTag()方法中方便使用。

使用pageContext获取输出流，然后使用流对象向浏览器打印Hello Tag!字符串。注意：如果没有在setPageContext()方法中保存参数，那么在doStartTag()方法中就会抛出空指针异常。

返回0表示不执行标签体。现在不用理会它！

这一部分是对当前标签库的声明！都是一些无需关心的东西。

l  当前标签库的描述；

l  当前标签库的版本；

l  支持JSP的版本；

l  标签库的名称（用于在工具上显示标签）；

l  uri：这个东西是有用的，后面再讲；

l  小图标也是为了在工具上显示用的；

标签的名称

标签处理类

标签体是空类型

it与taglib指令中的prefix对应；helloTag与tld文件中的<name>对应！

技术分享

SimpleTag

 1　SimpleTag是什么

标签处理类必须实现JspTag接口，而JspTag接口有两个子接口：Tag和SimpleTag。更加确切的说：标签处理类必须实现Tag或SimpleTag接口。

JSP2.0之后，SUN提供了SimpleTag接口，通过SimpleTag接口来实现标签处理类要比Tag这种传统方式方便很多，所以现在我们可以大声与Tag说再见了。

SimpleTag接口内容如下：

l  void doTag()：标签执行方法；

l  JspTag getParent()：获取父标签；

l  void setParent(JspTag parent)：设置父标签

l  void setJspContext(JspContext context)：设置PageContext

l  void setJspBody(JspFragment jspBody)：设置标签体对象；

2　继承SimpleTagSupport

public class HelloTag extends SimpleTagSupport {

    public void doTag() throws   JspException, IOException {

       this.getJspContext().getOut().write("<p>Hello   SimpleTag!</p>")[向页面输出！注意，不能向页面输出<%%>东西！] ;

    }

}

3　<body-content>

<body-content>元素的可选值有：

l  empty：不能有标签体内容。

l  JSP：标签体内容可以是任何东西：EL、JSTL、<%=%>、<%%>，以及html；但不建议使用Java代码段，SimpleTag已经不再支持使用<body-content>JSP</body-content>；

l  scriptless：标签体内容不能是Java代码段，但可以是EL、JSTL等；

l  tagdependent：标签体内容不做运算，由标签处理类自行处理，无论标签体内容是EL、JSP、JSTL，都不会做运算。

4 不执行标签下面的页面内容

我们知道，在使用Tag接口来编写标签时，可以跳过标签下面的JSP页面内容。在SimpleTag中也是可以的，这需要在doTag()方法中抛出SkipPageException。

SkipPageException是JspException的子类，当doTag()方法抛出该异常时，JSP真身不会打印异常信息，而是跳转页面内容！

5　带有属性的标签

l  在处理类中添加属性，以及getter/setter方法；

l  在TLD中部属相关属性。

　forEach

功能：模仿JSTL中的<c:forEach>标签。

forEach标签属性：

l  items：Object类型，可以是Collection、Map，或者数组（用到了数组反射）；

l  begin：Integer类型，表示从哪个下标位置开始遍历；

l  end：Integer类型，表示遍历到哪个下标位置结束；

l  var：String类型，使用var指定的值来保存当前项到PageContext中；

l  step：Integer类型，表示步长；

l  varStatus：String类型，使用varStatus的值来保存当前循环的循环状态。

jsp页面  设置一个集合

<%@ page language="java" import="java.util.*" pageEncoding="UTF-8"%>
<%@ taglib uri="http://www.itzl.com/myjstl/mytagTest" prefix="mytag"%>
<
<html>
  <head></head>
  <body>
     <%
    /* List list = new ArrayList();
    list.add("aaa");
    list.add("bbb");
    list.add("ccc");
    request.setAttribute("list", list); */
    /* Map map=new HashMap();
    map.put("a1", "qwe");
    map.put("a2", "asd");
    map.put("a3", "zxc");
    request.setAttribute("map", map);
    */ 
    int arr[]={1,2,3};
    request.setAttribute("arr", arr);
    %>
    <mytag:ForEach items="${arr}" var="v">
    ${v}
    </mytag:ForEach>

  </body>
</html>

实现

package cn.zl.web.el;

import java.io.IOException;
import java.lang.reflect.Array;
import java.util.ArrayList;
import java.util.Collection;
import java.util.Map;

import javax.servlet.jsp.JspException;
import javax.servlet.jsp.PageContext;
import javax.servlet.jsp.tagext.JspFragment;
import javax.servlet.jsp.tagext.SimpleTagSupport;

import cn.zl.web.jsp.VarStatuts;

public class ForEachSimpleTag extends SimpleTagSupport {

        private Integer begin;
        private Integer end;
        private Integer step;
        private Object items;
        private String var;
        private String varStatus;
        private Collection collection = new ArrayList(); 
        public void setBegin(Integer begin) {
            this.begin = begin;
        }
        public void setEnd(Integer end) {
            this.end = end;
        }
        public void setStep(Integer step) {
            this.step = step;
        }
        public void setItems(Object items) {
            this.items = items;
        }
        public void setVar(String var) {
            this.var = var;
        }
        public void setVarStatus(String varStatus) {
            this.varStatus = varStatus;
        }
        private Object[] toArray (Object items) throws JspException {
            if(items == null ) {
                throw new NullPointerException("items不存在！");
            }
            if(items instanceof Collection) {
                return ((Collection)items).toArray() ;
            } else if(items instanceof Map) {
                return ((Map)items).entrySet().toArray() ;
            } else if(items.getClass().isArray()) {
                //return (Object[])items ;
                int length = Array.getLength(items);//得到数组长度
                for (int i = 0; i < length; i++) {
                    //取数组中的每个元素
                    Object obj = Array.get(items, i);// 取第i个元素
                    collection.add(obj);//将数组中的元素加入到集合中
                    
            }
                return collection.toArray();
            }            
            throw new JspException("items不是数组，不是集合！") ;
        }
        public void doTag() throws JspException, IOException {
            Object[] objs = this.toArray(items) ;
            if(begin == null) {
                begin = 0;
            } 
            if(end == null) {
                end = objs.length - 1;
            } 
            if(step == null) {
                step = 1;
            } 
            PageContext pageContext = (PageContext) this.getJspContext();
            JspFragment body = this.getJspBody();
            for(int i = begin; i <= end; i+=step ) {
                Object item = objs[i];
                if(varStatus != null ) {
                    VarStatuts vs = new VarStatuts();
                    vs.setFirst(i == begin);
                    vs.setLast(i == end);
                    vs.setIndex(i);
                    vs.setCount(i+1);
                    vs.setCurrent(objs[i]) ;
                    pageContext.setAttribute(varStatus, vs) ;
                }
                if(var != null) {
                    pageContext.setAttribute(var, item); 
                }
                body.invoke(null); 
            }
            if(var != null) {
                pageContext.removeAttribute(var);
            }
            if(varStatus != null) {
                pageContext.removeAttribute(varStatus);
            } 
        }
    }

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">
    <description>A tag library exercising SimpleTag handlers.</description>
    <tlib-version>1.0</tlib-version>
    <short-name>mytag</short-name>
    <!--命名空间   （别名）-->
    <uri>http://www.itzl.com/myjstl/mytagTest</uri>
    <!-- el 自定义函数       -->
   
  <tag><!-- 配置文件 -->
        <name>ForEach</name>
        <tag-class>cn.zl.web.el.ForEachSimpleTag</tag-class>
        <body-content>scriptless</body-content>
        <attribute>
            <name>items</name><!-- 属性名称 -->
            <required>true</required><!-- 改属性是否必须，true代表必须 -->
            <rtexprvalue>true</rtexprvalue><!-- 是否支持表达式 -->
        </attribute>
        <attribute>
            <name>var</name><!-- 属性名称 -->
            <required>false</required><!-- 改属性是否必须，true代表必须 -->
            <rtexprvalue>false</rtexprvalue><!-- 是否支持表达式 -->
        </attribute>
    </tag>
   
</taglib>

 

 

 

EL的函数与标签

标签：

原文地址：http://www.cnblogs.com/lulu638/p/4257710.html
踩
(0)
赞
(0)
   
举报
评论 一句话评论（0）
登录后才能评论！
分享档案
更多>
2021年07月29日 (22)
2021年07月28日 (40)
2021年07月27日 (32)
2021年07月26日 (79)
2021年07月23日 (29)
2021年07月22日 (30)
2021年07月21日 (42)
2021年07月20日 (16)
2021年07月19日 (90)
2021年07月16日 (35)
周排行
mamicode.com排行更多图片
更多
友情链接
兰亭集智   国之画   百度统计   站长统计   阿里云   chrome插件   新版天听网
关于我们 - 联系我们 - 留言反馈
© 2014 mamicode.com 版权所有  联系我们:gaon5@hotmail.com
迷上了代码！