Ruby On Rails
2026-02-26 17:18 Diff
https://ru.hexlet.io/courses/rails-basics/lessons/crud/theory_unit

Несмотря на огромное число разнообразных сайтов, практически всю веб-разработку можно свести к CRUD-операциям. В этом уроке мы познакомимся с ними подробнее.

Что такое CRUD

CRUD — это широко распространенный термин, означающий четыре стандартные операции над любой сущностью. Рассмотрим такой пример для статей:

  • Создание (Create) — добавление новой статьи.
  • Чтение (Read) — просмотр статьи пользователями сайта или в административном интерфейсе.
  • Обновление (Update) — редактирование содержимого статьи, изменение заголовка или категории.
  • Удаление (Delete) — удаление статьи из базы данных.

Точно так же можно расписать действия над любыми другими ресурсами: комментариями к статьям, тегами, авторами и так далее. Чтобы создать полный CRUD для статей, нужно выполнить следующие действия:

  • Создать сущность в коде (как правило, это класс).
  • Добавить таблицу в базу данных для хранения статей.
  • Написать тесты для проверки обработчиков статей.
  • Добавить обработчики для выполнения CRUD операций.
  • Добавить шаблоны для отображения статей на сайте.

Ниже мы пройдемся по всему процессу создания CRUD статьи (сущность Article).

Начнем с роутинга. Полный CRUD для статей включает минимум семь маршрутов:

Такое соглашение об именовании маршрутов изначально появилось в Ruby On Rails, а затем его адаптировали во многих других.

Ресурсный роутинг — это механизм в Ruby on Rails, который позволяет легко создавать маршруты для стандартных операций CRUD (Создание, Чтение, Обновление, Удаление) для ресурсов, таких как модели. Он значительно упрощает процесс определения маршрутов, так как автоматически создает все необходимые маршруты для работы с ресурсами.

Командой bin/rails g resource мы можем создать новый ресурс и полный набор файлов и кода, необходимых для работы с ресурсом. Давайте разберем, что именно делает эта команда и какие файлы она создает.

  • bin/rails: Это исполняемый файл Rails, который запускает команды в вашем приложении.
  • g: Сокращение от "generate", команда для генерации кода.
  • resource: Указывает, что мы хотитим создать ресурс, который будет включать в себя маршруты, контроллер, представления и миграции.
  • article: Имя ресурса, в данном случае это Article.
  • title:string body:text: Это атрибуты, которые будут добавлены к модели Article. Здесь title будет строковым полем, а body — текстовым полем.

При выполнении этой команды Rails создаст следующие файлы и изменения:

  1. Миграция: Создается файл миграции в db/migrate, который будет содержать код для создания таблицы articles с полями title и body.

    Пример миграции:

  2. Модель: Создается файл модели app/models/article.rb, который будет представлять сущность Article.

    Пример модели:

  3. Контроллер: Создается контроллер app/controllers/articles_controller.rb, который будет обрабатывать запросы, связанные с ресурсом Article.

  4. Представления: Создается директория app/views/articles, в которой будут находиться шаблоны представлений для действий контроллера (index, show, new, edit).

  5. Маршруты: В файл config/routes.rb будет добавлена строка для ресурсного роутинга:

Команда генерации упрощает процесс создания нового ресурса в приложении Ruby on Rails, автоматически генерируя все необходимые компоненты для работы с сущностью. После выполнения этой команды останется только выполнить миграцию базы данных с помощью bin/rails db:migrate и начать использовать созданный ресурс.

Модель была создана пустой, мы можем добавить в нее валидацию присутствия полей:

После генерации ресурса Article с помощью команды bin/rails g resource articles title:string body:text, у нас есть все необходимые компоненты для работы с CRUD операциями. Давайте подробнее рассмотрим каждую из них.

Создание (Create)

Создание новой статьи начинается с отображения формы для ввода данных. Когда пользователь заполняет форму и отправляет ее, данные передаются на сервер с помощью POST-запроса.

Пример метода create в контроллере:

В этом методе мы создаем новый объект Article, используя параметры, полученные из формы с помощью Strong Params. Strong Parameters — это механизм в Ruby on Rails, который помогает защитить приложение от уязвимостей, связанных с массовым присвоением (mass assignment). Он позволяет явно указывать, какие параметры могут быть использованы для создания или обновления объектов, что предотвращает возможность изменения нежелательных атрибутов.

Форма для создания новой статьи отображается на странице, когда пользователь переходит по маршруту GET /articles/new. В контроллере ArticlesController метод new отвечает за инициализацию нового объекта Article и отображение формы.

После выполнения метода new(), Rails автоматически рендерит шаблон app/views/articles/new.html.erb, который содержит форму для создания новой статьи:

Здесь Используется хелпер form_with, который создает форму для объекта @article. Если при валидации возникли ошибки, они будут отображены в верхней части формы, что позволяет пользователю увидеть, что нужно исправить. Поля формы (title и body) автоматически связываются с атрибутами объекта @article.

Если сохранение прошло успешно, происходит перенаправление на страницу статьи. В противном случае отображается форма с ошибками.

Чтение (Read)

Чтение статей включает в себя два действия: отображение списка всех статей и просмотр конкретной статьи.

Пример метода index:

Переменная @articles будет доступна в представлении, что позволяет отобразить список статей.

Пример метода show:

Метод index получает все статьи из базы данных и передает их в представление. Метод show находит конкретную статью по ID и также передает ее в представление.

Обновление (Update)

Обновление статьи начинается с отображения формы редактирования, которая заполняется текущими данными статьи. После внесения изменений и отправки формы данные передаются на сервер с помощью PATCH или PUT-запроса.

Пример метода update:

В этом методе мы находим статью по ID и обновляем ее с новыми параметрами. Если обновление прошло успешно, происходит перенаправление на страницу статьи. В противном случае отображается форма редактирования с ошибками.

Если при валидации возникли ошибки, они будут отображены в верхней части формы, что позволяет пользователю увидеть, что нужно исправить. Поля формы (title и body) автоматически заполняются текущими значениями статьи.

Удаление (Delete)

Удаление статьи происходит по запросу DELETE. Обычно это действие инициируется пользователем через кнопку "Удалить" на странице статьи или в списке статей.

Пример метода destroy:

В этом методе мы находим статью по ID и вызываем метод destroy, чтобы удалить ее из базы данных. После успешного удаления происходит перенаправление на страницу со списком статей.

Чтобы выполнить запрос на удаление ресурса из шаблона, мы должны использовать хелпер link_to с указанием метода :delete. Это позволяет отправить DELETE-запрос на сервер, когда пользователь нажимает на ссылку.

Flash

Сообщения flash используются для отображения временных уведомлений пользователям, таких как сообщения об успехе или ошибках после отправки форм или выполнения других действий. Флеш-сообщения передаются в шаблон и там выводятся. После их извлечения хранилище обнуляется.

Флеш-сообщения показываются только на один запрос. После обновления страницы или перехода в другое место они пропадают. Это удобно, так как не нужно следить за их жизненным циклом.

Во многих веб-фреймворках, включая Ruby on Rails, типы флеш-сообщений часто стандартизированы, например:

  • notice или success: для информирования пользователя о том, что действие было выполнено успешно.

  • error для отображения ошибок, связанных с валидацией или другими проблемами. Например, сообщение о том, что введённые данные некорректны.

  • info: Используется для предоставления дополнительной информации пользователю, которая не является ни успешной, ни ошибочной. Например, сообщение о том, что действие будет выполнено позже.

  • warning: для предупреждения пользователя о потенциальных проблемах или рисках, связанных с его действиями.

Пример использования Flash

В контроллере Ruby on Rails мы можем использовать эти типы сообщений следующим образом:

Чтобы вывести flash-сообщения в нашем приложении на Ruby on Rails, добавим соответствующий код в представление. Обычно это делается в основном макете приложения, чтобы сообщения отображались на всех страницах:

app/views/layouts/application.html.erb:

Собираем все вместе

Итоговый контроллер: Полный разбор элементов CRUD

Собираем все элементы CRUD в итоговом контроллере ArticlesController, который управляет статьями в нашем приложении. Контроллер включает следующие действия:

  • create: Создает новую статью, проверяет наличие ошибок и перенаправляет пользователя на страницу статьи или возвращает форму с сообщением об ошибках.
  • new: Инициализирует новый объект статьи для отображения формы создания.
  • index: Получает все статьи и отображает их в списке.
  • show: Находит и отображает конкретную статью по ее идентификатору.
  • edit: Находит статью для редактирования и отображает форму.
  • update: Обновляет существующую статью, проверяет наличие ошибок и перенаправляет пользователя или возвращает форму с сообщениями об ошибках.
  • destroy: Удаляет статью и перенаправляет пользователя на список статей или возвращает сообщение об ошибке, если удаление не удалось.

Контроллер также включает метод article_params, который использует Strong Parameters для обеспечения безопасности, разрешая только определенные параметры для массового присвоения.

Обработка HTTP-ошибок

Обработка HTTP-ошибок позволяет обеспечить пользователям понятные и информативные сообщения об ошибках. В Ruby on Rails существует несколько способов обработки ошибок, которые позволяют разработчикам управлять различными ситуациями, такими как отсутствие запрашиваемых ресурсов, ошибки валидации и внутренние серверные ошибки.

Рассмотрим, как настроить маршруты для обработки ошибок, создать контроллер для управления этими ошибками и использовать механизмы Rails для перенаправления пользователей на соответствующие страницы ошибок.

Настройка обработки ошибок

  1. В Ruby on Rails настройка config.exceptions_app = routes в config/application.rb позволяет нам обрабатывать ошибки через маршруты приложения, что дает возможность создавать свои страницы ошибок.

    В файле config/application.rb добавим следующую строку:

    Это указывает фреймворку использовать маршруты приложения для обработки исключений.

  2. В файле config/routes.rb добавим маршруты для обработки ошибок:

  3. Создадим контроллер ErrorsController в соответствующем файле app/controllers/errors_controller.rb:

  4. Создадим директорию app/views/errors и добавим в нее шаблоны для ошибок:

    app/views/errors/not_found.html.erb:

    app/views/errors/server_error.html.erb:

Поведение вывода ошибок зависит от конфигурации окружения, в котором работает приложение. Если config.consider_all_requests_local установлено в true (что является значением по умолчанию в development-среде), Rails будет показывать полные трассировки стека и подробные сообщения об ошибках в браузере. Это позволяет видеть, что пошло не так, и быстро исправлять ошибки.

В production-среде consider_all_requests_local обычно установлено в false. Rails не будет показывать полные трассировки стека. Вместо этого фреймворк будет отображать стандартные страницы ошибок (например, 404 или 500) или наши страницы ошибок.

Изменить поведение вывода ошибок в разных окружениях, можно изменив config/environments/.rb* файлы. Например, в config/environments/development.rb:

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

Заключение

Мы изучили создания CRUD-сущности в Ruby on Rails, мы рассмотрели ключевые этапы, включая настройку ресурсного роутинга, создание контроллеров и представлений, а также обработку HTTP-ошибок. Эти аспекты обеспечивают функциональность, удобство использования и надежность веб-приложения.