还在CRUD吗？给你一招一剑封喉，彻底摆脱简单的增删改查

有没有一种办法，在java的企业级开发中，既能满足复杂的需求开发；又可以快速的完成简单的增删改查（有一定的业务逻辑），同时能保证技术的统一性和延续性呢？ fluent-mybatis在完成了对mybatis封装，实现了在java代码中使用流式语言，满足条件设置、复杂关联、嵌套、union、多数据库支持、个性化扩展等便捷能力外。现在又推出了，专门面向表单级的增删改查，声明即实现的一剑封喉的能力。
呵呵呵，作者吹牛不用上税啊，我们来看个简单的例子：

我们定义一个spring rest api接口如下
复制代码
@RestController
@FormService(table = “student”)
public interface StudentQueryApi {
@PostMapping(“/student”)
Student findStudentBy(@RequestBody StudentQuery student);

@PostMapping("/listStudentBy")
List<Student> listStudentBy(@RequestBody StudentQuery student);

}

@Data
@Accessors(chain = true)
public class StudentQuery implements Serializable {
private String userName;

@Entry(type = EntryType.LikeLeft)
private String address;

@Entry(type = Between)
private Integer[] age;

private Integer gender;
/**
 * 默认正序
 */
@Entry(type = EntryType.OrderBy, value = "userName")
private boolean byUserName = true;
/**
 * 默认倒序
 */
@Entry(type = EntryType.OrderBy, value = "age")
private boolean byAge;

}

@Data
@Accessors(chain = true)
public class Student implements Serializable {

private String userName;

private String status;

private String phone;

@Entry("email")
private String hisEmail;

private Integer age;

private String address;

}
复制代码
然后用@FormServiceScan注解把API路径加入到spring configuration中, 用法和mybatis的@MapperScan类似

@FormServiceScan({“你定义api的package路径”})
public class SpringConfig {
// 你其它bean配置
}
复制代码
很简单，虽然你仅仅是定义了一个接口，没有写一行实现代码，你已经完整的实现了一个查询逻辑。查询入参包括了，相等条件，between条件，like条件和排序设置。

启动springboot应用，我们用rest client调用一下看看

是不是很简单，声明即实现，对于单表的CRUD，产品画完原型，开发也基本实现完了，form-service功能也算一种低代码实现框架了。

下面我们重点将一下form-service的核心概念
@FormService, 定义在接口类上, 表明该接口是个FormService接口
@FormServiceScan, 定义在Spring的@Configuration类上，功能类似Mybatis的@MapperScan，用来扫描所有的@FormService接口
@FormMethod，可选，定义在Service方法上，如果是插入或更新方法，必须声明，如果是查询方法，无需声明
@Entry，可选，定义在表单字段上，在下列场景下需要显式定义@Entry
条件字段，条件不是相等，而是大于，小于，between等
表单字段名称和Entity字段名称不一致
分页条件字段（页码，每页数量）
排序字段
更新字段
同时，在接口和属性上，除了可以定义form-service的注解外，还需要有下面增强

还可以结合spring rest注解 @RestController+@PostMapping，直接将接口暴露为rest api
结合javax.validate注解，实现入参的合法性校验
当然，以上所有的功能都是基于你已经按照FluentMybatis的规范生成了数据库Entity类。 fluent mybatis代码生成

关联查询和 1 + N问题解决
但还不是fluent-mybatis FormService的所有功能，FormService还可以通过简单的声明，解决1对1和1对N的关联查询，同时解决在查询列表时，引起的1+N查询问题，而这所有的一切，都不需要你编码， 有一定编码经验的同学，就问你这样 爽不爽！！！

生成fluent mybatis Entity类时，通过@Relation注解定义1:1, 1:N的关联关系
比如这样

@Tables(url = URL, username = "root", password = "password",
    srcDir = SrcDir, testDir = TestDir, basePack = BasePack + 2,
    gmtCreated = "gmt_created", gmtModified = "gmt_modified", logicDeleted = "is_deleted",
    tables = {
        @Table(value = {"student", "student_score"},
            columns = @Column(value = "version", isLarge = true)
        ),
    relations = {
        @Relation(method = "findDeskMate", type = RelationType.OneWay_0_1,
            source = "student", target = "student", where = "id=desk_mate_id"),
        @Relation(source = "student", target = "student_score", type = RelationType.TwoWay_1_N,
            where = "id=student_id")
    })
static class RelationDef1 {
}

复制代码

1. Student和同桌是1 vs 1的关系
2. Student和成绩Score是 1 vs N关系
   复制代码
   上面的代码生成的Entity类如下

@FluentMybatis(
table = “student”,
schema = “fluent_mybatis”
)
public class StudentEntity extends RichEntity {
// … 省略属性定义

/**

• 1对1关联查询方法
  */
  @RefMethod(“deskMateId = id”)
  public StudentEntity findDeskMate() {
  return super.invoke(“findDeskMate”, true);
  } /**
• 1对多关联查询方法
  */
  @RefMethod(“studentId = id”)
  public List findStudentScoreList() {
  return super.invoke(“findStudentScoreList”, true);
  }
  }
  复制代码
  在查询接口返回值中定义关联对象，比如下面这样
  @Data
  @Accessors(chain = true)
  public class Student {
  private Long id; private String userName; private String status; private String phone; @Entry(“email”)
  private String hisEmail; private Integer age; private String address;
  /**
  • 同桌对象, 对应 findDeskMate方法
    / private Student deskMate; /*
  • 分数列表, 属性名称是scores, 无法按规则和findStudentScoreList对应
  • 需在 @Entry 注解中显式指定关联方法
    */
    @Entry(value = “findStudentScoreList”)
    private List scores;
    }
    复制代码
    现在我们重新执行 listStudentBy 的测试方法, 看一下结果情况

@BeforeEach
void setup() {
// 准备2个学生的数据，互为同桌
ATM.dataMap.student.table(2)
.env.values(“test_env”)
.userName.values(“li ming”, “xiao qiang”)
.age.values(23, 34)
.email.values(“xxx@test”)
.address.values(“hangzhou binjiang”)
.deskMateId.values(2, 1)
.cleanAndInsert();
// 准备3条成绩数据，liming有二门成绩，小强一门成绩
ATM.dataMap.studentScore.table(3)
.env.values(“test_env”)
.studentId.values(1, 1, 2)
.subject.values(“yuwen”, “english”)
.score.values(79, 67, 98)
.cleanAndInsert();
}

@Test
void listEntity() {
List students = service.listStudentBy(new StudentQuery()
.setAddress(“hangzhou”)
.setAge(new Integer[]{20, 40}));

// 验证列表数据
want.object(students).eqDataMap(
    ATM.dataMap.student.entity(2)
        .userName.values("li ming", "xiao qiang")
        .age.values(23, 34)
        .address.values("hangzhou binjiang")
        .kv("hisEmail", "xxx@test")
);
/* 同桌的同桌 = 自己 */

want.object(students.get(0)).eqReflect(students.get(1).getDeskMate(), EqMode.IGNORE_DEFAULTS);
/* 验证成绩列表 */
want.object(students.get(0).getScores()).eqDataMap(new DataMap(2)
.kv(“score”, 79, 67)
.kv(“subject”, “yuwen”, “english”));
want.object(students.get(1).getScores()).eqDataMap(new DataMap(1)
.kv(“score”, 98)
.kv(“subject”, “english”));
}
复制代码
接着我观察一下控制台打印出来的sql语句, 总共执行了3条SQL语句 1. 查询学生列表 2. 查询学生的同桌, 条件 desk_mate_id IN (?, ?) 3. 查询学生的成绩, 条件 student_id IN (?, ?)

==> Preparing: SELECT id, ...省略字段 FROM student WHERE is_deleted = ? AND env = ? AND address LIKE ? AND age BETWEEN ? AND ? ORDER BY user_name ASC, age DESC
==> Parameters: false(Boolean), test_env(String), hangzhou%(String), 20(Integer), 40(Integer)
<== Total: 2 ==> Preparing: SELECT id, ...省略字段 FROM student WHERE is_deleted = ? AND env = ? AND desk_mate_id IN (?, ?)
==> Parameters: false(Boolean), test_env(String), 1(Long), 2(Long)
<== Total: 2 ==> Preparing: SELECT id, ...省略字段 FROM student_score WHERE is_deleted = ? AND env = ? AND student_id IN (?, ?)
==> Parameters: false(Boolean), test_env(String), 1(Long), 2(Long)
<== Total: 3
复制代码
通过，上面观察，框架完美的解决了1+N查询的问题

框架使用
maven引用, 详细的使用文档请参考 fluent mybatis文档

<dependency>
    <groupId>com.github.atool</groupId>
    <artifactId>form-service-meta</artifactId>
    <version>1.9.1</version>
</dependency>
<dependency>
    <groupId>com.github.atool</groupId>
    <artifactId>fluent-mybatis</artifactId>
    <version>1.9.1</version>
</dependency>
<dependency>
    <groupId>com.github.atool</groupId>
    <artifactId>fluent-mybatis-processor</artifactId>
    <version>1.9.1</version>
    <scope>provided</scope>
</dependency>

复制代码
完整的例子见 fluent mybatis

链接：
https://juejin.cn/post/7033388050012962852