EasilyNET.WebCore.Swagger 1.9.0-preview1

.NET 6.0 This package targets .NET 6.0. The package is compatible with this framework or higher.
This is a prerelease version of EasilyNET.WebCore.Swagger.
There is a newer version of this package available.
See the version list below for details. 
dotnet add package EasilyNET.WebCore.Swagger --version 1.9.0-preview1
                    


                    

                
NuGet\Install-Package EasilyNET.WebCore.Swagger -Version 1.9.0-preview1
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package. 
<PackageReference Include="EasilyNET.WebCore.Swagger" Version="1.9.0-preview1" />
For projects that support PackageReference, copy this XML node into the project file to reference the package. 
<PackageVersion Include="EasilyNET.WebCore.Swagger" Version="1.9.0-preview1" />
                    


                            Directory.Packages.props
                        

                    

                
<PackageReference Include="EasilyNET.WebCore.Swagger" />
                    


                            Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package. 
paket add EasilyNET.WebCore.Swagger --version 1.9.0-preview1
                    


                    

                
#r "nuget: EasilyNET.WebCore.Swagger, 1.9.0-preview1"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package. 
#addin nuget:?package=EasilyNET.WebCore.Swagger&version=1.9.0-preview1&prerelease
                    


                            Install EasilyNET.WebCore.Swagger as a Cake Addin
                        

                    

                
#tool nuget:?package=EasilyNET.WebCore.Swagger&version=1.9.0-preview1&prerelease
                    


                            Install EasilyNET.WebCore.Swagger as a Cake Tool

EasilyNET.WebCore.Swagger

将 Swagger 的扩展独立出来,避免 WebCore 的过度依赖.

  • 新增 Swagger 页面参数忽略.比如某些默认参数不需要调用者传入,并且也不希望他看见
  • 接口隐藏,或者控制器隐藏
  • 添加默认值显示 代码示例
  • 在 Swagger 文档中给需要 Authorize 的接口添加 🔒

可用特性

  • ApiGroupAttribute 对控制器进行分组.便于将特有的功能分到一个组方便管理.
  • HiddenApiAttribute 隐藏控制器或者单个接口.
  • SwaggerIgnoreAttribute 忽略接口参数或者传入实体的属性 代码示例

如何使用?

// 添加 Swagger 服务
private const string name = $"{title}-{version}";

private const string version = "v1";
private const string title = "WebApi.Test";

builder.Services.AddSwaggerGen(c =>
{
    // 配置默认的文档信息
    c.SwaggerDoc(name, new()
    {
        Title = title,
        Version = version,
        Description = "Console.WriteLine(\"🐂🍺\")"
    });
    // 这里使用EasilyNET提供的扩展配置.
    c.EasilySwaggerGenOptions(name);
    // 配置认证方式
    c.AddSecurityDefinition("Bearer", new()
    {
        Description = "JWT Authorization header using the Bearer scheme. Example: \"Authorization: Bearer {token}\"",
        Name = "Authorization",
        In = ParameterLocation.Header,
        Type = SecuritySchemeType.ApiKey,
        Scheme = "Bearer"
    });
});

...

// 注册 Swagger 中间件
app.UseSwagger().UseSwaggerUI(c =>
{
    // 配置默认文档
    c.SwaggerEndpoint($"/swagger/{name}/swagger.json", $"{title} {version}");
    // 使用EasilyNET提供的扩展配置
    c.EasilySwaggerUIOptions();
});
Product Compatible and additional computed target framework versions.
.NET net6.0 is compatible.  net6.0-android was computed.  net6.0-ios was computed.  net6.0-maccatalyst was computed.  net6.0-macos was computed.  net6.0-tvos was computed.  net6.0-windows was computed.  net7.0 is compatible.  net7.0-android was computed.  net7.0-ios was computed.  net7.0-maccatalyst was computed.  net7.0-macos was computed.  net7.0-tvos was computed.  net7.0-windows was computed.  net8.0 is compatible.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed.  net9.0 was computed.  net9.0-android was computed.  net9.0-browser was computed.  net9.0-ios was computed.  net9.0-maccatalyst was computed.  net9.0-macos was computed.  net9.0-tvos was computed.  net9.0-windows was computed.  net10.0 was computed.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
4.25.609.190 154 6/9/2025
2.2.5 149 3/26/2024
2.2.4 134 3/25/2024
2.2.3 151 3/24/2024
2.2.2 174 3/21/2024
2.2.1 152 3/20/2024
2.2.0 157 3/13/2024
2.1.9 169 2/21/2024
2.1.8 130 2/18/2024
2.1.7 147 2/16/2024
2.1.6 143 2/14/2024
2.1.5 137 2/14/2024
2.1.4 162 2/9/2024
2.1.3 162 2/8/2024
2.1.2 150 2/5/2024
2.1.1.2 218 12/26/2023
2.1.1.1 170 12/26/2023
2.1.1 171 12/25/2023
2.1.0 166 12/17/2023
2.0.11 233 12/6/2023
2.0.1 220 11/15/2023
2.0.0 173 11/14/2023
1.9.1 173 11/1/2023
1.9.0 176 10/19/2023
1.9.0-preview2 316 10/12/2023
1.9.0-preview1 153 10/12/2023
1.8.9 207 10/11/2023
1.8.8 189 10/11/2023
1.8.7-rc2 157 9/21/2023
1.8.7-rc1 161 9/12/2023
1.8.6 221 8/31/2023
1.8.5 846 8/25/2023
1.8.4 197 8/24/2023
1.8.3 221 8/23/2023
1.8.2 249 8/22/2023
1.8.1 223 8/18/2023
1.8.0 194 8/15/2023
1.7.9 230 8/11/2023
1.7.8 182 8/11/2023
1.7.7 211 8/10/2023
1.7.6 202 8/9/2023
1.7.5 248 8/9/2023
1.7.4 303 8/3/2023
1.7.3 224 8/1/2023
1.7.2 206 7/31/2023
1.7.1 188 7/27/2023
1.7.0 211 7/25/2023
1.6.9 234 7/25/2023
1.6.8 204 7/24/2023
1.6.7 229 7/20/2023
1.6.6 212 7/19/2023
1.6.5 188 7/19/2023
1.6.4 202 7/17/2023
1.6.3 191 7/17/2023
1.6.2 266 7/12/2023
1.6.1 271 6/30/2023
1.6.0 192 6/26/2023
1.5.9 230 6/22/2023
1.5.8 256 6/15/2023
1.5.7.1 241 6/14/2023
1.5.7 250 6/14/2023
1.5.6.2 254 6/7/2023
1.5.6.1 225 6/7/2023
1.5.6 224 6/7/2023
1.5.5.2 276 5/26/2023
1.5.5.1 239 5/26/2023
1.5.5 241 5/26/2023
1.5.4.4 216 5/25/2023
1.5.4.3 239 5/23/2023
1.5.4.2 311 5/17/2023
1.5.4.1 211 5/16/2023
1.5.4 301 5/11/2023
1.5.3 224 5/11/2023
1.5.2 250 5/10/2023
1.5.1 210 5/10/2023
1.5.0 259 5/6/2023
1.4.0 231 5/5/2023
1.3.9 283 4/23/2023