mybatis-metamodel 是 mybatis-plus 和 tk mapper 的元数据模型生成插件,目的是解决它们在复杂场景下自定义SQL时的紧耦合问题
我们都知道mybatis-plus 和 tk mapper 开源项目是mybatis优秀的增强插件,它们通过重定义MappedStatement实现了通用增删改查。它们所提供的增删改查的功能,极大提高了开发者的开发效率。 但是,在一些复杂的应用场景下,它们的通用增删改查不能满足我们的开发需求,为了实现需求,需要通过它们内置的条件查询组件自定义查询语句。在这种复杂场景下,就无法避免使用字符串表示 表名或者字段名,这在复杂的项目中如果修改了字段名,很容易造成后期运行时错误。
为了避免应用在运行时发生错误,本项目将在编译期提供数据库的元数据,可以帮助应用在编译期就感知原有数据库元数据的修改。
举个列子: 我们需要自定义SQL查询用户信息。引入本项目后,可以在编译期自动生成元数据模型UserInfo_.class,元数据模型里面包含每个table field的信息,除此之外,还可以通过MetaModelContext获取对应的
Mapper
// 根据 example 条件查询
String queryUserName = "hugo_1";
Example userInfoQueryExample = new Example(UserInfo.class);
Example.Criteria criteria = userInfoQueryExample.createCriteria();
criteria.andEqualTo(UserInfo_.username.getColumn(), queryUserName);
List<UserInfo> userInfosByQuery = userInfoMapper.selectByExample(userInfoQueryExample);
Assert.assertEquals(1, userInfosByQuery.size());
//获取table名
String tableName = metaModelContext.getTableName(UserInfo_.class);
Assert.assertEquals("user_info", tableName);
mybatis-plus
// 根据 map 查询
// 查询username为hugo_1的数据
Map<String, Object> map = new HashMap<>();
map.put(UserInfo_.username.getColumn(), "hugo_1"); //获取元数据
userInfo = userInfoMapper.selectByMap(map).get(0);
// wrapper查询
// 查询address为中国的列表
List<UserInfo> userList = userInfoMapper.selectList(
new QueryWrapper<UserInfo>().eq(UserInfo_.address.getColumn(), "中国")
//获取table名
String tableName = metaModelContext.getTableName(UserInfo_.class);
支持MAPPER版本1.1.5+
支持mybatis-plus版本3.2.0+
参考下面的wiki
感谢以下开源项目