用最清爽的方式开发dotNet

不管是官方自带模板还是其他开源搞的，总是一来一大堆，如果你也嫌弃这些过于臃肿，不如看看我这个方式

前提

假设我要做一个简单的api

方式

想到清爽，那肯定是简单方便，脑袋第一个念头就是.Net6 推出的miniapi了

官方路子

两篇官方文档足以，按照文档step by step 就ok了，其他的需要就加

我的野路子

官方是官方，官方走的路子当然还是基于它最标准的搞法，我的路子则是基于国内实际情况
总体思路就是用控制台改api

模拟前提场景

搞一个普通企业官网的api，那么要求就是以下几点

需要数据库操作
需要授权鉴权
需要swagger文档
需要上传文件

根据这些要求，我需要引入最基本的就几个：

Swashbuckle.AspNetCore （swagger相关）
SqlSugarCore （sqlsugar Orm）
Microsoft.AspNetCore.Authentication.JwtBearer （授权鉴权这里用简单的jwt）
Mapster （dto和entity互转）

如果有其他需求，再自己加，一点也不冗余

代码

Program.cs 里面直接无脑写下以下代码

var builder = WebApplication.CreateBuilder(args);


> dotNet 几忘了，反正很早就是通用主机了，如果你同时还要搞blazor server啥的，把这一坨封装一下即可，通用的

var builder = WebApplication.CreateBuilder(args);

#region 基本设置
builder.Services.AddMemoryCache();
builder.Services.AddControllers();
builder.Services.Configure<FormOptions>(options =>
{
    // 设置上传大小限制256MB
    options.MultipartBodyLengthLimit = 268435456;

});
builder.Services.AddSingleton<SqlSugarMemoryCacheService>();
#endregion

#region 授权鉴权


// 添加身份验证和授权中间件
builder.Services.AddAuthentication(JwtBearerDefaults.AuthenticationScheme)
    .AddJwtBearer(options =>
    {
        options.TokenValidationParameters = new TokenValidationParameters
        {
            ValidateIssuer = true,
            ValidateAudience = true,
            ValidateLifetime = true,
            ValidateIssuerSigningKey = true,
            ValidIssuer = "ningissuer",
            ValidAudience = "wr",
            IssuerSigningKey = new SymmetricSecurityKey(Encoding.UTF8.GetBytes("sdfsdfsrty45634kkhxxhtdgdfss345t678xx"))
        };
    });

builder.Services.AddAuthorization(options =>
{
    options.AddPolicy("AdminOnly", policy =>
    {
        policy.RequireClaim("role", "admin");
    });
});

#endregion

#region swagger
builder.Services.AddEndpointsApiExplorer();
builder.Services.AddSwaggerGen(c =>
{
    c.SwaggerDoc("v1", new OpenApiInfo { Title = "企业官网Api", Version = "v1" });

    // 添加身份验证
    c.AddSecurityDefinition("Bearer", new OpenApiSecurityScheme
    {
        Description = "JWT Authorization header using the Bearer scheme",
        Name = "Authorization",
        In = ParameterLocation.Header,
        Type = SecuritySchemeType.ApiKey
    });

    // 添加授权要求
    c.AddSecurityRequirement(new OpenApiSecurityRequirement
        {
            {
                new OpenApiSecurityScheme
                {
                    Reference = new OpenApiReference
                    {
                        Type = ReferenceType.SecurityScheme,
                        Id = "Bearer"
                    }
                },
                new string[] {}
            }
        });

    // 设置 XML 注释文件的路径
    var xmlFile = $"{Assembly.GetExecutingAssembly().GetName().Name}.xml";
    var xmlPath = Path.Combine(AppContext.BaseDirectory, xmlFile);
    c.IncludeXmlComments(xmlPath);
});
#endregion

var app = builder.Build();
app.UseSwagger();
app.UseStaticFiles();
// 启用身份验证和授权中间件
app.UseAuthentication();
app.UseRouting();
app.UseAuthorization();
app.UseEndpoints(endpoints =>
{
    endpoints.MapControllers(); // 这里配置了使用控制器的路由
});
app.UseSwaggerUI(c =>
{
    c.SwaggerEndpoint("/swagger/v1/swagger.json", "企业官网Api");
    c.RoutePrefix = string.Empty; // 将 Swagger UI 设置为应用程序的根路径
});

ServiceLocator.Instance = app.Services;
ServiceLocator.ApplicationBuilder = app;

var db = SqlSugarHelper.Db;
//数据库初始化
app.MapGet("/seed", async () =>
{


    db.CodeFirst.InitTables<SysUserEntity>();

    string name = "op";
    string pwd = "op";
    var loginResult = await db.Queryable<SysUserEntity>().Where(a => !a.IsBan && a.UsePwd == pwd && a.UserName == name).AnyAsync();
    if (!loginResult)
    {
        await db.Insertable<SysUserEntity>(new SysUserEntity { IsBan = false, UsePwd = pwd, UserName = name }).ExecuteCommandAsync();
    }

    db.CodeFirst.InitTables<FileSourceEntity>();
    db.CodeFirst.InitTables<ArticleEntity>();

});

app.MapGet("/health", () => "1024");

app.Run();

接口就“勉为其难”的新建个api文件夹然后

Alt text


/// <summary>
    /// 系统用户
    /// </summary>
    [Route("api/[controller]/[action]")]
    [ApiController]
    public class SysUserController : BaseApi
    {
        public SysUserController()
        {

        }

        /// <summary>
        /// 检测Token信息
        /// </summary>
        /// <returns></returns>
        [HttpGet]
        [Authorize]
        public ApiResult CheckToken()
        {

            var httpContext = HttpContext;

            // 从请求头中获取 Authorization 标头的值
            var authorizationHeader = httpContext.Request.Headers["Authorization"].FirstOrDefault();

            if (!string.IsNullOrEmpty(authorizationHeader) && authorizationHeader.StartsWith("Bearer "))
            {
                // 提取令牌字符串（去除 "Bearer " 前缀）
                var token = authorizationHeader.Substring(7);

                var tokenHandler = new JwtSecurityTokenHandler();
                var jwtToken = tokenHandler.ReadJwtToken(token);

                // 获取 ClaimTypes.Name 的值
                var username = jwtToken.Claims.FirstOrDefault(claim => claim.Type == "name")?.Value;

                // 在这里使用 username 进行其他操作

                return Success($"当前Token用户是:{username}");
            }

            return Error("Toekn信息解析失败");
        }

        /// <summary>
        /// 登录
        /// </summary>
        /// <param name="model"></param>
        /// <returns></returns>
        [AllowAnonymous]
        [HttpPost]
        public async Task<ApiResult> Login(SysUserEntity model)
        {
            string secretKey = "sdfsdfsrty45634kkhxxhtdgdfss345t678xx";
            var loginResult = await db.Queryable<SysUserEntity>().Where(a => !a.IsBan && a.UsePwd == model.UsePwd && a.UserName == model.UserName).AnyAsync();
            // 验证用户名和密码

            if (!loginResult)
            {
                return Error("账号密码错误");
            }

            // 生成 JWT 令牌
            var tokenHandler = new JwtSecurityTokenHandler();

            var key = Encoding.ASCII.GetBytes(secretKey);
            var tokenDescriptor = new SecurityTokenDescriptor
            {
                Subject = new ClaimsIdentity(new List<Claim>
                {
                    new Claim(ClaimTypes.Name, model.UserName),
                    new Claim(JwtRegisteredClaimNames.Jti, model.Id.ToString()),
                    new Claim(JwtRegisteredClaimNames.Iat, DateTime.Now.ToString()),
                    new Claim(ClaimTypes.Expiration, DateTime.Now.AddHours(10).ToString())
                }),
                Expires = DateTime.UtcNow.AddDays(7),
                SigningCredentials = new SigningCredentials(new SymmetricSecurityKey(key), SecurityAlgorithms.HmacSha256Signature),
                Issuer = "ningissuer",
                Audience = "wr",
               
            };
            var token = tokenHandler.CreateToken(tokenDescriptor);
            var tokenString = tokenHandler.WriteToken(token);
            // 返回 JWT 令牌
            return Success(new { token = "Bearer " + tokenString });
        }
    }

到这里，基本上已经结束了