# 注意：本文档后期不在跟新，新文档迁移到：[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
#### 赞助
