自己设计一个 JAVA + MyBatis 解析实体类多表通用查询

时间:2022-07-22
本文章向大家介绍自己设计一个 JAVA + MyBatis 解析实体类多表通用查询,主要内容包括其使用实例、应用技巧、基本知识点总结和需要注意事项,具有一定的参考价值,需要的朋友可以参考一下。
  • 首先想清楚实体类与数据表的映射关系, 如
    • 表名
    • 主键
    • 逻辑删除
    • ... (按需求自行添加)
//那么我们需要先自定义如下几个注解 ​
//用于表示实体类对应的数据表 
@TableName(value = "数据表名")  
//用于表示实体主键 
@TableId 
//用于表示字段为逻辑删除 
@TableLogic
  • 现在已经可以通过实体类描述一张数据表了,那么我们来想一下如何优雅的想一个使用方式吧
    • 首先我们需要表示查询的字段有哪些?如何表示呢?
    • 如何关联表
    • 如何定义查询条件
    • 排序
    • 如何分组等等
    • ...(按需求添加功能)
//那么我们需要定义一个查询描述的实体
class MulSelect {
	MulSelect(selectColumns/*要查询的字段*/, Table ...tables/*用到的数据表*/);
    //条件查询 WhereCustomSegment 后面介绍
   	WhereCustomSegment where(String table);
   	//排序
    orderBy(String ...columns);
    //...
}  
class WhereCustomSegment {
    like(String column, String value);
    and(String column, String value);
    notLike(String column, String value);
    eq(String column, String value);
    //...数据库操作方法,这里不多写
}
//现在根据我们的需求已经粗略的定义了, 那么我们再想想如何优雅的使用吧。User: 用户表,Address:地址表, Orders: 订单表
new MulSelect("user.user_id, user.user_name, address.detail, orders.orders_id, orders.orders_no", new User(), new Address(), new Orders());
//这样我们好像已经表示了要查询的字段,要使用到的表,但是我想查询的字段用实体的Field,一张整表的字体我想直接用实体表示,那么我们再修改下使用方式吧
new MulSelect("user.UserId, user.userName, address.detail, orders", new User(), new Address(), new Orders());

//ok, 那么我们再想一下如何排序
MulSelect.orderBy("user.userName", "orders.createAt asc", ...);
//ok, 那么我们再想下如何使用查询吧
multipleSelect
    .where("user")
    .like("userName", "whoareyou")
    .eq("userGender", 1)
    .where("address")
    .like("provice", "江苏")
    .where("orders")
    .like("ordersNo", "20200117")
//哎呦,感觉不错哦,那么我们就开始按照我们希望的使用方式去实现吧
  • 很好,现在我们已经想好了怎么使用了,那么我们开始按照使用的思路去实现吧
    • 先来处理一下查询的字段和用到的表吧
//虽然我们使用的时候是实体,但最终还是要解析成sql的,那么我们需要想好解析成sql 时候所用到的东东,提前准备好
class TableEntity {
    String tableName; //表的真正名称肯定是要的
    String nickName; //表名的重命名也是要的, 去掉真名的表的下划线的全英文字母  
    String idName; //表的主键名称肯定是要的
    String logicName; //上面定义了逻辑删除功能,所以这个逻辑删除也要
    List<String> entityColumns; //实体的字段
    List<String> tableColumns; //与实体字段一对一的数据表的字段
    Object entity; //与之相关的实体
}
//现在用到数据表实体已经定义好了,是不是要写个工具将传入的实体参数解析成 TableEntity 了呢
class TableUtil {
    TableEntity toTableEntity(Object entity); //将实体解析成TableEntity
    //...
}
//已经有了数据表的描述,那么我们将selectColumns 解析成 sql 的 select 字段完全没有问题了吧
//将 "user.UserId, user.userName, address.detail, orders" 解析
// ',' 分割去空格, '.' 前后的替换为 nickName,'.' 后面替换为数据表的字段,单独的 orders 替换为 nickName.[every tableColumn]
class TableUtil {
    TableEntity toTableEntity(Object entity); //将实体解析成TableEntity
    //添加一个工具来实现吧
    String toNativeSelectColumns(String SelectColumns);
}
  • 那么我们再来看看如何实现表的连接吧
/**
	传过来是这样的参数:  new User(), new Address(), new Orders()
	简单的约束弄: 找到 User 表的主键(@TableId) 字段的Field名, 匹配 Address中的 Filed名,找到了那么说明用此字段关联,同样的方式, 循环向后寻找即可找到所有关联。但是这样的简单的定义约束。user表的主键需要为user_id, address表的与user表关联的字段 必需也要叫user_id,关联的字段名必须取一样的名称,如果想不一样,可以使用注解,这里先不作介绍。
*/
//那么工具类又新增方法, 这里只作Left Join
class TableUtil {
    TableEntity toTableEntity(Object entity); //将实体解析成TableEntity
    //添加一个工具来实现吧
    String toNativeSelectColumns(String SelectColumns);
    //添加left join 方法
    List<String> toLeftJoin(Object ...entities);
}
  • 现在已经解决了查找的字段与自动关联的问题,那么接下来是如何条件查询了, 前面我们已经定义了 WhereCustomSegment 类了,完善一个思路吧
class WhereCustomSegment {
    public WhereCustomSegment(TableEntity ...tableEntities);  //构造,我们需要关于数据表的全部信息
    WhereCustomSegment where(String tableName);
}
//那么如何实现一个like 方法呢? 如:   like("userName", "whoareyou")
//了解 myBatis 这段应该了 user.user_name like #{userName}, 按此救命我们将现在有信息解析为此就相当容易了
stringBuffer
    .append(" ")
    .append(tableEntity.getNickName()) // 表的nick name
    .append(".") 
    .append(tableEntity.getTableColumns().get(tableEntity.getEntityColumns().indexOf(fieldName))) //通过field名称找到数据表中的字段
    .append(" ")
    .append("like ")//opreaction 操作 
    .append("#{parameter.")
    .append(key) // 不重复的key 如 userName
    .append("}");
parameter.put(key, value); //将对应的key 和 value 存储起来,用于调xml时候作为参数传递过去
//简易的思路就完成了
  • 现在已经准备好解析完成的sqlSegment了,那么我们要把他放在myBatis的Xml里,我们定义个MulSelectMapper.java && MulSelectMapper.xml
//MulSelectMapper.java
public interface MulSelectMapper {
    public List<Map<String, Object>> multiSelect(MulSelect param);
    //分页统计总数
	public Integer countMulSelect(MulSelect param);
}
//MulSelectMapper.xml
<select id="mulSelect" parameterType="com.common.MulSelect" resultType="map">
    select distinct ${selectColumns} from ${masterTable}  
    <if test="join!=null">
        <foreach collection="join" index="index" item="item" separator=" " >
            left join ${item}
        </foreach>
    </if>
    <where>
        ${sqlSegment}
    </where>
    <if test="groupBy!=null and groupBy!=''">
        group by ${groupBy}
    </if>
    <if test="orderBy!=null and orderBy!=''">
        order by ${orderBy}
    </if>
    <if test="start != null and end != null">
        limit #{start}, #{end}
    </if>
</select>
  • 现在就差一个通用的service 来调用了 MultipleService.java
public class MultipleService { 
    MultipleResult multipleSelect(MulSelect param); 
}
//调用通用查询

OK,现在使用方法设计出来了, 核心的解析流程也出来了, 如何调也设计好了,那下章我们来一行一行去实现自己的通过查询吧