ActiveData 开源项目教程
active_dataWorking with any data in AR style项目地址:https://gitcode.com/gh_mirrors/ac/active_data
项目介绍
ActiveData 是一个基于 ActiveModel 的前端数据处理工具。它适用于需要表单对象模式的场景,提供了完整对象生命周期支持、嵌入和引用关联、后端无关的命名作用域功能、回调、验证和脏属性等功能。ActiveData 通过模块化架构设计,支持多种属性和类型转换,使得数据处理更加灵活和高效。
项目快速启动
安装
首先,将以下代码添加到你的 Gemfile 中:
gem 'active_data'
然后执行:
$ bundle
或者手动安装:
$ gem install active_data
基本使用
以下是一个简单的示例,展示了如何定义和使用 ActiveData 模型:
require 'active_data'
class ProfileForm
include ActiveData::Model
attribute :first_name, type: String
attribute :last_name, type: String
end
profile = ProfileForm.new(first_name: 'John', last_name: 'Doe')
puts profile.first_name # 输出: John
puts profile.last_name # 输出: Doe
应用案例和最佳实践
表单对象模式
ActiveData 非常适合用于实现表单对象模式。通过定义模型和属性,可以轻松处理表单数据验证和处理逻辑。
class RegistrationForm
include ActiveData::Model
attribute :email, type: String
attribute :password, type: String
attribute :password_confirmation, type: String
validates :email, presence: true, format: { with: /\A[^@\s]+@[^@\s]+\z/ }
validates :password, presence: true, confirmation: true
end
form = RegistrationForm.new(email: 'test@example.com', password: 'password', password_confirmation: 'password')
puts form.valid? # 输出: true
嵌入式对象
ActiveData 支持嵌入式对象,可以方便地处理复杂的数据结构。
class Address
include ActiveData::Model
attribute :street, type: String
attribute :city, type: String
attribute :zip, type: String
end
class User
include ActiveData::Model
attribute :name, type: String
embeds_one :address
end
user = User.new(name: 'John Doe', address: { street: '123 Main St', city: 'Anytown', zip: '12345' })
puts user.address.street # 输出: 123 Main St
典型生态项目
ActiveData 可以与其他 Ruby on Rails 生态项目无缝集成,例如:
- ActiveRecord: 用于数据库操作,与 ActiveData 结合可以实现复杂的数据处理逻辑。
- RSpec: 用于测试,确保 ActiveData 模型的正确性和稳定性。
- RuboCop: 用于代码风格检查,保持代码的一致性和可读性。
通过这些生态项目的支持,ActiveData 可以更好地融入现有的开发流程,提高开发效率和代码质量。
active_dataWorking with any data in AR style项目地址:https://gitcode.com/gh_mirrors/ac/active_data