DaoTemplate (hutool 2.12.2 API)

java.lang.Object
- com.xiaoleilu.hutool.db.DaoTemplate

```
public class DaoTemplate
extends Object
```
数据访问层模板
此模板用于简化对指定表的操作，简化的操作如下：
1、在初始化时指定了表名，CRUD操作时便不需要表名
2、在初始化时指定了主键，某些需要主键的操作便不需要指定主键类型

作者:

Looly

字段概要

字段
限定符和类型	字段和说明
`protected String`	`primaryKeyField` 本表的主键字段，请在子类中覆盖或构造方法中指定，默认为id
`protected SqlRunner`	`runner`
`protected String`	`tableName` 表名

构造器概要

构造器
构造器和说明
`DaoTemplate(String tableName)` 构造，此构造需要自定义SqlRunner，主键默认为id
`DaoTemplate(String tableName, String primaryKeyField)` 构造，此构造需要自定义SqlRunner
`DaoTemplate(String tableName, String primaryKeyField, DataSource ds)` 构造
`DaoTemplate(String tableName, String primaryKeyField, SqlRunner runner)` 构造

方法概要

方法
限定符和类型	方法和说明
`int`	`add(Entity entity)` 添加
`Long`	`addForGeneratedKey(Entity entity)` 添加
`List<Object>`	`addForGeneratedKeys(Entity entity)` 添加
`int`	`addOrUpdate(Entity entity)` 增加或者更新实体
`int`	`count(Entity where)` 满足条件的数据条目数量
`<T> int`	`del(Entity where)` 删除
`<T> int`	`del(String field, T value)` 删除
`<T> int`	`del(T pk)` 删除
`boolean`	`exist(Entity where)` 指定条件的数据是否存在
`List<Entity>`	`find(Entity where)` 根据某个字段值查询结果
`<T> List<Entity>`	`find(String field, T value)` 根据某个字段值查询结果
`List<Entity>`	`findAll()` 查询当前表的所有记录
`Entity`	`get(Entity where)` 根据条件实体查询单个记录，当有多条返回时，只显示查询到的第一条
`<T> Entity`	`get(String field, T value)` 根据某个字段（最好是唯一字段）查询单个记录当有多条返回时，只显示查询到的第一条
`<T> Entity`	`get(T pk)` 根据主键获取单个记录
`int`	`update(Entity entity)` 更新职位信息

从类继承的方法 java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- 字段详细资料
  - runner
```
protected SqlRunner runner
```
  - tableName
```
protected String tableName
```
    表名
  - primaryKeyField
```
protected String primaryKeyField
```
    本表的主键字段，请在子类中覆盖或构造方法中指定，默认为id
- 构造器详细资料
  - DaoTemplate
```
public DaoTemplate(String tableName)
```
    构造，此构造需要自定义SqlRunner，主键默认为id
    
    参数:
    tableName - 数据库表名
  - DaoTemplate
```
public DaoTemplate(String tableName,
           String primaryKeyField)
```
    构造，此构造需要自定义SqlRunner
    
    参数:
    tableName - 数据库表名
    primaryKeyField - 主键字段名
  - DaoTemplate
```
public DaoTemplate(String tableName,
           String primaryKeyField,
           DataSource ds)
```
    构造
    
    参数:
    tableName - 表名
    primaryKeyField - 主键字段名
    ds - 数据源
  - DaoTemplate
```
public DaoTemplate(String tableName,
           String primaryKeyField,
           SqlRunner runner)
```
    构造
    
    参数:
    tableName - 表名
    primaryKeyField - 主键字段名
    runner - SqlRunner对象
- 方法详细资料
  - add
```
public int add(Entity entity)
        throws SQLException
```
    添加
    
    参数:
    entity - 实体对象
    
    返回:
    插入行数
    
    抛出:
    
    SQLException
  - addForGeneratedKeys
```
public List<Object> addForGeneratedKeys(Entity entity)
                                 throws SQLException
```
    添加
    
    参数:
    entity - 实体对象
    
    返回:
    主键列表
    
    抛出:
    
    SQLException
  - addForGeneratedKey
```
public Long addForGeneratedKey(Entity entity)
                        throws SQLException
```
    添加
    
    参数:
    entity - 实体对象
    
    返回:
    自增主键
    
    抛出:
    
    SQLException
  - del
```
public <T> int del(T pk)
        throws SQLException
```
    删除
    
    类型参数:
    T - 主键类型
    参数:
    pk - 主键
    
    返回:
    删除行数
    
    抛出:
    
    SQLException
  - del
```
public <T> int del(String field,
          T value)
        throws SQLException
```
    删除
    
    类型参数:
    T - 主键类型
    参数:
    field - 字段名
    value - 字段值
    
    返回:
    删除行数
    
    抛出:
    
    SQLException
  - del
```
public <T> int del(Entity where)
        throws SQLException
```
    删除
    
    类型参数:
    T - 主键类型
    参数:
    where - 删除条件，当条件为空时，返回0（防止误删全表）
    
    返回:
    删除行数
    
    抛出:
    
    SQLException
  - update
```
public int update(Entity entity)
           throws SQLException
```
    更新职位信息
    
    参数:
    entity - 实体对象，必须包含主键
    
    返回:
    更新行数
    
    抛出:
    
    SQLException
  - addOrUpdate
```
public int addOrUpdate(Entity entity)
                throws SQLException
```
    增加或者更新实体
    
    参数:
    entity - 实体，当包含主键时更新，否则新增
    
    返回:
    新增或更新条数
    
    抛出:
    
    SQLException
  - get
```
public <T> Entity get(T pk)
           throws SQLException
```
    根据主键获取单个记录
    
    类型参数:
    T -
    参数:
    pk - 主键值
    
    返回:
    记录
    
    抛出:
    
    SQLException
  - get
```
public <T> Entity get(String field,
             T value)
           throws SQLException
```
    根据某个字段（最好是唯一字段）查询单个记录
    当有多条返回时，只显示查询到的第一条
    
    类型参数:
    T -
    参数:
    field - 字段名
    value - 字段值
    
    返回:
    记录
    
    抛出:
    
    SQLException
  - get
```
public Entity get(Entity where)
           throws SQLException
```
    根据条件实体查询单个记录，当有多条返回时，只显示查询到的第一条
    
    参数:
    where - 条件
    
    返回:
    记录
    
    抛出:
    
    SQLException
  - find
```
public <T> List<Entity> find(String field,
                    T value)
                  throws SQLException
```
    根据某个字段值查询结果
    
    类型参数:
    T -
    参数:
    field - 字段名
    value - 字段值
    
    返回:
    记录
    
    抛出:
    
    SQLException
  - findAll
```
public List<Entity> findAll()
                     throws SQLException
```
    查询当前表的所有记录
    
    返回:
    记录
    
    抛出:
    
    SQLException
  - find
```
public List<Entity> find(Entity where)
                  throws SQLException
```
    根据某个字段值查询结果
    
    参数:
    where - 查询条件
    
    返回:
    记录
    
    抛出:
    
    SQLException
  - count
```
public int count(Entity where)
          throws SQLException
```
    满足条件的数据条目数量
    
    参数:
    where - 条件
    
    返回:
    数量
    
    抛出:
    
    SQLException
  - exist
```
public boolean exist(Entity where)
              throws SQLException
```
    指定条件的数据是否存在
    
    参数:
    where - 条件
    
    返回:
    是否存在
    
    抛出:
    
    SQLException

类 DaoTemplate

字段概要

构造器概要

方法概要

从类继承的方法 java.lang.Object

字段详细资料

runner

tableName

primaryKeyField

构造器详细资料

DaoTemplate

DaoTemplate

DaoTemplate

DaoTemplate

方法详细资料

add

addForGeneratedKeys

addForGeneratedKey

del

del

del

update

addOrUpdate

get

get

get

find

findAll

find

count

exist