Привет, коллеги-разработчики! Сегодня мы собираемся углубиться в одну из интересных функций, представленных в Rails 7: метод create_enum. Если вы когда-либо работали с перечислениями в Rails, вы знаете, что их определение и управление ими может быть немного громоздким. Но не бойтесь, Rails 7 приходит на помощь с фантастическим решением!

Прежде чем мы перейдем к коду, давайте кратко вспомним, что такое перечисления. Перечисления — это способ представления фиксированного набора значений для определенного атрибута в ваших моделях Rails. Они обеспечивают удобный и понятный способ работы с предопределенными параметрами. Традиционно для достижения этой функциональности разработчики Rails полагались на целочисленные перечисления или строковые константы.

В предыдущих версиях Rails определение перечислений требовало написания большого количества кода и поддержки отдельных таблиц поиска. Однако в Rails 7 представлен метод create_enum, который значительно упрощает процесс. Давайте посмотрим, как это работает:

# Migration file
class AddStatusToOrders < ActiveRecord::Migration[7.0]
  def change
    create_enum :order_status, %w[open shipped delivered cancelled]
    add_column :orders, :status, :order_status, default: 'open'
  end
end
# Model file
class Order < ApplicationRecord
  enum status: {
    open: 'open',
    shipped: 'shipped',
    delivered: 'delivered',
    cancelled: 'cancelled'
  }
end

С помощью метода create_enum мы можем определить наше перечисление непосредственно в файле миграции. Мы передаем имя перечисления (в данном случае :order_status) и массив возможных значений (%w[open shipped delivered cancelled]). Это создает новый тип перечисления в базе данных и автоматически генерирует набор констант, которые мы можем использовать в наших моделях.

Затем при миграции мы добавляем новый столбец в таблицу «заказы» типа :order_status. Мы установили значение по умолчанию 'open', которое будет использоваться, если другое значение явно не назначено.

В модели мы определяем перечисление, используя знакомый метод enum. Мы предоставляем хэш, ключами которого являются значения перечисления (open, shippedи т. д.), а значениями — соответствующие значения базы данных (9, 'shipped'и т. д.). Это позволяет нам использовать значения перечисления непосредственно в нашем коде, что делает его более читабельным и менее подверженным ошибкам.

order = Order.new(status: :open)
order.open?        # => true
order.status       # => "open"
order.status = :shipped
order.shipped?     # => true
order.status       # => "shipped"
order.status = :invalid_status
# Raises ArgumentError: 'invalid_status' is not a valid status
Order.statuses
# Returns a hash of all the possible enum values and their corresponding database values
# { "open" => "open", "shipped" => "shipped", "delivered" => "delivered", "cancelled" => "cancelled" }