класс ActionController::Responder

Отвечает за предоставление ресурса для различных запросов с разными типами контента, обычно в зависимости от HTTP-метода. Ответчик срабатывает при вызове respond_with. Простейший случай для изучения — это запрос GET:

class PeopleController < ApplicationController
  respond_to :html, :xml, :json

  def index
    @people = Person.all
    respond_with(@people)
  end
end

При поступлении запроса, например, для получения ответа в формате XML, происходят три шага:

1) the responder searches for a template at people/index.xml;

2) if the template is not available, it will invoke <code>#to_xml</code> on the given resource;

3) if the responder does not <code>respond_to :to_xml</code>, call <code>#to_format</code> on it.

Встроенная семантика HTTP-методов

Стандартный ответчик Rails содержит семантику для каждого HTTP-метода. В зависимости от типа контента, метода и состояния ресурса, он будет вести себя по-разному.

Используя стандартный ответчик Rails, запрос POST для создания объекта можно записать как:

def create
  @user = User.new(params[:user])
  flash[:notice] = 'User was successfully created.' if @user.save
  respond_with(@user)
end

Что точно так же, как:

def create
  @user = User.new(params[:user])

  respond_to do |format|
    if @user.save
      flash[:notice] = 'User was successfully created.'
      format.html { redirect_to(@user) }
      format.xml { render xml: @user, status: :created, location: @user }
    else
      format.html { render action: "new" }
      format.xml { render xml: @user.errors, status: :unprocessable_entity }
    end
  end
end

То же самое происходит для запросов PATCH/PUT и DELETE.

Вложенные ресурсы

Вы можете передавать вложенные ресурсы так же, как делаете в form_for и polymorphic_url. Представьте, что у проекта много задач. Действие create для контроллера TasksController будет выглядеть так:

def create
  @project = Project.find(params[:project_id])
  @task = @project.tasks.build(params[:task])
  flash[:notice] = 'Task was successfully created.' if @task.save
  respond_with(@project, @task)
end

Передача нескольких ресурсов гарантирует, что ответчик будет перенаправлять на project_task_url вместо task_url.

Для именованных и одиночных ресурсов требуется передать символ, как в полиморфных URL. Если у проекта один менеджер, который имеет много задач, вызов должен быть таким:

respond_with(@project, :manager, @task)

Обратите внимание, что если вы передаете массив, он будет обрабатываться как коллекция, поэтому следующее не эквивалентно:

respond_with [@project, :manager, @task]

Настраиваемые параметры

respond_with также позволяет передавать параметры, которые передаются в вызов render. Эти параметры применяются только для успешных сценариев. Например, вы можете сделать следующее в методе create выше:

def create
  @project = Project.find(params[:project_id])
  @task = @project.tasks.build(params[:task])
  flash[:notice] = 'Task was successfully created.' if @task.save
  respond_with(@project, @task, status: 201)
end

Это вернёт статус 201, если задача была успешно сохранена. В противном случае, он просто проигнорирует заданные параметры и вернёт статус 422 и ошибки ресурса. Вы также можете переопределить место перенаправления:

respond_with(@project, location: root_path)

Чтобы настроить сценарий ошибки, вы можете передать блок в respond_with:

def create
  @project = Project.find(params[:project_id])
  @task = @project.tasks.build(params[:task])
  respond_with(@project, @task, status: 201) do |format|
    if @task.save
      flash[:notice] = 'Task was successfully created.'
    else
      format.html { render "some_special_template" }
    end
  end
end

Использование respond_with с блоком следует той же синтаксической конструкции, что и respond_to.