# 注意：本文档后期不在跟新，新文档迁移到：[http://www.openkit.cc/docs/kitadmin/#/](http://www.openkit.cc/docs/kitadmin/#/) #### 首先感谢使用KitAdmin后台开发框架 #### 反馈交流QQ群：696279396 --- ### 通用Mapper使用方法 - 在以下文件添加注解的方式 1. `Model`文件下面 ``` @Table(name="kit_g_group") // 数据库表映射注解 public class GGroup { @Id // 主键注解 @GeneratedValue(strategy= GenerationType.IDENTITY) // 主键自增用这个 // @GeneratedValue(generator = "UUID") // 主键为 唯一ID 用这个 private Integer groupId; @Transient // 参数不需要映射到数据库的注解 private String groupName; @OrderBy(value = "DESC") // 按照这个字段倒叙排序注解 private String kitAdminPassword; @OrderBy(value = "ASC") // 按照这个字段倒叙排序注解 private String kitAdminImgUrl; // 多个排序，会按照第一个为主要排序，第二个为辅助排序 } ``` 2. `Service`接口中 ``` // 继承 BaseService 中的接口，T 表示实体类名 extends BaseService<T> ``` 3. `Service` 实现类中 ``` // 继承 BaseServiceImpl 实现Service接口中的方法，T 表示实体类名 extends BaseServiceImpl<T> implements Service ``` 4. `Mapper`接口中 ``` // 继承Mapper 接口，T 表示实体类名 extends Mapper<T> ``` ### 已经封装好的公共的Mapper接口 |方法名|返回值|解释|说明| |:--:|:--:|:--:|:--:| |queryById(int id) |Model |根据id查询实体| 如果主键是自增调用这个方法| |queryByUUID(String id) |Model |根据id查询实体| 如果主键是UUID调用这个方法| |queryAll() | List<Model> |查询所有| | |queryListByWhere(T param)| List<Model> |条件查询|传入对象，多个条件只要一个必须全部符合才会匹配 | |queryCount(T param)| Integer |查询记录数 |传入对象，多个条件只要一个必须全部符合才会匹配 | |queryPageListByWhere(T param,Integer page,Integer rows)| List<Model> |全匹配分页查询 |传入对象，多个条件只要一个必须全部符合才会匹配 | |queryOne(T param)| Model |查询一条记录 | | |save(T param)| Integer |插入记录 | 返回影响行数| |saveSelect(T param)| Integer |新增对象中的非空字段 | 返回影响行数| |update(T param)| Integer |根据主键更新 | 返回影响行数，如果对象中是null，会跟新成null| |updateSelective(T param)| Integer |根据主键更新对象中非空字段 | 返回影响行数| |deleteById(int id)| Integer |根据主键删除 | 返回影响行数| |deleteByUUId(String id)| Integer |批量删除 | 返回影响行数| |queryPageListWhereLike(Class<T> clazz,T param,Integer page,Integer rows)| List<Model> | 多个条件模糊分页查询 | 返回对象结果集| |queryListWhereLike(Class<T> clazz, T param)| List<Model> |多个条件模糊查询所有 | 返回对象结果集| |queryCountWhereLike(Class<T> clazz,T param)| Integer |根据多个模糊查询条件，查询出总条数 | 返回总条数| ### 注意 > 我们整合了通用Mapper，但是我们却并没有破坏它原来的结构，所以你可以利用通用Mapper中的实现原理，自己编写你的`BaseService`和`BaseServiceImpl` 通用`Mapper`开发文档地址：https://mapperhelper.github.io/docs/ --- #### 反馈交流QQ群：696279396 #### 赞助