ShenNius.Infrastructure项目用于定义ShenNius.Admin.Mvc项目和ShenNius.Admin.API项目共用的特性类、数据操作接口实现类、上下文类、通讯类,主要文件的用途如下:
Attributes文件夹保存特性类或过滤器类定义,主要包括:
1)AuthorityAttribute:访问控制类,继承自ActionFilterAttribute,主要实现在访问函数之前判断用户是否登录、是否有权限访问该函数;
2)GlobalExceptionFilter:自定义异常过滤器类,继承自IExceptionFilter接口,用于在捕获异常时记录日志,该类在ShenNius.Admin.API项目的ShenniusAdminApiModule.OnConfigureServices中调用以注册全局异常处理(参考文献2)。
. 3)LogAttribute:审计日志记录类,继承自ActionFilterAttribute接口,用于在操作执行后记录日志,但暂未看到项目中使用该类;
4)ModelValidateAttribute:自定义模型验证过滤器类,继承自ModelValidateAttribute接口,用于在模型验证失败后使用ApiResult类返回验证结果,该类在ShenNius.Admin.API项目的ShenniusAdminApiModule.OnConfigureServices中调用以注册全局过滤器;
5)MultiTenantAttribute:自定义多租户处理类,继承自ActionFilterAttribute和IActionFilter,用于在执行操作时从当前上下文中获取当前用户的TenantId,并赋予操作函数的每个输入参数对象的TenantId属性(只要参数类继承自IGlobalTenant接口),该类按需赋予ShenNius.Admin.Mvc项目和ShenNius.Admin.API项目的控制器类及其内部函数。
Hubs文件夹仅包含UserLoginNotifiHub类定义,该类继承自Hub,使用SignalR与前端通信,用于同一账户在不同客户端登录时通知之前的客户端下线。该类在ShenNius.Admin.API项目的ShenniusAdminApiModule的OnConfigureServices内注册服务,并在OnApplicationInitialization函数内使用app.UseEndpoints映射全局路由。ShenNius.Mvc.Admin项目的mysignalR.js文件内使用signalR.HubConnectionBuilder连接上述路由,然后在Index.cshtml文件内使用signalr发送当前用户已经登录的信息,也即调用服务端UserLoginNotifiHub.SaveCurrentUserInfo函数保存信息,如果信息已存在,则提醒该账号已在另一地方登录,并返回登录页面。
Repository文件夹包括特定数据操作接口的实现类,主要包括商城模块的商品、订单数据操作接口实现类,系统模块的菜单、回收站数据操作接口实现类,之前文章中介绍过,在此不再赘述。
TimedTask文件夹包括自定义后台服务类TimedBackgroundService,该类继承自BackgroundService(参考文献3),其启动后创建System.Threading.Timer对象(参考文献4)运行定时服务,定期刷新用户的登录状态。ShenNius.Admin.API项目的ShenniusAdminApiModule的OnConfigureServices内使用Services.AddHostedService注册后台服务。
根目录下的EntityExpand文件定义辅助函数处理树形结构数据,主要用在ShenNius.Admin.API项目的ColumnController、CategoryController控制器类以处理树形栏目及商品分类,还用在本项目的MenuRepository内显示多级菜单。
根目录下的ShenNiusContext类是ShenNius.Domain项目IShenNiusContext接口的实现类,该类基于Token或者HttpContext.User获取用户信息、登录信息、IP等上下文数据,ShenNius.Admin.API项目的ShenniusAdminApiModule的OnConfigureServices内注册该类。
参考文献:
[1]https://gitee.com/shenniu_code_group/shen-nius.-modularity
[2]https://www.cnblogs.com/51net/p/18698187
[3]https://blog.csdn.net/qq_31136349/article/details/139473574
[4]https://www.cnblogs.com/hnzhengfy/p/SystemThreadingTimer.html