大摇大摆显示不正确的查询参数

Question

我有这个控制器和操作方法：

[ApiController]
[Route("api/[controller]")]
public class AppointmentController : ControllerBase
{        
    [Route("{provider}/AvailableSlots")]
    [HttpGet]        
    public Task<AvailableSlotsResponse> GetAvailableSlots(Request<AvailableSlotsRequest> request)
    {
        return null;
    }
}

下面是模型：

    public class Request<T> where T : class
    {
        [FromRoute]
        public string Provider { get; set; }
        [FromQuery(Name = "")]
        public T Model { get; set; }
    }

    public class AvailableSlotsRequest
    {
        //[FromQuery(Name = "Location")] //Would prefer not to have to use this
        public string Location { get; set; }
    }

我需要使用＜code＞Location＜/code＞作为URL中的查询参数名称，以便按预期到达endpoint。

例如< code > http://localhost/API/Appointment/Company/available slots？位置=SYD

然而，当我查看Swagger页面时，该参数被称为＜code＞Model。位置，这让我的API的消费者感到困惑：

我可以使用< code >[from query(Name = " Location ")]来强制Swagger显示< code>Location，但是这感觉非常多余，并且重复了属性名。

这是我在配置服务（）中设置的Swagger：

services.AddSwaggerDocument(document =>
            {
                document.PostProcess = d =>
                {
                    d.Info.Version = Configuration["APIVersion"];
                    d.Info.Title = $"{Configuration["ApplicationName"]} {Configuration["DomainName"]} API";
                };
            });

如何让Swagger显示< code >位置而不是< code >型号？Location，而不必在< code>[FromQuery]属性中重复单词“Location”？

Answer 1

不幸的是，我不得不使用[FromQuery（Name=“

然而，我找到了一个更好的方法：

[ApiController]
[Route("api/[controller]")]
public class AppointmentController : ControllerBase
{        
    [Route("{provider}/AvailableSlots")]
    [HttpGet]        
    public Task<AvailableSlotsResponse> GetAvailableSlots(AvailableSlotsRequest request)
    {
        return null;
    }
}

public class Request
{
    [FromRoute]
    public string ProviderName { get; set; }
}

public class AvailableSlotsRequest : Request
{
    [FromQuery]
    public string Location { get; set; }
}

这也意味着模型可以使用任何属性，而我第一次尝试用 [FromQuery] 装饰 T 模型。

Answer 2

将属性[FromRoute]添加到控制器参数：

    public Task<AvailableSlotsResponse> GetAvailableSlots([FromRoute]Request<AvailableSlotsRequest> request)

删除Model属性中的属性＜code＞FromQuery＜/code＞，并从de Location属性中取消注释属性＜code＜FromQuery