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