class Async::HTTP::Server

An HTTP server that accepts connections on a specific endpoint and dispatches requests to an application handler.

def self.for(*arguments, **options, &block)

@parameter options [Hash] Options to pass to {initialize}.
@parameter arguments [Array] Arguments to pass to {initialize}.
Create a server using a block as the application handler. 
def self.for(*arguments, **options, &block)
	self.new(block, *arguments, **options)
end

def accept(peer, address, task: Task.current)

@parameter address [Addrinfo] The remote address of the peer.
@parameter peer [IO] The connected peer.
Accept an incoming connection and process requests. 
def accept(peer, address, task: Task.current)
	connection = @protocol.server(peer)
	
	Console.debug(self){"Incoming connnection from #{address.inspect} to #{@protocol}"}
	
	connection.each do |request|
		# We set the default scheme unless it was otherwise specified.
		# https://tools.ietf.org/html/rfc7230#section-5.5
		request.scheme ||= self.scheme
		
		# Console.debug(self) {"Incoming request from #{address.inspect}: #{request.method} #{request.path}"}
		
		# If this returns nil, we assume that the connection has been hijacked.
		self.call(request)
	end
ensure
	connection&.close
end

def as_json(...)

@returns [Hash] A JSON-compatible representation of this server. 
def as_json(...)
	{
		endpoint: @endpoint.to_s,
		protocol: @protocol,
		scheme: @scheme,
	}
end

def initialize(app, endpoint, protocol: endpoint.protocol, scheme: endpoint.scheme)

@parameter scheme [String] The default scheme to set on requests.
@parameter protocol [Protocol] The protocol to use for incoming connections.
@parameter endpoint [Endpoint] The endpoint to bind to.
@parameter app [Protocol::HTTP::Middleware] The Rack-compatible application to serve.
Initialize the server with an application handler and endpoint. 
def initialize(app, endpoint, protocol: endpoint.protocol, scheme: endpoint.scheme)
	super(app)
	
	@endpoint = endpoint
	@protocol = protocol
	@scheme = scheme
end

def run

@returns [Async::Task] The task that is running the server. 
def run
	Async do |task|
		@endpoint.accept(&self.method(:accept))
		
		# Wait for all children to finish:
		task.children.each(&:wait)
	end
end

def to_json(...)

@returns [String] A JSON string representation of this server. 
def to_json(...)
	as_json.to_json(...)
end