Diboot官方版

Diboot简介

Diboot是一个开发平台，通过它可以设计新的应用程序和web程序。该软件提供了基本的框架和高效的工具。包括基于内核的内核、IAM权限组件、文件组件、调度器定时组件、diboot-antd-admin、diboot-element-admin、devtools开发。使用这些组件，您可以快速配置程序开发方案来构建新程序。可以部署身份访问控制模块和文件处理模块。可以给程序添加调度任务，配置工作流方案，为用户添加功能模块提供更好的部署方式，结合开发实现CRUD完整功能生成、前端组件排列生成、数据结构代码同步、后端代码一键生成、非覆盖更新代码、自动SQL和索引！

Diboot软件功能

非常容易使用(在引入依赖jar和配置参数之后，您可以启动并运行应用程序)

功能强大(数据结构和代码同步、前端和后端一键式生成、前端面板组件排列)

灵活配置(可以配置生成的代码路径，启用Lombok’、swaggy’等。根据需要)

代码标准(devtools标准化数据结构定义和代码实现以降低成本)

支持多个库(MySQL、MaaDB、ORACLE、SQLServer、PostgreSQL)

Diboot软件特色

单表及关联场景的CRUD导入导出完整功能全自动，无需手写代码。

结合前端面板组件排列的能力，可以自动生成更多的场景。

数据结构变更与代码链接同步，变更SQL和索引自动记录。

一键式代码生成和非覆盖更新本地后端代码

配置灵活(生成的代码路径可以根据需要配置，是否启用Lombok '、Swagger '等。)

SQL是非常标准的代码(devtools标准化了数据结构定义和代码实现)

Diboot使用说明

使用diboot-IAM的说明

#1.引入依赖性

或Gradle:

数据库连接已配置，iam starter组件将在首次启动时自动初始化，生成相关的表和初始数据。

如果使用diboot-devtools，还需要引入与devtools相关的依赖项，只需点击一下就可以生成与iam相关的contller。

注意:iam初始化的密码是:admin/123456。请在成功启动后及时更改密码。

#2.参数配置:

配置文件配置项目:

3.认证和授权

登录/申请令牌(后端):

登录并获取令牌后，前端会将其缓存并添加到每个请求的标头中，该标头属于thtoken。

当令牌的剩余有效期小于1/4时，组件将自动生成一个新令牌，并将其写入响应的标头中。通用名也是thtoken。如果前端响应的标头有新的thtoken，它将替换本地缓存值。

#4.BindPermission注释的使用

它可以添加到康特勒的类和方法中。权限ID支持类似于Spng @RequestMapping注释的“类+方法”拼接功能。方法上的注释支持自动身份验证，并且可以同时继承。例如:

BindPermission注释支持自动提取要验证的接口列表，并将其提供给前端进行快速绑定。

#5.将日志用作日志注释

@Log注释支持将日志自动记录到iam_operation_log表中，日志注释支持在RequestMapping方法上直接添加。

添加到支持Contller的方法中，例如:

6.登录/注册/退出

登录:

退出:

注册

获取当前用户对象:

Diboot-IAM:身份验证组件

#1.展开其他登录方法

的默认登录方法是:用户名和密码。如果需要扩展其他登录方式:

创建从身份验证凭据继承的身份验证凭据对象

实现AuthService接口，定义认证模式和接口实现。

申请令牌以替换您的身份验证方法:

2.替换用户类型或展开多个用户类型。

的默认用户实体是IamUser。获取当前登录的用户对象:

如果预置不能满足业务场景的需要，可以将用户替换为您的实体:

首先，在登录方式上，在生成令牌之前先传入当前用户类型:(如果有多个用户类型共享登录界面，可以从登录首页& # 8221；用户类型值& # 8221；)

获取用户对象相关代码已更改为:

或者多个用户:

3.更换缓存标记

默认的组件缓存类是shi的内存缓存实现:MemoryconstraintedCache。如果需要用redis之类的自定义缓存替换，需要创建一个缓存实现类来实现CacheMar接口(参考MemoryconstraintedCache的源代码)。

#第一步。依靠spng-boot-starter-data-redis，配置参数初始化RedisTemplate。

第二步。创建Redis缓存管理类，从抽象缓存中继承，并重写缓存。

实现shi的缓存接口:

第三步。将shi的CacheMar配置为您的CacheMar缓存类实例。

4.自定义数据权限

在某些场景下，搜索查询需要绑定一些数据权限控制的强制条件，比如只能查询部门的数据。

#第一步。将@DataAccessCheckpoint注释添加到需要数据权限控制的实体中的字段，并指定CheckpointType。

示例代码:

第二步。实现数据访问接口，并返回当前用户可以访问的相应检查点类型的合法标识。

第三步。在spngconfig类中配置Mybatis-plus数据权限，并启用数据权限拦截。

5.将JWT的令牌实现更改为无状态令牌。

在自2.2版以来的配置类中，重新定义BasicHttpAuthenticationFilter，并将其替换为StatelessJwtAuthFilter。示例代码如下:

常见问题

diboot-iam-spng-启动相关

#diboot支持哪些版本的Spng Boot？

Diboot 2.0.x支持Spng引导2.2.x

Diboot 2.1.x支持Spng引导2.3.x

Diboot 2.2.x支持Spng引导2.4+

#IAM的后端代码在哪里？

IAM的后端基础代码由devtools自动生成。

配置diboot组件依赖性和devtools依赖性。

启动项目，进入devtools的组件初始化页面，选择core、IAM等组件，执行初始化。

开发工具将生成基于IAM的代码到您配置的路径。

注意:diboot-example(打开新窗口)包含后端示例供参考:diboot-iam-example(IAM示例代码)和diboot-online-demo(在线演示项目)。

#如何自定义jackson配置

Diboot-core-starter包含默认的HttpMessageConverters配置，jackson已启用并初始化。关键配置参数是:

如果此配置不能满足您的开发场景，您可以在配置文件中重新定义HttpMessageConverters:

随着diboot-core-starter的引入，SQL分页查询有了重复的LIMIT。

mybatis-plus的分页配置在diboot-core-starter中默认预设(使用my batis-plus 3.4 . x MybatisPlusInterceptor的最新配置模式)。如果依赖core-starter，就不需要再次配置mybatis-plus的分页，只需要删除自己定制的mybatis-plus的分页配置即可。如果需要添加其他拦截器，需要重新定义MybatisPlusInterceptor。例子如下:

想在mybatis-plus老项目中使用diboot的绑定能力？还是用diboot-core？在没有数据库连接配置文件的模块下？

对于没有历史负担的新项目，我们建议您使用diboot系统的所有starter组件。核心组件有以下两个包:

内核代码

Diboot-core-starter:依赖于Diboot-core，增加自动配置、字典表初始化等功能(取决于数据库)。

对于mybatis-plus的老项目，如果想利用diboot的绑定能力或者在没有数据库连接概要的模块下使用内核组件，只能依靠diboot-core而不是diboot-core-starter。步骤如下:

1.添加核心相关性(非核心启动器)

2.如果只依赖核心，需要在包扫描中加入com.diboot.core，实现HttpMessageConverters和Mybatis-plus的分页配置:

3.如果您只依赖于核心，并且需要与@BindDict字典绑定，那么您需要实现DictionaryServiceExtPvider接口。(使用diboot-core-starter自动创建字典表，或者下载SQL(打开新窗口)手动创建表。

#启动错误:在映射器中找不到自定义接口。

默认情况下，当diboot-devtools没有指定mapper.xml路径时，为了方便起见，mapper.xml文件将生成到与mapper相同的路径。此时，您需要修改pom配置来编译包含xml和dtd类型的文件。

Maven配置:

渐变配置:

如何构建树形结构？

树对象约定:应该有parentId属(根节点为0)和List子属，便于自动构造。

首先，找出需要构建树结构的所有节点，例如:

调用BeanUtils.buildTree来构建一个树结构

返回第一级子节点。