天河部落,曹代腾,wade
准备
源码地址: https://github.com/newlifex/newlife.cube
演示地址: 可以直接注册用户以及选用第三方登录
开始
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是排序字段
如对本文有疑问，请在下面进行留言讨论，广大热心网友会与你互动！！ 点击进行留言回复
asp.net搭建博客，使用BlogEngine.NET+MySql搭建博客
网友评论