Ручная (расширенная) настройка

Используйте ручную настройку, когда необходимо собрать части сервера самостоятельно, например, когда один процесс должен предоставлять несколько хостов, портов, маршрутизаторов или пользовательскую конфигурацию сервера. Для большинства приложений API построителя короче и предпочтительнее. Ручная настройка полезна, когда нужен прямой контроль над четырьмя основными компонентами: Router, один или несколько объектов ListeningHost, HttpServerConfiguration и конечный HttpServer.

Сначала нам нужно понять концепцию запрос/ответ. Она довольно проста: для каждого запроса должен быть ответ. Sisk следует этому принципу. Давайте создадим метод, который отвечает сообщением «Hello, World!» в HTML, указывая код статуса и заголовки.

// Program.cs
using Sisk.Core.Http;
using Sisk.Core.Routing;

static HttpResponse IndexPage(HttpRequest request)
{
    HttpResponse indexResponse = new HttpResponse
    {
        Status = System.Net.HttpStatusCode.OK,
        Content = new HtmlContent(@"
            <html>
                <body>
                    <h1>Hello, world!</h1>
                </body>
            </html>
        ")
    };

    return indexResponse;
}

Следующий шаг — связать этот метод с HTTP‑маршрутом.

Маршрутизаторы #

Маршрутизаторы — это абстракции маршрутов запросов и служат мостом между запросами и ответами сервиса. Маршрутизаторы управляют маршрутами сервиса, функциями и ошибками.

Маршрутизатор может иметь несколько маршрутов, и каждый маршрут может выполнять разные операции по этому пути, такие как вызов функции, отдача страницы или предоставление ресурса с сервера.

Создадим наш первый маршрутизатор и привяжем метод IndexPage к пути индекса.

Router mainRouter = new Router();

mainRouter.MapGet("/", IndexPage);

Теперь наш маршрутизатор может принимать запросы и отправлять ответы. Однако mainRouter не привязан к хосту или серверу, поэтому сам по себе он не будет работать. Следующий шаг — создать наш ListeningHost.

Хосты прослушивания и порты #

ListeningHost может размещать маршрутизатор и несколько прослушиваемых портов для одного и того же маршрутизатора. ListeningPort — это префикс, на котором HTTP‑сервер будет слушать.

Здесь мы можем создать ListeningHost, который указывает на два конечных пункта для нашего маршрутизатора:

ListeningHost myHost = new ListeningHost
{
    Router = mainRouter,
    Ports = new ListeningPort[]
    {
        new ListeningPort("http://localhost:5000/")
    }
};

Теперь наш HTTP‑сервер будет слушать указанные конечные пункты и перенаправлять запросы к нашему маршрутизатору.

Конфигурация сервера #

Конфигурация сервера отвечает за большую часть поведения самого HTTP‑сервера. В этой конфигурации мы можем связать ListeningHosts с нашим сервером.

HttpServerConfiguration config = new HttpServerConfiguration();
config.ListeningHosts.Add(myHost); // Добавляем наш ListeningHost в эту конфигурацию сервера

Общие параметры конфигурации сервера:

Далее создаём наш HTTP‑сервер:

HttpServer server = new HttpServer(config);
server.Start();    // Запускает сервер
Console.ReadKey(); // Предотвращает завершение приложения

Теперь мы можем собрать исполняемый файл и запустить наш HTTP‑сервер командой:

dotnet watch

Во время выполнения откройте браузер и перейдите по пути сервера — вы должны увидеть: