diboot/diboot-core/README.md

64 lines
2.6 KiB
Markdown
Raw Normal View History

2019-06-22 16:01:36 +08:00
## diboot-core: 全新优化内核
2019-06-22 16:24:18 +08:00
主要实现:
2019-06-22 16:01:36 +08:00
1. 多表关联的自动绑定, 实现单表CRUD和多表关联的无SQL化
2019-06-22 16:24:18 +08:00
2. 提供其他常用开发场景的最佳实践封装。
2019-06-22 16:01:36 +08:00
2019-06-22 16:26:12 +08:00
### ** 单表CRUD无SQL
2019-06-22 16:24:18 +08:00
> 依赖Mybatis-Plus实现Mybatis-Plus具备通用Mapper方案和灵活的查询构造器
2019-06-22 16:26:12 +08:00
### ** 多表关联查询无SQL适用于大多数场景拆分成单表查询自动实现结果绑定
2019-06-22 16:01:36 +08:00
> 通过注解实现多数场景下的关联查询无SQL
2019-06-27 11:49:49 +08:00
#### 2.1. 注解自动绑定数据字典(枚举值)的显示值Label
2019-06-22 16:01:36 +08:00
~~~java
2019-06-27 11:49:49 +08:00
@BindDict(type="GENDER", field = "gender")
2019-06-22 16:01:36 +08:00
private String genderLabel;
~~~
2019-06-22 16:24:18 +08:00
#### 2. 注解自动绑定其他表的字段
2019-06-22 16:01:36 +08:00
~~~java
// 支持关联条件+附加条件绑定字段
@BindField(entity=Department.class, field="name", condition="department_id=id AND parent_id>=0")
private String deptName;
// 支持通过中间表的级联关联绑定字段
@BindField(entity = Organization.class, field="name", condition="this.department_id=department.id AND department.org_id=id")
private String orgName;
~~~
2019-06-22 16:24:18 +08:00
#### 3. 注解自动绑定其他表实体Entity
2019-06-22 16:01:36 +08:00
~~~java
// 支持关联条件+附加条件绑定Entity
@BindEntity(entity = Department.class, condition="department_id=id")
private Department department;
// 通过中间表的级联关联绑定Entity支持附加条件
@BindEntity(entity = Organization.class, condition = "this.department_id=department.id AND department.org_id=id AND department.deleted=0")
private Organization organization;
~~~
2019-06-22 16:24:18 +08:00
#### 4. 注解自动绑定其他表实体集合List<Entity>
2019-06-22 16:01:36 +08:00
~~~java
// 支持关联条件+附加条件绑定多个Entity
@BindEntityList(entity = Department.class, condition = "id=parent_id")
private List<Department> children;
// 通过中间表的 多对多关联 绑定Entity支持附加条件
@BindEntityList(entity = Role.class, condition="this.id=user_role.user_id AND user_role.role_id=id")
private List<Role> roleList;
2019-06-22 16:24:18 +08:00
~~~
2019-06-22 16:26:12 +08:00
### ** 调用方式
2019-06-22 16:24:18 +08:00
#### 1. 自动绑定关联(不需要转型)
~~~java
// 调用AnnotationBindingManager自动绑定注解相关关联
//List<MyUserVO> voList = ...;
AnnotationBindingManager.autoBind(voList);
~~~
#### 2. 自动转型并绑定关联(需要转型)
~~~java
// 获取Entity列表
List<User> entityList = userService.getEntityList(queryWrapper);
// 调用AnnotationBindingManager自动绑定注解相关关联
List<MyUserVO> voList = AnnotationBindingManager.autoConvertAndBind(userList, MyUserVO.class);
2019-06-22 16:01:36 +08:00
~~~
2019-07-10 21:54:54 +08:00
##### 使用样例请参考 - [diboot-core-example](https://github.com/dibo-software/diboot-v2-example/tree/master/diboot-core-example)