يمثل ActiveRecord حرف M (النموذج) في معمارية Rails MVC، حيث يغلف منطق العمل واستعلامات قاعدة البيانات والروابط وقواعد التحقق.
طرق الاستعلام
# دوال البحث الأساسية
User.find(1) # يثير RecordNotFound إذا لم يتم العثور عليه
User.find_by(email: '[email protected]')# يرجع nil إذا لم يتم العثور عليه
User.first
User.last
# الشروط والتصفية
User.where(active: true)
User.where.not(role: 'banned')
User.where('age >= ?', 18)
# الترتيب والتحديد
User.order(created_at: :desc).limit(10).offset(20)
# النطاقات (Scopes)
class User < ApplicationRecord
scope :active, -> { where(active: true) }
scope :recent, -> { order(created_at: :desc) }
end
العلاقات (Associations)
class Author < ApplicationRecord
has_many :books, dependent: :destroy
has_one :profile
has_many :reviews, through: :books
end
class Book < ApplicationRecord
belongs_to :author
has_and_belongs_to_many :genres
end
التحقق من الصحة (Validations)
class User < ApplicationRecord
validates :name, presence: true, length: { minimum: 2 }
validates :email, presence: true, uniqueness: { case_sensitive: false }, format: { with: URI::MailTo::EMAIL_REGEXP }
validates :age, numericality: { greater_than_or_equal_to: 13 }
validates :role, inclusion: { in: %w[admin member guest] }
end
ردود النداء (Callbacks)
class Order < ApplicationRecord
before_validation :normalize_currency
before_create :generate_tracking_code
after_create_commit :send_receipt_email
private
def normalize_currency
self.currency = currency.upcase
end
end
تتبع السمات المتغيرة (Dirty Attribute Tracking)
user = User.first
user.name = "New Name"
user.changed? # => true
user.changed # => ["name"]
user.changes # => {"name" => ["Old Name", "New Name"]}
user.name_was # => "Old Name"
التجميعات والحسابات (Aggregations & Calculations)
Order.count
Order.sum(:total_amount)
Order.average(:rating)
Order.maximum(:price)
Order.minimum(:price)