小明接了个项目，业务方的需求里面有很多组织管理、人员管理、事件管理的需求，这些业务有面向终端客户的查询，也有面向内部管理人员的管理。需求的复杂度不高，很多都是表单的增删改查，但架不住需求点太多，小明还是得加班加点的当搬砖码农。其实，针对这类场景，有很多公司尝试使用打破分层界限的编码工具，比如宇宙第一编码语言PHP、ruby/rails等，方便快捷，奈何业务复杂了以后，都得慢慢迁移到企业级开发语言java上。也有公司，开始尝试低代码平台，通过简单的托拉拽就完成后台管理界面的开发，奈何，现在的低代码开发还真只能胜任上面需求中的增删改查。
复制代码

有没有一种办法，在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<StudentScoreEntity> 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<Score> 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<Student> 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