hzdtf285 / Hzdtf.foundation.framework
Labels
Projects that are alternatives of or similar to Hzdtf.foundation.framework
Hzdtf.FoundationFramework
基础框架系统，支持.NET和.NET Core平台，语言：C#，DB支持MySql和SqlServer，主要功能有抽象持久化、服务层，将业务基本的增删改查抽离复用；提供代码生成器从DB生成实体、持久化、服务以及MVC控制器，每层依赖接口，并需要在客户端将对应实现层用Autofac程序集依赖注入，用AOP提供日志跟踪、事务、模型验证等。对Autofac、Redis、RabbitMQ封装扩展；DB访问提供自动主从访问，Redis客户端分区。特别适合管理系统。
本框架必须运行在.NET Standard 2.0、.NET Framework 4.7.2和.NET Core 3.1.5以上。下载源码用Visual Studio 2019打开。 工程以Standard或Std结尾是标准库，以Framework或Frm结尾为Framework库，以Core结尾为Core库。 初始编译时会耗些时间，因为要从nuget下载包。 框架使用依赖接口注入，使用对象要优先依赖接口，用Autofac属性注入方式。 工程包含contract表示契约工程，专门定义接口以及抽象部分类；包含impl为实现接口的具体类。 实体类以Info结尾。
一、Comnon包 所有公共工具类库
二、Platform包 基于不同平台实现不同的配置类 使用配置是，直接用Contract项目里的IAppConfiguration
三、Logger包 框架自定义的日志组件 日志等级有：debug,info,wran,error,fatal，默认等级为debug，如设置info，则大于或info等级都会记录，而小于该等级（如debug）不会记录。等级在配置文件里可设置，配置名为：HzdtfLog:LogLevel:Default。
四、IOC包 DI与AOP的扩展功能，目前只实现Autofac扩展。提供了读入配置文件进行加载程序集进行注入，需要注入的类必须加上Inject特性描述；实现了部分的拦截器（AOP），如日志记录拦截、禁用拦截、授权拦截和参数验证拦截。注：使用拦截器的方法必须是virtual或override，因为框架使用的是类拦截。
五、Tool\CodeGenerator包 代码生成器工具，提供从数据库读取所有表，然后生成所有码（包含模型、持久化接口、持久化实现、服务接口、服务实现、Framework控制器和Core控制器），生成的代码只需要放在对应各在的项目工程里即可，具体生成的代码参考BasicFunction。 1、命名空间前辍：您的项目命名空间前辍，生成的所有代码都会以这个作为前辍。 2、此工具目前只支持MySql（5.0以上）和SQL Server（2008以上）。
六、Tool\EncryptionAndDecryption包 提供对字符串加解密工具，主要用在对数据库字符串加密。
七、Authorization包 提供针对不同平台进行用户授权验证，将用户授权信息存储到cookie里等公共操作。
八、Cache包
第三方的缓存组件封装，目前只实现了对Redis扩展，依赖于StackExchange.Redis组件。
1、封装了ConnectionMultiplexer对象，使用IConnectionMultiplexerManager接口
使用时必须要IConnectionMultiplexerManager得到Database，否则框架扩展的功能都使用不上。
2、扩展了针对对象存储到Redis的Hash类型，在ObjectSet(this IDatabase db, RedisKey key, object value, TimeSpan? expiry = null, CommandFlags flags = CommandFlags.None)里。
3、扩展了针对分布式锁的功能（轮询模式），在LockTake(this IDatabase db, RedisKey key, Action action, int retryIntervalMillisecond = 200, CommandFlags flags = CommandFlags.None)
4、扩展了针对分布式锁的功能（发布订阅模式，推荐使用），在 LockTake(this IConnectionMultiplexer connectionMultiplexer, RedisKey key, Action action, int timeoutMilliSecond = 5000, CommandFlags flags = CommandFlags.None)
5、如使用Core，则添加Hzdtf.Redis.Extend.Core引用。在appsetting.json里配置：
"Redis": {
"ConnectionEncrypt": false,
"Connections": [
{
"Key": "Key1",
"ConnectionString": "127.0.0.1:6379,127.0.0.1:6380,127.0.0.1:6381"
}
]
}
如果有多种Redis，则用Key区分。
如果有主从，在使用从时，flags应使用CommandFlags.PreferSlave,会优先找从，如果从不可用，则找主。默认是找主
九、MessageQueue包 1、对消息队列进行扩展封装，目前只实现了RabbitMQ，核心都在rabbitMessageQueue.xml配置文件里，使用生产者或消费者，输入对应参数，会找这个配置文件找到对应的交换机和队列名。具体参考DEMO。 2、利用RabbitMQ对RPC进行封装，并巧妙使用了DispatchProxy代理类，使调用方使用调用远程，就像调用本地方法一样，具体参考RPC DEMO。
十、Persistence包 1、对持久化操作进行封装，包含一个表的基本增删改查（包括分页查）功能，并支持异步操作。此持久化依赖于Dapper组件。 2、提供了针对数据库事务方便操作，只需要在具体方法里加上Transaction特性描述即可。 3、关于ConnectionId：名称为连接ID（Guid)，每个持久化方法里必须含有的参数，作用是为了在多个方法之间复用同一个连接对象，提高性能。原则是：哪里创建的连接ID哪里负责销毁，不是您创建的就不要自行销毁它。 4、DbConnectionManager数据库连接管理器：提供了相对智能的维护DB连接资源池，主要存在目的是为了连接ID而存在，并支持通过传入访问模式参数，自动进行主从操作。主数据库字符串配置名：ConnectionStrings:DefaultConnection；从数据库字符串配置名：ConnectionStrings:SlaveConnection，当没有配置从时，会自动找主。ConnectionStrings:Encrypt：表示字符串是否加密。
十一、Service包 俗称服务层，所有业务逻辑都放在此包里。 1、在方法里加了Auth特性，表示调用此方法前会验证当前用户是否有权限。 2、在方法参数里加了验证特性，调用此方法前首先会验证参数有效性，如： ModifyPasswordByLoginId([Model] CurrUserModifyPasswordInfo currUserModifyPassword, string connectionId = null)，加了Model特性，会验证currUserModifyPassword里的属性有效值。验证方法与微软提供的模型验证一致。 3、所有服务层返回的方法都必须是ReturnInfo对象，该对象里的Code为0时，表示业务处理成功。非0为失败。 4、由工具自动生成代码统一由Generators文件夹包含，此处的文件最好不要改，如要扩展功能，则用部分类特性，新建Expand文件夹。
十二、Controller包 控制器包，提供基本的MVC控制器增删改查的抽象功能方法，符合RESTFull风格。
十三、BasicFunction包 基本功能，提供了用户、角色、角色权限、数据字典四大功能模块，还提供登录退出功能，可以理解为基本的范例。 注： 1、MenuCode:菜单编码，表示菜单的唯一编码，如用户菜单，角色菜单等。 2、FunctionCode:功能编码，表示一个具体功能，如添加、编辑、查询和删除等。 3、菜单与功能关联：如一个菜单具体哪些功能，可通过此处关联。 4、角色与菜单功能关联：如一个角色具体哪些权限，可通过此处关联。
在范例的控制器里有[MenuCode("User")]，Action方法里有[FunctionCode("Add")]，表示执行这个控制器的这个Action时，拦截器会判断该用户是否有用户的添加这个权限。
十四、Workflow包 工作流，提供流程审核功能，可配置送件、退件路线，由表单与流程组成一个审核流程。
十五、WebDemo包 提供Web的Demo网站程序，采用WebAPI方式，前后端分离，使用Bootstreap UI框架。运行时，先创建数据库，导入Doc\创建表与初始化基本数据_mysql.sql，目前只有MySql才做了基础数据。用户名：system，密码：123。 依赖注入程序集都在：assemblyConfig.json配置文件里，包含了要注入哪些程序集，以及哪些程序集要使用哪些拦截器。 所有要使用具体程序集（包含具体使用哪些对象）都要在客户端里装载，因为所有项目都依赖于接口，而不是依赖于具体实现，具体类里也不创建具体依赖类。
结语： 1、获取当前用户：UserTool.CurrUser，在客户端（WEB站点）里要实现获取当前用户的方法，如User.GetCurrUserFunc => 从Cookie或Session取出当前用户。 2、获取当前环境：UtilTool.CurrEnvironmentType （目前只有生产与测试环境，默认是生产） 3、获取具体日志对象：LogTool.DefaultLog，默认是ConsoleLog，如系统未使用依赖注入，又要改变记录日志方式，则需要在系统启动时手工设置此对象。 4、获取IOC的对象：框架使用的是属性注入，所以一般使用属性的公有权限，如下： public IUserService UserService { get; set; } 直接拿来使用，如要手工获取，则使用AutofacTool.Resolve<对象类型>()。 5、程序启动时，必须先加载依赖注入的对象，具体参考DEMO。