美文网首页
BoYuan开发示例-- 生成简单的项目。

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

作者: Sunday_1024 | 来源:发表于2020-01-20 16:38 被阅读0次

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

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

    免费开源的简化版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. 部门管理 模块。添加或编辑页面基本可以不动。部门列表页面的需要,添加关键词搜索,伪删除功能实现。

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

    关键词代码实现

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

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

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

    性别枚举

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

    性别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

    相关文章

      网友评论

          本文标题:BoYuan开发示例-- 生成简单的项目。

          本文链接:https://www.haomeiwen.com/subject/oicjzctx.html