0. 介绍BoYuan快速开发框架。

实现页面权限或页面+button权限基于权限角色的后台框架,并有完善的异常拦截写入日志功能。 项目为webform开发模式,简单的service分层架构,前端FineUIPro , 数据层使用FreeSql+雪花算法实体模式,兼容各种不同的数据库迁移(支持的数据库:SqlServer, Mysql, Postgresql, Oracle 等)。 配有代码生成工具和其他利于编程的工具,优秀的编码体验,层次分明,简单易学,从而实现快速开发的目的,适用于中小型项目快速开发。 建议使用vs2017以上版本开发工具 , mssql数据库 ,Framework 4.5 以上版本。 有建议或问题,欢迎联系我

在线视频使用教程

https://www.bilibili.com/video/BV1864y1o7te

免费开源的简化版BoYuan框架:SugarFineUI

https://gitee.com/sundayisblue/SugarFineUITool

关于架构变化说明:原来使用的orm是sqlsugar,现在替换为freesql,原因是freesql功能多稳定并且对其他数据库兼容性更好。写法上有些差异,但lambda风格不变

1. 项目初始化,并创建数据库。

打开代码生成项目,如图会看到项目基本结构。也可以参看项目说明文档,会有项目概述

BoYuan开发示例-- 生成简单的项目。_数据库

让我们先从数据库创建开始,以SqlServer为例子(其他数据库一样的操作)。如下图,填写好对应数据库的链接,点击执行“初始化表”按钮,即可完成相关基础表结构。

BoYuan开发示例-- 生成简单的项目。_字段_02

BoYuan开发示例-- 生成简单的项目。_数据库_03

BoYuan开发示例-- 生成简单的项目。_数据库_04

创建我们的业务表,这里创建员工表部门表。默认都是以id作为主键,注意不要设置成自增 否则不利于数据库迁移,默认是long类型(sqlserver里是bigint)。

BoYuan开发示例-- 生成简单的项目。_sql_05

BoYuan开发示例-- 生成简单的项目。_sql_06

2. 生成Entity实体模型和FineuiPro页面代码。

创建好数据库后,我们就可以执行代码工具。

BoYuan开发示例-- 生成简单的项目。_字段_07

首先 生成FreeSql实体,选择对应的页面。如下图,点击连接数据库,暂时不支持单表实体生成。默认是放到C盘目录下,个人不喜欢直接覆盖到项目代码,当然如果你喜欢可以修改。

把生成的实体放入到entity层

BoYuan开发示例-- 生成简单的项目。_数据库_08

生成FineUIPro页面。 选择FineUIPro页面,先在右边连接好数据库,选择要生成页面的相关表,代码生成是根据单表结构来生成的;生成代码相关信息,比如说命名空间、路径等,默认不需要修改;生成的代码默认放在C盘,这里我只想生成编辑页面,列表页面,单选即可,最后点击生成简单代码按钮,生成相关页面。

BoYuan开发示例-- 生成简单的项目。_字段_09

把生成页面代码放入到项目中,先别着急运行项目:选中项目->vs菜单项目->执行转换为Web应用程序

BoYuan开发示例-- 生成简单的项目。_数据库_10

BoYuan开发示例-- 生成简单的项目。_字段_11

如果想查看单页面生成代码,选择表(多选的表还是默认选择选中的第一个表),点击按钮显示单页代码即可。

BoYuan开发示例-- 生成简单的项目。_sql_12

至此项目代码生成完毕,重新编译生成项目,保证项目不报错。

3. 更改数据库。

更改数据连接字符串,如图在web.config中设置。

BoYuan开发示例-- 生成简单的项目。_sql_13

更改数据库类型。注意 如果是PostgreSQL 要设置为小写,oracle 要设置为大写,通过设置UseNameConvert参数来设置,其他数据可以不用设置此参数。

BoYuan开发示例-- 生成简单的项目。_字段_14

4. 权限配置。

运行项目BoYuan.FineuiProWeb。在login.aspx页面里,我为了方便调试,page_load事件里增加了自动登录的代码,项目发布时候不要忘记删除。

BoYuan开发示例-- 生成简单的项目。_数据库_15

登录后默认能看到相关的管理员设置。如果想显示新增加的页面到系统里,在页面组件里设置。

BoYuan开发示例-- 生成简单的项目。_字段_16

右键点击根节点,可以添加根页面;

BoYuan开发示例-- 生成简单的项目。_字段_17

如下图,左边点击可以设置页面所在路径。右边URL地址,可以设置url地址,也可以是外网地址(需要填写完整的url,例:https:// www .baidu .com);如果是文件夹,可以不填写。状态显示 是在左侧菜单里是否显示状态。

BoYuan开发示例-- 生成简单的项目。_sql_18

回头,我们看下代码生成工具,批量添加页面组件。如果生成的页面比较多,手动一个个添加是个麻烦的体力活儿。当然我也想偷懒,让Boyuan框架帮你去做。一键添加页面组件到数据库里,如下图。会根据你项目所有的aspx文件,同步到数据里。(同理,可以同步button权限,这里暂时不讨论button权限。)

BoYuan开发示例-- 生成简单的项目。_字段_19

我们在回来,在系统中查看一下,同步的页面组件数据。当然 页面名称需要自己修改,如下图。

BoYuan开发示例-- 生成简单的项目。_sql_20

设置权限角色。如下图,更改超级管理员角色权限,让新增的页面显示出来。打挑的都是有权访问的页面。

BoYuan开发示例-- 生成简单的项目。_sql_21

查看生成的页面,可以CRUD数据了,但是离你的业务还差一点,这需要手动编码了。

BoYuan开发示例-- 生成简单的项目。_字段_22

5. 完善业务代码。

  1. 部门管理 模块。添加或编辑页面基本可以不动。部门列表页面的需要,添加关键词搜索,伪删除功能实现。

部门列表页面 关键词代码实现:红框里代表修改的代码,获取关键词,模糊查询部门名称。

BoYuan开发示例-- 生成简单的项目。_字段_23

部门列表页面 伪删除功能: 默认是批量删除代码,需要修改成伪删除代码。如下图。

BoYuan开发示例-- 生成简单的项目。_数据库_24

  1. 员工管理 模块。员工管理涉及到多表连接查询,添加一个员工信息同时需要添加所在部门,这里我们用下拉框来表示部门。

员工管理 列表页面,需要添加性别下拉框,部门下拉框,员工姓名或员工编码模糊查询。性别字段,这里我打算用枚举对象来实现,我们先创建个性别枚举。

BoYuan开发示例-- 生成简单的项目。_sql_25

列表页面的初始化方法,增加性别

BoYuan开发示例-- 生成简单的项目。_数据库_26

BoYuan开发示例-- 生成简单的项目。_字段_27

列表页面的初始化方法,增加部门

BoYuan开发示例-- 生成简单的项目。_数据库_28

BoYuan开发示例-- 生成简单的项目。_字段_29

BoYuan开发示例-- 生成简单的项目。_sql_30

列表页面的绑定方法 bind:

先做关联查询。如下图,写select字段比较麻烦,如果字段太多是个很不爽的体力活。BoYuan框架有解决方案。

BoYuan开发示例-- 生成简单的项目。_sql_31


选择代码工具,反射获取字段代码页面。如下图,操作获取员工相关字段信息。

BoYuan开发示例-- 生成简单的项目。_数据库_32

同理,可以获取部门字段信息。

BoYuan开发示例-- 生成简单的项目。_数据库_33

最后把,上面操作的2段代码进行复制到项目里,并合并。

BoYuan开发示例-- 生成简单的项目。_数据库_34

动态添加查询条件。列表页面所有的业务逻辑完成。

BoYuan开发示例-- 生成简单的项目。_字段_35

员工管理 编辑页面,业务代码完善。如下图,需要修改性别所在部门 为下拉框。

BoYuan开发示例-- 生成简单的项目。_sql_36

修改编辑页面:

BoYuan开发示例-- 生成简单的项目。_数据库_37

BoYuan开发示例-- 生成简单的项目。_sql_38

BoYuan开发示例-- 生成简单的项目。_数据库_39

至此,所有的业务代码完成。自己添加数据试试效果吧!

6. 项目开发小技巧。

项目提供完整的异常追踪功能,并输出到Log中,方便线上发布排查问题。同时也debug下也会输出所有的sql,方便调试代码。

如果你遇到此问题

BoYuan开发示例-- 生成简单的项目。_sql_40

请排查项目或服务器上Log

BoYuan开发示例-- 生成简单的项目。_sql_41

vs的输出窗口会有追踪所有运行的sql,方便编程调试。如下图

BoYuan开发示例-- 生成简单的项目。_sql_42