简化.NET开发，拥抱清爽的MiniAPI方法
内容提要
本文介绍了利用.NET 6的MiniAPI特性开发API的方法。MiniAPI提供了一个轻量级的起点，但本文将探讨一种更为直接的方法。通过选择核心组件和配置服务和中间件，可以简化API开发。这种开发方式适用于中小公司项目，结构清晰易于学习和理解。开发者应该利用现有的开源资源和库，技术应该为业务服务。
延伸解读
从控制台改造为Web项目的关键步骤
文章指出，将项目文件中的Sdk从Microsoft.NET.Sdk改为Microsoft.NET.Sdk.Web，是启用Web项目特有配置的关键。这一改动使得控制台应用程序能够使用ASP.NET Core的Web功能，如中间件、依赖注入和控制器。对于习惯传统模板的开发者，这种改造方式减少了项目结构的复杂性，同时保留了Web开发的核心能力。
核心组件选型与作用
文章选择了四个核心组件：Swashbuckle.AspNetCore用于生成Swagger文档，SqlSugarCore作为ORM简化数据库操作，Microsoft.AspNetCore.Authentication.JwtBearer处理JWT授权鉴权，Mapster负责DTO与Entity的转换。这些组件都是开源库，覆盖了企业官网API的常见需求，如文档、数据访问、安全和对象映射，帮助开发者避免重复造轮子。
适用场景与学习曲线
这种基于MiniAPI的清爽开发方式适用于中小公司项目，结构清晰，易于管理和扩展。对于新手而言，项目框架直观，便于学习和理解。但文章也暗示，这种方法可能不适合大型复杂项目，因为其简化特性可能缺乏某些高级功能。开发者应根据项目规模和团队熟悉度权衡选择。
技术服务于业务的实践理念
文章强调，技术应该服务于业务，而不是为了技术本身。通过利用现有的开源资源和库，开发者可以快速构建满足业务需求的API，避免过度设计和复杂化。这种理念鼓励开发者关注业务价值，而非技术堆砌，尤其适合资源有限的中小团队。
Q&A
MiniAPI是什么，它有什么优势？
MiniAPI是.NET 6中的一个特性，旨在简化API开发，提供轻量级的起点，帮助开发者更高效地构建API。
如何使用MiniAPI开发一个企业官网API？
可以通过改造控制台应用程序，选择核心组件如Swashbuckle.AspNetCore和SqlSugarCore，并配置服务和中间件来开发企业官网API。
在MiniAPI项目中，如何配置JWT授权？
在项目中使用`AddAuthentication`方法配置JWT授权，设置`tokenValidationParameters`以实现JWT的验证。
MiniAPI适合什么类型的项目？
MiniAPI适合中小公司项目，因为它结构清晰、易于学习和理解，便于管理和扩展。
在MiniAPI中如何生成Swagger文档？
可以通过`AddSwaggerGen`方法配置Swagger，指定API文档的标题和版本，从而生成Swagger文档。
开发者在使用MiniAPI时应注意什么？
开发者应利用现有的开源资源和库，避免重复造轮子，确保技术服务于业务需求。
