класс ActionDispatch::Integration::Session

Родитель:: Объект
Включённые модули:: ActionDispatch::TestProcess, ActionDispatch::Integration::RequestHelpers, ActionDispatch::Assertions, ActionDispatch::Routing::UrlFor, ActionController::Testing

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

Обычно вы создадите новую сессию с помощью IntegrationTest#open_session, а не создавая Integration::Session напрямую.

Константы

DEFAULT_HOST

Атрибуты

accept[RW]

Заголовок Accept, который нужно отправить.

controller[R]

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

host[W]

host![W]

remote_addr[RW]

Значение #remote_addr, используемое в последнем запросе.

request[R]

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

request_count[RW]

Счётчик количества обработанных запросов.

response[R]

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

Общедоступные методы класса

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

Создаёт и инициализирует новый экземпляр Session.

Вызывает метод суперкласса ActionDispatch::Routing::UrlFor.new

# File actionpack/lib/action_dispatch/testing/integration.rb, line 184
def initialize(app)
  super()
  @app = app

  # If the app is a Rails app, make url_helpers available on the session
  # This makes app.url_for and app.foo_path available in the console
  if app.respond_to?(:routes)
    singleton_class.class_eval do
      include app.routes.url_helpers if app.routes.respond_to?(:url_helpers)
      include app.routes.mounted_helpers if app.routes.respond_to?(:mounted_helpers)
    end
  end

  reset!
end

Общедоступные методы экземпляра

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

Словарь куки, возвращенных последним ответом и которые будут отправлены со следующим запросом.

# File actionpack/lib/action_dispatch/testing/integration.rb, line 165
def cookies
  _mock_session.cookie_jar
end

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

Имя хоста, используемое в последнем запросе.

# File actionpack/lib/action_dispatch/testing/integration.rb, line 152
def host
  @host || DEFAULT_HOST
end

https!(flag = true) Показать исходный код

Указывает, должна ли сессия имитировать безопасный HTTPS-запрос.

session.https!
session.https!(false)

# File actionpack/lib/action_dispatch/testing/integration.rb, line 241
def https!(flag = true)
  @https = flag
end

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

Возвращает true, если сессия имитирует безопасный HTTPS-запрос.

if session.https?
  ...
end

# File actionpack/lib/action_dispatch/testing/integration.rb, line 250
def https?
  @https
end

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

Сбрасывает экземпляр. Это может быть использовано для сброса информации состояния в существующем экземпляре сессии, чтобы он мог использоваться с чистого состояния.

session.reset!

# File actionpack/lib/action_dispatch/testing/integration.rb, line 217
def reset!
  @https = false
  @controller = @request = @response = nil
  @_mock_session = nil
  @request_count = 0
  @url_options = nil

  self.host        = DEFAULT_HOST
  self.remote_addr = "127.0.0.1"
  self.accept      = "text/xml,application/xml,application/xhtml+xml," +
                     "text/html;q=0.9,text/plain;q=0.8,image/png," +
                     "*/*;q=0.5"

  unless defined? @named_routes_configured
    # the helpers are made protected by default--we make them public for
    # easier access during testing and troubleshooting.
    @named_routes_configured = true
  end
end

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

# File actionpack/lib/action_dispatch/testing/integration.rb, line 200
def url_options
  @url_options ||= default_url_options.dup.tap do |url_options|
    url_options.reverse_merge!(controller.url_options) if controller

    if @app.respond_to?(:routes) && @app.routes.respond_to?(:default_url_options)
      url_options.reverse_merge!(@app.routes.default_url_options)
    end

    url_options.reverse_merge!(:host => host, :protocol => https? ? "https" : "http")
  end
end