модуль ActionController::MimeResponds

# File actionpack/lib/action_controller/metal/mime_responds.rb, line 208
def respond_to(*mimes)
  raise ArgumentError, "respond_to takes either types or a block, never both" if mimes.any? && block_given?

  collector = Collector.new(mimes, request.variant)
  yield collector if block_given?

  if format = collector.negotiate_format(request)
    _process_format(format)
    response = collector.response
    response ? response.call : render({})
  else
    raise ActionController::UnknownFormat
  end
end

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

def index
  @people = Person.all
end

Вот то же действие с интегрированной поддержкой веб-служб:

def index
  @people = Person.all

  respond_to do |format|
    format.html
    format.xml { render xml: @people }
  end
end

Это означает: «Если клиент хочет HTML в ответ на это действие, просто ответьте так, как мы делали раньше, но если клиент хочет XML, верните ему список людей в формате XML». (Rails определяет желаемый формат ответа из HTTP-заголовка Accept, отправленного клиентом.)

Предположим, у вас есть действие, которое добавляет нового человека, при необходимости создавая его компанию (по имени), если она еще не существует, без веб-служб, оно может выглядеть так:

def create
  @company = Company.find_or_create_by(name: params[:company][:name])
  @person  = @company.people.create(params[:person])

  redirect_to(person_list_url)
end

Вот то же действие с интегрированной поддержкой веб-служб:

def create
  company  = params[:person].delete(:company)
  @company = Company.find_or_create_by(name: company[:name])
  @person  = @company.people.create(params[:person])

  respond_to do |format|
    format.html { redirect_to(person_list_url) }
    format.js
    format.xml  { render xml: @person.to_xml(include: @company) }
  end
end

Если клиент хочет HTML, мы просто перенаправляем его обратно к списку людей. Если он хочет JavaScript, то это запрос Ajax, и мы отображаем JavaScript-шаблон, связанный с этим действием. Наконец, если клиент хочет XML, мы отображаем созданного человека как XML, но с одной особенностью: мы также включаем компанию человека в рендер XML, что-то вроде этого:

<person>
  <id>...</id>
  ...
  <company>
    <id>...</id>
    <name>...</name>
    ...
  </company>
</person>

Обратите внимание, однако, на дополнительный фрагмент в начале этого действия:

company  = params[:person].delete(:company)
@company = Company.find_or_create_by(name: company[:name])

Это связано с тем, что входящий XML-документ (если происходит запрос веб-службы) может содержать только один корневой узел. Поэтому нам нужно переупорядочить вещи, чтобы запрос выглядел так (в кодировке URL):

person[name]=...&person[company][name]=...&...

И так (в кодировке XML):

<person>
  <name>...</name>
  <company>
    <name>...</name>
  </company>
</person>

Другими словами, мы делаем запрос так, чтобы он работал с данными только одного человека. Затем в действии мы извлекаем данные компании из запроса, находим или создаём компанию и создаём нового человека с оставшимися данными.

Обратите внимание, что вы можете определить собственный парсер XML-параметров, который позволит описать несколько сущностей в одном запросе (например, объединив их все в один корневой узел), но если вы просто последуете устоявшейся практике и примете значения по умолчанию Rails, жизнь станет намного проще.

Если вам нужно использовать тип MIME, который не поддерживается по умолчанию, вы можете зарегистрировать свои собственные обработчики в файле config/initializers/mime_types.rb следующим образом.

Mime::Type.register "image/jpg", :jpg

Respond to также позволяет указать общий блок для разных форматов, используя any:

def index
  @people = Person.all

  respond_to do |format|
    format.html
    format.any(:xml, :json) { render request.format.to_sym => @people }
  end
end

В примере выше, если формат xml, он отобразит:

render xml: @people

Или, если формат json:

render json: @people

Форматы могут иметь разные варианты.

Вариант запроса — специализация формата запроса, например :tablet, :phone, или :desktop.

Мы часто хотим отображать разные шаблоны html/json/xml для телефонов, планшетов и настольных браузеров. Варианты упрощают это.

Вы можете установить вариант в before_action:

request.variant = :tablet if request.user_agent =~ /iPad/

Обрабатывайте варианты в действии так же, как и форматы:

respond_to do |format|
  format.html do |variant|
    variant.tablet # renders app/views/projects/show.html+tablet.erb
    variant.phone { extra_setup; render ... }
    variant.none  { special_setup } # executed only if there is no variant set
  end
end

Предоставьте отдельные шаблоны для каждого формата и варианта:

app/views/projects/show.html.erb
app/views/projects/show.html+tablet.erb
app/views/projects/show.html+phone.erb

Когда вы не используете общий код внутри формата, вы можете упростить определение вариантов, используя встроенный синтаксис:

respond_to do |format|
  format.js         { render "trash" }
  format.html.phone { redirect_to progress_path }
  format.html.none  { render "trash" }
end

Варианты также поддерживают общий блок `any`/`all`, который имеют форматы.

Он работает как для встроенного синтаксиса:

respond_to do |format|
  format.html.any   { render text: "any"   }
  format.html.phone { render text: "phone" }
end

так и для синтаксиса с блоком:

respond_to do |format|
  format.html do |variant|
    variant.any(:tablet, :phablet){ render text: "any" }
    variant.phone { render text: "phone" }
  end
end

Вы также можете установить массив вариантов:

request.variant = [:tablet, :phone]

что будет работать аналогично переговорам форматов и типов MIME. Если не будет объявлен вариант :tablet, будет выбран вариант :phone:

respond_to do |format|
  format.html.none
  format.html.phone # this gets rendered
end

Убедитесь, что вы прочитали документацию ActionController::MimeResponds.respond_to для получения дополнительных примеров.