redirect.pony

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
use uri = "uri"

class val Redirect
  """
  A validated redirect hop, ready to follow.

  The `Location` header has been resolved against the request URL, security
  rules applied (credentials stripped on a cross-origin hop, `https`-to-`http`
  downgrade refused before a `Redirect` is ever built), and the method and
  body rewritten for the response status. The remaining hop count is already
  decremented for the next hop.

  RedirectFollower uses this internally — application code does not interact
  with it directly. The constructor is private so the security rules cannot
  be bypassed and the remaining hop count cannot be reset.
  """
  let _status: U16
  let _target: uri.URI val
  let _request: HTTPRequest val
  let _remaining: USize

  new val _create(
    status': U16,
    target': uri.URI val,
    request': HTTPRequest val,
    remaining': USize)
  =>
    _status = status'
    _target = target'
    _request = request'
    _remaining = remaining'

  fun status(): U16 =>
    """
    The redirect status code (301, 302, 303, 307, or 308).
    """
    _status

  fun target(): uri.URI val =>
    """
    The resolved absolute URL to follow.
    """
    _target

  fun request(): HTTPRequest val =>
    """
    The request to send on the next hop: the original request with its
    method and body rewritten for the status and its headers stripped for a
    cross-origin hop.
    """
    _request

  fun remaining(): USize =>
    """
    How many redirect hops may still be followed after this one.
    """
    _remaining