BoYuan开发示例-- 生成简单的项目。
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盘目录下，个人不喜欢直接覆盖到项目代码，当然如果你喜欢可以修改。
连接数据库生成实体模型.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. 完善业务代码。
- 部门管理 模块。添加或编辑页面基本可以不动。部门列表页面的需要，添加关键词搜索，伪删除功能实现。
部门列表页面 关键词代码实现:红框里代表修改的代码，获取关键词，模糊查询部门名称。
关键词代码实现
部门列表页面 伪删除功能: 默认是批量删除代码，需要修改成伪删除代码。如下图。
修改后的伪删除方法
- 员工管理 模块。员工管理涉及到多表连接查询，添加一个员工信息同时需要添加所在部门，这里我们用下拉框来表示部门。
员工管理 列表页面，需要添加性别下拉框，部门下拉框，员工姓名或员工编码模糊查询。性别字段，这里我打算用枚举对象来实现，我们先创建个性别枚举。
性别枚举
列表页面的初始化方法，增加性别：
性别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
