ActiveRecord – Rails 中的对象关系映射

ActiveRecord 将类连接到关系数据库表，为应用程序建立一个几乎零配置的持久层。该库提供了一个基类，当子类化时，会在新类和数据库中的现有表之间设置映射。在应用程序上下文中，这些类通常被称为模型。模型还可以连接到其他模型；这可以通过定义关联来完成。

ActiveRecord 严重依赖于命名，因为它使用类和关联名称来建立各个数据库表和外键列之间的映射。虽然这些映射可以明确定义，但建议遵循命名约定，尤其是在开始使用该库时。

您可以在ActiveRecord 基础知识指南中阅读有关 ActiveRecord 的更多信息。

一些主要功能的简要概述

类和表、属性和列之间的自动映射。
```
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的内置支持。

对 Log4r 和 Logger 的日志记录支持。

ActiveRecord::Base.logger = ActiveSupport::Logger.new(STDOUT)
ActiveRecord::Base.logger = Log4r::Logger.new('Application Log')

使用迁移进行与数据库无关的架构管理。

class AddSystemSettings < ActiveRecord::Migration[7.1]
  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

了解更多信息