Red Download - Download Red Quellcodes

Red

Andere Kategorien

vements

Herunterladen

Das RedHttp-Projekt wird nicht mehr gepflegt. Besuchen Sie Carter für ein ähnliches Erlebnis mit geringer Zeremonie.

RedHttpServer

Plattformübergreifendes HTTP-Server-Framework von Low Ceremony mit WebSocket-Unterstützung

Ein .NET Standard-Webanwendungsframework, das auf ASP.NET Core mit Kestrel basiert und von der Einfachheit von Express.js inspiriert ist

Homepage
Dokumentation

Installation

RedHttpServer kann über NuGet installiert werden: Install-Package RHttpServer

Middleware und Plugins

RedHttpServer ist so konzipiert, dass es einfach darauf aufzubauen ist. Der Server unterstützt sowohl Middleware-Module als auch Erweiterungsmodule

JsonConverter – verwendet System.Text.Json
XmlConverter – verwendet System.Xml.Serialization
BodyParser – verwendet sowohl den Json- als auch den XML-Konverter, um den Anforderungstext je nach Inhaltstyp in ein Objekt zu analysieren.

Weitere Erweiterungen und Middleware

CookieSessions ist eine einfache Sitzungsverwaltungs-Middleware, die Cookies mit Authentifizierungstokens verwendet.
JwtSessions einfache Sitzungsverwaltungs-Middleware, die JWT-Tokens verwendet – verwendet Jwt.Net
Validierung erstellt Validatoren für Formulare und Abfragen mithilfe einer Fluent-API
EcsRenderer, einfache Vorlagen-Rendering-Erweiterung. Weitere Informationen zum Format erhalten Sie, indem Sie auf den Link klicken.
CommonMarkRenderer, einfache CommonMark/Markdown-Renderer-Erweiterung – verwendet CommonMark.NET
BarbarsRenderer einfache Barbars-Renderer-Erweiterung – verwendet Barbars.Net

Beispiel

 var server = new RedHttpServer ( 5000 , "public" ) ;
server . Use ( new EcsRenderer ( ) ) ;
server . Use ( new CookieSessions < MySession > ( TimeSpan . FromDays ( 1 ) ) ) ;

// Authentication middleware
async Task < HandlerType > Auth ( Request req , Response res )
{
    if ( req . GetData < MySession > ( ) != null )
    {
        return HandlerType . Continue ;
    }

    await res . SendStatus ( HttpStatusCode . Unauthorized ) ;
    return HandlerType . Final ;
}

var startTime = DateTime . UtcNow ;

// Url parameters
server . Get ( "profile/:username" , Auth , ( req , res ) =>
{
    var username = req . Context . ExtractUrlParameter ( "username" ) ;
    // ... lookup username in database or similar and fetch profile ...
    var user = new { FirstName = "John" , LastName = "Doe" , Username = username } ;
    return res . SendJson ( user ) ;
} ) ;

// Using forms
server . Post ( "/login" , async ( req , res ) =>
{
    var form = await req . GetFormDataAsync ( ) ;
    // ... some validation and authentication ...
    await res . OpenSession ( new MySession { Username = form [ "username" ] } ) ;
    return await res . SendStatus ( HttpStatusCode . OK ) ;
} ) ;

server . Post ( "/logout" , Auth , async ( req , res ) =>
{
    var session = req . GetData < MySession > ( ) ;
    await res . CloseSession ( session ) ;
    return await res . SendStatus ( HttpStatusCode . OK ) ;
} ) ;

// Simple redirects
server . Get ( "/redirect" , Auth , ( req , res ) => res . Redirect ( "/redirect/test/here" ) ) ;

// File uploads
Directory . CreateDirectory ( "uploads" ) ;
server . Post ( "/upload" , async ( req , res ) =>
{
    if ( await req . SaveFiles ( "uploads" ) )
        return await res . SendString ( "OK" ) ;
    else
        return await res . SendString ( "Error" , status : HttpStatusCode . NotAcceptable ) ;
} ) ;

server . Get ( "/file" , ( req , res ) => res . SendFile ( "somedirectory/animage.jpg" ) ) ;

// Using url queries
server . Get ( "/search" , Auth , ( req , res ) =>
{
    string searchQuery = req . Queries [ "query" ] ;
    string format = req . Queries [ "format" ] ;
    // ... perform search using searchQuery and return results ...
    var results = new [ ] { "Apple" , "Pear" } ;

    if ( format == "xml" )
        return res . SendXml ( results ) ;
    else
        return res . SendJson ( results ) ;
} ) ;

// Markdown rendering
server . Get ( "/markdown" , ( req , res ) => res . RenderFile ( "markdown.md" ) ) ;

// Esc rendering
server . Get ( "/serverstatus" , async ( req , res ) => await res . RenderPage ( "pages/statuspage.ecs" ,
    new RenderParams
    {
        { "uptime" , ( int ) DateTime . UtcNow . Subtract ( startTime ) . TotalSeconds } ,
        { "version" , Red . RedHttpServer . Version }
    } ) ) ;

// Using websockets
server . WebSocket ( "/echo" , async ( req , wsd ) =>
{
    wsd . SendText ( "Welcome to the echo test server" ) ;
    wsd . OnTextReceived += ( sender , eventArgs ) => { wsd . SendText ( "you sent: " + eventArgs . Text ) ; } ;
    return HandlerType . Final ;
} ) ;

// Keep the program running easily (async Program.Main - C# 7.1+)
await server . RunAsync ( ) ;

Warum?

Weil ich C# und .NET Core mag, aber sehr oft für ein Projekt einen einfachen, aber leistungsstarken Webserver benötige. Express.js ist prägnant und einfach zu handhaben, daher ist die API davon inspiriert.