Блог

Я работаю с некоторым уже существующим кодом, который использует конечную точку HttpGet для получения всех комментариев. Он принимает некоторые параметры по умолчанию, и перед каждым параметром он украшен [FromQuery] атрибутом. Я немного смущен тем, зачем нам это нужно здесь и что это действительно делает для меня.

В Интернете не так много всего, что я нашел, это документация: ( https://learn.microsoft.com/en-us/dotnet/api/microsoft.aspnetcore.mvc.fromqueryattribute?view=aspnetcore-2.2 )

Однако это не отвечает на мой вопрос…

• Что такое строка запроса?
• Как это используется в конечных точках?
• Когда мне не нужно указывать этот атрибут? Я не вижу, чтобы он использовался очень часто.

 [HttpGet]
[ProducesResponseType(typeof(FooResponse), 200),
public async Task<ActionResult<FooResponse>> GetAll([FromQuery]string sortColumn = "CommentId",
    [FromQuery]SortDirections sortDirection = SortDirections.Asc, 
    [FromQuery]string filter = "", 
    [FromQuery]int page = 1, 
    [FromQuery]int pageSize = 10)
{
    var data = await _mediator.Send(new GetAllComments(sortColumn, sortDirection, filter, page, pageSize));
.
.
.
    return Ok(data);
}
  

Я подозреваю, что это как-то связано с тем, что передается в URL, но я не совсем уверен…

Использование здесь излишне. Действие будет функционировать одинаково без [FromQuery] применения ко всем параметрам, поскольку оно отвечает только на запросы GET.

Что такое строка запроса?

Строка запроса — это часть URI после применения ? символа. Он представляет собой часть данных URI по сравнению с частью чистой маршрутизации.

Как это используется в конечных точках?

Вопрос здесь немного запутанный, поэтому было бы уместнее спросить «Как он используется в запросе?» Ответ на это — это способ передачи данных вместе с запросом GET в определенный URI. В отличие от других методов HTTP, GET на самом деле не разрешает «тело» запроса. (На самом деле, спецификация технически допускает это, но это почти повсеместно не реализовано таким образом.)