怎样使用自定义标签简化 js、css 引入？

发布时间：2023-09-06 01:15责任编辑：傅花花关键词：js

国庆将至，工作兴致全无，来总结点项目里平时不起眼干货。

前端引入 js 、css 一般是这样：

<script type="text/javascript" src="webContent 相对路径"></script><link type="text/css" href="webContent 相对路径" rel="stylesheet"/> ?

简化后的 js 、css 引入姿势：

<fnc:script path="静态资源相对路径"/><fnc:style path="静态资源相对路径"/>

看起来是不是顺眼多了，自定义标签引入文件的方式，好处和扩展点还有很多，且听我慢慢道来。

该自定义标签基于 jsp-api，要没使用过 jsp 的同学，其实也没必要往下翻了，都挺忙的对吧。

1. 继承 TagSupport 设计标签处理类

javax.servlet.jsp.tagext.TagSupport 作为自定义标签核心关注类，实现了 IterationTag、Tag、JspTag 接口。

在实现的这些接口中，有些表示状态的常量需要介绍一下，这样你的理解会更明亮。

int SKIP_BODY = 0; //跳过了开始和结束标签之间的代码int EVAL_BODY_INCLUDE = 1;//需要处理标签体int SKIP_PAGE = 5;//忽略剩下的页面int EVAL_PAGE = 6;//继续输出下面的页面int EVAL_BODY_AGAIN = 2;//反复执行所处的方法

配上我这活动图和上述状态码然后结合接口方法，应该大体上明白 sun 底层对 jsp 标签整个处理流程了吧。

像 struts 的 <s:> 标签系列、webwork 的<ww:> 标签系列、JSTL 的 <s:> 标签系列等等...都是在上述流程下做的扩展。

好了，底层机制剖析结束，还是回归主题，继承 TagSupport 的自定义标签处理类如下。

public class StyleTag extends TagSupport { ???private String path; ???public StyleTag() { ???} ???public int doEndTag() throws JspException { ???????JspWriter writer = this.pageContext.getOut(); ???????String contextPath = this.pageContext.getRequest().getServletContext().getContextPath(); ???????try { ???????????if (StrUtil.isNotBlank(path)) { ???????????????if (this.path.startsWith("/")) { ???????????????????writer.write("<link rel=‘stylesheet‘ type=‘text/css‘ href=‘" + contextPath + "/static" + this.path + "‘/>"); ???????????????} else ???????????????????writer.write("<link rel=‘stylesheet‘ type=‘text/css‘ href=‘" + this.path + "‘/>"); ???????????} ???????} catch (Throwable var9) { ???????????System.out.println("Output style Error:" + var9.getMessage()); ???????} finally { ???????????this.path = null; ???????} ???????return TagSupport.EVAL_PAGE; ???} ??//....getter/setter}

我想做的事情比较简单，这里重写 doEndTag 方法就足够了，实际项目场景涉及复杂，这里就不进行描述了。

2. 编写 tld 标签库定义

当你想在 jsp 页面使用时还需要编写与后端处理类对应的 xml 标签定义。

<?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>项目核心标签库</description> ???<display-name>JSTL functions core</display-name> ???<tlib-version>1.1</tlib-version> ???<short-name>fnc</short-name> ???<uri>http://com.rambo.spm/core/tags</uri> ???<tag> ???????<description>简化css在页面的引入方式</description> ???????<name>style</name> ???????<tag-class>com.rambo.spm.core.tag.StyleTag</tag-class> ???????<body-content>empty</body-content> ???????<attribute> ???????????<description>css相对static的路径</description> ???????????<name>path</name> ???????????<required>true</required> ???????????<rtexprvalue>true</rtexprvalue> ???????</attribute> ???</tag></taglib>