dry-validation 使用教程

dry-validation 使用教程

dry-validation Validation library with type-safe schemas and rules 项目地址: https://gitcode.com/gh_mirrors/dr/dry-validation

1. 项目介绍

dry-validation 是一个强大的数据验证库，专为 Ruby 设计。它提供了类型安全的模式和规则定义，使得数据验证过程更加简洁和高效。dry-validation 的核心优势在于其严格的、显式的数据模式与域验证逻辑的分离，这使得验证规则既类型安全又专注于验证逻辑本身，从而简化了代码并提高了可读性。

2. 项目快速启动

安装

首先，确保你已经安装了 Ruby。然后，通过 Gem 安装 dry-validation：

gem install dry-validation

基本使用

以下是一个简单的示例，展示了如何使用 dry-validation 定义一个基本的验证模式：

require 'dry-validation'

# 定义一个简单的验证模式
UserSchema = Dry::Validation.Schema do
  required(:name).filled(:str?)
  required(:age).filled(:int?, gt?: 18)
end

# 使用模式进行验证
result = UserSchema.call(name: 'John', age: 25)

# 检查验证结果
if result.success?
  puts "验证通过"
else
  puts "验证失败: #{result.errors.to_h}"
end

输出

验证通过

3. 应用案例和最佳实践

应用案例

dry-validation 广泛应用于需要严格数据验证的场景，例如：

• Web 应用表单验证：确保用户提交的数据符合预期格式和业务规则。
• API 输入验证：在接收外部数据时，确保数据的完整性和正确性。
• 数据导入/导出：在处理大量数据时，确保每条数据的格式和内容符合要求。

最佳实践

1. 分离模式和规则：将数据模式与验证规则分离，使得代码更清晰、易于维护。
2. 使用宏定义：通过定义宏来减少重复代码，提高代码的可重用性。
3. 依赖注入：利用 dry-validation 的依赖注入功能，使得验证逻辑更加灵活和可扩展。

4. 典型生态项目

dry-validation 是 dry-rb 生态系统的一部分，与其相关的项目包括：

• dry-schema：提供数据模式定义和类型检查功能。
• dry-types：定义和使用自定义数据类型。
• dry-struct：用于定义具有严格类型检查的结构体。

这些项目共同构成了一个强大的工具集，适用于需要严格类型检查和数据验证的 Ruby 应用。

---

通过本教程，你应该已经掌握了 dry-validation 的基本使用方法，并了解了其在实际应用中的最佳实践和相关生态项目。希望这能帮助你在项目中更好地使用 dry-validation。

dry-validation Validation library with type-safe schemas and rules 项目地址: https://gitcode.com/gh_mirrors/dr/dry-validation