魔方Newlife.Cube权限系统的使用及模版覆盖详解

讲人：大石头
时间：2018-11-14 晚上20：00
地点：钉钉群（组织代码BKMV7685）QQ群：1600800
内容：魔方Newlife.Cube权限系统的使用及模版覆盖详解

准备

源码地址: https://github.com/NewLifeX/NewLife.Cube

演示地址:http://cube.newlifex.com 可以直接注册用户以及选用第三方登录

单点登录:htts://sso.newlifex.com

讲课视频1:https://pan.baidu.com/s/1zEUkG7YXnVdvTLq6dJBhzg

讲课视频2:https://pan.baidu.com/s/10omTlET99DF-4cgG2bObzw

开始

1.初识魔方魔方后台结构介绍

魔方是一个基于ASP.NET MVC的多角色的权限管理系统,新版本的设计目标是所有页面封装在DLL里边,通过覆盖修改视图,做到极简化的使用

1登录

　　其中集成了SSO单点登录及第三方OAuth登录,其中既可以作为OAuth客户端也可以作为OAuth服务端,可以自己内部发布一个sso服务器端,只需要发布cube.dll,xcode.dll,core.dll三个dll的空项目即可

1.1顶部菜单栏

　　顶部菜单有栏目点击及用户修改注销等功能

1.2工作台首页

　　　应用系统:地址可以解决Nginx转发的路径不对的问题

　　　域名地址:多ip或者Nginx代理的显示

重启系统功能特别有用(缓存没有更新,配置没有生效,重启后会重新加载,轻量级重启,不用iis整个重启

程序集列表:可以分析是否缺少第三方组件的引用

.netcore session不建议使用,所以以后尽量不用session

内部版本,后边两个字段是编译出来的,编译时间来自于内部版本比如2.4.6805.17968,其中内部版本号6805基于2000年1月1日的天数,后边的17968字段是后边的秒数除以2的一个结果

1.3左侧区域菜单

　　菜单是树状的多层菜单,菜单树是内存计算的,1000对以内会整体缓存,因此菜单更新后不一定实时显示,因为有缓存,需要重启一下

2.系统菜单中的4个基本功能

　　　用户

　　　记录每个用户,可以对用户信息进行管理,其中清除密码功能比较特别,清除密码后可以任意密码登录,登录密码作为新密码存储在数据库中

　　　日志

　　　日志作为系统的安全与审计,是不能修改,添加,删除的.其中包含操作记录,访问统计等

　　　角色

　　　系统默认了管理员,游客,普通用户,高级用户等几个角色,其中在第一个默认登录系统的账号会自动替换为管理员角色,admin自动降级为游客,角色与名称可以根据自己的业务进行修改,其中我们支持多角色,一个主角色,多个次要角色,多角色是或的关系,只要有权限都支持.

　　　菜单

　　　对系统菜单与业务菜单进行编辑与修改,其中系统菜单里边修改过后一定要勾选上必要,不然会被魔方初始化覆盖,其中可见指的是是否在左侧菜单栏中显示,可以自定义权限

　　业务菜单

　　系统启动后会自动扫描区域与控制器,将区域作为一级菜单加载到数据库,将控制器作为二级子菜单加载到区域菜单下边,其中菜单名字通过[DisplayName("菜单名称")]来注解

　3.高级功能

　　3.1魔方设置

　　　　基本设置

　　对系统的一些基本设置,包括全局调试,日志等级,日志目录,插件服务器设置等

　　　　系统设置

　　　　对系统的名称进行设置,登录页,页面头部的名称,其中开发者模式的开关控制着页面的sql输出,以及高级功能里边的生成Form表单与生成List数据页的视图,启用与否代表整个魔方系统是否启用

　　　　数据中间设置

　　　　xcode中间件设置,其中最重要的反向工程设置,默认为on,这个时候会根据实体文件对数据表进行检测,其中会新增字段,不能删除与修改字段,缓存时间一般是10秒,可以设置默认的备份数据库目录,主要针对sqlite文件数据库

　　　　魔方设置

　　　　显示时间控制,作为整个页面的数据库查询时间的一个辅助开发功能设置

　　　　插件服务器设置,这个是所有的插件以及资源服务器的一个设置

　　　　工作台页面设置,作为一个后台权限系统登录进来展示的首页

　　　　布局页设置,是整个mvc布局页的一个设置

　　　　密码登录,启用注册,自动注册强行绑定用户设置都是跟用户相关的一些设置

　　　　下拉框选择,其中下拉框开启后样式为bootstrap,页面加载会比较耗时,如果追求极速,可以考虑关闭下拉框选择

　　　　SSL作为https的强制使用

　　　3.2文件

　　　　在线的文件管理系统,可以直接上传bin文件以及下载sqlite的备份文件下载到本地

　　　3.3页面右边高级功能

　　　　清空数据表:其中清空表是checkident操作,会把自增ID重新从1开始

　　　　删除全部:删除当前符合查询条件的全部记录

　　　　导出xml与json,按照xml或者json格式导出当前符合查询条件的记录

　　　　导出excel,测试过最多导出过90w的记录

　　　　生成Form表单:生成表单视图模版文件,可以随意修改视图页面

　　　　生成List数据模版,随意修改列表数据页

4.魔方项目引用及使用

　　4.1魔方dll的引用

　　　　新建.NET Framework MVC项目

　　 640?wx_fmt=png

　　在新建项目中右键选择管理Nuget包中搜索NewLife.cube然后安装到本项目中,该cube.dll会自动引入XCode.dll与core.dll,其中cube所需的资源包,项目会自动下载到Content目录下边

　　 640?wx_fmt=png

安装完成后会在目录生成Model.xml与Build.tt文件,其中Model.xml文件是数据库参考文件

数据库模型文件详细说明见图所标识:

Index为默认主键索引,其中表名+主键名称会在实体类Biz.cs中自动生成扩展属性

640?wx_fmt=png

4.2实体的生成

在build.tt文件上右键选择运行自定义工具就会在Model.xml文件中设定的目录下生成实体文件.cs数据文件,biz.cs业务文件,分部类,一个类放在多个文件里边,biz.cs只是在第一次生成,以后不会覆盖生成,.cs每次更新表都会重新生成

4.3魔方的使用区域与控制器

　　在项目上右键在弹出菜单中选择添加,在子菜单中点击区域按钮新增区域Areas,即在左侧新建一个一级菜单

我新建了一个Test的区域,修改区域的AreaRegistration文件,将继承修改为AreaRegistrationBase,并使用注解[DisplayName("区域名称即一级菜单的名称")]的方式为该菜单的名称

新建控制器继承自EntityController<实体类>,会自动生成一个二级子菜单,通过注解[DisplayName("二级菜单的名称")]

640?wx_fmt=png

运行得到该实体列表页,要想列表中某些字段不显示,只需要在控制器中的构造方法里边输入ListFields.Remove("列名”)

public class MyUserController : EntityController<Log>
{       
public MyUserController() {ListFields.Remove(Log._.CreateUserID);}}

4.4高级按钮生成表单与列表的视图文件

生成模版文件后,点击工程的显示所有按钮,然后在对应的控制器的view目录下将模版文件包括在项目中,这个时候可以对模版进行任意覆盖修改,自己可以多修改运行试试效果,特别注意

需要在views下边的webconfig文件中加入以下的命名空间

640?wx_fmt=png

5.魔方的精髓模版覆盖

　5.1模版介绍

　　模版分为表单模版Form.cshtml,列表模版List.cshtml,布局模版,每个模版可以分别单独覆盖,可以局部整体覆盖,真正做到任意覆盖,其中最重要的是可以根据优先级顺序进行整体局部覆盖,需要整站覆盖直接修改　　　　 Ace_Layout.cshtml

　　 其中优先级顺序依次为项目Views-->控制器Views-->Areas Views-->魔方内置Views

　　 列表模版详细说明如下:整个模版分为_List_Toolbar.cshtml,_List_Data.cshtml,_List_Pager.cshtml

其中_List_Data.cshtml又包含两部分数据部分:_List_Data_Item.cshtml 与操作部分:_List_Data_Action.cshtml

_List_Toolbar.cshtml是最复杂的功能其中包含批量操作_List_Toolbar_Batch.cshtml,日期搜索_List_Search.cshtml对应(_DateRange.cshtml)不知为何要这样多一个search的页面,不敢揣摩圣意,关键字查询_List_Toolbar_Search.cshtml,高级按钮功能,_List_Toolbar_Adv.cshtml

现在示例一下修改Search的查询:首先在控制器中重载一下Search方法,在实体中实现Search的高级搜索方法

   protected override IEnumerable<UserOnline> Search(Pager p){         
var id = p["id"];//取当前页面的id值   
         //p["q"]关键字的值return UserOnline.Search(p["q"],p);}