Localhost GuidesExample Server

Example Server

This guide demonstrates how to use class Localhost::Authority to implement a simple HTTPS client & server.

https.rb

Require the required libraries:

require 'async'
require 'async/io/host_endpoint'
require 'async/io/ssl_endpoint'
require 'async/http/server'
require 'async/http/client'
require 'localhost'

The (self-signed) authority to use:

hostname = "localhost"
authority = Localhost::Authority.fetch(hostname)

The server app:

app = lambda do |request|
	Protocol::HTTP::Response[200, {}, ["Hello World"]]
end

Bind to the specified host:

endpoint = Async::IO::Endpoint.tcp(hostname, "8080")

Prepare the server, endpoint will be used for bind:

server_endpoint = Async::IO::SSLEndpoint.new(endpoint, ssl_context: authority.server_context)
server = Async::HTTP::Server.new(app, server_endpoint, protocol: Async::HTTP::Protocol::HTTP1, scheme: "https")

Prepare the client, endpoint will be used for connect:

client_endpoint = Async::IO::SSLEndpoint.new(endpoint, ssl_context: authority.client_context)
client = Async::HTTP::Client.new(client_endpoint, protocol: Async::HTTP::Protocol::HTTP1, scheme: "https", authority: authority)

Run the reactor:

Async do |task|
	# Start the server task:
	server_task = task.async do
		server.run
	end
	
	# Connect to the server:
	response = client.get("/")
	puts "Status: #{response.status}\n#{response.read}"
	
	# Stop the server:
	server_task.stop
end