HttpSession

The HttpSession is class responsible of receiving and sending data to a client :

• The received data are structured as a HttpRequest in the Request property.
• The sending data are structured as a HttpResponse in the Response property.

Server

/// <summary>
/// Underlying SimpleW Server
/// </summary>
public readonly SimpleWServer Server;

This property can be used to control Server from any Controller class.

JsonEngine

/// <summary>
/// Expose the Server.JsonEngine
/// </summary>
public IJsonEngine JsonEngine;

Request

/// <summary>
/// Last HttpRequest Parsed
/// </summary>
public HttpRequest Request;

When HttpSession receive data from a client, it parses its content into a HttpRequest object and set the Request property. It supports http pipelining.

Response

/// <summary>
/// Current HttpResponse
/// </summary>
public HttpResponse Response;

Before HttpSession call the Dispatcher to execute the underlying handler of the matched Route, it instanciates a new HttpResponse object and set the Response property.

NOTE

You should always used the Response to send data to a client.

SendAsync

WARNING

The SendAsync methods bellow are the lowest level to send data to client. They are barely aliases of Socket.SendAsync() with a thread-safe guard. You should never need to use them but instead use the Response property to send data to a client.

/// <summary>
/// SendAsync native to socket (thread safe)
/// Lower level of sending
/// </summary>
/// <param name="buffer"></param>
/// <returns></returns>
/// <exception cref="InvalidOperationException"></exception>
public async ValueTask SendAsync(ReadOnlyMemory<byte> buffer)

/// <summary>
/// SendAsync to socket (thread safe)
/// Lower level of sending
/// </summary>
/// <param name="segments"></param>
/// <returns></returns>
public async ValueTask SendAsync(ArraySegment<byte>[] segments)

/// <summary>
/// SendAsync to socket (thread safe)
/// Lower level of sending
/// </summary>
/// <param name="header"></param>
/// <param name="body"></param>
/// <returns></returns>
public async ValueTask SendAsync(ArraySegment<byte> header, ArraySegment<byte> body)

/// <summary>
/// SendAsync to socket (thread safe)
/// Lower level of sending
/// </summary>
/// <param name="buffer"></param>
/// <returns></returns>
/// <exception cref="InvalidOperationException"></exception>
public async ValueTask SendAsync(ArraySegment<byte> buffer)

jwt

/// <summary>
/// JWT
/// </summary>
public string jwt { get; set; }

webuser

/// <summary>
/// <para>Get Current IWebUser</para>
/// <para>set by the underlying Controller.webuser
///       The only use case to have a webuser
///       property here is for logging</para>
/// </summary>
public IWebUser webuser { get; set; }