ActiveData 开源项目教程

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