Fast.JwtBearer 3.5.30

简体中文 | English

<p align="center"> <img src="Fast.png" width="160" alt="Fast.NET Logo" /> </p>

<h1 align="center">Fast.NET</h1>

<p align="center"> 面向现代 .NET 应用的模块化基础设施 SDK </p>

<p align="center"> <a href="https://www.nuget.org/packages/Fast.NET.Core"><img src="https://img.shields.io/nuget/v/Fast.NET.Core.svg?label=Fast.NET.Core&logo=nuget" alt="NuGet version" /></a> <a href="https://www.nuget.org/packages/Fast.NET.Core"><img src="https://img.shields.io/nuget/dt/Fast.NET.Core.svg?logo=nuget" alt="NuGet downloads" /></a> <img src="https://img.shields.io/badge/.NET-6.0%20%7C%207.0%20%7C%208.0%20%7C%209.0%20%7C%2010.0-512BD4?logo=dotnet" alt="Supported .NET versions" /> <a href="LICENSE"><img src="https://img.shields.io/badge/license-Apache--2.0-blue.svg" alt="Apache-2.0 License" /></a> </p>

Fast.NET 是一组可按需组合的 .NET 基础设施库，覆盖 Web 应用初始化、依赖注入、缓存、事件总线、日志、对象映射、认证、数据访问、序列化、动态 API、统一响应、Swagger/OpenAPI 与 Consul 集成。每项能力都以独立 NuGet 包交付，应用只需引用真正需要的模块。

Fast.NET 不是一个必须整体引入的“大而全”框架。它更像一组具有一致设计和配置体验的 SDK 组件，可用于 ASP.NET Core、Worker Service，以及适合对应模块的其他现代 .NET 应用。

为什么选择 Fast.NET

• 模块化：17 个独立包，按需安装，避免无关依赖进入应用。
• 多版本兼容：主要模块同时支持 net6.0、net7.0、net8.0、net9.0、net10.0。
• 通用基础设施：Fast.IaaS 保持 netstandard2.1，便于被不同现代 .NET 项目复用。
• 一致的扩展方式：围绕 IServiceCollection、WebApplicationBuilder 和 IApplicationBuilder 提供惯用扩展方法。
• 可独立采用：缓存、日志、序列化、数据访问等模块可单独使用，无需绑定完整技术栈。
• 面向发布：统一生成 XML 文档、NuGet 包和符号包，并提供交互式 Windows 发布脚本。

兼容性

netstandard2.1 不支持传统 .NET Framework。如果应用仍运行在 .NET Framework 上，需要单独评估兼容方案。

快速开始

1. 安装所需模块

Fast.NET 没有强制性的总包。请选择实际需要的 NuGet 包：

dotnet add package Fast.NET.Core
dotnet add package Fast.Serialization.System.Text.Json
dotnet add package Fast.Swagger

例如，需要 Redis 缓存、JWT 认证或 SqlSugar 时，再分别安装：

dotnet add package Fast.Cache
dotnet add package Fast.JwtBearer
dotnet add package Fast.SqlSugar

Fast.Serialization.System.Text.Json 与 Fast.Serialization.Newtonsoft.Json 提供相同风格的序列化扩展。通常根据项目技术选型选择其中一个。

2. 注册服务

下面展示一个组合多个模块的 ASP.NET Core 示例。只保留项目实际安装的模块即可。

using Fast.Cache;
using Fast.DependencyInjection;
using Fast.DynamicApplication;
using Fast.EventBus;
using Fast.JwtBearer;
using Fast.Logging;
using Fast.Mapster;
using Fast.NET.Core;
using Fast.OpenApi;
using Fast.Serialization;
using Fast.SqlSugar;
using Fast.Swagger;
using Fast.UnifyResult;

var builder = WebApplication.CreateBuilder(args);

builder.Initialize();
builder.AddCorsAccessor();

builder.Services.AddSerialization();
builder.Services.AddGzipCompression();
builder.Services.AddMapster();
builder.Services.AddDependencyInjection();
builder.Services.AddEventBus();
builder.Services.AddCache();
builder.Services.AddLoggingService(builder.Configuration);
builder.Services.AddSqlSugar(builder.Configuration, builder.Environment);
builder.Services.AddJwtBearer(builder.Configuration);
builder.Services.AddUnifyResult();
builder.Services.AddDynamicApplication();
builder.Services.AddSwaggerDocuments(builder.Configuration);
builder.Services.AddOpenApi(builder.Configuration);
builder.Services.AddControllers();

var app = builder.Build();

app.UseHttpsRedirection();
app.UseStaticFiles();
app.EnableBuffering();
app.UseRouting();
app.UseSwaggerDocuments();
app.MapControllers();

app.Run();

各模块的默认配置节点和可选参数以对应源码中的 *SettingsOptions 与扩展方法 XML 文档为准。

项目架构

flowchart TB
    app["ASP.NET Core / Worker / Console 应用"]

    subgraph api["Web 与 API 集成"]
        swagger["Fast.Swagger"]
        openapi["Fast.OpenApi"]
        dynamic["Fast.DynamicApplication"]
        unify["Fast.UnifyResult"]
        jwt["Fast.JwtBearer"]
        consul["Fast.Consul"]
    end

    subgraph capability["基础设施能力"]
        cache["Fast.Cache"]
        eventbus["Fast.EventBus"]
        logging["Fast.Logging"]
        mapster["Fast.Mapster"]
        di["Fast.DependencyInjection"]
        sqlsugar["Fast.SqlSugar"]
        serialization["Fast.Serialization.*"]
    end

    subgraph foundation["核心基础"]
        core["Fast.NET.Core"]
        runtime["Fast.Runtime"]
        iaas["Fast.IaaS · netstandard2.1"]
    end

    app --> api
    app --> capability
    api --> foundation
    capability --> foundation
    core --> runtime
    swagger --> dynamic
    dynamic --> unify
    consul --> core
    consul --> iaas

这张图展示模块的职责分层；实际项目引用关系、启动流程和扩展边界请参阅架构说明。

模块目录

仓库结构

Fast.NET/
├─ src/                         # 17 个可独立发布的 SDK 模块
├─ docs/                        # 中英文架构与设计文档
├─ translateTool/               # Vue 国际化文案提取与回写工具
├─ Directory.Build.props        # 统一目标框架、打包和仓库元数据
├─ global.json                  # .NET SDK 选择策略
├─ Fast.NET.sln                 # 主解决方案
├─ UploadNuget.bat              # Windows 交互式构建与 NuGet 发布工具
├─ README.zh.md / README.md     # 中英文项目入口
└─ LICENSE                      # Apache-2.0 许可证

本地构建

安装与 global.json 匹配的 .NET SDK 后执行：

dotnet restore Fast.NET.sln
dotnet build Fast.NET.sln -c Release

生成 NuGet 包：

dotnet pack Fast.NET.sln -c Release --no-restore

Windows 用户也可以双击 UploadNuget.bat，选择构建配置后，仅打包、上传全部包，或上传指定的单个包。

文档与协作

• 架构说明
• 贡献指南
• 国际化工具
• 更新记录
• 问题反馈
• 参与贡献

提交代码前请至少完成受影响目标框架的构建验证，并保持中英文公共文档同步。

许可证

Fast.NET 基于 Apache License 2.0 开源。使用、修改和分发本项目时，请遵守许可证及适用法律。

维护者

由 小方（1.8K 仔） 发起并维护。欢迎通过 Issue 和 Pull Request 参与完善 Fast.NET，为 .NET 生态提供更多可靠、易组合的基础设施选择。