SimpleHttp

A basic HTTP server framework written in C#.

License

GNU GPL, "giving you legal permission to copy, distribute and/or modify it."

Feature requests

I'm not actively developing this project at present, but I want to revive it. It is being used in an academic setting. If I can add any functionality to assist your project, feel free to get in touch. Alternatively, I'm open to pull requests.

Usage

using JamesWright.SimpleHttp;
using System.Threading;
using System.Threading.Tasks;

namespace JamesWright.SimpleHttp.Example
{
    class Program
    {
        static void Main(string[] args)
        {
            App app = new App();

            app.Get("/", async (req, res) =>
            {
                res.Content = "<p>You did a GET.</p>";
                res.ContentType = "text/html";
                await res.SendAsync();
            });

            app.Post("/", async (req, res) =>
            {
                res.Content = "<p>You did a POST: " + await req.GetBodyAsync() + "</p>";
                res.ContentType = "text/html";
                await res.SendAsync();
            });

            app.Put("/", async (req, res) =>
            {
                res.Content = "<p>You did a PUT: " + await req.GetBodyAsync() + "</p>";
                res.ContentType = "text/html";
                await res.SendAsync();
            });

            app.Delete("/", async (req, res) =>
            {
                res.Content = "<p>You did a DELETE: " + await req.GetBodyAsync() + "</p>";
                res.ContentType = "text/html";
                await res.SendAsync();
            });

            app.Start();
        }
    }
}

APIs

App

Represents an application, served over HTTP, and the requests for which it will listen.

Public properties and methods

void Get(string endpoint, Action<Request, Response> handler)

Adds a handler for a HTTP GET request to the requested endpoint.

void Post(string endpoint, Action<Request, Response> handler)

Adds a handler for a HTTP POST request to the requested endpoint.

void Put(string endpoint, Action<Request, Response> handler)

Adds a handler for a HTTP PUT request to the requested endpoint.

void Delete(string endpoint, Action<Request, Response> handler)

Adds a handler for a HTTP DELETE request to the requested endpoint.

void Start(string portNumber = "8005")#####

Initialises the server and its underlying listener. Port number can be optionally specified.

Request

A HTTP request, and its underlying information, that is sent to the server.

Public properties and methods

string Endpoint { get; }

Returns the endpoint that the Request instance represents e.g. "/".

string[] Parameters { get; }#####

Contains the parameters sent with the HTTP request. Currently not populated.

async Task<string> GetBodyAsync()

Returns the request's body asynchronously.

Response

A response to be sent to the user.

Public properties and methods

string Content { get; set; }

The body content to be returned to the user.

string ContentType { get; set; }#####

The Internet media type (MIME) of the response e.g. "application/json".

async Task SendAsync()

Sends the response asynchronously.

Roadmap

• Request parameters
• JSON
• NuGet
• HTTPS/SSL
• Memory management
• Unit tests