README.md

µHttpSharp

A very lightweight & simple embedded http server for c#

Master	Provider
	Windows CI Provided By JetBrains and CodeBetter
	Windows CI Provided By AppVeyor
	Mono CI Provided by travis-ci

Usage

A NuGet Package is available, Install via NuGet Package Manager :

install-package uHttpSharp

A sample for usage :

using (var httpServer = new HttpServer(new HttpRequestProvider()))
{
	// Normal port 80 :
	httpServer.Use(new TcpListenerAdapter(new TcpListener(IPAddress.Loopback, 80)));
    
	// Ssl Support :
	var serverCertificate = X509Certificate.CreateFromCertFile(@"TempCert.cer");
	httpServer.Use(new ListenerSslDecorator(new TcpListenerAdapter(new TcpListener(IPAddress.Loopback, 443)), serverCertificate));

	// Request handling : 
	httpServer.Use((context, next) => {
		Console.WriteLine("Got Request!");
		return next();
	});

	// Handler classes : 
	httpServer.Use(new TimingHandler());
	httpServer.Use(new HttpRouter().With(string.Empty, new IndexHandler())
									.With("about", new AboutHandler()));
	httpServer.Use(new FileHandler());
	httpServer.Use(new ErrorHandler());
	
	httpServer.Start();
	
	Console.ReadLine();
}

Features

µHttpSharp is a simple http server inspired by koa, and has the following features :

• RESTful controllers
• Ssl Support
• Easy Chain-Of-Responsibility architecture

Performance

µHttpSharp manages to handle 13000 requests a sec (With Keep-Alive support) on core i5 machine, cpu goes to 27%, memory consumption and number of threads is stable.

ab -n 10000 -c 50 -k -s 2 http://localhost:8000/

This is ApacheBench, Version 2.3 <$Revision: 1528965 $>
Copyright 1996 Adam Twiss, Zeus Technology Ltd, http://www.zeustech.net/
Licensed to The Apache Software Foundation, http://www.apache.org/

Benchmarking localhost (be patient)
Completed 1000 requests
Completed 2000 requests
Completed 3000 requests
Completed 4000 requests
Completed 5000 requests
Completed 6000 requests
Completed 7000 requests
Completed 8000 requests
Completed 9000 requests


Server Software:
Server Hostname:        localhost
Server Port:            8000

Document Path:          /
Document Length:        21 bytes

Concurrency Level:      50
Time taken for tests:   0.707 seconds
Complete requests:      9357
Failed requests:        0
Keep-Alive requests:    9363
Total transferred:      1507527 bytes
HTML transferred:       196644 bytes
Requests per second:    13245.36 [#/sec] (mean)
Time per request:       3.775 [ms] (mean)
Time per request:       0.075 [ms] (mean, across all concurrent requests)
Transfer rate:          2083.53 [Kbytes/sec] received

Connection Times (ms)
			  min  mean[+/-sd] median   max
Connect:        0    0   0.0      0       1
Processing:     1    4   0.7      4      13
Waiting:        1    4   0.7      4      13
Total:          1    4   0.7      4      13

Percentage of the requests served within a certain time (ms)
  50%      4
  66%      4
  75%      4
  80%      4
  90%      4
  95%      4
  98%      5
  99%      9
 100%      4 (longest request)

How To Contribute?

• Use it
• Open Issues
• Fork and Push requests