FastEndpoints项目中Swagger参数默认驼峰命名解析

在FastEndpoints项目中，Swagger文档默认会以驼峰命名法(CamelCase)显示请求参数名称。这一特性对于保持API文档的一致性和可读性非常重要。

默认行为分析

FastEndpoints框架内置了对Swagger的支持，当开发者使用标准方式配置时，请求DTO中的属性会自动以驼峰命名形式展示在Swagger UI中。例如：

public class SampleRequest
{
    public string UserName { get; set; }  // 在Swagger中显示为"userName"
    public int AgeGroup { get; set; }     // 在Swagger中显示为"ageGroup"
}

这种默认行为符合大多数REST API的设计规范，使得前端开发者能够更自然地使用这些API。

实现原理

FastEndpoints通过以下机制实现这一特性：

1. 内部集成了Swagger生成器
2. 自动应用了.NET默认的JSON序列化设置
3. 遵循了OpenAPI规范的最佳实践

当开发者调用SwaggerDocument()方法时，框架会自动配置这些默认行为，无需额外设置。

自定义配置选项

虽然框架提供了合理的默认值，但开发者仍可以通过以下方式调整Swagger的命名策略：

services.AddFastEndpoints()
    .SwaggerDocument(o =>
    {
        o.SerializerSettings = new() 
        {
            ContractResolver = new DefaultContractResolver
            {
                NamingStrategy = new CamelCaseNamingStrategy()
            }
        };
    });

这种显式配置方式可以确保命名策略的一致性，即使在项目中有其他可能影响序列化的设置时也能保持预期行为。

最佳实践建议

1. 保持DTO属性使用PascalCase命名法
2. 让Swagger自动处理为camelCase输出
3. 仅在特殊需求时覆盖默认行为
4. 确保整个项目使用一致的命名策略

通过理解这些默认行为和配置选项，开发者可以更高效地使用FastEndpoints构建符合行业标准的API文档。