Як використовувати скоупи в ActiveRecord Rails

ActiveRecord — це потужний ORM (Object-Relational Mapping) для Ruby on Rails, який дозволяє розробникам легко взаємодіяти з базами даних. Однією з найкорисніших функцій ActiveRecord є скоупи. У цій статті ми розглянемо, що таке скоупи, як їх використовувати, а також надамо кілька прикладів, щоб ви могли легко впровадити їх у свої проекти.

Що таке скоупи?

Скоупи в ActiveRecord — це методи, які дозволяють вам визначати запити до бази даних, які можна повторно використовувати. Вони допомагають зберігати код чистим і організованим, а також полегшують читання запитів. Скоупи можуть бути використані для фільтрації, сортування та обробки даних.

Переваги використання скоупів

Зменшення дублювання коду.
Покращення читабельності запитів.
Легкість у тестуванні та підтримці.
Можливість комбінування скоупів для створення складних запитів.

Як створити скоупи

Створення скоупів в ActiveRecord є досить простим процесом. Вам потрібно просто визначити метод у вашій моделі, який повертає запит. Ось базовий приклад:

class Product < ApplicationRecord
  scope :available, -> { where(available: true) }
end

У цьому прикладі ми створили скоуп available, який повертає всі продукти, які доступні для покупки. Скоупи зазвичай використовують лямбда-функції (->), щоб забезпечити правильну обробку контексту.

Використання скоупів

Використання скоупів у вашому коді є дуже простим. Ви можете викликати скоупи так, як ви б викликали будь-який інший метод моделі:

available_products = Product.available

Цей код поверне всі доступні продукти з бази даних. Ви також можете комбінувати скоупи для створення більш складних запитів.

Комбінування скоупів

Однією з найпотужніших функцій скоупів є можливість їх комбінування. Ви можете викликати кілька скоупів один за одним, щоб отримати більш специфічні результати. Ось приклад:

class Product < ApplicationRecord
  scope :available, -> { where(available: true) }
  scope :cheap, -> { where('price < ?', 10) }
end

cheap_available_products = Product.available.cheap

У цьому прикладі ми спочатку отримуємо всі доступні продукти, а потім фільтруємо їх, щоб залишити лише ті, що коштують менше 10 одиниць валюти.

Скоупи з параметрами

Скоупи також можуть приймати параметри, що робить їх ще більш гнучкими. Ось приклад скоупу, який приймає параметр:

class Product < ApplicationRecord
  scope :priced_above, ->(price) { where('price > ?', price) }
end

expensive_products = Product.priced_above(100)

У цьому прикладі ми створили скоуп priced_above, який приймає ціну як параметр і повертає всі продукти, які коштують більше вказаної суми.

Скоупи з порядком сортування

Ви також можете використовувати скоупи для визначення порядку сортування результатів. Ось приклад:

class Product < ApplicationRecord
  scope :ordered_by_price, -> { order(price: :asc) }
end

sorted_products = Product.ordered_by_price

Цей скоуп повертає всі продукти, відсортовані за ціною у зростаючому порядку.

Скоупи з обмеженнями

Скоупи можуть також включати обмеження на кількість результатів, які ви хочете отримати. Ось приклад:

class Product < ApplicationRecord
  scope :limited, ->(limit) { limit(limit) }
end

limited_products = Product.limited(5)

Цей скоуп повертає лише перші 5 продуктів з бази даних.

Скоупи для асоціацій

Скоупи також можуть бути використані для роботи з асоціаціями. Наприклад, якщо у вас є модель Order, яка має асоціацію з Product, ви можете створити скоуп для отримання всіх замовлень, які містять доступні продукти:

class Order < ApplicationRecord
  has_many :products

  scope :with_available_products, -> { joins(:products).merge(Product.available) }
end

orders_with_available_products = Order.with_available_products

Цей скоуп повертає всі замовлення, які містять доступні продукти.

Тестування скоупів

Тестування скоупів є важливою частиною процесу розробки. Ви можете використовувати RSpec або Minitest для тестування ваших скоупів. Ось приклад тесту для скоупу available:

RSpec.describe Product, type: :model do
  describe '.available' do
    it 'повертає лише доступні продукти' do
      available_product = Product.create(available: true)
      unavailable_product = Product.create(available: false)

      expect(Product.available).to include(available_product)
      expect(Product.available).not_to include(unavailable_product)
    end
  end
end

Цей тест перевіряє, що скоуп available повертає лише доступні продукти.

Висновок

Скоупи в ActiveRecord — це потужний інструмент, який допомагає розробникам створювати чистий, організований і зрозумілий код. Вони дозволяють легко фільтрувати, сортувати та обробляти дані, а також зменшують дублювання коду. Використовуючи скоупи, ви можете значно спростити роботу з базою даних у ваших Rails-додатках.

Сподіваємося, що ця стаття допомогла вам зрозуміти, як використовувати скоупи в ActiveRecord. Тепер ви можете впроваджувати їх у свої проекти та покращувати якість свого коду!