DNTFrameworkCore 使用教程
项目介绍
DNTFrameworkCore 是一个基于 ASP.NET Core 的轻量级和可扩展的基础设施,用于构建高质量的 Web 应用程序。它提供了多种功能,包括基于权限的授权、CRUD API 构建、CRUD MVC 控制器等。DNTFrameworkCore 支持多种扩展库,如 EFCore、FluentValidation 和多租户支持等。
项目快速启动
安装项目模板
首先,安装基于 ASP.NET Core Web API 和 DNTFrameworkCore 的 boilerplate 项目模板:
dotnet new --install DNTFrameworkCoreTemplateAPI::*
创建新项目
使用安装的模板创建新项目:
dotnet new dntcore-api
项目结构
创建的项目结构如下,包含完整的身份管理功能,包括用户、角色和动态权限管理,以及集成了持久 JWT 认证机制:
DNTFrameworkCore.API/
├── src/
│ ├── DNTFrameworkCore.API.Application/
│ ├── DNTFrameworkCore.API.Domain/
│ ├── DNTFrameworkCore.API.Infrastructure/
│ ├── DNTFrameworkCore.API.Web/
│ └── DNTFrameworkCore.API.sln
├── test/
│ └── DNTFrameworkCore.API.Tests/
├── .gitignore
├── .gitattributes
├── LICENSE
├── README.md
└── global.json
运行项目
导航到项目目录并运行项目:
cd DNTFrameworkCore.API
dotnet run
应用案例和最佳实践
应用案例
DNTFrameworkCore 可以用于构建各种 Web 应用程序,包括但不限于:
- 企业内部管理系统
- 电子商务平台
- 内容管理系统
最佳实践
- 模块化设计:将应用程序划分为多个模块,每个模块负责特定的功能。
- 权限管理:使用 DNTFrameworkCore 提供的基于权限的授权机制,确保系统的安全性。
- 代码生成:利用 DNTFrameworkCore 提供的代码生成工具,快速生成 CRUD 操作的代码。
典型生态项目
DNTFrameworkCore.EFCore
提供基于 EFCore 的 IEntityService 实现、日志记录和事务拦截功能。
DNTFrameworkCore.FluentValidation
提供基于 FluentValidation 库的 IModelValidator 实现,用于模型验证。
DNTFrameworkCore.Web.MultiTenancy
提供多租户支持,适用于需要多租户架构的应用程序。
DNTFrameworkCore.Licensing
提供轻量级的构建和读取签名许可证的库,基于 SignedXml。
通过以上模块的组合使用,可以构建出功能丰富、结构清晰的高质量 Web 应用程序。