Home

Awesome

Util应用框架介绍

Member project of .NET Core Community GitHub license

<a href="https://www.jetbrains.com/?from=Util" target="_blank"> <img src="https://github.com/dotnetcore/Home/blob/master/img/jetbrains.svg" title="JetBrains" /> </a>

什么是Util应用框架?

Util是一个.Net平台下的应用框架，旨在提升中小团队的开发能力，由工具类、分层架构基类、Ui组件，配套代码生成模板，权限等组成。

Util应用框架的作者: 何镇汐

Util应用框架的主要作者为何镇汐。

Util应用框架的开源协议: MIT

这是最宽松的开源协议,意味着可以以任何方式使用该代码。

Util应用框架的主要贡献者

汪总 胡兴业

这里只列出了主要贡献者,还有很多开发人员以不同形式对Util做出了宝贵贡献。

Util应用框架的目标: 让开发更简单

Util应用框架让你的团队迅速进入业务开发状态,并在开发过程中持续提供帮助。

Util应用框架的特点: 简单易用

Util应用框架的设计理念是追求Api简单化,尽量少的配置,不用精确记忆Api,有个模糊印象即可使用。

Util应用框架的学习成本相对较低,对于有.Net基础的开发人员,进行常规业务开发,通常在3天内上手。

Util应用框架开发流程

搜集 - 整理 - 集成 - 封装

每当发现无法满足项目需求时，扩展框架的时刻来临。

从头造轮子是下策，所以总是先四处搜集相关资料。对于简单的需求，可能只需要找到一些代码片断即可。对于更专业的问题，需要寻求第三方技术框架的帮助。

找到解决方案并调试通过后，需要对代码进行整理，以符合我们的编程风格。

通常以Nuget包或Npm包的方式进行集成,为了降低学习成本，需要仔细考虑如何封装才能让调用者最省力。

任何有技术含量的工作，均由第三方技术框架完成，Util应用框架仅对技术框架选型并集成封装。

Util应用框架只是很薄的一层外观，为复杂的技术框架提供一个简易视图。

这导致更健壮的实现和更易用的API。

Util应用框架的使用方式

使用Util应用框架有几种不同的方式。

最灵活的方式是将Util应用框架的代码复制到你自己的应用框架中,然后可以随意修改它们来满足项目需求。

不过这种方式的代价也很大,很难合并Util的任何更新,你需要自行维护相当大的代码库。

由于Util应用框架的体积在不断增长,维护这些代码库可能给你带来不小的负担。

另一种可行的方式是将Util应用框架作为你的基础库,使用Nuget引入它们,基础的工作让Util应用框架帮你完成,你只需要扩展自己业务领域相关的功能。

这种方式的限制也很明显,Util提供的功能可能无法满足你的要求。

解决这个问题的关键是与Util开发团队保持沟通,将你的需求告诉我们。

对于通用功能,我们会尽量满足,这样会让更多的开发者受益,对于定制需求,我们也会为你提供扩展点,方便你能自行扩展。

框架核心

Util应用框架在项目启动时,会扫描全部程序集,并自动执行服务注册器,执行相关依赖配置.

启动器核心代码参考自 NopCommerce .

项目启动扫描时,会加载所有的服务注册器,并按顺序执行.

服务注册器类似其它应用框架的模块概念,但功能有限.

只能用于配置依赖注入关系,无法获取服务提供程序,所以不能执行复杂的操作.

扫描 ISingletonDependency, IScopeDependency, ITransientDependency 接口,并自动配置依赖.

框架基础

技术选型: AutoMapper.

对象到对象映射主要用于分层对象之间的转换,比如从实体映射到DTO.

Util 在所有对象上添加 MapTo 扩展方法,自动完成基础配置,如果映射的两端对象属性名相同,则无需配置,直接使用即可.

技术选型: AspectCore.

AOP用于在调用方法时进行拦截,在执行前后添加自定义逻辑.

Util 主要使用AOP拦截器进行验证.

Util 使用 DataAnnotation 注解作为基础验证方式,并提供 验证规则 和 验证处理器 等构造块进行自定义验证和处理.

Util 在实体,DTO等对象上添加了 Validate 方法, 以标准化的方式进行对象验证.

Util 提供了 Warning 类型,表示业务异常,并封装相关异常操作.

技术选型: Identity, Identity Server 4

Identity 是Asp.Net Core自带的身份认证框架,提供用户管理,登录认证等功能.

Identity Server 4 是一个身份认证服务器,用于颁发令牌和验证令牌等操作.

Identity Server 4 已经停止更新,它的新版本是收费的,Util 仅使用 Identity Server 4 的基础功能,由于它的基础功能已经十分稳定,暂时不需要迁移到其它框架.

Util 除了集成 Identity 和 Identity Server 4,还扩展了Asp.Net Core自定义授权策略,提供简单易行的Api访问控制方法.

Util Platform提供了基于角色和资源的权限管理功能,可以轻松设置前端UI菜单和按钮等权限,同时对后端API进行访问控制.

技术选型: My.Extensions.Localization.Json

Util 本地化支持Json文件或自定义数据存储方式.

My.Extensions.Localization.Json 提供了Json本地化功能.

由于无法满足项目需求, 以源码方式引入, 对健壮性和性能进行了提升.

技术选型: Serilog, Seq, Exceptionless

Serilog是.Net目前最流行的日志框架,支持结构化日志.

Seq 和 Exceptionless 是日志管理系统,提供了操作日志的界面,可以使用Serilog写入.

Util 对它们进行了轻度封装,集成了常用配置,并提供日志上下文等扩展.

技术选型: EasyCaching

Util 集成了内存缓存和Redis缓存两种提供程序.

技术选型: MediatR, Dapr

事件总线分为本地事件总线和集成事件总线.

Util 本地事件总线提供两种实现,默认使用Ioc方式实现,无需外部依赖. 另外引入了 MediatR 框架,它是流行的进程内事件处理框架.

集成事件总线用于微服务之间消息通信,Util 集成了 Dapr 微服务框架,基于 Dapr 的发布订阅实现集成事件总线.

技术选型: RazorEngineCore , Handlebars.Net

Util 以源码方式引入 RazorEngineCore ,并进行大量修改.

Razor 模板引擎目前主要用在 Util 代码生成器.

技术选型: ImageSharp

ImageSharp 是一个图像处理库.

Util 使用 ImageSharp 实现动态文本头像生成.

技术选型: Minio

Minio 是流行的对象存储系统,适合部署到内部服务器.

Util 集成封装了 Minio SDK, 提供 存储桶名称处理策略, 文件名处理策略等构造块进行扩展处理.

技术选型: Quartz , HangFire

Util 封装了 Quartz 和 HangFire, 用于处理后台任务.

技术选型: EntityFrameworkCore , Dapper

Util数据访问主要使用 EntityFrameworkCore ,它是.Net官方提供的ORM框架,属于重量级数据访问框架.

EntityFrameworkCore 支持工作单元模式,对复杂的业务处理非常有效,但对复杂的查询操作无能为力.

可以直接使用 EntityFrameworkCore 执行Sql语句, 但此操作非常原始,效率低下.

Dapper是轻量级数据访问框架, Util引入它并进行封装,用于解决查询问题.

目前 Util Dapper 封装尚不可用,它还缺乏分页,Lambda表达式支持等高级功能,现在仅用于代码生成读取元数据,后续会进行扩展.

由于使用国产数据库的需求逐渐增多,后续将考虑引入 FreeSql 数据访问框架.

Util包含大量工具类,用于处理常用操作.

架构支持

多租户架构支持

Saas系统支持多家客户使用同一系统,客户数据彼此隔离.

Util 参考了 ABP 应用框架的多租户架构设计的租户解析和数据过滤部分.

Util 多租户架构在独立部署租户数据库方面基于 EntityFrameworkCore 的官方建议,有一些限制.

DDD分层架构支持

Util 分层架构基于领域驱动设计(DDD) 和 企业应用架构模式(POEAA) 的基础构造块.

.Net 早期流行的分层架构是三层架构, 对于不熟悉 DDD 的开发人员,可以把它当成三层架构使用,不过术语的变化而已.

但是对于有一定领域模型使用经验的开发人员,该架构在处理更复杂的业务时可以有效管控复杂性.

对于复杂模块的开发,该架构与三层架构的主要区别在于,实体是作为简单数据容器,还是作为业务处理的场所.

对于很多业务领域,将实体对应的业务操作封装到实体本身,可以提升业务表达能力和封装性.

Util 分层架构分为四层.

领域层

领域层是Util分层架构的核心.

领域层非常纯净, 没有对数据访问和UI的依赖,很容易对该层进行单元测试.

基础设施层

对于大多项目,基础设施层主要包含数据访问的实现.

应用层

集成了领域层和基础设施层,为UI提供服务.

表现层

微服务架构支持

Util 集成了 Dapr ,它是微软主推的微服务框架.

Util 封装了 Dapr Http同步调用,异步事件发布订阅,状态存储等功能.

并对身份认证,事件日志,事件重发等重要功能进行扩展.

常见业务功能支持

树形结构支持

有些数据包含层次结构.

Util 分层架构包含对树形结构的支持.

如果使用 Util UI,无论加载树形表格还是树形,继承基类即可实现功能.

审计支持

大多操作需要记录创建人,创建时间,修改人,修改时间等审计信息.

Util支持保存时自动设置审计信息.

Util 审计设计参考自 ABP 应用框架.

逻辑删除支持

Util 支持逻辑删除,删除时更新为已删除状态,查询时自动过滤已删除记录.

Util 逻辑删除设计参考自 ABP 应用框架.

对象变更值支持

修改时可能需要获取对象哪些数据发生了变化.

Util 提供多种方式获取对象变更值记录.

代码生成

由于 Util 采用 DDD分层架构,导致简单需求也需要创建大量的类型.

手工创建这些类型效率低下,通过代码生成迅速创建它们,可以大幅提升开发效率和质量.

Util 配套代码生成器, 简单易用, 可解决大部分机械工作.

在生成的代码基础上进行修改,比从头开始工作要好得多.

UI 技术选型

Util Angular UI 特点

Util Angular UI 功能列表

Util Angular UI 主要由 util-angular 和 Util.Ui.NgZorro 两个库提供支持.

Util Angular UI 已知缺陷

Util Angular UI 所有已知缺陷均已解决.

Util Angular UI 适合你吗?

Util Angular UI 是为 .Net 全栈工程师准备的,如果你喜欢更简洁的语法,希望开发的成本更低,它就适合你.

参考应用框架

很明显,闭门造车不可取。

Util应用框架大部分依赖以Nuget方式引入,极少部分需要修改源码,则以复制源码方式使用。

另外,.Net应用框架还有很多优秀的开源项目,从中学习和吸取养分是Util成长的关键。

Util应用框架主要参考了以下开源项目,从中吸收架构和代码,并以Util风格进行整理。

Util应用框架相关资源

Util教程目录

Github项目地址

Gitee项目地址

由于国内访问Github非常缓慢,现在Util所有项目发布时会在Gitee进行同步更新。

Nuget包

包名版本下载量
Util.Core
Util.ObjectMapping.AutoMapper
Util.Aop.AspectCore
Util.Validation
Util.Security
Util.Data.Abstractions
Util.AspNetCore
Util.Localization
Util.Logging
Util.Logging.Serilog
Util.Logging.Serilog.Exceptionless
Util.Events.Abstractions
Util.Events
Util.Events.MediatR
Util.Templates
Util.Templates.Razor
Util.Templates.Handlebars
Util.Caching
Util.Caching.EasyCaching
Util.Scheduling
Util.Scheduling.Quartz
Util.Scheduling.Hangfire
Util.Images.ImageSharp
Util.Images.Avatar
Util.FileStorage.Abstractions
Util.FileStorage
Util.FileStorage.Minio
Util.FileStorage.Aliyun
Util.FileStorage.All
Util.Tenants.Abstractions
Util.Tenants
Util.Domain
Util.Domain.Biz
Util.Data.Core
Util.Data.Sql
Util.Data.Metadata
Util.Data.EntityFrameworkCore
Util.Data.EntityFrameworkCore.SqlServer
Util.Data.EntityFrameworkCore.PostgreSql
Util.Data.EntityFrameworkCore.MySql
Util.Data.EntityFrameworkCore.Sqlite
Util.Data.EntityFrameworkCore.Oracle
Util.Data.Dapper.Core
Util.Data.Dapper.SqlServer
Util.Data.Dapper.PostgreSql
Util.Data.Dapper.MySql
Util.Data.Dapper.All
Util.Application
Util.Application.EntityFrameworkCore
Util.Application.WebApi
Util.Microservices
Util.Microservices.Polly
Util.Microservices.Dapr
Util.Microservices.HealthChecks
Util.Ui
Util.Ui.Angular
Util.Ui.NgZorro
Util.Ui.NgAlain
Util.Generators
Util.Generators.Razor

Npm包

util-angular npm package NPM downloads