dOOv：Java 数据验证与映射库（简化业务逻辑）

dOOv 是一个为 Java 开发人员设计的轻量化库，专注于数据验证和对象间的映射。与传统的验证框架不同，dOOv 通过提供简洁、声明式的 API，使得开发者可以轻松地编写、扩展和维护验证和映射规则。其设计灵感源自领域驱动设计（DDD），非常适合复杂业务场景下的验证需求。本文将通过示例代码、功能列表和用例分析，全面介绍 dOOv 的核心功能。

💯 dOOv 的优势

• 声明式验证与映射：通过简洁的 API 构建复杂的验证与映射规则，使代码更易读、易维护。
• 强类型安全：dOOv 使用 Java 泛型确保类型安全，从而减少运行时错误。
• 灵活可扩展：开发者可以通过扩展库内已有功能，自定义规则和映射。
• 适用于复杂业务场景：特别适合金融、保险、电子商务等需要多层次数据验证与对象映射的复杂领域。
• 验证结果报告：生成详尽的验证报告，帮助开发人员快速定位问题。
• 领域驱动设计支持：完美契合基于 DDD 的项目架构，使得业务逻辑与验证规则紧密结合。

💯 dOOv 的基础使用

1. 声明式验证

dOOv 的验证通过流式 API 实现，开发者可以方便地对对象进行属性验证。下面展示一个简单的用户信息验证示例：

import static org.dooov.sample.validation.dsl.DSL.*;public class ValidationExample {public static void main(String[] args) {// 验证规则：firstName 不能为空且年龄大于18岁ValidationRule rule = when(field(User::getFirstName).notNull().and(field(User::getAge).greaterOrEquals(18))).validate();User user = new User("John", 20);// 执行验证ValidationResult result = rule.executeOn(user);if (result.isValid()) {System.out.println("验证通过");} else {System.out.println("验证失败: " + result.getFailureCause());}}
}

在上述代码中，我们定义了一个 User 类，并为其属性 firstName 和 age 设置验证规则。该验证规则要求 firstName 不能为空，且 age 必须大于等于 18 岁。

2. 对象映射

dOOv 的映射功能让开发者可以轻松实现对象间的属性复制。以下示例展示了如何将一个 User 对象的属性映射到 UserDTO 对象：

import static org.dooov.sample.mapping.dsl.DSL.*;public class MappingExample {public static void main(String[] args) {User sourceUser = new User("John", 20);UserDTO targetDTO = new UserDTO();MappingRule mappingRule = map(field(User::getFirstName)).to(field(UserDTO::setFirstName)).and(map(field(User::getAge)).to(field(UserDTO::setAge)));// 执行映射mappingRule.executeOn(sourceUser, targetDTO);System.out.println("DTO 映射结果: " + targetDTO.getFirstName() + ", " + targetDTO.getAge());}
}

这个映射例子中，我们将 User 对象的 firstName 和 age 映射到目标对象 UserDTO 上。通过 dOOv 的 map() 方法，轻松实现对象间的数据传输。

💯 dOOv 高级功能

1. 复杂验证逻辑

dOOv 支持定义多层次复杂验证逻辑，允许开发者使用逻辑运算符（AND/OR）构建嵌套规则。以下示例展示了如何结合多个条件进行验证：

import static org.dooov.sample.validation.dsl.DSL.*;public class ComplexValidationExample {public static void main(String[] args) {ValidationRule complexRule = when(field(User::getFirstName).notNull().and(field(User::getAge).greaterOrEquals(18)).or(field(User::getEmail).matches("^(.+)@(.+)$"))  // 验证邮箱格式).validate();User user = new User("John", null, "john@example.com");ValidationResult result = complexRule.executeOn(user);if (result.isValid()) {System.out.println("用户信息验证通过");} else {System.out.println("用户信息验证失败: " + result.getFailureCause());}}
}

在此示例中，dOOv 结合了 AND/OR 条件，允许用户通过 firstName 和 age 或邮箱格式的验证。

2. 自定义验证规则

dOOv 支持用户根据业务需求自定义验证规则，提供了极大的灵活性。以下是一个创建自定义年龄验证规则的例子：

public class CustomValidationRule {public static ValidationRule isAdult() {return when(field(User::getAge).greaterOrEquals(18)).validate();}public static void main(String[] args) {User user = new User("Anna", 16);ValidationRule rule = isAdult();ValidationResult result = rule.executeOn(user);if (result.isValid()) {System.out.println("用户是成年人");} else {System.out.println("用户未成年");}}
}

这个自定义规则用于验证用户是否成年，开发者可以将其复用于多个场景中，简化代码结构。

3. 自定义映射逻辑

除了默认的映射功能，dOOv 也支持创建自定义的映射逻辑。以下展示如何扩展 dOOv 映射规则：

import static org.dooov.sample.mapping.dsl.DSL.*;public class CustomMappingExample {public static void main(String[] args) {User sourceUser = new User("John", "Doe", 25);UserDTO targetDTO = new UserDTO();MappingRule customMappingRule = map(field(User::getFirstName)).to(field(UserDTO::setFirstName)).and(map(field(User::getLastName)).to((source, target) -> {target.setFullName(source.getFirstName() + " " + source.getLastName());})).and(map(field(User::getAge)).to(field(UserDTO::setAge)));customMappingRule.executeOn(sourceUser, targetDTO);System.out.println("映射结果: " + targetDTO.getFullName() + ", 年龄: " + targetDTO.getAge());}
}

在这个例子中，我们自定义了 LastName 映射逻辑，将 FirstName 和 LastName 组合成 FullName 并赋值给目标对象 UserDTO。

💯 dOOv 的特性与使用场景

特性	描述	示例代码
流式 API	使用流式 API 创建验证和映射规则，代码清晰简洁。	when(field(User::getFirstName).notNull())
验证逻辑	定义复杂的验证规则，比如非空、数值范围、字符串长度等。	field(User::getAge).greaterOrEquals(18)
对象映射	支持对象间的映射，可以轻松地将一个对象的属性复制到另一个对象中。	map(field(User::getFirstName)).to(field(UserDTO::setFirstName))
自定义规则	可以根据业务需求，扩展库中的验证和映射规则。	CustomRule customRule = new CustomRule();
强类型安全	通过泛型和类型检查，确保在编译时检测到错误，减少运行时异常。	-
领域驱动设计支持	dOOv 基于领域驱动设计的思想，特别适用于复杂的业务场景，比如用户输入验证、订单管理等。	-
报告生成	生成详细的验证报告，包含失败原因和通过的验证条件。	ValidationResult result = rule.executeOn(user);
自定义映射逻辑	可以创建自定义映射规则，将多个源对象属性映射到目标对象。	map((source, target) -> {...})

💯 dOOv 的实际应用场景

• 用户输入表单验证：dOOv 可以用来验证前端输入的表单数据，比如用户注册或登录时的基本信息。
• 订单管理系统：在电子商务系统中，可以使用 dOOv 来验证订单的正确性，如订单金额、库存是否充足等。
• 复杂对象映射：适用于 DTO 转换、对象数据迁移等场景，特别是在需要跨系统或数据库进行数据同步时。

📥 下载地址

dOOv 最新版 下载地址

💬 结语

dOOv 是一个简洁而强大的 Java 数据验证与映射库，提供了流畅的 API 和灵活的扩展性，适合各类业务场景中的数据验证和映射需求。从简单的属性验证到复杂的对象映射，dOOv 都能提供可靠的解决方案。

📒 参考文献

• dOOv 官网
• dOOv GitHub仓库