Skip to content

StefH/NETStandard.HttpListener

Repository files navigation

NETStandard.HttpListener .NETStandard 1.3 and UWP

A simple library based on (https://github.com/robertsundstrom/HttpListener) that essentially allows for building your own HTTP server on .NETStandard 1.3 and the Universal Windows Platform (UWP).

Build status codecov Coverage Status NuGet Badge

Overview

This library fills the void left by the missing System.Net.Http.HttpListener in .NET Core and Universal Windows Platform (UWP).

By targetting NETStandard 1.3 and UWP (10.0.10240.0), this API enables HTTP server scenarios on Windows 10 for IoT on Raspberry Pi (2 & 3).

Taking a modern approach, this API is not meant to be entirely compatible with the HttpListener found in the full .NET Framework on Windows desktop.

Please, be aware that this is an early concept, and thus not ready for production.

Contributions are most welcome.

Solution

The solution consists of two projects with a common core targetting:

  1. .NET Core 1.1 project - Windows, Linux and Mac OS X.
  2. Universal Windows Platform (UWP) - Windows 10 and up. (10.0.10240.0)

The API:s are generally similar, but may differ slightly on each platform due to their respective API constraints. However, the core concepts remain the same.

On .NET Core it uses .NET's TCPListener and TCPClient.

On UWP it uses Windows Runtime's StreamSocketListener and StreamSocket.

Sample

Add the using statements.

using System;
using System.Net;
using System.Net.Http;

The code used in this sample should be the same on any platform.

var listener = new HttpListener(IPAddress.Parse("127.0.0.1"), 8081);
try
{
	listener.Request += async (sender, context) =>
	{
		var request = context.Request;
		var response = context.Response;
		if (request.HttpMethod == HttpMethods.Get)
		{
			await response.WriteContentAsync($"Hello from Server at: {DateTime.Now}\r\n");
		}
		else
		{
			response.MethodNotAllowed();
		}
		// Close the HttpResponse to send it back to the client.
		response.Close();
	};
	listener.Start();

	Console.WriteLine("Press any key to exit.");
	Console.ReadKey();
}
catch (Exception exc)
{
	Console.WriteLine(exc.ToString());
}
finally
{
	listener.Close();
}

Visit 127.0.0.1:8081 in your browser.

Also consider having a look at the unit tests.

Todo

Here are some things to consider doing in the future:

  • Rewrite the HttpRequest parser and implement missing features, like authentication and the handling of content types.

About

HttpListener for .NET Core (NETStandard 1.3) and Universal Windows Platform (UWP)

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published