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

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

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

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

Константы

DEFAULT_HOST
REQUEST_KWARGS

Атрибуты

accept[RW]

Заголовок Accept для отправки.

controller[R]

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

host[W]

host![W]

remote_addr[RW]

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

request[R]

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

request_count[RW]

Текущий счётчик количества обработанных запросов.

response[R]

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

Публичные методы класса

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

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

  reset!
end

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

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

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

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

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

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

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

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

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

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

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

Указывает, нужно ли симулировать запрос HTTPS.

session.https!
session.https!(false)

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

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

Возвращает true если сессия имитирует запрос HTTPS.

if session.https?
  ...
end

process(method, path, params: nil, headers: nil, env: nil, xhr: false, as: nil) Показать исходный код

# File actionpack/lib/action_dispatch/testing/integration.rb, line 276
def process(method, path, params: nil, headers: nil, env: nil, xhr: false, as: nil)
  request_encoder = RequestEncoder.encoder(as)
  headers ||= {}

  if method == :get && as == :json && params
    headers['X-Http-Method-Override'] = 'GET'
    method = :post
  end

  if path =~ %r{://}
    location = URI.parse(path)
    https! URI::HTTPS === location if location.scheme
    if url_host = location.host
      default = Rack::Request::DEFAULT_PORTS[location.scheme]
      url_host += ":#{location.port}" if default != location.port
      host! url_host
    end
    path = location.query ? "#{location.path}?#{location.query}" : location.path
  end

  hostname, port = host.split(':')

  request_env = {
    :method => method,
    :params => request_encoder.encode_params(params),

    "SERVER_NAME"     => hostname,
    "SERVER_PORT"     => port || (https? ? "443" : "80"),
    "HTTPS"           => https? ? "on" : "off",
    "rack.url_scheme" => https? ? "https" : "http",

    "REQUEST_URI"    => path,
    "HTTP_HOST"      => host,
    "REMOTE_ADDR"    => remote_addr,
    "CONTENT_TYPE"   => request_encoder.content_type,
    "HTTP_ACCEPT"    => request_encoder.accept_header || accept
  }

  wrapped_headers = Http::Headers.from_hash({})
  wrapped_headers.merge!(headers) if headers

  if xhr
    wrapped_headers["HTTP_X_REQUESTED_WITH"] = "XMLHttpRequest"
    wrapped_headers["HTTP_ACCEPT"] ||= [Mime[:js], Mime[:html], Mime[:xml], "text/xml", "*/*"].join(", ")
  end

  # this modifies the passed request_env directly
  if wrapped_headers.present?
    Http::Headers.from_hash(request_env).merge!(wrapped_headers)
  end
  if env.present?
    Http::Headers.from_hash(request_env).merge!(env)
  end

  session = Rack::Test::Session.new(_mock_session)

  # NOTE: rack-test v0.5 doesn't build a default uri correctly
  # Make sure requested path is always a full uri
  session.request(build_full_uri(path, request_env), request_env)

  @request_count += 1
  @request = ActionDispatch::Request.new(session.last_request.env)
  response = _mock_session.last_response
  @response = ActionDispatch::TestResponse.from_response(response)
  @response.request = @request
  @html_document = nil
  @url_options = nil

  @controller = @request.controller_instance

  response.status
end

Выполняет фактический запрос.

method: Метод HTTP (GET, POST, PATCH, PUT, DELETE, HEAD, OPTIONS) как символ.
path: URI (как строка) для выполнения запроса.
params: Параметры HTTP для передачи. Это может быть nil, словарь или строка, соответствующим образом закодированная (application/x-www-form-urlencoded или multipart/form-data).
headers: Дополнительные заголовки для передачи, как словарь. Заголовки будут объединены в хэш Rack.
env: Дополнительные значения env для передачи, как словарь. Заголовки будут объединены в хэш Rack.

Этот метод редко используется напрямую. Используйте #get, #post, или другие стандартные методы HTTP в тестах интеграции. #process требуется только при использовании метода запроса, у которого нет метода, определённого в тестах интеграции.

Этот метод возвращает объект Response, который можно использовать для проверки деталей ответа. Кроме того, если этот метод был вызван из объекта ActionDispatch::IntegrationTest, то переменная экземпляра объекта @response будет указывать на тот же объект ответа.

Пример:

process :get, '/author', params: { since: 201501011400 }

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

# File actionpack/lib/action_dispatch/testing/integration.rb, line 210
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

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

session.reset!

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

# File actionpack/lib/action_dispatch/testing/integration.rb, line 193
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)
      url_options.reverse_merge!(@app.routes.default_url_options)
    end

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