diboot/diboot-core
wyldusername 7aba9cc05f 代码优化:添加非空判断 2019-08-15 18:08:47 +08:00
..
src 代码优化:添加非空判断 2019-08-15 18:08:47 +08:00
README.md + 更新readme,增加@BindQuery注解的使用 2019-08-13 10:55:59 +08:00
build.gradle + 增加注册接口 2019-07-11 16:07:52 +08:00

README.md

diboot-core: 全新优化内核

主要实现:

  1. 单表CRUD和多表关联查询的无SQL化
  2. Entity/DTO自动转换为QueryWrapper@BindQuery注解绑定字段参数对应的查询条件无注解默认映射为等于=条件)
  3. 提供其他常用开发场景的最佳实践封装。

** 一. 单表CRUD无SQL

依赖Mybatis-plus实现Mybatis-plus具备通用Mapper方案和灵活的查询构造器

** 二. 多表关联查询无SQL通过注解绑定关联自动拆分成单表查询并绑定结果

通过注解实现多数场景下的关联查询无SQL

1. 注解自动绑定数据字典(自定义枚举)的显示值Label

@BindDict(type="USER_STATUS", field = "status")
private String statusLabel;

2. 注解自动绑定其他表的字段

// 支持关联条件+附加条件绑定字段
@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;

3. 注解自动绑定其他表实体Entity

// 支持关联条件+附加条件绑定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;

4. 注解自动绑定其他表实体集合List

// 支持关联条件+附加条件绑定多个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;

** 三. 注解绑定关联的使用方式

1. 引入依赖

Gradle:

compile("com.diboot:diboot-core-spring-boot-starter:2.0.2")

或Maven

<dependency>
    <groupId>com.diboot</groupId>
    <artifactId>diboot-core-spring-boot-starter</artifactId>
    <version>2.0.2</version>
</dependency>

注: @BindDict注解需要依赖dictionary表可配置参数 diboot.core.init-sql=true 初次启动时starter会自动安装 init-{db}.sql。 如不支持自动安装的数据库,需手动执行 diboot-core-*.jar/META-INF/sql/init-{db}.sql 。

2. 定义你的Service继承diboot的BaseService或Mybatis-plus的ISerivice及Mapper

3. 使用注解绑定:

调用RelationsBinder自动绑定注解相关关联

方式1. 自动绑定关联(不需要转型)

//List<MyUserVO> voList = ...; 
RelationsBinder.bind(voList);

方式2. 自动转型并绑定关联(需要转型)

// 查询单表获取Entity集合
// List<User> entityList = userService.list(queryWrapper);
List<MyUserVO> voList = RelationsBinder.convertAndBind(userList, MyUserVO.class);

** 四. Entity/DTO自动转换为QueryWrapper的使用方式

1. Entity/DTO中声明映射查询条件

示例代码:

public class UserDTO{
    // 无@BindQuery注解默认会映射为=条件
    private Long gender;
    
    // 有注解,映射为注解指定条件
    @BindQuery(comparison = Comparison.LIKE)
    private String realname;
    
    //... getter, setter
}

2. 调用QueryBuilder.toQueryWrapper(entityOrDto)进行转换

/**
 * url参数示例: /list?gender=M&realname=张
 * 将映射为 queryWrapper.eq("gender", "M").like("realname", "张")
 */
@GetMapping("/list")
public JsonResult getVOList(UserDto userDto) throws Exception{
    //调用super.buildQueryWrapper(entityOrDto) 或者直接调用 QueryBuilder.toQueryWrapper(entityOrDto) 进行转换
    QueryWrapper<User> queryWrapper = super.buildQueryWrapper(userDto);
    //... 查询list
    return new JsonResult(Status.OK, list);
}

五. 样例参考 - diboot-core-example