With the GenHTTP framework, developers should be able to easily develop new web applications in a short time. Everything else is provided by the server infrastructure as well as the excellent ecosystem of .NET which easily allows to build, test, and run applications.
Similar to other frameworks such as Nancy, embedio, NetCoreServer, or Watson, and in comparison to ASP.NET, GenHTTP focuses on a low learning curve to quickly achieve results. You should be able to setup a new web service or website in a couple of minutes.
This section shows how to create a new project from scratch using project templates and how to extend your existing application by embedding the GenHTTP engine.
Project templates can be used to create apps for typical use cases with little effort. After installing the .NET SDK and the templates via dotnet new -i GenHTTP.Templates in the terminal, the templates are available via the console or directly in Visual Studio:
To create a project by using the terminal, create a new folder for your app and use one of the following commands:
| Template | Command |
|---|---|
| REST Webservice | dotnet new genhttp-webservice |
| REST Webservice (single file) | dotnet new genhttp-webservice-minimal |
| Website | dotnet new genhttp-website |
| Website (Static HTML) | dotnet new genhttp-website-static |
| Website (MVC + Razor) | dotnet new genhttp-website-mvc-razor |
| Website (MVC + Scriban) | dotnet new genhttp-website-mvc-scriban |
After the project has been created, you can run it via dotnet run and access the server via http://localhost:8080.
If you would like to extend an existing .NET application, just add a nuget reference to the GenHTTP.Core nuget package. You can then spawn a new server instance with just a few lines of code:
var content = Content.From(Resource.FromString("Hello World!"));
using var server = Host.Create()
.Handler(content)
.Defaults()
.Start(); // or .Run() to block until the application is shut down
When you run this sample it can be accessed in the browser via http://localhost:8080.
The example project above gives you a basic idea on how projects developed with the GenHTTP may look like. To create more complex web applications (such as websites or webservices), follow the guides in the following sections: