006.JSTL自定义标签

在之前的JSTL的总结中已经对函数标签库进行了一些说明,在这里我再一次重新整理一下!
自带函数标签库介绍
引入该标签库的方法为：
<%@ taglib prefix="fn" uri="http://java.sun.com/jsp/jstl/functions" %>

函数名	函数说明	使用举例
fn:contains	判断字符串是否包含另外一个字符串
fn:containsIgnoreCase	判断字符串是否包含另外一个字符串(大小写无关)
fn:endsWith	判断字符串是否以另外字符串结束
fn:escapeXml	把一些字符转成XML表示，例如 <字符应该转为<	${fn:escapeXml(param:info)}
fn:indexOf	子字符串在母字符串中出现的位置	${fn:indexOf(name, "-")}
fn:join	将数组中的数据联合成一个新字符串，并使用指定字符格开	${fn:join(array, ";")}
fn:length	获取字符串的长度，或者数组的大小	${fn:length(shoppingCart.products)}
fn:replace	**替换 **字符串中指定的字符	${fn:replace(text, "-", "•")}
fn:split	把字符串按照指定字符切分	${fn:split(customerNames, ";")}
fn:startsWith	判断字符串是否以某个子串开始
fn:substring	截取子串	${fn:substring(zip, 6, -1)}
fn:substringAfter	获取从某个字符所在位置开始的子串	${fn:substringAfter(zip, "-")}
fn:substringBefore	获取从开始到某个字符所在位置的子串	${fn:substringBefore(zip, "-")}
fn:toLowerCase	转为小写	${fn.toLowerCase(product.name)}
fn:toUpperCase	转为大写	${fn.UpperCase(product.name)}
fn:trim	去除字符串前后的空格	${fn.trim(name)}

解释

• fn:contains(string, substring) 如果参数string中包含参数substring，返回true
• fn:containsIgnoreCase(string, substring) 如果参数string中包含参数substring（忽略大小写），返回true
• fn:endsWith(string, suffix) 如果参数 string 以参数suffix结尾，返回true
• fn:escapeXml(string) 将有特殊意义的XML (和HTML)转换为对应的XML character entity code，并返回
• fn:indexOf(string, substring) 返回参数substring在参数string中第一次出现的位置
• fn:join(array, separator) 将一个给定的数组array用给定的间隔符separator串在一起，组成一个新的字符串并返回。
• fn:length(item) 返回参数item中包含元素的数量。参数Item类型是数组、collection或者String。如果是String类型,返回值是String中的 字符数。
• fn:replace(string, before, after) 返回一个String对象。用参数after字符串替换参数string中所有出现参数before字符串的地方，并返回替换后的结果
• fn:split(string, separator) 返回一个数组，以参数separator 为分割符分割参数string，分割后的每一部分就是数组的一个元素
• fn:startsWith(string, prefix) 如果参数string以参数prefix开头，返回true
• fn:substring(string, begin, end) 返回参数string部分字符串, 从参数begin开始到参数end位置，包括end位置的字符
• fn:substringAfter(string, substring) 返回参数substring在参数string中后面的那一部分字符串
• fn:substringBefore(string, substring) 返回参数substring在参数string中前面的那一部分字符串
• fn:toLowerCase(string) 将参数string所有的字符变为小写，并将其返回
• fn:toUpperCase(string) 将参数string所有的字符变为大写，并将其返回
• fn:trim(string) 去除参数string 首尾的空格 ，并将其返回

自定义函数库

第一步 自定义类 和 方法（public +static）

    package com.pangsir.ty;
    public class TestFunction {
      /**
      *
      * 自定义类和方法 ，方法必须是public + static
      * @param name 
      * @return 
      */  
      public static String toTest(String name){
        return " 练习自定义函数, "+name;
      }
    }

注： toTest（）必须是 public static 的。

第二步 编写自定义 tld 文件，将此自定义tld文件放在WEB-INF或者WEB-INF的任意子目录下

    
    
    
    
      
      
      test own defined functions library
      test  functions
      
      1.0
      
      test
      
      http://codemihong.com/functions
      
      
       
       testFunction
       
       com.pangsir.ty.TestFunction
       
       java.lang.String toTest(java.lang.String)
      
     

说明：

1. 标签、、、、内容随意，注意这里设置的uri后面jsp中要引入。
2. 标签中的 标签在JSP中要作为函数名调用，这里的名字可以和实际的函数名一致，也可以不一致，可认为是实际函数名的别名。
3. 标签是 包名+类名 (自定义类)。
4. 是自定义函数的说明，如果是包装类型，需写完整路径；如果是基本数据类型，则不需要。如下又一示例所示：

     
        
          Returns the index withing a string of the first occurrence of a specified substring.
        
        indexOf
        org.apache.taglibs.standard.functions.Functions
        int indexOf(java.lang.String, java.lang.String)
        
          ${fn:indexOf(name, "-")}
        
      

补充说明:注册JSTL函数,若uri为/WEB-INF/xxx.tld，则无需再下面tomcat中注册

      
      
          
            http://codemihong.com/functions  
            /WEB-INF/myfunctions.tld  
          
      

第三步 在要使用自定义函数库的JSP页面中引入

<%@ taglib prefix="hp" uri="http://codemihong.com/functions" %>

第四步 使用：${前缀 + 冒号 + 函数的别名 }

    
    
测试JSTL--自定义函数库
      ${hp:testFunction("人总是需要向前看的") }
    

第五步 测试