Active Record – Rails 中的对象关系映射
Active Record 将类连接到关系数据库表,为应用程序建立几乎零配置的持久层。该库提供一个基类,当被子类化时,会设置新类与数据库中现有表之间的映射。在应用程序的上下文中,这些类通常被称为**模型**。模型也可以连接到其他模型;这是通过定义**关联**来完成的。
Active Record 很大程度上依赖于命名,因为它使用类和关联名称来建立各自数据库表和外键列之间的映射。尽管这些映射可以明确定义,但建议遵循命名约定,尤其是在开始使用该库时。
您可以在Active Record 基础指南中阅读有关 Active Record 的更多信息。
一些主要功能的简要概述
-
类和表、属性和列之间的自动映射。
class Product < ActiveRecord::Base end
Product 类会自动映射到名为“products”的表,可能如下所示
CREATE TABLE products ( id bigint NOT NULL auto_increment, name varchar(255), PRIMARY KEY (id) );
这也将定义以下访问器:
Product#name
和Product#name=(new_name)
。 -
通过简单的类方法定义的对象之间的关联。
class Firm < ActiveRecord::Base has_many :clients has_one :account belongs_to :conglomerate end
-
值对象的聚合。
class Account < ActiveRecord::Base composed_of :balance, class_name: 'Money', mapping: %w(balance amount) composed_of :address, mapping: [%w(address_street street), %w(address_city city)] end
-
验证规则,对于新对象或现有对象可能有所不同。
class Account < ActiveRecord::Base validates :subdomain, :name, :email_address, :password, presence: true validates :subdomain, uniqueness: true validates :terms_of_service, acceptance: true, on: :create validates :password, :email_address, confirmation: true, on: :create end
-
适用于整个生命周期的回调(实例化、保存、销毁、验证等)。
class Person < ActiveRecord::Base before_destroy :invalidate_payment_plan # the `invalidate_payment_plan` method gets called just before Person#destroy end
-
继承层次结构。
class Company < ActiveRecord::Base; end class Firm < Company; end class Client < Company; end class PriorityClient < Client; end
-
事务。
# Database transaction Account.transaction do david.withdrawal(100) mary.deposit(100) end
-
对列、关联和聚合的反射。
reflection = Firm.reflect_on_association(:clients) reflection.klass # => Client (class) Firm.columns # Returns an array of column descriptors for the firms table
-
通过简单的适配器进行数据库抽象。
# connect to SQLite3 ActiveRecord::Base.establish_connection(adapter: 'sqlite3', database: 'dbfile.sqlite3') # connect to MySQL with authentication ActiveRecord::Base.establish_connection( adapter: 'mysql2', host: 'localhost', username: 'me', password: 'secret', database: 'activerecord' )
了解更多,并阅读有关对 MySQL、PostgreSQL 和 SQLite3 的内置支持。
-
ActiveRecord::Base.logger = ActiveSupport::Logger.new(STDOUT) ActiveRecord::Base.logger = Log4r::Logger.new('Application Log')
-
使用迁移进行与数据库无关的模式管理。
class AddSystemSettings < ActiveRecord::Migration[8.0] def up create_table :system_settings do |t| t.string :name t.string :label t.text :value t.string :type t.integer :position end SystemSetting.create name: 'notice', label: 'Use notice?', value: 1 end def down drop_table :system_settings end end
理念
Active Record 是 Martin Fowler 描述的同名对象关系映射 (ORM) 模式 的实现
“一个包装数据库表或视图中的一行的对象,封装数据库访问,并在此数据上添加域逻辑。”
Active Record 试图提供一个连贯的包装器,作为解决对象关系映射不便之处的方案。此映射的首要指令是最大限度地减少构建真实世界域模型所需的代码量。这可以通过依靠一些约定来实现,这些约定使 Active Record 能够从最少的明确指示中推断出复杂的关系和结构。
约定优于配置
-
没有 XML 文件!
-
大量的反射和运行时扩展
-
魔法本身并不一定是坏词
承认数据库
-
允许您在特殊情况下和性能方面下降到 SQL
-
不试图复制或替换数据定义
下载和安装
Active Record 的最新版本可以使用 RubyGems 安装
$ gem install activerecord
源代码可以作为 GitHub 上的 Rails 项目的一部分下载
许可证
Active Record 在 MIT 许可下发布
支持
API 文档位于
Ruby on Rails 项目的错误报告可以在这里提交
功能请求应在以下位置的 rails-core 邮件列表中讨论