+
-## 引子
-几年前我在博客园写了一个 [应用程序框架实战](https://www.cnblogs.com/xiadao521) 的系列文章，受到不少.net同学的青睐，不过由于种种原因（想写的范围过大，技术更新过快，工作忙，人越来越懒，好吧，我承认主要是最后一点）而烂尾。
+## 什么是Util应用框架?
-我在博客中放出过一些示例代码，由于未正式开源，修复过的bug也未能更新，所以将博客中提供的示例项目都删除了。
+Util是一个.Net平台下的应用框架，旨在提升中小团队的开发能力，由工具类、分层架构基类、Ui组件，配套代码生成模板，权限等组成。
-一些同学将这些代码应用在项目上，当碰到问题时，由于没有技术支持，也没有相关教程，苦不堪言。而另外一些同学没有下载到示例项目。
+## Util应用框架的作者: **何镇汐**
-虽然博客断更2年，但时常有同学通过加QQ或发EMAIL的方式联系我，希望能够得到最新代码，并对用法和设计思路进行讲解。
+Util应用框架的主要作者为何镇汐。
-.net core发展迅猛，它为.net提供了更广阔的竞争力，同时也意味着新一轮的学习与代码移植工作开始，我也在这个大潮中跌跌撞撞的摸索着。
+## Util应用框架的开源协议: **MIT**
-几位好友（[AlexLEWIS](https://github.com/alexinea "刘怡") [Kiler](https://github.com/kiler398 "谢炀") [Lemon](https://github.com/liuhaoyang "刘浩杨") ）发起了.net core学习小组，并打算为国内.net core开源大业作出贡献，我果断加入了队伍进行学习，并决定对Util应用框架进行开源。
+这是最宽松的开源协议,意味着可以以任何方式使用该代码。
-经讨论，大家决定将各自的开源项目统一发布到 [.NET China Foundation](https://github.com/dotnetcore) 之下，以方便国内.net core开源项目的推广，同时也欢迎国内.net core开源项目作者的加入。
+## Util应用框架的主要贡献者
-## 技术框架与应用框架
+[汪总](https://github.com/jianxuanbing "简楚恩") [胡兴业](https://github.com/huxingye)
-框架是一种可复用的基础代码库，如果它只解决纯技术问题，可以认为是技术框架，如果它与你的业务相关，则可认为是应用框架（框架，应用框架均没有标准定义，我在此以个人理解描述术语含义，以方便后续讨论，并非权威定义）。
+这里只列出了主要贡献者,还有很多开发人员以不同形式对Util做出了宝贵贡献。
-.net提供的基础类库是最基础的技术框架，它提供了进行.net开发所需要的基础API，这些API都比较原始。完全使用原始API进行项目开发，会导致高昂的学习成本，更多的Bug，难以维护的重复代码，低效的开发进度。
+## Util应用框架的目标: **让开发更简单**
-为了完成某项特定的技术需求，比如写日志，你可以使用原始API进行简单实现，并在多个地方复制粘贴进行调用。这很快会让你厌烦，除了冗余代码以外，你发现还需要经常扩展日志操作的功能，于是你想把日志操作封装成库来调用。
+Util应用框架让你的团队迅速进入业务开发状态,并在开发过程中持续提供帮助。
-等等，不要再重复造轮子了(为了学习目的造轮子，这绝对是值得肯定的，但确实准备拿来使用的，如果不是真有几把刷子，比如 [Lemon](https://github.com/liuhaoyang "刘浩杨") 同学，建议还是省省吧)，一些前辈已经做了这些基础工作，并且他们的工作已经在全球大范围的使用，非常成熟，并且持续维护。
+## Util应用框架的特点: **简单易用**
-这些能够解决特定技术问题的类库暂时统称为第三方技术框架,在项目上使用第三方技术框架是项目成功的必要保障。从此，你不再为如何实现某项技术问题而烦恼，也不需要为持续扩展的技术需求而疲于奔命，更多的精力被用在业务上，这才是你应该干的事。
+Util应用框架的设计理念是追求Api简单化,尽量少的配置,不用精确记忆Api,有个模糊印象即可使用。
-对于你的项目，每当碰到某种技术障碍时，你会四处打听有没有某个第三方技术框架解决了你的问题，找到以后，你通过调试一些Demo代码，简单的用起来了。每当需要这个功能的时候，你会从以前的代码复制粘贴，由于第三方技术框架已经高度封装，所以冗余代码不是特别显著，你没有理会它。
+Util应用框架的学习成本相对较低,对于有.Net基础的开发人员,进行常规业务开发,通常在3天内上手。
-如果你的团队并不经常沟通，处理同一问题的过程将在团队中反复发生，这将导致对于某个问题的技术实现不一致，并且付出高昂的学习成本。当调用代码被大量的复制粘贴后，如果发现调用代码有Bug，或需要增加一些健壮性，你才意识到虽然第三方技术框架已经比较完善，但对它的调用依然有封装的必要。
+## Util应用框架开发流程
-你开始封装一些经常需要操作的代码，这些代码可能是用.net原始Api封装的，也可能是封装了第三方技术框架的调用，这些封装好的代码被称为公共操作类，也叫工具类。
+> *搜集* - *整理* - *集成* - *封装*
-对于最基础的Crud和业务代码的结构，你发现也可以抽取出来，形成分层架构基类。
+每当发现无法满足项目需求时，扩展框架的时刻来临。
-你的项目可能需要在网页上进行开发，采用原始的html,css,js技术，将面临界面美观，浏览器兼容性,开发效率低下等问题，有第三方技术框架提供了相关的解决方案，比如EasyUi,Bootstrap,Angularjs,ReactJs等。将第三方UI框架集成并封装起来，能够显著提升开发效率。
+从头造轮子是下策，所以总是先四处**搜集**相关资料。对于简单的需求，可能只需要找到一些代码片断即可。对于更专业的问题，需要寻求第三方技术框架的帮助。
-如果在项目中，你需要实现支付等业务功能，你可以对这些第三方业务接口进行封装。
+找到解决方案并调试通过后，需要对代码进行**整理**，以符合我们的编程风格。
-对于常规的项目，总是需要一些通用模块，比如权限，将它作为后续项目的起点是一个好主意。
+通常以Nuget包或Npm包的方式进行**集成**,为了降低学习成本，需要仔细考虑如何**封装**才能让调用者最省力。
-当这些基础代码被高度封装后，常规的Crud代码变得非常简洁，但你还是需要复制这些基础结构，通过反复整理，可以得到一个代码模板，通过代码生成工具将基础的Crud代码生成出来，可以大幅提升生产力。
+> 任何有技术含量的工作，均由第三方技术框架完成，Util应用框架仅对技术框架选型并集成封装。
+>
+> Util应用框架只是很薄的一层外观，为复杂的技术框架提供一个简易视图。
+>
+> 这导致更健壮的实现和更易用的API。
-这个持续封装过程演变为一套项目开发模式，支持这套模式的所有基础代码库，我将它称之为应用框架。
+## Util应用框架的使用方式
-应用框架为你项目的所有方面提供支持，你需要不断的完善它。由于应用框架需要解决你项目上的所有问题，所以没有绝对通用和包罗万象的应用框架，你必须在这些应用框架之上进行扩展。
+使用Util应用框架有几种不同的方式。
-## Util的由来
+最灵活的方式是将Util应用框架的代码复制到你自己的应用框架中,然后可以随意修改它们来满足项目需求。
-Util是我在.net开发生涯中不断积累而成的一套应用框架，最初的名字叫CommonUtilities，这是一个基本由公共操作类构成的类库。
+不过这种方式的代价也很大,很难合并Util的任何更新,你需要自行维护相当大的代码库。
-随着经验和水平的上升，我根据自己的习惯，逐步实现了经典图书中某些概念（比如规约），并吸收了一些流行应用框架( 比如 [ABP](https://github.com/aspnetboilerplate/aspnetboilerplate) [Nop](https://www.nopcommerce.com) )的部分代码。
+由于Util应用框架的体积在不断增长,维护这些代码库可能给你带来不小的负担。
-Util并不是一个完善的应用框架，我总是根据自己项目上的需求来扩展它，所以它基本只是为了满足我个人习惯和项目的产物。
+另一种可行的方式是将Util应用框架作为你的基础库,使用Nuget引入它们,基础的工作让Util应用框架帮你完成,你只需要扩展自己业务领域相关的功能。
-由于技术更新异常迅速，多年来大量的代码被持续重构，还有更多的代码被抛弃，这也是Util不完善的一个重要原因。
+这种方式的限制也很明显,Util提供的功能可能无法满足你的要求。
-发布Util的目的，是希望帮助技术还比较落后的.net小型团队能够搭建出自己的应用框架，提供一个示范，同时也希望它成为跟我有相似开发习惯和偏好的.net同学的重要工具。
+解决这个问题的关键是与Util开发团队保持沟通,将你的需求告诉我们。
-## 愿景
+对于通用功能,我们会尽量满足,这样会让更多的开发者受益,对于定制需求,我们也会为你提供扩展点,方便你能自行扩展。
-让开发更简单
+## 框架核心
-## 承诺
+- ### 启动器
-不必担心再次断更，代码会持续更新，使用文档将由Util核心开发团队成员编写，我会补充一些设计方面的文档上来。
+Util应用框架在项目启动时,会扫描全部程序集,并自动执行服务注册器,执行相关依赖配置.
-## 特点
+启动器核心代码参考自 [NopCommerce](https://www.nopcommerce.com) .
-**简单易用**的傻瓜式API设计，让你的团队能够快速上手进行开发。对于简单操作，通常采用静态方法或扩展方法进行调用，对于更加复杂的操作，尽量封装为链式API。
+- ### 服务注册器
-**强类型（*静态类型*）** 化风格，将UI组件封装为asp.net core razor组件，充分发挥VS开发工具的优势，比如智能提示，编译时检查。
+项目启动扫描时,会加载所有的服务注册器,并按顺序执行.
-**代码整洁**，Util开发小组成员都有着代码洁癖，每行代码都经过反复斟酌。
+> 服务注册器类似其它应用框架的模块概念,但功能有限.
+>
+> 只能用于配置依赖注入关系,无法获取服务提供程序,所以不能执行复杂的操作.
-地道的**中国味**，Util开发小组成员的英文水平比较菜，命名充满国风，并以中文注释进行补充。
+- ### 依赖注册器
-## 面向群体
+扫描 ISingletonDependency, IScopeDependency, ITransientDependency 接口,并自动配置依赖.
-Util应用框架面向的是*架构初学者*，但不是.net初学者。
+## 框架基础
-如果你是.Net初学者，基本的Crud（增删改查）尚且完成不了，请缓一年再来。
+- ### 对象到对象映射
-你可能已经有了一些项目经验，甚至已经开发多年，但你的项目依然进度缓慢，很难按时交付，代码质量糟糕，难以继续维护，你迫切希望找到一种方法来改善这个过程，Util就是为你准备的。
+技术选型: [AutoMapper](http://automapper.org/).
-如果你手里没有任何积累，Util将是你搭建自己框架的一个很好的起点。
+对象到对象映射主要用于分层对象之间的转换,比如从实体映射到DTO.
-如果你已经身经百战，自己的框架也比较成熟，Util对你的帮助不会太大。
+Util 在所有对象上添加 **MapTo** 扩展方法,自动完成基础配置,如果映射的两端对象属性名相同,则无需配置,直接使用即可.
-如果你对API的英文语法要求很高，Util可能无法达到你的要求，请自行修改命名或远离它。
+- ### AOP( 面向切面编程 )
-## 使用方式
+技术选型: [AspectCore](https://github.com/dotnetcore/AspectCore-Framework).
-我推荐的方式是搭建你自己的应用框架，逐步吸收Util和其它应用框架的代码，但这需要你投入大量的学习时间。
+AOP用于在调用方法时进行拦截,在执行前后添加自定义逻辑.
-我会逐步更新框架代码，当时机成熟时，将提供一个示例应用程序供大家参考。
+Util 主要使用AOP拦截器进行验证.
-在把框架完全应用到你的项目之前，你的团队至少要有一名成员能够根据项目需求进行扩展。对于懒汉，通常希望拿到一套干货，直接在项目上当成黑盒来使用，除非你的项目异常简单，否则这种方式不可取。
+- ### 对象验证
-对于简单的操作，你可以运行和阅读相应单元测试代码，即可了解它们如何使用。对于复杂操作，一方面看单元测试，另外我们会编写相关文档以描述调用方式和工作机制。
+Util 使用 DataAnnotation 注解作为基础验证方式,并提供 **验证规则** 和 **验证处理器** 等构造块进行自定义验证和处理.
-## 开发环境及类库依赖
+Util 在实体,DTO等对象上添加了 **Validate** 方法, 以标准化的方式进行对象验证.
-以下是我们在项目开发和部署时使用的工具和组件，这个列表会经常更新。
+- ### 异常处理
-> 如果没有标注版本号，则采用最新版本。
+Util 提供了 **Warning** 类型,表示业务异常,并封装相关异常操作.
-1. 开发工具：
- - Visual Studio 2017
- - Resharper
+- ### 身份认证和授权
-2. 数据库
- - Sql Server
- - Mysql
- - PostgreSQL
+技术选型: [Identity](https://learn.microsoft.com/zh-cn/aspnet/core/security/authentication/identity), [Identity Server 4](https://github.com/IdentityServer/IdentityServer4)
-3. 设计工具
- - PowerDesigner 16.5
- - XMind
+Identity 是Asp.Net Core自带的身份认证框架,提供用户管理,登录认证等功能.
-4. 版本控制
- - Git
+> Identity Server 4 是一个身份认证服务器,用于颁发令牌和验证令牌等操作.
+>
+> Identity Server 4 已经停止更新,它的新版本是收费的,Util 仅使用 Identity Server 4 的基础功能,由于它的基础功能已经十分稳定,暂时不需要迁移到其它框架.
-5. 部署环境
- - Ubuntu Server
- - Docker
+Util 除了集成 Identity 和 Identity Server 4,还扩展了Asp.Net Core自定义授权策略,提供简单易行的Api访问控制方法.
-6. 开发平台
- - .Net Core 2.0
+Util Platform提供了基于角色和资源的权限管理功能,可以轻松设置前端UI菜单和按钮等权限,同时对后端API进行访问控制.
-7. 单元测试及模拟框架
- - XUnit
- - NSubstitute
+- ### 本地化
-8. ORM
- - EntityFrameworkCore 2.0
- - Microsoft.EntityFrameworkCore.SqlServer 2.0.0
- - Npgsql.EntityFrameworkCore.PostgreSQL 2.0.0
- - Pomelo.EntityFrameworkCore.MySql 2.0.x
+技术选型: [My.Extensions.Localization.Json](https://github.com/hishamco/My.Extensions.Localization.Json)
-9. Ioc框架
- - Autofac
+Util 本地化支持Json文件或自定义数据存储方式.
-10. Aop框架
- - [AspectCore](https://github.com/dotnetcore/AspectCore-Framework)
+My.Extensions.Localization.Json 提供了Json本地化功能.
-11. Json框架
- - Newtonsoft.Json( 即Json.Net )
+由于无法满足项目需求, 以源码方式引入, 对健壮性和性能进行了提升.
-12. 映射框架
- - AutoMapper
+- ### 日志
-13. 日志框架
- - [NLog](http://nlog-project.org/)
- - [Exceptionless](https://github.com/exceptionless)
+技术选型: [Serilog](https://serilog.net/), [Seq](https://datalust.co/), [Exceptionless](https://exceptionless.com/)
-14. Id生成器
- - [ECommon.Utilities.ObjectId](https://github.com/tangxuehua/ecommon/blob/master/src/ECommon/Utilities/ObjectId.cs)
+Serilog是.Net目前最流行的日志框架,支持结构化日志.
-15. RSA加密算法
- - [DotnetCore.RSA](https://github.com/stulzq/DotnetCore.RSA/blob/master/DotnetCore.RSA/RSAHelper.cs)
+Seq 和 Exceptionless 是日志管理系统,提供了操作日志的界面,可以使用Serilog写入.
-16. 二维码操作
- - [QRCoder](https://github.com/codebude/QRCoder/)
+Util 对它们进行了轻度封装,集成了常用配置,并提供日志上下文等扩展.
-17. 短信操作
- - [Luosimao](https://luosimao.com/)
+- ### 缓存
-18. Queryable动态扩展
- - [System.Linq.Dynamic.Core](https://github.com/StefH/System.Linq.Dynamic.Core)
+技术选型: [EasyCaching](https://github.com/dotnetcore/EasyCaching)
-19. Web框架
- - [Asp.Net Core](https://docs.microsoft.com/zh-cn/aspnet/core/)
+Util 集成了内存缓存和Redis缓存两种提供程序.
-20. UI
- - 脚本语言
- - [TypeScript](https://www.tslang.cn)
- - 脚本框架
- - [Angular 6](https://angular.cn/)
- - Css预处理器
- - [Sass](http://www.sass-lang.com)
- - 组件库
- - [Angular Material](https://material.angular.io/)
- - [PrimeNg](https://www.primefaces.org/primeng)
- - [Angular-Material-App](https://github.com/stbui/angular-material-app)
- - 脚本库
- - [Moment](http://momentjs.cn/)
- - 图标
- - [Material Design Icon](https://material.io/icons/)
- - [Font Awesome Icon](http://fontawesome.io/)
- - 打包
- - Webpack
- - 测试
- - Karma
- - Jasmine
+- ### 事件总线
-21. 代码生成器
- - CodeSmith 6.5
+技术选型: [MediatR](https://github.com/jbogard/MediatR), [Dapr](https://dapr.io/)
-22. 参考应用框架
- - [ABP](https://github.com/aspnetboilerplate/aspnetboilerplate)
- - [Nop](https://www.nopcommerce.com)
- - Nop是一个开源商城，封装了大量实用的基础代码。
+> 事件总线分为本地事件总线和集成事件总线.
-## 框架开发流程
+Util 本地事件总线提供两种实现,默认使用Ioc方式实现,无需外部依赖. 另外引入了 MediatR 框架,它是流行的进程内事件处理框架.
- > *搜集* - *整理* - *集成* - *封装*
+集成事件总线用于微服务之间消息通信,Util 集成了 Dapr 微服务框架,基于 Dapr 的发布订阅实现集成事件总线.
-每当发现框架无法满足项目中的需求时，扩展的时刻来临。
+- ### 模板引擎
-从头造轮子是下策，所以总是先四处**搜集**相关资料。对于简单的需求，可能只需要找到一些代码片断即可。对于更专业的问题，比如将对象转换为json字符串，需要寻求第三方技术框架的帮助。
+技术选型: [RazorEngineCore](https://github.com/adoconnection/razorenginecore) , [Handlebars.Net](https://github.com/Handlebars-Net/Handlebars.Net)
-找到解决方案并调试通过后，需要对代码进行**整理**，以符合我们的编程风格。
+Util 以源码方式引入 RazorEngineCore ,并进行大量修改.
+
+Razor 模板引擎目前主要用在 Util 代码生成器.
+
+- ### 图像处理
+
+技术选型: [ImageSharp](https://sixlabors.com/)
+
+ImageSharp 是一个图像处理库.
+
+Util 使用 ImageSharp 实现动态文本头像生成.
+
+- ### 文件存储
+
+技术选型: [Minio](http://minio.org.cn/)
+
+Minio 是流行的对象存储系统,适合部署到内部服务器.
+
+Util 集成封装了 Minio SDK, 提供 存储桶名称处理策略, 文件名处理策略等构造块进行扩展处理.
+
+- ### 后台任务
+
+技术选型: [Quartz](https://www.quartz-scheduler.net/) , [HangFire](https://www.hangfire.io/)
+
+Util 封装了 Quartz 和 HangFire, 用于处理后台任务.
+
+- ### 数据访问
+
+技术选型: [EntityFrameworkCore](https://docs.microsoft.com/zh-cn/ef/core/) , [Dapper](https://github.com/DapperLib/Dapper)
+
+Util数据访问主要使用 EntityFrameworkCore ,它是.Net官方提供的ORM框架,属于重量级数据访问框架.
+
+EntityFrameworkCore 支持工作单元模式,对复杂的业务处理非常有效,但对复杂的查询操作无能为力.
+
+可以直接使用 EntityFrameworkCore 执行Sql语句, 但此操作非常原始,效率低下.
+
+Dapper是轻量级数据访问框架, Util引入它并进行封装,用于解决查询问题.
+
+目前 Util Dapper 封装尚不可用,它还缺乏分页,Lambda表达式支持等高级功能,现在仅用于代码生成读取元数据,后续会进行扩展.
+
+由于使用国产数据库的需求逐渐增多,后续将考虑引入 [FreeSql](https://github.com/dotnetcore/FreeSql) 数据访问框架.
+
+- ### 工具类
+
+Util包含大量工具类,用于处理常用操作.
+
+- 类型转换操作
+- Lambda操作
+- 命令行操作
+- 配置操作
+- 枚举操作
+- Ioc操作
+- Json操作
+- 字符串操作
+- 时间操作
+- IP操作
+- Web操作
+- 加密操作
+- ...
+
+## 架构支持
+
+### 多租户架构支持
+
+Saas系统支持多家客户使用同一系统,客户数据彼此隔离.
+
+Util 参考了 [ABP](https://abp.io/) 应用框架的多租户架构设计的租户解析和数据过滤部分.
+
+Util 多租户架构在独立部署租户数据库方面基于 EntityFrameworkCore 的官方建议,有一些限制.
+
+### DDD分层架构支持
+
+Util 分层架构基于领域驱动设计(DDD) 和 企业应用架构模式(POEAA) 的基础构造块.
+
+.Net 早期流行的分层架构是三层架构, 对于不熟悉 DDD 的开发人员,可以把它当成三层架构使用,不过术语的变化而已.
+
+但是对于有一定领域模型使用经验的开发人员,该架构在处理更复杂的业务时可以有效管控复杂性.
+
+对于复杂模块的开发,该架构与三层架构的主要区别在于,实体是作为简单数据容器,还是作为业务处理的场所.
+
+对于很多业务领域,将实体对应的业务操作封装到实体本身,可以提升业务表达能力和封装性.
+
+Util 分层架构分为四层.
+
+#### 领域层
+
+领域层是Util分层架构的核心.
+
+领域层非常纯净, 没有对数据访问和UI的依赖,很容易对该层进行单元测试.
+
+ - ##### 聚合根
+
+ 作为并发单元的最外层实体.
+
+ - ##### 实体
+
+ 由唯一标识决定的业务对象.
+
+ - ##### 值对象
+
+ 表示实体属性值的对象.
+
+ - ##### 仓储
+
+ 表示聚合根的集合,用于进行数据访问.
+
+ - ##### 领域服务
+
+ 用于封装多个聚合根的操作.
+
+ - ##### 领域事件
+
+ 表示实体数据发生变化.
+
+ 使用Util本地事件总线发布领域事件.
+
+ 有几个标准领域事件:
+
+ - EntityChangedEvent - 实体变更事件
+ - EntityCreatedEvent - 实体创建事件
+ - EntityUpdatedEvent - 实体修改事件
+ - EntityDeletedEvent - 实体删除事件
+
+#### 基础设施层
+
+对于大多项目,基础设施层主要包含数据访问的实现.
+
+#### 应用层
+
+集成了领域层和基础设施层,为UI提供服务.
+
+ - ##### 应用服务
+
+ 应用服务接收UI请求,并将调用委托给实体,领域服务等构造块完成业务功能.
+
+ 对于普通项目,业务逻辑直接在应用服务中实现即可,这与三层架构相似.
+
+ - ##### 数据传输对象(DTO)
+
+ 数据传输对象是一种用来传递参数的对象.
+
+ - ##### 查询参数对象
+
+ 查询参数对象是一种专门用来传递查询参数的对象.
+
+#### 表现层
+
+### 微服务架构支持
+
+Util 集成了 [Dapr](https://dapr.io/) ,它是微软主推的微服务框架.
+
+Util 封装了 Dapr Http同步调用,异步事件发布订阅,状态存储等功能.
+
+并对身份认证,事件日志,事件重发等重要功能进行扩展.
+
+### 常见业务功能支持
+
+#### 树形结构支持
+
+有些数据包含层次结构.
+
+Util 分层架构包含对树形结构的支持.
+
+如果使用 Util UI,无论加载树形表格还是树形,继承基类即可实现功能.
+
+#### 审计支持
+
+大多操作需要记录创建人,创建时间,修改人,修改时间等审计信息.
+
+Util支持保存时自动设置审计信息.
+
+Util 审计设计参考自 [ABP](https://abp.io/) 应用框架.
+
+#### 逻辑删除支持
+
+Util 支持逻辑删除,删除时更新为已删除状态,查询时自动过滤已删除记录.
+
+Util 逻辑删除设计参考自 [ABP](https://abp.io/) 应用框架.
+
+#### 对象变更值支持
+
+修改时可能需要获取对象哪些数据发生了变化.
+
+Util 提供多种方式获取对象变更值记录.
+
+
+## 代码生成
+
+由于 Util 采用 DDD分层架构,导致简单需求也需要创建大量的类型.
+
+手工创建这些类型效率低下,通过代码生成迅速创建它们,可以大幅提升开发效率和质量.
+
+Util 配套代码生成器, 简单易用, 可解决大部分机械工作.
+
+在生成的代码基础上进行修改,比从头开始工作要好得多.
+
+## UI 技术选型
+
+- ### Js语言
+ - #### [TypeScript](https://www.typescriptlang.org/zh/)
+ TypeScript 是 微软开发的脚本语言, 扩展了弱类型的 Javascript,提供增强的语法和强类型支持.
+
+ 为编辑器代码提示和语法错误检测奠定坚实基础.
+
+- ### Js框架
+ - #### [Angular](https://angular.io)
+
+ Angular 是 Google开发的 Js框架.
+
+ Angular使用 TypeScript 脚本语言开发, 并采用 [RxJs](https://github.com/ReactiveX/RxJS) 响应式编程框架.
+
+ Angular 是前端Js三大框架之一,另外两个是 Vue 和 React.
+
+ Util UI 用于开发管理后台,选择 Angular 是因为它的语法最优雅, 也最符合后端开发人员的习惯.
+
+- ### Angular 组件库
+
+ - #### [Ng Zorro](https://ng.ant.design/)
+
+ Ng Zorro 是阿里 Ant Design 的 Angular 版本,提供 80+ 常用组件,覆盖大部分业务开发场景.
+
+ - #### [Ng Alain](https://ng-alain.com/)
+
+ 虽然 Ng Zorro 提供了大量常用组件,但项目开发需要一个集成度更高的环境.
+
+ Ng Alain 是一个基架项目, 集成了 Ng Zorro 组件,提供业务开发的项目模板,除了菜单导航等框架元素,还有很多开箱即用的业务处理页面模板.
+
+- ### Angular 微前端框架
+
+ - #### [Angular Module Federation](https://github.com/angular-architects/module-federation-plugin)
+
+ 如果你的项目包含大量 Angular 模块,所有文件在同一个项目中,会导致开发环境卡顿和缓慢.
+
+ 发布项目也可能需要很长时间.
+
+ 另外,如果某个模块需要进行修改,哪怕只修改一行代码,也需要对所有模块重新发布.
+
+ 与后端的微服务类似,微前端是前端的项目拆分方法.
+
+ 微前端将不同的 Angular 模块拆分到不同项目中,可以独立开发,独立测试和独立部署.
+
+ > 无论你是否使用微服务架构,均可使用微前端拆分方式.
+
+ Angular Module Federation 是基于Webpack模块联合的Angular微前端解决方案.
+
+
+## Util Angular UI 特点
+
+- ### 组件扩展支持
+
+ 除了支持 Ng Zorro 原生功能外,Util UI还对常用组件进行了扩展.
+
+ 最重要的扩展是支持常用组件直接发出 Api 请求,而不用定义额外的服务.
+
+- ### Razor TagHelper 支持
+
+ Util Angular UI不仅可以使用 html 页面,还能使用 .Net Razor 页面.
+
+ Razor 页面可以使用 TagHelper 服务端标签.
+
+ Util 已将大部分 Ng Zorro 组件封装为 TagHelper 标签.
+
+ 除了获得强类型提示外,TagHelper 作为抽象层,提供更简洁的标签语法.
+
+ 另一个强大之处在于Lambda表达式支持, 可以将DTO直接绑定到 TagHelper 标签上.
+
+ 能够从Lambda表达式提取元数据,并自动设置大量常用属性,比如name,验证,模型绑定等.
-对于像autofac这样的类库，只需要nuget引用一下就完事，但对于UI层面的框架，需要进行更复杂的**集成**才能工作，我们可能还会修改一些源码以方便后续扩展。
+- ### 前后分离
-最后，为了达到复用的目的，需要仔细考虑如何**封装**才能让调用者最省力。
+ 一些开发人员看到 Util Angular UI 使用 .Net Razor 页面,可能认为 UI 与 .Net 高度耦合,但现在的趋势是前后分离.
-> 前几年，我喜欢把第三方技术框架的源码放到我的类库中，那是因为nuget经常连接失败，不过现在nuget比较稳定了，并且对包的嵌套引用支持得很好，所以不再采用山寨方式。
+ 所谓前后分离,是前端UI和后端API没有依赖,更换某一端对另一端没有影响.
-> 任何有技术含量的工作，均由第三方技术框架完成，Util应用框架仅对技术框架选型并集成封装。Util只是很薄的一层外观，为复杂的技术框架提供一个简易视图。这导致更健壮的实现和更易用的API。
+ 另外,前后分离后,前端UI和后端API可以由不同的开发人员完成.
-## 项目开发流程
+ .Net Razor页面仅在开发阶段提供帮助,在发布时, Razor 页面会转换为 html ,后续发布流程与纯前端开发方式相同.
-一套得心应手的应用框架，能让你的团队如虎添翼，开发效率和开发质量将同时提升N倍，这在拥有应用框架的公司已经是不争的事实。
+ 一旦发布成功,将完全脱离.Net 环境,可以使用 Nginx 容器承载它.
-那是不是意味着，只要下载到一套应用框架，你的团队马上就能脱胎换骨呢？ 非也，梅花香自苦寒来，宝剑锋从磨砺出，路漫漫其修远兮，你将上下而求索。
+ 发布后的产物,与你使用纯前端方式开发打包没有区别.
-任何应用框架都属于辅助设施，能否高效完成项目，还是靠你团队本身的水平。要高效完成项目，需要对技术、架构、过程等方面达到一定认识，这是一个漫长的学习过程。我会为你分享一些项目开发流程上的经验，并提供一份经典图书的清单。
+ 如果你喜欢,可以把后端API换成JAVA,也能正常运行.
-对于普通的项目，大体由简单的基础管理模块和较复杂的业务模块构成。
+- ### 配套Api支持
-基础管理模块表现为Crud操作加上一些简单业务逻辑，它们的特点是功能简单但数量众多，解决它们的有效手段是代码生成器，由生成器生成全套代码（包括管理后台的UI代码），然后在这个基础上手工修改。
+ 前端UI和后端API的开发是两个完全不同的领域.
-对于复杂的业务模块，它们往往由权限（操作权限与数据权限）、流程控制、复杂的计算、绕脑的策略等问题交织在一起，解决它们的有效手段是DDD（领域驱动设计），TDD(测试驱动开发)，设计模式。
+ 但开发一个功能,又需要前端和后端的配合,他们需要沟通,作出一些约定.
-> 遗憾的是，听过这些名词的部分开发人员，由于没有真正实践，还在道听途说的质疑这些方法的有效性，或是用这些方法来开发Crud操作，用大炮打蚊子，没用对地方反而质疑方法的作用。
+ 对于配合不到位的团队,前后端的沟通成本可能很高,另外提供的API可能无法满足UI的需求,从而让前端代码变得畸形.
-对于权限，目前发现最通用，最简单，最易理解的方法是基于*资源*和*角色*的权限设计。操作权限是通用的，但数据权限太灵活，目前我们配合规约模式来解决。
+ 通常.Net开发人员的Js编程功底高于常规前端人员,前端人员更擅长样式布局.
-由于项目开发流程是一个很大的主题，我会用专门的文章来进行介绍，以抛砖引玉。
+ Util Angular UI 不仅提供对前端组件的封装,同时也为常见功能提供 Api 支持.
-## 作者
+ 对于使用 Util Angular UI 的团队, 将 UI 和 API 交给同一个.Net开发人员就是最好的选择.
-何镇汐
+ 前端人员仅调整界面样式即可.
-## 核心开发团队
+ 不仅减少了沟通成本, API和前端组件的高度集成封装,让常规功能的开发效率得到大幅提升.
-[何镇汐](https://github.com/utilcore) [程序喵](https://github.com/program-meow "胡雲鹏") [Richfiter](https://github.com/xingwen1987 "邢文")
+ 当然,这对 .Net 开发人员的水平有一定要求.
-应用框架的开发工作量很大，个人显得力不从心，我也迫切希望找到一些志同道合的同学共同完成，同时也欢迎你的加入。
+- ### 本地化支持
-对于Util核心开发团队成员，需要至少独立完成Util中的一个模块（比如微信公众号接口封装），并持续维护它。
+ 得益于 Ng Alain 本地化的良好设计, 可以使用 i18n 管道进行文本的本地化转换.
-> 为了保持代码风格的统一，Util核心开发团队必须以统一的编码规范提交代码，在必要的时候，我会对代码进行重构。
+ ```
+ '文本' | i18n
+ ```
-## 技术顾问团队
+ 不过对于需要支持本地化的项目,这依然是一个负担,每个表单项,每个表格项,每个文本,可能都需要添加 i18n 管道.
-[AlexLEWIS](https://github.com/alexinea "刘怡") [Kiler](https://github.com/kiler398 "谢炀") [Lemon](https://github.com/liuhaoyang "刘浩杨") [Savorboard](https://github.com/yuleyule66 "杨晓东") [Lyrics](https://github.com/lyricsyo "娄宇")
+ Util Angular UI 让本地化开发更进一步,对大部分组件提供了本地化支持,只有极少数文本需要手工添加 i18n 管道.
-Util应用框架技术顾问团队负责对API易用性，代码健壮性，设计缺陷等内容进行审查，在发现问题时提出改善意见。
+- ### 授权访问支持
-> 如果您是一名资深.net开发专家，并希望为Util应用框架出谋划策，欢迎加入Util应用框架技术顾问团队。
+ Ng Alain提供了授权访问的支持.
-## 贡献与反馈
+ Util Platform权限模块基于资源和角色的设计,可以很好的与 Ng Alain授权进行集成.
-> 如果你在阅读或使用Util中任意一个代码片断时发现Bug，或有更佳实现方式，请通知我们。
+ 你可以控制菜单和任意区域根据权限显示和隐藏.
-> 为了保持代码简单，目前很多功能只建立了基本结构，细节特性未进行迁移，在后续需要时进行添加，如果你发现某个类无法满足你的需求，请通知我们。
+- ### 微前端支持
-> 你可以通过github的Issue或Pull Request向我们提交问题和代码，如果你更喜欢使用QQ进行交流，请加入我们的交流QQ群。
+ Util Angular UI 引入了 [Angular Module Federation](https://github.com/angular-architects/module-federation-plugin) , 能够将 Angular 模块拆分到不同项目中,可以独立开发,独立测试和独立部署.
-> 对于你提交的代码，如果我们决定采纳，可能会进行相应重构，以统一代码风格。
+ 对于大中型项目,这是非常有必要的.
-> 对于热心的同学，将会把你的名字放到**贡献者**名单中。
-## 贡献者
+## Util Angular UI 功能列表
-## 交流方式与技术支持
+Util Angular UI 主要由 util-angular 和 Util.Ui.NgZorro 两个库提供支持.
- 当你在使用Util进行开发时，倘若碰到无法解决的问题，可以加群讨论，Util团队会尽力帮助你度过难关。
+ - ### util-angular 功能列表
- - Util应用框架交流QQ群(一群)：24791014
+ [util-angular](https://github.com/util-core/util-angular) 是一个 Js 库, 由Curd组件基类, Ng Zorro常用组件扩展指令和一组工具类组成.
- > 不论是Util应用框架的代码，还是交流活动都是免费的，所以你不能指望我们必须在短时间内响应你，同时也希望大家都保持开放的心态，为初学者提供一些便利。
+ - #### 基础类型
- > 对于一些伸手党，本来百度3分钟就可以解决的问题，却四处找人问，对于这些家伙，我建议你们转JAVA。
+ - ViewModel - 视图模型基类
+ - TreeViewModel - 树形视图模型基类
+ - TreeNode - 树形节点基类
+ - PageList - 分页列表
+ - QueryParameter - 查询参数基类
+ - TreeQueryParameter - 树形查询参数基类
+ - Result - 服务端返回结果
+ - StateCode - 服务端状态码约定
+ - SelectItem - 列表项
+ - SelectList - 列表
+ - SelectOptionGroup - 列表配置组
+ - SelectOption - 列表配置项
-## 免责申明
+ - #### 工具类
-- 虽然我们对代码已经进行高度审查，并用于自己的项目中，但依然可能存在某些未知的BUG，如果你的生产系统蒙受损失，Util团队不会对此负责。
+ - 浏览器本地存储操作
+ - Cookie操作
+ - 事件总线操作
+ - 本地化操作
+ - Ioc操作
+ - 加载操作
+ - 路由操作
+ - 弹出层操作
+ - 抽屉操作
+ - 表单操作
+ - Http操作
+ - Web Api操作
+ - 消息操作
+ - ...
-- 出于成本的考虑，我们不会对已发布的API保持兼容，每当更新代码时，请注意该问题。
+ - #### Crud组件基类
-## 开源地址
+ - 编辑组件基类
+ - 表格编辑组件基类
+ - 树形编辑组件基类
+ - 查询组件基类
+ - 表格查询组件基类
+ - 树形表格查询组件基类
-https://github.com/dotnetcore/util/
+ - #### Ng Zorro指令扩展
-## License
+ - 必填项验证扩展指令
+ - 验证消息扩展指令
+ - Ng Zorro 按钮扩展指令
+ - Ng Zorro 选择框扩展指令
+ - Ng Zorro 表格扩展指令
+ - Ng Zorro 表格编辑扩展指令
+ - Ng Zorro 树形表格扩展指令
+ - Ng Zorro 树形扩展指令
+ - Ng Zorro 上传扩展指令
-**MIT**
+ - ### Util.Ui.NgZorro 库介绍
+
+ Util.Ui.NgZorro 是一个 C# 类库,包含 TagHelper标签和树形控制器等类型.
+
+ 绝大部分 Ng Zorro 组件已经封装.
+
+ 由于组件很多,就不一一列出.
-> 这意味着你可以在任意场景下使用Util应用框架而不会有人找你要钱。
+## Util Angular UI 已知缺陷
-> Util会尽量引入开源免费的第三方技术框架，如有意外，还请自行了解。
+Util Angular UI 所有已知缺陷均已解决.
-## 书单
+## Util Angular UI 适合你吗?
-> 本清单会持续更新
+Util Angular UI 是为 .Net 全栈工程师准备的,如果你喜欢更简洁的语法,希望开发的成本更低,它就适合你.
-- 面向对象
- - 《UML和模式应用》 作者：Craig Larman
- - 《面向对象分析与设计》 作者：Grady Booch
+## 参考应用框架
-- 架构模式
- - 《企业应用架构模式》 作者：Martin Fowler
- - 《领域驱动设计》 作者：Eric Evans
- - 《敏捷软件开发-原则、模式与实战》 作者：Robert C.Martin
- - 《实现领域驱动设计》 作者：Vaughn Vernon
+很明显,闭门造车不可取。
-- 设计模式
- - 《设计模式》 作者：Erich Gamma
- - 《Head First设计模式》 作者：Eric Freeman
+Util应用框架大部分依赖以Nuget方式引入,极少部分需要修改源码,则以复制源码方式使用。
-- TDD
- - 《测试驱动开发》 作者：Kent Beck
- - 《测试驱动开发的艺术》 作者：Lasse Koskela
- - 《单元测试的艺术》 作者：Roy Osherove
- - 《重构-改善既有代码的设计》 作者：Martin Fowler
- - 《实现模式》 作者：Kent Beck
- - 《代码整洁之道-Clean Code》 作者：Robert C.Martin
- - 《重构与模式》 作者：Joshua Kerievsky
+另外,.Net应用框架还有很多优秀的开源项目,从中学习和吸取养分是Util成长的关键。
-## 重大升级
+Util应用框架主要参考了以下开源项目,从中吸收架构和代码,并以Util风格进行整理。
-> 包括.net core版本的跳跃式升级等，比如从.net core1.x升级到2.0。
-
-- 2017年7月21日，将.net core升级到2.0 Preview 2。
-
-## 更新计划
-
-> 不打算提供精确的更新计划，以免无法兑现。
-
-> 对于已发布的代码，将标记为[已发布]。对于已迁移到.net core的代码，将标记为[已完成]，并即将发布。对于正在开发或迁移的代码，标记为[开发中]。对于尚未启动的部分，标记为[待启动]。这个列表会经常更新。
-
-- 公共操作类(工具类)及扩展
- - 类型转换操作 [已发布]
- - Json操作 - 基于Newtonsoft.Json [已发布]
- - 映射操作 - 基于AutoMapper [已发布]
- - Ioc操作 - 基于Autofac [已发布]
- - 应用程序异常操作 [已发布]
- - 验证操作 [已发布]
- - 验证操作拦截器 [已发布]
- - 枚举操作 [已发布]
- - 字符串操作 [已发布]
- - Lambda表达式操作 [已发布]
- - 日志操作 - 基于NLog和Exceptionless [已发布]
- - 日志操作拦截器 [已发布]
- - IQueryable查询扩展 [已发布]
- - 时间操作 [已发布]
- - 上下文操作 [已发布]
- - 类型查找器 [已发布]
- - 二维码操作 - 基于QRCoder [已发布]
- - 短信操作 -基于LuoSiMao [已发布]
- - 加密操作 [已发布]
- - Url参数生成器 [已发布]
-- 分层架构基类及组件
- - 实体基类 [已发布]
- - 聚合根基类 [已发布]
- - 值对象基类 [已发布]
- - 树型实体基类 [已发布]
- - 操作审计 [已发布]
- - EF Core实体映射配置基类 [已发布]
- - EF Core工作单元基类 [已发布]
- - EF Core调试日志 [已发布]
- - 仓储基类 [已发布]
- - 查询对象 [已发布]
- - 范围查询条件 [已发布]
- - 分页参数 [已发布]
- - 分页集合 [已发布]
- - 查询参数 [已发布]
- - 工作单元服务 [已发布]
- - 工作单元拦截器 [已发布]
- - Crud服务 [已发布]
- - 树型Crud服务 [待启动]
- - 持久化对象Po基类 [已发布]
- - 持久化对象存储基类 [已发布]
- - 事件总线 [已发布]
-- UI组件 - 支持HtmlHelper和TagHelper两种方式
- - 组件基类 [已发布]
- - TagHelper基类 [已发布]
- - 图标 - 集成了Material Design和Font Awesome图标集 [已发布]
- - 下拉列表 - 基于Material Select组件 [已发布]
- - 文本框 - 基于Material 文本框和日期选择框组件 [已发布]
- - 表单 [已发布]
- - 按钮 - 基于Material 按钮组件 [已发布]
- - 链接 - 基于Material 链接组件 [已发布]
- - 复选框 - 基于Material 复选框组件 [已发布]
- - 滑动开关 - 基于Material slide-toggle组件 [已发布]
- - 单选框 - 基于Material 单选框组件 [已发布]
- - 菜单 - 基于Material Menu组件 [已发布]
- - 选项卡 - 基于Material Tabs组件 [已发布]
- - 导航侧边栏 - 基于Material SideNav组件 [已发布]
- - 工具栏 - 基于Material Toolbar组件 [已发布]
- - 卡片 - 基于Material Card组件 [已发布]
- - 面板 - 基于Material Panel组件 [已发布]
- - 文件上传 - 基于PrimeNg 文件上传组件 [待启动]
- - 表格 [待启动]
-- 权限 [待启动]
-- 公共业务基类
- - 地址 [已发布]
-- 支付操作
- - 支付宝条码支付 [已发布]
-
-## 更新列表
-
-- 2017年7月6日，更新了类型转换操作类，类型转换扩展方法，类型转换单元测试。
-- 2017年7月14日，更新了Json操作类，Json操作单元测试。更新了对象映射操作类，对象映射操作单元测试。
-- 2017年7月18日，更新了Ioc操作类，Ioc扩展方法，Ioc操作单元测试。
-- 2017年7月21日，将Util升级到.net core 2.0 prew。
-- 2017年7月26日，更新了应用程序异常操作类Warning及单元测试。
-- 2017年7月28日，更新了验证操作(Util/Validations目录)及单元测试。
-- 2017年8月1日，更新了枚举操作及单元测试。
-- 2017年8月2日，更新了实体、聚合根基类及单元测试。
-- 2017年8月3日，更新了值对象基类及单元测试。
-- 2017年8月4日，更新了字符串操作及扩展，Lambda表达式操作及扩展，以及相关单元测试。
-- 2017年8月5日，更新了映射操作的集合映射。更新了范围查询条件(Util/Datas/Queries/Criterias)及相关单元测试。
-- 2017年8月6日，更新了分页参数、分页集合、查询参数及相关单元测试。
-- 2017年8月8日，更新了查询对象及相关单元测试。
-- 2017年8月9日，更新了EF实体映射配置基类。更新了EF工作单元基类。
-- 2017年8月10日，更新了数据操作集成测试项目。
-- 2017年8月11日，更新了CodeSmith代码生成模板。
-- 2017年8月12日，更新了树型实体基类及单元测试。
-- 2017年8月14日，更新了持久化对象Po基类，仓储部分实现及相关单元测试。
-- 2017年8月19日，更新了操作审计(Util/Domains/Auditing)。
-- 2017年8月21日，更新了仓储基类，持久化对象存储基类，IQueryable查询扩展。
-- 2017年9月3日，更新了公共业务类型-地址(Address)，修改了代码生成模板。
-- 2017年9月10日，更新了时间操作类，修改了代码生成模板。
-- 2017年9月15日，更新了上下文操作(Util/Contexts)，更新了日期格式化扩展(Util/Extensions.DateTime)。
-- 2017年9月19日，更新了日志操作，日志提供程序支持NLog与Exceptionless。
-- 2017年9月20日，更新了日志操作拦截器(Util.Logs/Aspects)。
-- 2017年9月21日，更新了验证操作拦截器(Util/Validations/Aspects)。
-- 2017年9月27日，更新了工作单元服务(Util/Datas.UnitOfWorks),工作单元拦截器(Util.Applications/Aspects),Crud服务(Util.Applications)。
-- 2017年9月30日，更新了事件总线(Util/Events)，类型查找器(Util/Reflections)，支持了IOC扫描注册功能。
-- 2017年10月21日，更新了Ui组件基类及TagHelper基类，图标组件(Util.Ui.Angular/Material/Icons)及单元测试。
-- 2017年10月25日，更新了二维码操作(Util.Tools.QrCode,基于QRCoder)和短信操作(Util.Tools.Sms，封装了LuoSiMao接口)。
-- 2017年10月29日，更新了加密操作(Util.Helpers.Encrypt，集成了MD5,DES,AES,RSA加密操作)及单元测试。
-- 2017年10月30日，更新了Url参数生成器(Util.Parameters)及单元测试。
-- 2017年10月31日，更新了支付宝条码支付操作(Util.Biz.Payments/Alipay)及单元测试。
-- 2017年11月15日，更新了EF Core调试日志(Util.Datas/Logs)及单元测试。
-- 2018年1月2日，更新了下拉列表组件(Util.Ui.Angular/Material/Forms)及单元测试。
-- 2018年1月10日，更新了文本框组件(Util.Ui.Angular/Material/Forms)及单元测试。
-- 2018年1月12日，更新了表单组件(Util.Ui.Angular/Material/Forms)及单元测试。
-- 2018年1月14日，更新了按钮和链接组件(Util.Ui.Angular/Material/Buttons)及单元测试。
-- 2018年1月16日，更新了复选框组件(Util.Ui.Angular/Material/Forms)及单元测试。
-- 2018年1月17日，更新了滑动开关组件(Util.Ui.Angular/Material/Forms)及单元测试。
-- 2018年1月18日，更新了单选框组件(Util.Ui.Angular/Material/Forms)及单元测试。
-- 2018年2月18日，更新了菜单组件(Util.Ui.Angular/Material/Menus)及单元测试。
-- 2018年2月22日，更新了选项卡组件(Util.Ui.Angular/Material/Tabs)及单元测试。
-- 2018年2月25日，更新了导航侧边栏组件(Util.Ui.Angular/Material/SideNavs)及工具栏组件(Util.Ui.Angular/Material/Toolbars)。
-- 2018年2月26日，更新了卡片组件(Util.Ui.Angular/Material/Cards)。
-- 2018年2月27日，更新了面板组件(Util.Ui.Angular/Material/Panels)。
\ No newline at end of file
+- [ABP](https://abp.io/)
+
+- [NopCommerce](https://www.nopcommerce.com)
+
+- [Csla](https://cslanet.com/)
+
+## Util应用框架相关资源
+
+### Util教程目录
+
+- 知乎:
-
-
-
- {{ item.text }}
-
-
-
- `,
- host: {
- 'class': 'util-form-field',
- },
- styles: [`
- .radio-layout-vertical {
- display: inline-flex;
- flex-direction: column;
- }
- .radio-label{
- margin-bottom: 8px;
- color:rgba(0,0,0,.54);
- }
- .radio-required{
- color: red;
- }
- .radio-button-horizontal {
- margin-right: 12px;
- }
- .radio-button-vertical {
- margin-bottom: 5px;
- }
- `]
-})
-export class RadioWrapperComponent implements OnInit, AfterViewInit {
- /**
- * 名称
- */
- @Input() name: string;
- /**
- * 是否垂直布局
- */
- @Input() vertical: boolean;
- /**
- * 是否显示标签
- */
- @Input() showLabel: boolean;
- /**
- * 标签文本
- */
- @Input() label: string;
- /**
- * 标签文本位置,可选值：'before', 'after'
- */
- @Input() labelPosition: string;
- /**
- * 禁用
- */
- @Input() disabled: boolean;
- /**
- * 必填项
- */
- @Input() required: boolean;
- /**
- * 数据源
- */
- @Input() dataSource: SelectOption[];
- /**
- * 请求地址
- */
- @Input() url: string;
- /**
- * 模型，用于双向绑定
- */
- @Input() model;
- /**
- * 模型变更事件,用于双向绑定
- */
- @Output() modelChange = new EventEmitter
-
- `,
- styles: [`
- .table-container {
- display: flex;
- flex-direction: column;
- position: relative;
- }
- .table-loading-shade {
- position: absolute;
- top: 0;
- left: 0;
- bottom: 56px;
- right: 0;
- background: rgba(0, 0, 0, 0.15);
- z-index: 1;
- display: flex;
- align-items: center;
- justify-content: center;
- }
- ::ng-deep .mat-table {
- overflow: auto;
- }
- ::ng-deep .table-header {
- min-height: 64px;
- padding: 8px 24px 0;
- z-index: 100;
- }
- ::ng-deep .mat-form-field {
- width: 100%;
- }
- `]
-})
-export class TableWrapperComponent
-
-
-
-
-
- `,
- styles: [`
- .mat-progress-bar{
- height:2px;
- }
- `],
- providers: [DomHandler]
-})
-export class FileUploadComponent extends FileUpload {
- /**
- * 初始化文件上传
- */
- constructor(el: ElementRef, domHandler: DomHandler, sanitizer: DomSanitizer, zone: NgZone) {
- super(el, domHandler, sanitizer, zone);
- this.chooseLabel = MessageConfig.chooseFile;
- this.uploadLabel = MessageConfig.upload;
- this.cancelLabel = MessageConfig.cancel;
- }
-
- /**
- * 获取进度条样式
- */
- private getProgressStyles() {
- return {
- 'position': 'absolute',
- 'top': '0px',
- 'left': '0px'
- };
- }
-}
\ No newline at end of file
diff --git a/sample/Util.Samples.Webs/Typings/util/prime/single-file-upload.component.ts b/sample/Util.Samples.Webs/Typings/util/prime/single-file-upload.component.ts
deleted file mode 100644
index 166b8c559..000000000
--- a/sample/Util.Samples.Webs/Typings/util/prime/single-file-upload.component.ts
+++ /dev/null
@@ -1,43 +0,0 @@
-//============== 单文件上传======================
-//Copyright 2018 何镇汐
-//Licensed under the MIT license
-//================================================
-import { Component, EventEmitter, Input } from '@angular/core';
-import { MessageConfig } from '../config/message-config';
-import { FileInfo,FileType } from '../core/file-info';
-
-/**
- * 单文件上传
- */
-@Component({
- selector: 'single-file-upload',
- template:`
-
-
-
-
-
-
-
- ![]()
-
- {{file.name}}
- {{formatSize(file.size)}}
-
-
-
-
-
-