Apache Commons Validator 1.11.0 介绍与选型指南

目标：基于 Apache 官方文档、Maven Central 与 GitHub 仓库联网溯源（查询日期 2026-10-18），介绍 Apache Commons Validator 1.11.0 的定位、核心架构、功能特性、官方示例与同类选型对比，帮助读者判断是否将其引入工程。

一、信息基准

本章为全文信息基准：所有版本号、发布时间、能力描述均来自下列官方来源，查询日期统一为 2026-10-18。

1.1 查询日期与版本依据

1.2 官方来源清单

• 项目主页：https://commons.apache.org/proper/commons-validator/
• 下载页：https://commons.apache.org/validator/download_validator.cgi
• 发布说明（Changes Report）：https://commons.apache.org/proper/commons-validator/changes.html
• Javadoc（routines 包）：https://commons.apache.org/proper/commons-validator/apidocs/org/apache/commons/validator/routines/package-summary.html
• Maven Central 构件：https://central.sonatype.com/artifact/commons-validator/commons-validator
• GitHub 只读副本：https://github.com/apache/commons-validator
• 版本对照数据：https://mvnrepository.com/artifact/commons-validator/commons-validator

二、软件概述

Apache Commons Validator 1.11.0（2026-07-31 发布，Apache License 2.0）是 Apache Commons 旗下的 Java 数据校验构件，官方定位是"为客户端与服务端数据校验提供构建积木"，既可独立使用，也可配合 Struts 等框架工作（来源：官网 Overview，2026-10-18）。它解决两类高频痛点：一是邮箱、URL、IP、日期、信用卡号、ISBN 等通用数据的正确性判断，二是同一数据在不同地区（Locale）下需要套用不同校验规则、输出不同错误消息的问题（来源：官网首页 "helps you with common issues… based on locale"）。

项目由 Apache Software Foundation 维护，属于 Commons 组件家族（Commons Proper），构件坐标 commons-validator:commons-validator，Maven Central 上被 2.1K 个上游构件引用，在 Validation Libraries 分类排名第 5（来源：mvnrepository.com，2026-10-18 实查）。GitHub 只读副本 apache/commons-validator 有 233 stars，最近一次代码推送为 2026-10-17（来源：GitHub API，2026-10-18 实查），社区活跃度属于"稳定维护、低热度"类型。

三、核心架构

3.1 两套能力：XML 校验引擎 + 可复用例程库

官网 Overview 明确 Validator 提供两组独立功能（来源：官网 index.html，2026-10-18）：

1. 可配置校验引擎：以 XML（validation.xml + validator-rules.xml）声明校验规则，将校验方法插接到引擎中，对 JavaBean 属性批量执行校验，支持按 Locale 选择规则集与错误消息。该机制源自 Struts 1 时代，与 JavaBean/反射体系绑定。
2. 可复用"原语"校验方法（routines 包）：一组无状态、线程安全的静态校验工具类，不依赖 XML 与 JavaBean，直接对字符串/数值做判断。这是当前使用的主流方式。

3.2 关键组件

官网 Usage 对引擎用法的三步约定：创建 Validator 实例 → 添加资源（如待校验 JavaBean）→ 调用 validate()；同一 ValidatorResources 下实例可复用，但同一时刻不得跨线程共享单个 Validator 实例（来源：官网 index.html，2026-10-18）。

四、功能特性

4.1 例程（routines）覆盖的数据类型

• 邮箱：EmailValidator（支持 RFC 风格校验、带/不带本地部分引号、域名校验可联动 DNS）。
• URL：UrlValidator（可配置允许的 scheme、 authority 校验开关）。
• IP 与域名：InetAddressValidator（IPv4/IPv6）、DomainValidator（含 IDN 国际化域名）。
• 日期/时间/日历：DateValidator、TimeValidator、CalendarValidator，支持按 Locale 与 pattern 解析、校验与格式化。
• 数字：IntegerValidator、LongValidator、FloatValidator、DoubleValidator、BigDecimalValidator、ByteValidator、ShortValidator、PercentValidator、CurrencyValidator。
• 业务编码：CreditCardValidator（卡号+Luhn 校验位）、ISBNValidator（ISBN-10/13）、ISSNValidator、CodeValidator 通用编码骨架。 （来源：routines 包 Javadoc 汇总，2026-10-18）

4.2 XML 校验引擎能力

• 规则与表单分离：validator-rules.xml 定义可插拔校验动作，validation.xml 将动作绑到 Bean 属性；
• 按 Locale 复用规则、区分错误消息；
• 支持常量校验（constant）、正则 var、掩码规则 mask 等；
• 与 Struts 1 的 ValidatorPlugIn 原生集成（历史能力，官方文档保留）。 （来源：官网 Validator Framework Javadoc package-description，2026-10-18）

4.3 近两版演进要点

• 1.10.0/1.10.1（2025 年）主要涉及 DomainValidator 表数据更新与缺陷修复；
• 1.11.0（2026-07-31）延续维护性修复与数据表更新，无破坏性 API 变更。 （来源：官网 changes.html 与 Maven Central 版本列表，2026-10-18 实查；逐条明细以官方 changes report 为准）

五、快速上手

以下示例均引自/转写自官方 Javadoc 与官网文档，未做本地运行，Maven 坐标以 Maven Central 实查为准。

5.1 Maven 依赖

<dependency>
    <groupId>commons-validator</groupId>
    <artifactId>commons-validator</artifactId>
    <version>1.11.0</version>
</dependency>

（来源：Maven Central 构件页 https://central.sonatype.com/artifact/commons-validator/commons-validator/1.11.0，查询日期 2026-10-18）

5.2 例程 API 最小示例（官方 Javadoc 转写）

import org.apache.commons.validator.routines.EmailValidator;
import org.apache.commons.validator.routines.UrlValidator;
import org.apache.commons.validator.routines.InetAddressValidator;
import org.apache.commons.validator.routines.DateValidator;

public class QuickCheck {
    public static void main(String[] args) {
        // 例程均为无状态单例用法（官方 Javadoc 推荐getInstance()）
        boolean okMail = EmailValidator.getInstance().isValid("user@example.com");
        boolean okUrl  = new UrlValidator(new String[]{"http", "https"})
                             .isValid("https://commons.apache.org/proper/commons-validator/");
        boolean okIp   = InetAddressValidator.getInstance().isValid("192.168.1.10");
        // 按 Locale 校验/解析日期
        java.util.Date d = DateValidator.getInstance()
                             .validate("2026-10-18", "yyyy-MM-dd", java.util.Locale.CHINA);
        System.out.println(okMail + " " + okUrl + " " + okIp + " " + (d != null));
    }
}

（API 形态依据：https://commons.apache.org/proper/commons-validator/apidocs/org/apache/commons/validator/routines/package-summary.html，查询日期 2026-10-18）

5.3 XML 校验引擎最小示例（官方用法转写）

import java.io.InputStream;
import org.apache.commons.validator.Validator;
import org.apache.commons.validator.ValidatorResources;
import org.apache.commons.validator.beanexample.LocaleBean; // 示意：换成自己的Bean

public class EngineCheck {
    public static void main(String[] args) throws Exception {
        try (InputStream in = EngineCheck.class
                .getResourceAsStream("/validation-example.xml")) {
            ValidatorResources resources = new ValidatorResources(in);
            // 1) 创建 Validator（绑定资源与form名）；2) 注入待校验Bean；3) validate()
            Validator v = new Validator(resources, "myForm");
            v.setParameter("java.lang.Object", new Object());
            v.validate();
        }
    }
}

规则文件骨架（validator-rules.xml + validation.xml 双文件结构见官方文档与示例工程，来源：官网 Validator Framework Javadoc）：

<form-validation>
  <formset>
    <form name="myForm">
      <field property="email" depends="required,email">
        <arg key="myForm.email.displayname"/>
      </field>
    </form>
  </formset>
</form-validation>

⚠️ 注意：XML 引擎依赖 commons-beanutils、commons-digester 等传递依赖（随 POM 自动引入）；新项目建议优先使用 5.2 的例程 API，XML 引擎主要服务于存量 Struts 1 体系。

六、适用场景与限制

适用场景

• 服务端表单数据清洗：邮箱、URL、IP、日期、数字、卡号、ISBN 等格式校验；
• 需要按 Locale 差异化日期/数字/货币规则的国际化应用；
• 网络设备/资产管理等系统中的 IP 段、域名合法性判断；
• 与自研规则引擎配合：把 RegexValidator/CodeValidator 当作规则原子件复用。

限制与注意

• 不做 JSR-303/380（Bean Validation）注解式声明校验，不能直接替换 Hibernate Validator 的注解体系；
• XML 校验引擎与 JavaBean、旧式 XML 配置强耦合，现代化框架（Spring Boot + Jakarta EE）中基本不再使用；
• 1.11.0 基线为 JDK 8，javax 命名空间时代构件，若项目全面 Jakarta 化需注意其无 Jakarta 迁移版（官方未发布 org.apache.commons 新坐标下的 Jakarta 变体，2026-10-18 于 Maven Central 实查）；
• 邮箱/域名校验只做语法层判断，邮件是否真实可达需另行验证。

七、同类选型对比

7.1 对比表

对比对象选取 Hibernate Validator（Bean Validation 参考实现）、Jakarta Bean Validation（规范 API）与自建校验工具类；数据查询日期 2026-10-18。

（stars 与推送时间来源：GitHub API / shields.io；版本来源：Maven Central 各构件 metadata，均为 2026-10-18 实查）

7.2 选型建议

一句话选型：做"数据本身对不对"的通用格式判断（邮箱/URL/IP/日期/卡号）选 Commons Validator；做"对象属性是否符合业务约束"的注解式声明校验（@NotNull/@Size/@Valid 级联）选 Hibernate Validator（依 Jakarta Bean Validation 3.1.1 规范）；两者互补而非互斥；仅在格式规则极少且可控时才值得自建校验工具类。

八、参考链接

1. 项目主页（含 Overview/Features/Usage）：https://commons.apache.org/proper/commons-validator/
2. routines 包 Javadoc：https://commons.apache.org/proper/commons-validator/apidocs/org/apache/commons/validator/routines/package-summary.html
3. 发布说明：https://commons.apache.org/proper/commons-validator/changes.html
4. Maven Central 构件页：https://central.sonatype.com/artifact/commons-validator/commons-validator
5. 版本/使用量统计：https://mvnrepository.com/artifact/commons-validator/commons-validator
6. GitHub 只读副本：https://github.com/apache/commons-validator
7. Hibernate Validator：https://hibernate.org/validator/
8. Jakarta Bean Validation：https://jakarta.ee/specifications/bean-validation/