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

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. 项目初始化，并创建数据库。

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

项目概述

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

执行代码工具页面

初始化权限相关数据库

生成的默认表

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

员工表

部门表

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

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

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

连接数据库生成实体模型.png

把生成的实体放入到entity层

连接数据库生成对应的实体模型

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

生成页面设置.png

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

把生成页面代码放入到项目中.png

转换为Web应用程序

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

单页代码显示

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

3. 更改数据库。

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

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. 完善业务代码。

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

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

关键词代码实现

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

修改后的伪删除方法

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

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

性别枚举

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

性别aspx

性别cs

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

部门aspx

部门aspx列表字段

部门cs

列表页面的绑定方法 bind:

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

FreeSql左查询

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

反射获取员工实体字段信息

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

反射获取部门实体字段信息

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

合并后的显示字段代码

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

动态添加查询条件

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

待完善的编辑页面

修改编辑页面：

编辑页面aspx

后台page_Load事件

后台button事件

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

6. 项目开发小技巧。

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

如果你遇到此问题

登录异常，有可能是数据库连接问题

请排查项目或服务器上Log

在vs项目中根目录logs下生成的log文件

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

debug下实时运行的sql