小明接了个项目，业务方的需求里面有很多组织管理、人员管理、事件管理的需求，这些业务有面向终端客户的查询，也有面向内部管理人员的管理。需求的复杂度不高，很多都是表单的增删改查，但架不住需求点太多，小明还是得加班加点的当搬砖码农。其实，针对这类场景，有很多公司尝试使用打破分层界限的编码工具，比如宇宙第一编码语言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 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文档
com.github.atool
form-service-meta
1.9.1
com.github.atool
fluent-mybatis
1.9.1
com.github.atool
fluent-mybatis-processor
1.9.1
provided
复制代码完整的例子见 fluent mybatis
链接：
https://juejin.cn/post/7033388050012962852