首页 > 移动平台 > 详细

通用Mapper(十四)通用Mapper接口大全

时间:2021-09-22 02:12:32      阅读:48      评论:0      收藏:0      [点我收藏+]

Mapper 接口大全    

Mapper3接口有两种形式,一种是提供了一个方法的接口。还有一种是不提供方法,但是继承了多个单方法的接口,一般是某类方法的集合。

例如SelectMapper<T>是一个单方法的接口,BaseSelectMapper<T>是一个继承了4个基础查询方法的接口。

技术分享图片

 

基础接口

  1、Select

接口:SelectMapper<T>
方法:List<T> select(T record);
说明:根据实体中的属性值进行查询,查询条件使用等号


接口:SelectByPrimaryKeyMapper<T>
方法:T selectByPrimaryKey(Object key);
说明:根据主键字段进行查询,方法参数必须包含完整的主键属性,查询条件使用等号


接口:SelectAllMapper<T>
方法:List<T> selectAll();
说明:查询全部结果,select(null)方法能达到同样的效果


接口:SelectOneMapper<T>
方法:T selectOne(T record);
说明:根据实体中的属性进行查询,只能有一个返回值,有多个结果是抛出异常,查询条件使用等号


接口:SelectCountMapper<T>
方法:int selectCount(T record);
说明:根据实体中的属性查询总数,查询条件使用等号

  

 

  2、Insert 

接口:InsertMapper<T>
方法:int insert(T record);
说明:保存一个实体,null的属性也会保存,不会使用数据库默认值


接口:InsertSelectiveMapper<T>
方法:int insertSelective(T record);
说明:保存一个实体,null的属性不会保存,会使用数据库默认值

  

 

  3、Update

接口:UpdateByPrimaryKeyMapper<T>
方法:int updateByPrimaryKey(T record);
说明:根据主键更新实体全部字段,null值会被更新


接口:UpdateByPrimaryKeySelectiveMapper<T>
方法:int updateByPrimaryKeySelective(T record);
说明:根据主键更新属性不为null的值

 

 

  4、Delete

接口:DeleteMapper<T>
方法:int delete(T record);
说明:根据实体属性作为条件进行删除,查询条件使用等号


接口:DeleteByPrimaryKeyMapper<T>
方法:int deleteByPrimaryKey(Object key);
说明:根据主键字段进行删除,方法参数必须包含完整的主键属性

  

  5、base 组合接口

接口:BaseSelectMapper<T>
方法:包含上面Select的4个方法


接口:BaseInsertMapper<T>
方法:包含上面Insert的2个方法


接口:BaseUpdateMapper<T>
方法:包含上面Update的2个方法


接口:BaseDeleteMapper<T>
方法:包含上面Delete的2个方法

  

  6、CRUD 组合接口

接口:BaseMapper<T>
方法:继承了base组合接口中的4个组合接口,包含完整的CRUD方法

  

Example

  1、Example 方法

接口:SelectByExampleMapper<T>
方法:List<T> selectByExample(Object example);
说明:根据Example条件进行查询
重点:这个查询支持通过Example类指定查询列,通过selectProperties方法指定查询列


接口:SelectCountByExampleMapper<T>
方法:int selectCountByExample(Object example);
说明:根据Example条件进行查询总数


接口:UpdateByExampleMapper<T>
方法:int updateByExample(@Param("record") T record, @Param("example") Object example);
说明:根据Example条件更新实体record包含的全部属性,null值会被更新


接口:UpdateByExampleSelectiveMapper<T>
方法:int updateByExampleSelective(@Param("record") T record, @Param("example") Object example);
说明:根据Example条件更新实体record包含的不是null的属性值


接口:DeleteByExampleMapper<T>
方法:int deleteByExample(Object example);
说明:根据Example条件删除数据

  

  2、Example 组合接口

接口:ExampleMapper<T>
方法:包含上面Example中的5个方法

  

Condition

  1、Condition 方法

Condition方法和Example方法作用完全一样,只是为了避免Example带来的歧义,提供的的Condition方法

接口:SelectByConditionMapper<T>
方法:List<T> selectByCondition(Object condition);
说明:根据Condition条件进行查询


接口:SelectCountByConditionMapper<T>
方法:int selectCountByCondition(Object condition);
说明:根据Condition条件进行查询总数


接口:UpdateByConditionMapper<T>
方法:int updateByCondition(@Param("record") T record, @Param("example") Object condition);
说明:根据Condition条件更新实体record包含的全部属性,null值会被更新


接口:UpdateByConditionSelectiveMapper<T>
方法:int updateByConditionSelective(@Param("record") T record, @Param("example") Object condition);
说明:根据Condition条件更新实体record包含的不是null的属性值


接口:DeleteByConditionMapper<T>
方法:int deleteByCondition(Object condition);
说明:根据Condition条件删除数据

  

  2、Condition 组合接口

接口:ConditionMapper<T>
方法:包含上面Condition中的5个方法

  

RowBounds

  默认为内存分页,可以配合PageHelper实现物理分页

  1、RowBounds 方法

接口:SelectRowBoundsMapper<T>
方法:List<T> selectByRowBounds(T record, RowBounds rowBounds);
说明:根据实体属性和RowBounds进行分页查询


接口:SelectByExampleRowBoundsMapper<T>
方法:List<T> selectByExampleAndRowBounds(Object example, RowBounds rowBounds);
说明:根据example条件和RowBounds进行分页查询


接口:SelectByConditionRowBoundsMapper<T>
方法:List<T> selectByConditionAndRowBounds(Object condition, RowBounds rowBounds);
说明:根据example条件和RowBounds进行分页查询,该方法和selectByExampleAndRowBounds完全一样,只是名字改成了Condition

  

  2、RowBounds 组合接口

接口:RowBoundsMapper<T>
方法:包含上面RowBounds中的前两个方法,不包含selectByConditionAndRowBounds

  

 

special 特殊接口

  这些接口针对部分数据库设计,不是所有数据库都支持

接口:InsertListMapper<T>
方法:int insertList(List<T> recordList);
说明:批量插入,支持批量插入的数据库可以使用,例如MySQL,H2等,另外该接口限制实体包含id属性并且必须为自增列


接口:InsertUseGeneratedKeysMapper<T>
方法:int insertUseGeneratedKeys(T record);
说明:插入数据,限制为实体包含id属性并且必须为自增列,实体配置的主键策略无效

  

MySQL 专用

接口:MySqlMapper<T>
继承方法:int insertList(List<T> recordList);
继承方法:int insertUseGeneratedKeys(T record);
说明:该接口不包含方法,继承了special中的InsertListMapper<T>和InsertUseGeneratedKeysMapper<T>

 

SqlServer 专用

  由于sqlserver中插入自增主键时,不能使用null插入,不能在insert语句中出现id。

  注意SqlServer的两个特有插入方法都使用了

@Options(useGeneratedKeys = true, keyProperty = "id")

  

  这就要求表的主键为id,且为自增,如果主键不叫id可以看高级教程中的解决方法。

  另外这俩方法和 base 中的插入方法重名,不能同时存在!

  如果某种数据库和SqlServer这里类似,也可以使用这些接口(需要先测试)。

 

接口:InsertMapper
方法:int insert(T record);
说明:插入数据库,null值也会插入,不会使用列的默认值


接口:InsertSelectiveMapper
方法:int insertSelective(T record);
说明:插入数据库,null的属性不会保存,会使用数据库默认值


接口:SqlServerMapper
说明:这是上面两个接口的组合接口。

  

 

Ids 

通过操作ids字符串进行操作,ids 如 “1,2,3” 这种形式的字符串,这个方法要求实体类中有且只有一个带有@Id注解的字段,否则会抛出异常。

  1、Ids 接口

接口:SelectByIdsMapper
方法:List<T> selectByIds(String ids)
说明:根据主键字符串进行查询,类中只有存在一个带有@Id注解的字段


接口:DeleteByIdsMapper
方法:int deleteByIds(String ids)
说明:根据主键字符串进行删除,类中只有存在一个带有@Id注解的字段

  

  2、Ids 组合接口

接口:IdsMapper<T>
方法:包含上面Ids中的前两个方法

  

Mapper<T> 接口

接口:Mapper<T>
该接口兼容Mapper2.x版本,继承了BaseMapper<T>, ExampleMapper<T>, RowBoundsMapper<T>三个组合接口。

  

 

  扩展:查询时如何进行排序?

  Mapper3在查询的时候支持通过 @OrderBy 注解来设置默认的排序方式。

  当需要特殊排序时,可以使用Example(或Condition)查询,通过setOrderByClause方法设置排序的列。

 

通用Mapper(十四)通用Mapper接口大全

原文:https://www.cnblogs.com/niujifei/p/15311361.html

(0)
(0)
   
举报
评论 一句话评论(0
关于我们 - 联系我们 - 留言反馈 - 联系我们:wmxa8@hotmail.com
© 2014 bubuko.com 版权所有
打开技术之扣,分享程序人生!