小明接了个项目，业务方的需求里面有很多组织管理、人员管理、事件管理的需求，这些业务有面向终端客户的查询，也有面向内部管理人员的管理。需求的复杂度不高，很多都是表单的增删改查，但架不住需求点太多，小明还是得加班加点的当搬砖码农。其实，针对这类场景，有很多公司尝试使用打破分层界限的编码工具，比如宇宙第一编码语言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 的测试方法, 看一下结果情况

@BeforeEachvoid 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();}    @Testvoid 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

链接：