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

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

准备

源码地址: https://github.com/newlifex/newlife.cube

演示地址:  可以直接注册用户以及选用第三方登录

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

开始

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项目

　　

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

　　

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

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

 

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

4.2实体的生成

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

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

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

　　

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

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

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

 public class myusercontroller : entitycontroller<log>
    {
        public myusercontroller() {
            listfields.remove(log._.createuserid);
        }
    }

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

 

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

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

　　 <add namespace="newlife" />
        <add namespace="newlife.cube" />
        <add namespace="newlife.reflection" />
        <add namespace="newlife.web" />
        <add namespace="xcode" />
        <add namespace="xcode.membership" />

 

 

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);
        }

最后可以使用自定义工具razorgenerator将视图文件编译成dll文件,可以联机搜索安装

当项目views同时使用cshtml文件与dll的时候优先使用cshtml文件

神奇黑科技:http://cube.newlifex.com/school/class/json?q=11&sort=id&desc=true&key=abcdefg

魔方支持json,xml导出数据,其中key为token,q为关键字,sort是排序字段