Pull to refresh

Вышел релиз Rails 4.1. Некоторые тонкости переезда

Reading time 3 min
Views 17K
image
8 апреля в официальном блоге Ruby on Rails появилось сообщение об официальном выходе Rails 4.1. Весь функционал уместился в 5200 коммитов.

На хабре уже был обзор бета версии. Также можно почитать Release notes и A Guide for Upgrading Ruby on Rails.

В статье я бы хотел остановиться на некоторых тонкостях и деталях того, что под капотом.


Active Record Enums


class Conversation < ActiveRecord::Base
  enum status: [ :active, :archived ]
end

# conversation.update! status: 0
conversation.active!
conversation.active? # => true
conversation.status  # => "active"

# conversation.update! status: 1
conversation.archived!
conversation.archived? # => true
conversation.status    # => "archived"

# conversation.update! status: 1
conversation.status = "archived"

# conversation.update! status: nil
conversation.status = nil
conversation.status.nil? # => true
conversation.status      # => nil

Теперь мы имеем вот такой синтаксис для перечислений. Очень вкусно, очень удобно, но важно понимать несколько моментов.

1. Перечисление сохраняется как целое число в базе, но может быть получено по имени. (Enum values map to integers in the database, but can be queried by name).
Вот так будет выглядеть миграция примера выше:
create_table :conversations do |t|
  t.column :status, :integer
end

При этом в SQL-запросах тоже придется использовать целые числа:
where('status <> ? OR status <> ?', 0, 1)
where('status <> ? OR status <> ?', STATUS[:resolved], STATUS[:rejected])
Обратите внимание, что в даном случае STATUS — это константа класса, добавляемая макросом автоматически при создании перечисления.

2. Перечисление не использует ENUM тип, реализованный в некоторых в базах данных. Как следствие — нельзя изменять порядок значений в перечислении после создания записей в базе. Это приведет к путанице и конфликтам. Нельзя также просто удалить ненужное значение. Для этого соответствие между строковыми и численными значением должно быть задано явно.
class Bug < ActiveRecord::Base
  enum status: {
    new: 0,
    #removed status with id=1
    in_progress: 2,
    resolved: 3,
    rejected: 4,
    reopened: 5
  }
end

Получить этот хэш можно через Bug.statuses

3. Есть ограничения по именам значений перечисления.
Нельзя называть значения enum'ов именами существующих scopes, ассоциаций (что понятно) и уже существующих перечислений в рамках одной модели (что неочевидно). Например:
class Bug < ActiveRecord::Base
  enum status: [ :new, :closed ]
  enum code_review_status: [ :new, :finished ] # Так делать нельзя
end


Новое поведение Default scopes


Теперь default_scope по умолчанию влияет на все остальные scopes, если явно не указано обратное.
class User < ActiveRecord::Base
  default_scope { where state: 'pending' }
  scope :active, -> { where state: 'active' }
  scope :inactive, -> { where state: 'inactive' }
end

Теперь User.active будет эквивалентно User.where(state: 'pending').where(state: 'active'). Т.е. по умолчанию все scopes цепляются(chains) к default_scope.
Чтобы избежать этого нужно явно «отцепить» scope от default_scope с помощью unscope, except, rewhere:
class User < ActiveRecord::Base
  default_scope { where state: 'pending' }
  scope :active, -> { unscope(where: :state).where(state: 'active') }
  scope :inactive, -> { rewhere state: 'inactive' }
end


Расширенная CSRF защита.


Теперь по умолчанию CSRF защита включена и на get запросах с форматом .js.
Для честного разработчика есть два прикладных следствия из этого.
Во-первых, валятся все тесты, которые проверяли формирования правильного JS кода. Бороться с этим несложно.
Вместо
post :create, format: :js
Пишем
xhr :post, :create, format: :js
А во-вторых, если все-таки надо разрешить сторонним сайтам запрашивать js код, то надо явно указать это, добавив фильтр в контроллер:
skip_before_filter :verify_authenticity_token, only: [:stats, :visitor]

Ну и в каждом action надо добавить в заголовок ответа:
response.headers['Access-Control-Allow-Origin'] = '*'

Либо вместо звездочки указать имя сайта, которому разрешен доступ.



Пока это всё, с чем пришлось повозиться самому. Конечно же, функционал нового релиза Rails 4.1 гораздо шире. Но там как раз все вроде понятно, про это уже писали, к тому же, описание новой функциональности как всегда на высоте.
Но на всякий случай приведу список остальных Major Features:
  • Добавлен прелоадер Spring по умолчанию в новые проекты
  • Добавлен файл config/secrets.yml вместе с функционалом для хранения секретов приложений.
  • Action Pack Variants — возможность использования разных ответов для различных типов устройств (tablet, desktop, phone, etc.)
  • Action Mailer Previews — интеграция gem'а MailView в Rails — удобная работа с шаблонами писем.
  • Message Verifiers — обмен и проверка подлинности важных сообщений.
  • Module#concerning — удобное разделение ответственности между классами (честно говоря, я пока не нахожу ситуации, когда бы мне понадобилась эта функциональность)

Официально прекращена поддержка MySQL Server 4.1 (это если еще кто-то, кроме меня вынужден работать с этим раритетом). В реальности пока еще работает.
Tags:
Hubs:
+37
Comments 21
Comments Comments 21

Articles