Class: Dommy::Rack::HttpExchange

Inherits:
Object
  • Object
show all
Defined in:
lib/dommy/rack/http_exchange.rb

Overview

One HTTP request against the Rack app: build the env, call the app, wrap the Response, and store its Set-Cookie headers in the jar. This is the request primitive the redirect loop (Navigation) issues per hop.

It deliberately touches only thread-safe / immutable collaborators — the frozen Config, a stateless app, the thread-safe CookieJar, and a header source that is either read-only or a captured snapshot — so the very same exchange can run on a network worker thread, off the page (JS) thread, for the async-network path. The page-thread-only concerns it must NOT own are injected as hooks:

  • on_request — observe the outgoing env (the synchronous page path records it as last_request and fires request listeners; an async path routes the same notification through the scheduler inbox).
  • on_response — observe the Response (response listeners).

Reload bookkeeping (last_request_args) and history/document application are NOT here: they belong to the page thread and stay in Session / Navigation.

Instance Method Summary collapse

Constructor Details

#initialize(app:, config:, cookie_jar:, headers:, on_request: nil, on_response: nil) ⇒ HttpExchange

Returns a new instance of HttpExchange.

Parameters:

  • headers (HeaderStore, Hash) —

    anything responding to merge(overrides) -> Hash; the Session passes its live HeaderStore for the page path, a plain snapshot Hash for a worker path.



27
28
29
30
31
32
33
34
 
# File 'lib/dommy/rack/http_exchange.rb', line 27

def initialize(app:, config:, cookie_jar:, headers:, on_request: nil, on_response: nil)
  @app = app
  @config = config
  @cookie_jar = cookie_jar
  @headers = headers
  @on_request = on_request
  @on_response = on_response
end

Instance Method Details

#request(method, absolute_url, params: nil, body: nil, headers: {}) ⇒ Object

Perform one request and return its Response. headers are per-request overrides merged over the persistent header source.



38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
 
# File 'lib/dommy/rack/http_exchange.rb', line 38

def request(method, absolute_url, params: nil, body: nil, headers: {})
  env = RequestBuilder.new(@config).build(
    method: method,
    url: absolute_url,
    params: params,
    body: body,
    headers: @headers.merge(headers),
    cookie_string: @cookie_jar.cookies_for(absolute_url)
  )
  @on_request&.call(env)
  status, response_headers, response_body = @app.call(env)
  response = Response.new(status, response_headers, response_body, url: absolute_url)
  response.set_cookie_strings.each do |sc|
    @cookie_jar.store_from_header(sc, absolute_url)
  end
  @on_response&.call(response)
  response
end