Class: Async::HTTP::Protocol::HTTP1::Server

Inherits:
Connection
  • Object
show all
Defined in:
lib/async/http/protocol/http1/server.rb

Instance Attribute Summary

Attributes inherited from Connection

#count, #version

Instance Method Summary collapse

Methods inherited from Connection

#concurrency, #http1?, #http2?, #initialize, #peer, #read_line, #read_line?, #reusable?, #viable?

Constructor Details

This class inherits a constructor from Async::HTTP::Protocol::HTTP1::Connection

Instance Method Details

#each(task: Task.current) ⇒ Object

Server loop.



42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
 
# File 'lib/async/http/protocol/http1/server.rb', line 42

def each(task: Task.current)
  task.annotate("Reading #{self.version} requests for #{self.class}.")
  
  while request = next_request
    response = yield(request, self)
    body = response&.body
    
    if @stream.nil? and body.nil?
      # Full hijack.
      return
    end
    
    begin
      # If a response was generated, send it:
      if response
        trailer = response.headers.trailer!

        write_response(@version, response.status, response.headers)

        # Some operations in this method are long running, that is, it's expected that `body.call(stream)` could literally run indefinitely. In order to facilitate garbage collection, we want to nullify as many local variables before calling the streaming body. This ensures that the garbage collection can clean up as much state as possible during the long running operation, so we don't retain objects that are no longer needed.

        if body and protocol = response.protocol
          stream = write_upgrade_body(protocol)
          
          # At this point, the request body is hijacked, so we don't want to call #finish below.
          request = response = nil
          
          body.call(stream)
        elsif request.connect? and response.success?
          stream = write_tunnel_body(request.version)
          
          # Same as above:
          request = response = nil
          
          body.call(stream)
        else
          head = request.head?
          version = request.version
          
          # Same as above:
          request = nil unless body
          response = nil
          
          write_body(version, body, head, trailer)
        end

        # We are done with the body, you shouldn't need to call close on it:
        body = nil
      else
        # If the request failed to generate a response, it was an internal server error:
        write_response(@version, 500, {})
        write_body(request.version, nil)
      end
      
      # Gracefully finish reading the request body if it was not already done so.
      request&.finish
      
      # This ensures we yield at least once every iteration of the loop and allow other fibers to execute.
      task.yield
    rescue => error
      raise
    ensure
      body&.close(error)
    end
  end
end

#fail_request(status) ⇒ Object 



14
15
16
17
 
# File 'lib/async/http/protocol/http1/server.rb', line 14

def fail_request(status)
  @persistent = false
  write_response(@version, status, {}, nil)
end

#next_request ⇒ Object 



19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
 
# File 'lib/async/http/protocol/http1/server.rb', line 19

def next_request
  # The default is true.
  return unless @persistent
  
  # Read an incoming request:
  return unless request = Request.read(self)
  
  unless persistent?(request.version, request.method, request.headers)
    @persistent = false
  end
  
  return request
rescue Async::TimeoutError
  # For an interesting discussion about this behaviour, see https://trac.nginx.org/nginx/ticket/1005
  # If you enable this, you will see some spec failures...
  # fail_request(408)
  raise
rescue
  fail_request(400)
  raise
end