如何为ASP.NET Web API创建与GET功能相同的自定义谓词FOO

1. 注册自定义谓词到路由系统 #

根据你的.NET版本，在启动配置中添加FOO谓词的支持：

.NET Core/.NET 5+（Program.cs） #

builder.Services.AddRouting(options =>
{
    // 添加FOO谓词的路由策略
    options.AddPolicy("FOO", policy => policy.RequireMethod("FOO"));
});

ASP.NET Framework（Global.asax.cs） #

protected void Application_Start()
{
    RouteTable.Routes.MapHttpRoute(
        name: "FOOApi",
        routeTemplate: "api/{controller}/{id}",
        defaults: new { id = RouteParameter.Optional },
        constraints: new { httpMethod = new HttpMethodConstraint("FOO") }
    );
}

2. 修改控制器方法适配FOO谓词 #

在目标控制器方法上添加[AcceptVerbs("FOO")]特性，同时保留[FromUri]，让参数仍从URL绑定，和GET逻辑完全一致：

[AcceptVerbs("FOO")]
public IHttpActionResult FetchLongData([FromUri] LongRequestParams model)
{
    // 业务逻辑处理
    return Ok(model);
}

3. 调整服务器的请求长度限制 #

无论是自定义谓词还是GET，长URL都需要调整服务器的长度限制配置：

.NET Core/.NET 5+（appsettings.json） #

"Kestrel": {
    "Limits": {
        "MaxRequestLineSize": 65536, // 设置为合适的大小，比如64KB
        "MaxRequestHeadersTotalSize": 65536
    }
}

ASP.NET Framework（web.config） #

<system.web>
    <httpRuntime maxUrlLength="65536" maxQueryStringLength="65536" />
</system.web>
<system.webServer>
    <security>
        <requestFiltering>
            <requestLimits maxUrl="65536" maxQueryString="65536" />
        </requestFiltering>
    </security>
</system.webServer>

4. 客户端发送FOO请求示例 #

用HttpClient发送自定义FOO请求，参数直接拼接在URL中，和GET请求格式一致：

using (var client = new HttpClient())
{
    var requestUri = "https://your-domain/api/yourcontroller?longParam1=xxx&longParam2=yyy...";
    var request = new HttpRequestMessage(new HttpMethod("FOO"), requestUri);
    var response = await client.SendAsync(request);
    response.EnsureSuccessStatusCode();
}

注意事项 #

• 若使用反向代理（如Nginx、IIS），需确保代理允许传递FOO谓词，避免被拦截。
• 如需在Swagger中测试，需添加自定义OperationFilter，让Swagger识别并显示FOO谓词的接口。

内容的提问来源于stack exchange，提问作者Andrew