Asd.HttpLib 0.1.12

Asd.HttpLib.

Сервер.

Для работы с ASP.NET.

Program.cs

using Asd.HttpLib.AspNet;

В WebApplicationBuilder вызвать метод расширения "AddAsdHttpServer".

builder.Services.AddAsdHttpServer();

Далее для WebApplication добавить указать типы классов, которые будут содержать методы для ответов на запросы.

app.UseAsdHttpService<ClassName>();

При необходимость можно указать заголовки для ответа на запросы для данного типа.

app.UseAsdHttpService<ClassName>( x => x.AddHeader("Access-Control-Allow-Origin", "*") );

Структура класса.

Можно использовать в конструкторе другие сервисы ASP.NET.

public ClassName( Singleton singleton ) {
  _singleton = singleton;
}

Для обработки запросов используются методы с аннотацией [HttpMethod]

[HttpMethod]
public string SayHello( string name ) {
  return $"Hello, {name}!!!"
}

В таком случае по адресу ${ASP_URL}/SayHello/ можно отправить post запрос. У аннотации HttpMethod есть конструктор, принимающий строку. Эта строка перезаписывает имя метода.

[HttpMethod("say_hello")]
public string SayHello( string name )
...

В данной ситуации адрес будет не "${ASP_URL}/SayHello/", а "${ASP_URL}/say_hello/". Типы входных и выходных данный сериализуются автоматически. Примитивы отправляются в виде обычной строки.

...
return 12;
...

Такой вариант придет клиенту как "12". Непримитивные объекты передаются в виде JSON.

class Student {
  string Name;
}

Если класс Student будет возвращаемым типом метода, то клиент получит ответ в виде.

"{ "Name": "andrewmat2000" }"

Можно использовать несколько входных параметров. Например:

[HttpMethod("login")]
public bool Login( string username, string password ) {
  return username == UserName && password == Password;
}

Для этого агрументы со стороны клиента необходимо разделить ';'.

`${username};${password}`

Клиент.

using HttpClient = Asd.HttpLib.HttpClient;

HttpClient client = new("http://localhost/");  // Uri.

var value = client.Get<T>("method_name");  // T - Expected type.

// Request uri will be http://localhost/method_name/

if (!value) {
  // If response cannot be deserialized.
  throw new("No answer");
}
// Else you can use object with property Value.
T ob = value.Value;