1 本次更新

1.1 前言

   相信Myabtis Plus的wrapper大家已经很熟悉了，尤其是 LambdaQueryWrapper比JPA的 Specification好用了不知道多少倍，但是LambdaQueryWrapper写起来还不够行云流水，我一直在想能不能更简化它，于是出现了本次fhs版本更新带来的PO Wrapper增强器功能，他类似lombok，不需要写很多代码就可以对PO进行wrapper化增强配合ActiveRecord简直不要太爽。

1.2 上DEMO

 首先我们定义一个PO，并且使用 @Wrapperable注解标记要增强。

@Data
@Wrapperable
@TableName("user")
public class User {

    @TableId("user_id")
    private Integer userId;

    @TableField("name")
    private String name;

    @TableField("age")
    private Integer age;

    @TableField("sex")
    private String sex;


}

 然后使用activeRecord愉快的对User表进行CRUD操作。

@RestController
public class UserController {

    @GetMapping("/one")
    public User one() {
        return User.newOBJ().nameLike("小").one();
    }

    @GetMapping("/oneField")
    public User oneField() {
        return User.newOBJ().nameLike("小").one(new String[]{User.USERID, User.NAME});
    }

    @GetMapping("/list")
    public List<User> list() {
        return User.newOBJ().ageBetween(10, 25).list();
    }

    @GetMapping("/listField")
    public List<User> listField() {
        return User.newOBJ().ageBetween(10, 20).list(new String[]{User.USERID, User.NAME});
    }

    @GetMapping("/delete")
    public int delete() {
        return User.newOBJ().ageBetween(50, 80).delete();
    }

    @GetMapping("/count")
    public Long count() {
        return  User.newOBJ().ageBetween(10,26).count();
    }

   
    @GetMapping("/update")
    public int update() {
        User user = User.newOBJ();
        user.setAge(19);
        return user.nameEQ("小明").update();
    }
}

支持的方法(注意XX代表属性名，如果有多个属性的话，则会生成多个方法)

除了生成方法外还会生成常量，方便引用属性名。

比如属性中有一个name(小写) 会自动生成一个public static final String NAME="name".

1.3 所用技术简介

• Java APT+AST 在编译期对PO的class进行修改，添加我们需要的方法
• idea plugin  生成的class增加了方法和常量后，idea并不能索引到，所以需要开发插件告诉idea我们其实有这些方法，idea就不会报错并且可以自动提示了。
• QueryWrapper 当你执行了nameLike后其实框架是自动调用了 QueryWrapper.like("name","xx")，所以底层还是 QueryWrapper

1.4 觉得上述特性很好用，但是又不想用我的fhs framework怎么办？

 我们对此模块进行了单独抽离，https://gitee.com/fhs-opensource/fhs_mp maven中央仓库最新是1.0.2版本，

 <dependency>
            <groupId>com.fhs-opensource</groupId>
            <artifactId>mp_ext</artifactId>
            <version>1.0.2</version>
 </dependency>

 为了方便大家折腾自己的插件，我们也对idea进行了开源：

https://gitee.com/fhs-opensource/myabtis_plus_ext_idea_plugin

 和mp作者聊过，本插件孵化好后可能会合并到mp官方 作为mp4新特性发布。

2 fhs framework相关

2.1 FHS V3介绍

   优秀的国内快速开发平台非常多，FHS V2发布后我们单位内部也做了一番讨论，要不要坚持用自己的轮子，最终决定还是要做。一番讨论后，我们确定了以下几点目标：

•   全面拥抱vue,但是前端技术栈不求最新，但求最快。
•   前端简单的页面使用JSON驱动，简单的CRUD功能代码就算是后端也能开发和维护
•   全面拥抱微服务，但是不能因为SpringCloud的引入带来很大的学习成本(我们的项目有一些新手和实习生在干)
•   提供AllInOne模式，本地开发实现只启动一个SpringBoot 应用即可完成开发调试，test prod环境又可以支持微服务模式部署(俺们单位还有部分机器是E3 1230V2+8G 内存)
•   把部分组件提出来作为单独的开源项目发布，因为我们接的很多项目甲方要求使用他们的平台，我们可以引入几个组件但是不能换平台
•   提供高级查询API，简单的单表查询不要让程序员手动写一行代码。
•   提供基础的组织，用户，角色，菜单，字典，日志，前后端代码生成器
•   在不增加学习成本的情况下，尽可能使用国产开源组件

2.2 FHS V3差异化

•    翻译组件 

        字典码 sex  0 需要翻译成男 给前端，userid 1 需要翻译成张三给前端，使用翻译组件，配合Mybatis Plus，无需自己写SQL加一个注解即可实现。

        翻译组件支持一个项目多个数据源，以及跨微服务进行翻译，还支持传统的枚举翻译。

        此组件已经单独开源：https://gitee.com/fhs-opensource/easy_trans

•  简化远程调用

        Feign 做远程调用需要首先写一个service方法，然后用controller把service方法包一下，接着写一个feign接口，最后使用，而且对SpringCloud依赖性比较强，无法实现我们的All In One目标，我们希望把这个过程简化掉，于是EasyCloud模块出现了，只需要在service层加个注解就可以把普通的service方法暴漏出去给别人调用。

@CloudApi(serviceName="producer")//producer 是服务提供者的服务名称
public interface UserService {

    @CloudMethod  //加此注解意思是此方法提供给其他微服务调用
    List<UserDto> listByIds(String[] ids);
}

   我要使用的时候只需要依赖User微服务的接口和pojo，然后进行注入即可。

 @Autowired
 private UserService userService;

     通过EasyCloud，我们的开发者只需要多记2个注解即可，没有额外学习成本，本组件已经单独抽离开源：https://gitee.com/fhs-opensource/easy_cloud

•  JSON驱动VUE插件集-PAGEX

     常年逛开源中国的开发者应该对avue和amis比较熟悉，他们的star数量就能看出越来越多的前端开发者已经接受了JSON驱动，我们对组件的理解是：高度抽象，搭配后台API设计规范，开发者通过JSON告诉组件，我需要一个下拉框/多选框/Other，你的数据绑定到表单对象的哪个属性上，你这个组件的数据源URL是什么，你这个组件数据校验规则是什么于是我们写一个下拉tree是如下代码：

{
    type: "treeSelect",
    name: "organizationId",
    label: "部门",
    rule: "required",
    query: {},
    api: '/basic/ms/sysOrganization/tree',
    selectOn: (node) => {
        this.changeRoleSelect(node.id);
    }
}

    又比如列表的过滤条件，我只需要告诉组件，我需要input，他的title是分组编码，对应字段是code，我需要模糊匹配。

filters: [
    {label: '分组名称:', name: 'groupName', placeholder: "分组名称", type: 'text', operation: 'like'},
    {label: '分组编码:', name: 'groupCode', placeholder: "分组编码", type: 'text', operation: '='}
  ]

    配合高级查询API规范，需求变动加过滤字段，更改数据过滤操作符前端自己就搞了。当然我们也考虑了很多扩展，这里就不示例了。

    一个JSON驱动的CRUD 的代码demo。 https://gitee.com/fhs-opensource/fhs-framework/blob/v3.x/vue_ui/src/views/system/dict/index.vue

•  AllInOne 模式

    all in one的好处是省内存，调试方便，在新建微服务的时候需要注意业务代码和springboot启动类分离开，比如我有用户中心，订单2个微服务，那么使用all in one需要user,userApp,order,orderApp,allinoneApp 这么几个子模块，其中spingboot相关依赖和配置放到userApp和orderApp上，业务代码和springcloud 相关类解耦即可。

•  高级查询API

      高级查询API很多项目已经有了，配合前端PAGEX的CRUD组件，可以更简单灵活的构造列表查询参数。

 {
	"groupRelation": "AND",
	"pagerInfo": {
		"page": 1,  //第几页，从1开始
		"pageSize":10//每页多少条
	},
	"params": {},//扩展参数，具体要和后端约定
	"querys": [
		{
			"group": "main",//分组
			"operation": "=",//操作符
			"property": "userName",//Java属性名
			"relation": "AND",//是and 还是or
			"value": "wanglei" // 属性username=wanglei的查询出来
		}
	],
	"sorter": [
		{
			"direction": "ASC",//ASC 从小到大排序，DESC 从大到小排序
			"property": "createTime"//排序的字段名
		}
	]
}

•  Mybatis Plus+PO增强 简化查询条件构造

     为本次主要更新内容，这里不多说了

4 体验地址

http://82.157.62.164/login admin 123456

5 预览图

5 用到的国产组件集

• Mybatis Plus
• Sa-Token
• Validate-Springboot-Starter

• SpringCloud Alibaba

• ip2region

• knife4j