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

小明接了个项目,业务方的需求里面有很多组织管理、人员管理、事件管理的需求,这些业务有面向终端客户的查询,也有面向内部管理人员的管理。需求的复杂度不高,很多都是表单的增删改查,但架不住需求点太多,小明还是得加班加点的当搬砖码农。

其实,针对这类场景,有很多公司尝试使用打破分层界限的编码工具,比如宇宙第一编码语言PHP、ruby/rails等,方便快捷,奈何业务复杂了以后,都得慢慢迁移到企业级开发语言Java上。也有公司,开始尝试低代码平台,通过简单的托拉拽就完成后台管理界面的开发,奈何,现在的低代码开发还真只能胜任上面需求中的增删改查。

还在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吗? 给你一招一剑封喉,彻底摆脱简单的增删改查

是不是很简单,声明即实现,对于单表的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类。

关联查询和 1 + N问题解决

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

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

生成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(2334)
        .email.values("xxx@test")
        .address.values("hangzhou binjiang")
        .deskMateId.values(21)
        .cleanAndInsert();
    // 准备3条成绩数据,liming有二门成绩,小强一门成绩
    ATM.dataMap.studentScore.table(3)
        .env.values("test_env")
        .studentId.values(112)
        .subject.values("yuwen""english")
        .score.values(796798)
        .cleanAndInsert();
}
    
@Test
void listEntity() {
    List<Student> students = service.listStudentBy(new StudentQuery()
        .setAddress("hangzhou")
        .setAge(new Integer[]{2040}));
        
    // 验证列表数据
    want.object(students).eqDataMap(
        ATM.dataMap.student.entity(2)
            .userName.values("li ming""xiao qiang")
            .age.values(2334)
            .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"7967)
        .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查询的问题

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

框架使用

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

<dependency>
    <groupId>com.github.atool</groupId>
    <artifactId>fluent-mybatis</artifactId>
    <version>1.9.3</version>
</dependency>
<dependency>
    <groupId>com.github.atool</groupId>
    <artifactId>fluent-mybatis-processor</artifactId>
    <version>1.9.3</version>
    <scope>provided</scope>
</dependency>

完整的例子:

  • https://gitee.com/fluent-mybatis/fluent-mybatis/tree/master/fluent-mybatis-test/src/test/java/cn/org/atool/fluent/mybatis/formapi
来源:juejin.cn/post/7033388050012962852
后端专属技术群

构建高质量的技术交流社群,欢迎从事编程开发、技术招聘HR进群,也欢迎大家分享自己公司的内推信息,相互帮助,一起进步!

文明发言,以交流技术职位内推行业探讨为主

广告人士勿入,切勿轻信私聊,防止被骗

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

加我好友,拉你进群

原文始发于微信公众号(Java笔记虾):还在CRUD吗? 给你一招一剑封喉,彻底摆脱简单的增删改查

版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容, 请发送邮件至 举报,一经查实,本站将立刻删除。

文章由极客之音整理,本文链接:https://www.bmabk.com/index.php/post/153043.html

(0)
小半的头像小半

相关推荐

发表回复

登录后才能评论
极客之音——专业性很强的中文编程技术网站,欢迎收藏到浏览器,订阅我们!