异常教程

JSTL fn:contains()函数（手把手讲解）

更新时间:

💡一则或许对你有用的小广告

欢迎加入小哈的星球 ，你将获得：专属的项目实战 / 1v1 提问 / Java 学习路线 / 学习打卡 / 每月赠书 / 社群讨论

截止目前， 星球 内专栏累计输出 90w+ 字，讲解图 3441+ 张，还在持续爆肝中.. 后续还会上新更多项目，目标是将 Java 领域典型的项目都整一波，如秒杀系统, 在线商城, IM 即时通讯，权限管理，Spring Cloud Alibaba 微服务等等，已有 3100+ 小伙伴加入学习 ，欢迎点击围观

JSTL fn:contains()函数：字符串匹配的实用工具

在Web开发中，字符串处理是一个高频场景。无论是验证用户输入、解析URL参数，还是动态生成页面内容，开发者常常需要判断某个字符串是否包含特定子串。JSTL（JavaServer Pages Standard Tag Library）的fn:contains()函数，正是为了解决这类需求而设计的实用工具。本文将通过循序渐进的方式，结合实际案例，带您全面掌握这一函数的使用技巧。

一、函数基础：语法与核心逻辑

1.1 函数定义与参数解析

fn:contains()函数属于JSTL的fn标签库，其语法格式如下：

<%@ taglib prefix="fn" uri="http://java.sun.com/jsp/jstl/functions" %>
<c:set var="result" value="${fn:contains(source, substring)}" />
  • 参数说明：
    • source：待检测的原始字符串。
    • substring：需要匹配的子字符串。

该函数返回一个布尔值（true或false），表示substring是否存在于source中。例如：

<c:set var="text" value="Hello World" />
<c:if test="${fn:contains(text, 'World')}">
    <p>检测到目标子串！</p>
</c:if>

1.2 函数特性与注意事项

  • 大小写敏感：函数区分大小写，若需忽略大小写，可结合fn:toUpperCase()或fn:toLowerCase()使用。
  • 空值处理：若source或substring为null，函数将返回false。
  • 性能考量：对于超长字符串，建议先进行预处理（如截取关键段）以优化性能。

二、实战场景：从基础到进阶的应用

2.1 场景一：用户输入验证

假设需要检测用户提交的邮箱地址是否包含“@”符号：

<%-- 邮箱验证示例 --%>
<c:if test="${!fn:contains(email, '@')}">
    <div class="alert alert-danger">邮箱格式错误！缺少@符号</div>
</c:if>

2.2 场景二：URL参数解析

在处理动态URL时，可通过fn:contains()判断请求路径是否包含特定资源：

<%-- 判断当前页面是否为登录页 --%>
<c:if test="${fn:contains(pageContext.request.requestURI, '/login')}">
    <div class="login-banner">欢迎登录系统</div>
</c:if>

2.3 场景三：多条件组合判断

结合JSTL <c:choose>标签，实现复杂条件分支：

<%-- 根据用户角色显示不同菜单 --%>
<c:choose>
    <c:when test="${fn:contains(userRole, 'admin')}">
        <ul class="admin-menu">
            <!-- 管理员专属功能 -->
        </ul>
    </c:when>
    <c:when test="${fn:contains(userRole, 'guest')}">
        <ul class="guest-menu">
            <!-- 游客可见功能 -->
        </ul>
    </c:when>
    <c:otherwise>
        <p>未识别的用户角色</p>
    </c:otherwise>
</c:choose>

三、进阶技巧：与其它JSTL函数的协同

3.1 结合fn:split()处理字符串列表

当需要检测字符串是否存在于数组中时，可先用fn:split()拆分字符串，再逐个检查：

<%-- 检查用户权限列表是否包含"edit"权限 --%>
<c:set var="permissions" value="view,edit,delete" />
<c:set var="permissionList" value="${fn:split(permissions, ',')}" />
<c:forEach items="${permissionList}" var="perm">
    <c:if test="${fn:contains(perm, 'edit')}">
        <button>Edit</button>
    </c:if>
</c:forEach>

3.2 处理多语言国际化

在国际化（i18n）场景中，可结合<fmt:message>标签和fn:contains()实现动态内容切换：

<%-- 根据语言代码显示不同提示信息 --%>
<c:choose>
    <c:when test="${fn:contains(locale, 'zh')}">
        <fmt:message key="welcome.message" />
    </c:when>
    <c:otherwise>
        <fmt:message key="welcome.message.en" />
    </c:otherwise>
</c:choose>

四、常见问题与解决方案

4.1 问题：函数返回结果与预期不符

原因：可能因空格或特殊字符导致匹配失败
解决方案：使用fn:trim()去除空格，或通过fn:escapeXml()处理特殊字符：

<c:set var="cleanText" value="${fn:trim(inputText)}" />
<c:if test="${fn:contains(cleanText, 'search-term')}">
    <!-- 执行后续操作 -->
</c:if>

4.2 问题：如何实现模糊匹配？

建议：结合正则表达式使用fn:matches()函数：

<%-- 检测字符串是否符合邮箱格式 --%>
<c:if test="${fn:matches(email, '^[\\w-\\.]+@([\\w-]+\\.)+[\\w-]{2,4}$')}">
    <p>邮箱格式有效</p>
</c:if>

4.3 性能优化建议

  • 缓存结果：对重复使用的判断条件，可将结果存储在变量中复用： 
    <c:set var="hasAdminRole" value="${fn:contains(userRole, 'admin')}" />
<c:if test="${hasAdminRole}">
    <!-- 管理员专属逻辑 -->
</c:if>
  • 避免全表扫描：在处理大数据集时，优先在后端完成过滤，减少前端计算压力。

五、函数的适用场景与替代方案

5.1 主要适用场景

  • 表单验证：检测输入是否符合格式要求（如URL、电话号码）
  • 权限控制：基于角色字符串动态渲染页面元素
  • 内容过滤：在评论系统中屏蔽敏感词
  • 国际化支持：根据语言标识切换资源文件

5.2 替代方案对比

方法适用场景优势局限性
JSTL fn:contains()简单字符串匹配，前端逻辑处理语法简洁，无需Java代码不支持正则表达式
Java String.contains()复杂业务逻辑或需要类型安全的场景可结合其他字符串处理方法需要编写Java代码
正则表达式需要模式匹配或模糊查询的情况灵活度高，支持复杂规则语法复杂，学习成本较高

六、总结与实践建议

JSTL fn:contains()函数凭借其简洁的语法和直观的逻辑，成为JSP开发中处理字符串匹配的得力工具。通过本文的讲解，您已掌握其基础用法、进阶技巧及常见问题解决方案。在实际开发中，建议：

  1. 善用函数组合：结合fn:trim()、fn:split()等函数构建复杂逻辑
  2. 注重性能优化：对高频操作进行缓存或预处理
  3. 结合业务场景：根据需求选择JSTL函数或Java原生方法

掌握这一工具后，您可以更高效地完成用户输入验证、权限控制、内容过滤等任务，让JSP开发流程更加流畅。建议读者通过实际项目中的具体需求，进一步探索JSTL标签库的其他函数，逐步构建自己的字符串处理工具箱。

通过本文的系统讲解，希望开发者能对JSTL fn:contains()函数有全面的理解，并在实际开发中灵活运用这一功能。若需更深入的学习，可参考JSTL官方文档或相关开发案例，持续提升JSP开发技能。

最新发布

查看更多文章