0. 介绍BoYuan快速开发框架。
实现页面权限或页面+button权限基于权限角色的后台框架,并有完善的异常拦截写入日志功能。 项目为webform开发模式,简单的service分层架构,前端FineUIPro , 数据层使用FreeSql+雪花算法实体模式,兼容各种不同的数据库迁移(支持的数据库:SqlServer, Mysql, Postgresql, Oracle 等)。 配有代码生成工具和其他利于编程的工具,优秀的编码体验,层次分明,简单易学,从而实现快速开发的目的,适用于中小型项目快速开发。 建议使用vs2017以上版本开发工具 , mssql数据库 ,Framework 4.5 以上版本。 有建议或问题,欢迎联系我
在线视频使用教程
免费开源的简化版BoYuan框架:SugarFineUI
关于架构变化说明:原来使用的orm是sqlsugar,现在替换为freesql,原因是freesql功能多稳定并且对其他数据库兼容性更好。写法上有些差异,但lambda风格不变
1. 项目初始化,并创建数据库。
打开代码生成项目,如图会看到项目基本结构。也可以参看项目说明文档,会有项目概述。
让我们先从数据库创建开始,以SqlServer为例子(其他数据库一样的操作)。如下图,填写好对应数据库的链接,点击执行“初始化表”按钮,即可完成相关基础表结构。
创建我们的业务表,这里创建员工表和部门表。默认都是以id作为主键,注意不要设置成自增 否则不利于数据库迁移,默认是long类型(sqlserver里是bigint)。
2. 生成Entity实体模型和FineuiPro页面代码。
创建好数据库后,我们就可以执行代码工具。
首先 生成FreeSql实体,选择对应的页面。如下图,点击连接数据库,暂时不支持单表实体生成。默认是放到C盘目录下,个人不喜欢直接覆盖到项目代码,当然如果你喜欢可以修改。
把生成的实体放入到entity层
生成FineUIPro页面。 选择FineUIPro页面,先在右边连接好数据库,选择要生成页面的相关表,代码生成是根据单表结构来生成的;生成代码相关信息,比如说命名空间、路径等,默认不需要修改;生成的代码默认放在C盘,这里我只想生成编辑页面,列表页面,单选即可,最后点击生成简单代码按钮,生成相关页面。
把生成页面代码放入到项目中,先别着急运行项目:选中项目->vs菜单项目->执行转换为Web应用程序。
如果想查看单页面生成代码,选择表(多选的表还是默认选择选中的第一个表),点击按钮显示单页代码即可。
至此项目代码生成完毕,重新编译生成项目,保证项目不报错。
3. 更改数据库。
更改数据连接字符串,如图在web.config中设置。
更改数据库类型。注意 如果是PostgreSQL 要设置为小写,oracle 要设置为大写,通过设置UseNameConvert参数来设置,其他数据可以不用设置此参数。
4. 权限配置。
运行项目BoYuan.FineuiProWeb。在login.aspx页面里,我为了方便调试,page_load事件里增加了自动登录的代码,项目发布时候不要忘记删除。
登录后默认能看到相关的管理员设置。如果想显示新增加的页面到系统里,在页面组件里设置。
右键点击根节点,可以添加根页面;
如下图,左边点击可以设置页面所在路径。右边URL地址,可以设置url地址,也可以是外网地址(需要填写完整的url,例:https:// www .baidu .com);如果是文件夹,可以不填写。状态显示 是在左侧菜单里是否显示状态。
回头,我们看下代码生成工具,批量添加页面组件。如果生成的页面比较多,手动一个个添加是个麻烦的体力活儿。当然我也想偷懒,让Boyuan框架帮你去做。一键添加页面组件到数据库里,如下图。会根据你项目所有的aspx文件,同步到数据里。(同理,可以同步button权限,这里暂时不讨论button权限。)
我们在回来,在系统中查看一下,同步的页面组件数据。当然 页面名称需要自己修改,如下图。
设置权限角色。如下图,更改超级管理员角色权限,让新增的页面显示出来。打挑的都是有权访问的页面。
查看生成的页面,可以CRUD数据了,但是离你的业务还差一点,这需要手动编码了。
5. 完善业务代码。
- 部门管理 模块。添加或编辑页面基本可以不动。部门列表页面的需要,添加关键词搜索,伪删除功能实现。
部门列表页面 关键词代码实现:红框里代表修改的代码,获取关键词,模糊查询部门名称。
部门列表页面 伪删除功能: 默认是批量删除代码,需要修改成伪删除代码。如下图。
- 员工管理 模块。员工管理涉及到多表连接查询,添加一个员工信息同时需要添加所在部门,这里我们用下拉框来表示部门。
员工管理 列表页面,需要添加性别下拉框,部门下拉框,员工姓名或员工编码模糊查询。性别字段,这里我打算用枚举对象来实现,我们先创建个性别枚举。
列表页面的初始化方法,增加性别:
列表页面的初始化方法,增加部门:
列表页面的绑定方法 bind:
先做关联查询。如下图,写select字段比较麻烦,如果字段太多是个很不爽的体力活。BoYuan框架有解决方案。
选择代码工具,反射获取字段代码页面。如下图,操作获取员工相关字段信息。
同理,可以获取部门字段信息。
最后把,上面操作的2段代码进行复制到项目里,并合并。
动态添加查询条件。列表页面所有的业务逻辑完成。
员工管理 编辑页面,业务代码完善。如下图,需要修改性别 和 所在部门 为下拉框。
修改编辑页面:
至此,所有的业务代码完成。自己添加数据试试效果吧!
6. 项目开发小技巧。
项目提供完整的异常追踪功能,并输出到Log中,方便线上发布排查问题。同时也debug下也会输出所有的sql,方便调试代码。
如果你遇到此问题
请排查项目或服务器上Log
vs的输出窗口会有追踪所有运行的sql,方便编程调试。如下图