JSP标签库Taglib之自定义function篇，轻松实现日期格式化

一、什么是Taglib？

如果你曾使用JSP页面来作为渲染视图的话，我相信你对JSTL标签库一定不会感到陌生。

比如：

1.forEach代码片段

<c:forEach var="i" begin="1" end="5">
   Item <c:out value="${i}"/><p>
</c:forEach>

2.formatNumber 代码片段

<fmt:formatNumber type="number" pattern="###.###E0" value="${balance}" />

3.fn:length代码片段

${fn:length(string1)}

在我写代码的过程中，以上三种类型的JSTL标签使用频率最高。

它们分别是

1. 核心标签
2. 格式化标签
3. JSTL函数

JSTL标签库可通过以下方式进行导入。

<%@ taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core"%>
<%@ taglib prefix="fmt" uri="http://java.sun.com/jsp/jstl/fmt" %>

标签库（tag library），是指由在JSP页面中使用的标记所组成的库。JSP容器推出时带有一个小型的、默认的标记库。JSTL是其中一种，最为常用。

二、自定义function

但在实际的应用当中，JSTL并不能完全满足我们的需求，所以我们要能够实时的对其进行扩展。

有这样一种场景。

1.数据库中更新日期的数据格式（bigint型，13位长度。）如下：

`update_date` bigint(13) NOT NULL DEFAULT '0' COMMENT '更新时间',

2.对应的Java类中的格式（Long ）为：

protected Long update_date;
public Long getUpdate_date() {
    return update_date;
}

public void setUpdate_date(Long update_date) {
    this.update_date = update_date;
}

3.JSP页面中显示的格式为：

这种情况下，JSTL就“黔驴技穷”了，我们需要新增一种function来实现它。

第一步，Java端新建格式化方法

package com.cmower.common.util;

public class DateUtil {

    public static final String PATTERN_STANDARD = "yyyy-MM-dd HH:mm:ss";

    public static String formatTime(Long time) {
        if (time == null) {
            return " - ";
        }
        if (time == 0L) {
            return "  - ";
        }

        Date date = new Date(time);
        SimpleDateFormat formatter = new SimpleDateFormat(PATTERN_STANDARD);
        return formatter.format(date);
    }
}

第二步，把formatTime方法的使用权限传递给JSP页面

首先，新建fns.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>server function library</description>
    <tlib-version>1.0</tlib-version>
    <short-name>fns</short-name>
    <uri>http://localhost/fns</uri>

    <function>
        <description>转码long型日期值</description>
        <name>formatTime</name>
        <function-class>com.cmower.common.util.DateUtil</function-class>
        <function-signature>java.lang.String formatTime(java.lang.Long)</function-signature>
        <example>${fns:formatTime(long)}</example>
    </function>

</taglib>

1. <short-name>fns</short-name>定义该taglib的前缀为fns；
2. <name>formatTime</name>定义该taglib的function名为formatTime；
3. <function-class>com.cmower.common.util.DateUtil</function-class>function的类名；
4. <function-signature>java.lang.String formatTime(java.lang.Long)</function-signature>function关联Java端的方法名。

然后，我需要把该自定义标签库导入到对应的JSP页面中：

<%@ taglib prefix="fns" uri="/WEB-INF/tlds/fns.tld" %>

通过以下代码调用它：

${fns:formatTime(update_date)}

通过以上步骤就能够完成自定义Taglib了，小技能，大功效。

从前日色变得慢，一生只够爱一人。微信扫一扫，关注沉默王二公众号。