модуль ActionController::Live

Смешайте этот модуль в свой контроллер, и все действия в этом контроллере смогут транслировать данные клиенту по мере их записи.

class MyController < ActionController::Base
  include ActionController::Live

  def stream
    response.headers['Content-Type'] = 'text/event-stream'
    100.times {
      response.stream.write "hello world\n"
      sleep 1
    }
  ensure
    response.stream.close
  end
end

Существует несколько ограничений при использовании этого подхода. Вы не можете записывать заголовки после того, как ответ был отправлен (Response#committed? вернёт истину). Вызов write или close для потока ответа приведёт к тому, что объект ответа будет отправлен. Убедитесь, что все заголовки установлены до вызова write или close в вашем потоке.

Вы обязаны вызвать close в своём потоке, когда закончите, иначе сокет может остаться открытым навсегда.

Последнее ограничение заключается в том, что ваши действия выполняются в отдельном потоке от основного. Убедитесь, что ваши действия потокобезопасны, и это не должно представлять проблемы (не обменивайтесь состоянием между потоками и т. д.).

Публичные методы экземпляров

log_error(exception) Показать исходный код

# File actionpack/lib/action_controller/metal/live.rb, line 253
def log_error(exception)
  logger = ActionController::Base.logger
  return unless logger

  message = "\n#{exception.class} (#{exception.message}):\n"
  message << exception.annoted_source_code.to_s if exception.respond_to?(:annoted_source_code)
  message << "  " << exception.backtrace.join("\n  ")
  logger.fatal("#{message}\n\n")
end

process(name) Показать исходный код

Вызывает метод суперкласса

# File actionpack/lib/action_controller/metal/live.rb, line 212
def process(name)
  t1 = Thread.current
  locals = t1.keys.map { |key| [key, t1[key]] }

  error = nil
  # This processes the action in a child thread. It lets us return the
  # response code and headers back up the rack stack, and still process
  # the body in parallel with sending data to the client
  Thread.new {
    t2 = Thread.current
    t2.abort_on_exception = true

    # Since we're processing the view in a different thread, copy the
    # thread locals from the main thread to the child thread. :'(
    locals.each { |k,v| t2[k] = v }

    begin
      super(name)
    rescue => e
      if @_response.committed?
        begin
          @_response.stream.write(ActionView::Base.streaming_completion_on_exception) if request.format == :html
          @_response.stream.call_on_error
        rescue => exception
          log_error(exception)
        ensure
          log_error(e)
          @_response.stream.close
        end
      else
        error = e
      end
    ensure
      @_response.commit!
    end
  }

  @_response.await_commit
  raise error if error
end

response_body=(body) Показать исходный код

Вызывает метод суперкласса

# File actionpack/lib/action_controller/metal/live.rb, line 263
def response_body=(body)
  super
  response.close if response
end

set_response!(request) Показать исходный код

Вызывает метод суперкласса

# File actionpack/lib/action_controller/metal/live.rb, line 268
def set_response!(request)
  if request.env["HTTP_VERSION"] == "HTTP/1.0"
    super
  else
    @_response         = Live::Response.new
    @_response.request = request
  end
end