TiEntity (tisimple-码云(gitee.com))

java.lang.Object
- com.gitee.oeoe.tisimple.ability.AbilityISQL
- - com.gitee.oeoe.tisimple.ability.TiEntity<T>

All Implemented Interfaces:

IBaseAbility<T>, ITemplateDeleteAbility, ITemplateInsertAbility<T>, ITemplateQueryAbility<T>, ITemplateUpdateAbility, IPageParam, Serializable

Direct Known Subclasses:

MysqlSchemaTable, MysqlSchemaTableColumn
```
public abstract class TiEntity<T extends TiEntity<T>>
extends AbilityISQL
implements Serializable, IBaseAbility<T>, ITemplateQueryAbility<T>, ITemplateDeleteAbility, ITemplateUpdateAbility, ITemplateInsertAbility<T>, IPageParam
```
为实体提供操作表的进阶能力
Trustworthy

Since:

1.8+ 2022/1/11

Author:

zhu qiang

See Also:

Serialized Form

Constructor Summary

Constructors
Constructor and Description

TiEntity()

Constructors
Constructor and Description
`TiEntity()`

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`Long`	`count()` 按给定的条件统计数量
`int`	`delete()` 删除的数据，按所有不为空的字段匹配
`int`	`delete(ISQL template)` 按给定的条件删除记录
`int`	`delete(String sql)` 按给定的条件删除记录，实体本身的属性将放入到参数空间
`Connection`	`getConnection()` 获取当前对象的连接
`IPageFactory`	`getPageFactory()`
`ITxManager`	`getTxManager()`
`int`	`insert()` 插入一条数据，如果提供了主键生成器，生成器调用后会将结果设置到实体对应的属性上
`int`	`insert(ISQL template)` 新增
`int`	`insert(List<T> entities)` 新增-多记录-高级，主键若指定了生成器将自动赋值，或指定为自增，也会自动赋值批量模式将单独成一个事务进行批量插入
`int`	`insert(String sql)` 新增
`T`	`onlyOne()` 按给定的条件查询一个
`IPage<T>`	`page()` 按给定的条件分页查询
`IPage<T>`	`page(ISQL sqlTemplate)` 查一个list结果，如果没有异常，必将返回一个或为空的列表
`IPage<T>`	`page(String sql)` 查一个list结果，如果没有异常，必将返回一个或为空的列表，实体本身的属性将放入到参数空间
`Integer`	`pageIndex()` 获取当前分页编号，分页从1开始
`void`	`pageIndex(Integer size)` 设置当前页编号
`Integer`	`pageSize()` 获取分页大小
`void`	`pageSize(Integer size)` 设置分页大小
`List<T>`	`query()` 按给定的条件查询列表
`Long`	`queryCount(ISQL sqlTemplate, String selectName)` 统计记录数量
`Long`	`queryCount(String sqlTemplate, String selectName)` 统计记录数量，实体本身的属性将放入到参数空间
`List<T>`	`queryList(ISQL sqlTemplate)` 查一个list结果，如果没有异常，必将返回一个或为空的列表
`List<T>`	`queryList(String sqlTemplate)` 查一个list结果，如果没有异常，必将返回一个或为空的列表，实体本身的属性将放入到参数空间
`List<Map<String,Object>>`	`queryMap(ISQL sqlTemplate)` 查一个list-map结果，如果没有异常，必将返回一个或为空的列表，实体本身的属性将放入到参数空间
`List<Map<String,Object>>`	`queryMap(String sqlTemplate)` 查一个list-map结果，如果没有异常，必将返回一个或为空的列表，实体本身的属性将放入到参数空间
`T`	`queryOne(ISQL sqlTemplate)` 查一个实体结果，如果没有异常，必将返回一个或为null的T类型实体
`T`	`queryOne(String sqlTemplate)` 查一个实体结果，如果没有异常，必将返回一个或为null的T类型实体，实体本身的属性将放入到参数空间
`void`	`setConnection(Connection connection)`
`void`	`setPageFactory(IPageFactory pageFactory)`
`void`	`setTxManager(ITxManager tx)`
`int`	`update(ISQL template)` 按给定的条件更新记录
`int`	`update(String sql)` 按给定的条件更新记录，实体本身的属性将放入到参数空间
`int`	`update(T entity)` 更新记录

Methods inherited from class com.gitee.oeoe.tisimple.ability.AbilityISQL
countISQL, deleteISQL, insertISQL, insertISQL, queryISQL, updateISQL

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Constructor Detail
  - TiEntity
```
public TiEntity()
```
- Method Detail
  - getPageFactory
```
public IPageFactory getPageFactory()
```
  - setPageFactory
```
public void setPageFactory(IPageFactory pageFactory)
```
  - setTxManager
```
public void setTxManager(ITxManager tx)
```
  - getTxManager
```
public ITxManager getTxManager()
```
  - setConnection
```
public void setConnection(Connection connection)
```
  - getConnection
```
public Connection getConnection()
```
    获取当前对象的连接
    
    Returns:
    
    Connection 一条连接
    
    Throws:
    
    ObtainConnectionException - 获取连接异常
  - insert
```
public int insert()
           throws InsertException
```
    Description copied from interface: IBaseAbility
    
    插入一条数据，如果提供了主键生成器，生成器调用后会将结果设置到实体对应的属性上
    
    Specified by:
    
    insert in interface IBaseAbility<T extends TiEntity<T>>
    
    Returns:
    
    插入成功的数量，0-表示失败
    
    Throws:
    
    InsertException
  - delete
```
public int delete()
           throws DeleteException
```
    Description copied from interface: IBaseAbility
    
    删除的数据，按所有不为空的字段匹配
    
    Specified by:
    
    delete in interface IBaseAbility<T extends TiEntity<T>>
    
    Returns:
    
    删除的数量
    
    Throws:
    
    DeleteException
  - update
```
public int update(T entity)
           throws UpdateException
```
    Description copied from interface: IBaseAbility
    
    更新记录
    
    Specified by:
    
    update in interface IBaseAbility<T extends TiEntity<T>>
    
    Parameters:
    
    entity - 更新的值
    
    Returns:
    
    更新的记录数量
    
    Throws:
    
    UpdateException
  - page
```
public IPage<T> page()
              throws QueryException
```
    Description copied from interface: IBaseAbility
    
    按给定的条件分页查询
    
    Specified by:
    
    page in interface IBaseAbility<T extends TiEntity<T>>
    
    Returns:
    
    IPage，如果没有分页工厂则返回null
    
    Throws:
    
    QueryException
  - query
```
public List<T> query()
              throws QueryException
```
    Description copied from interface: IBaseAbility
    
    按给定的条件查询列表
    
    Specified by:
    
    query in interface IBaseAbility<T extends TiEntity<T>>
    
    Returns:
    
    匹配到的记录列表，必将返回一个list
    
    Throws:
    
    QueryException
  - onlyOne
```
public T onlyOne()
          throws QueryException
```
    Description copied from interface: IBaseAbility
    
    按给定的条件查询一个
    
    Specified by:
    
    onlyOne in interface IBaseAbility<T extends TiEntity<T>>
    
    Returns:
    
    若存在多个则会抛出查询异常，若不存在，则返回null
    
    Throws:
    
    QueryException
  - count
```
public Long count()
           throws QueryException
```
    Description copied from interface: IBaseAbility
    
    按给定的条件统计数量
    
    Specified by:
    
    count in interface IBaseAbility<T extends TiEntity<T>>
    
    Returns:
    
    匹配到的记录数量
    
    Throws:
    
    QueryException
  - queryMap
```
public List<Map<String,Object>> queryMap(String sqlTemplate)
                                  throws QueryException
```
    Description copied from interface: ITemplateQueryAbility
    
    查一个list-map结果，如果没有异常，必将返回一个或为空的列表，实体本身的属性将放入到参数空间
    
    Specified by:
    
    queryMap in interface ITemplateQueryAbility<T extends TiEntity<T>>
    
    Parameters:
    
    sqlTemplate - 使用模版语法的sql语句
    
    Returns:
    
    由key为表字段，value为值的map构成的列表
    
    Throws:
    
    QueryException - 查询中各个阶段出现异常
  - queryMap
```
public List<Map<String,Object>> queryMap(ISQL sqlTemplate)
                                  throws QueryException
```
    Description copied from interface: ITemplateQueryAbility
    
    查一个list-map结果，如果没有异常，必将返回一个或为空的列表，实体本身的属性将放入到参数空间
    
    Specified by:
    
    queryMap in interface ITemplateQueryAbility<T extends TiEntity<T>>
    
    Parameters:
    
    sqlTemplate - 使用模版语法的sql语句
    
    Returns:
    
    由key为表字段，value为值的map构成的列表
    
    Throws:
    
    QueryException - 查询中各个阶段出现异常
  - queryList
```
public List<T> queryList(String sqlTemplate)
                  throws QueryException
```
    Description copied from interface: ITemplateQueryAbility
    
    查一个list结果，如果没有异常，必将返回一个或为空的列表，实体本身的属性将放入到参数空间
    
    Specified by:
    
    queryList in interface ITemplateQueryAbility<T extends TiEntity<T>>
    
    Parameters:
    
    sqlTemplate - 使用模版语法的sql语句
    
    Returns:
    
    由T类型实体构成的列表
    
    Throws:
    
    QueryException - 查询中各个阶段出现异常
  - queryList
```
public List<T> queryList(ISQL sqlTemplate)
                  throws QueryException
```
    Description copied from interface: ITemplateQueryAbility
    
    查一个list结果，如果没有异常，必将返回一个或为空的列表
    
    Specified by:
    
    queryList in interface ITemplateQueryAbility<T extends TiEntity<T>>
    
    Parameters:
    
    sqlTemplate - sql模版对象
    
    Returns:
    
    由T类型实体构成的列表
    
    Throws:
    
    QueryException - 查询中各个阶段出现异常
  - queryOne
```
public T queryOne(String sqlTemplate)
           throws QueryException
```
    Description copied from interface: ITemplateQueryAbility
    
    查一个实体结果，如果没有异常，必将返回一个或为null的T类型实体，实体本身的属性将放入到参数空间
    
    Specified by:
    
    queryOne in interface ITemplateQueryAbility<T extends TiEntity<T>>
    
    Parameters:
    
    sqlTemplate - 使用模版语法的sql语句
    
    Returns:
    
    一个T类型的实体，如果不存在，则返回null
    
    Throws:
    
    QueryException - 查询中各个阶段出现异常
  - queryOne
```
public T queryOne(ISQL sqlTemplate)
           throws QueryException
```
    Description copied from interface: ITemplateQueryAbility
    
    查一个实体结果，如果没有异常，必将返回一个或为null的T类型实体
    
    Specified by:
    
    queryOne in interface ITemplateQueryAbility<T extends TiEntity<T>>
    
    Parameters:
    
    sqlTemplate - sql模版对象
    
    Returns:
    
    一个T类型的实体，如果不存在，则返回null
    
    Throws:
    
    QueryException - 查询中各个阶段出现异常
  - queryCount
```
public Long queryCount(String sqlTemplate,
                       String selectName)
                throws QueryException
```
    Description copied from interface: ITemplateQueryAbility
    
    统计记录数量，实体本身的属性将放入到参数空间
    
    Specified by:
    
    queryCount in interface ITemplateQueryAbility<T extends TiEntity<T>>
    
    Parameters:
    
    sqlTemplate - 使用模版语法的sql语句
    
    selectName - 代表返回数量的字段名，例如 'select count(a) as rows'中的rows
    
    Returns:
    
    记录数量，如果给定的 selectName 无误，将不会返回null
    
    Throws:
    
    QueryException - 查询中各个阶段出现异常
  - queryCount
```
public Long queryCount(ISQL sqlTemplate,
                       String selectName)
                throws QueryException
```
    Description copied from interface: ITemplateQueryAbility
    
    统计记录数量
    
    Specified by:
    
    queryCount in interface ITemplateQueryAbility<T extends TiEntity<T>>
    
    Parameters:
    
    sqlTemplate - sql模版对象
    
    selectName - 代表返回数量的字段名，例如 'select count(a) as rows'中的rows
    
    Returns:
    
    记录数量，如果给定的 selectName 无误，将不会返回null
    
    Throws:
    
    QueryException - 查询中各个阶段出现异常
  - page
```
public IPage<T> page(String sql)
              throws QueryException
```
    Description copied from interface: ITemplateQueryAbility
    
    查一个list结果，如果没有异常，必将返回一个或为空的列表，实体本身的属性将放入到参数空间
    
    Specified by:
    
    page in interface ITemplateQueryAbility<T extends TiEntity<T>>
    
    Parameters:
    
    sql - 使用模版语法的sql语句
    
    Returns:
    
    Page对象
    
    Throws:
    
    QueryException - 查询中各个阶段出现异常
  - page
```
public IPage<T> page(ISQL sqlTemplate)
              throws QueryException
```
    Description copied from interface: ITemplateQueryAbility
    
    查一个list结果，如果没有异常，必将返回一个或为空的列表
    
    Specified by:
    
    page in interface ITemplateQueryAbility<T extends TiEntity<T>>
    
    Parameters:
    
    sqlTemplate - sql模版对象
    
    Returns:
    
    Page对象
    
    Throws:
    
    QueryException - 查询中各个阶段出现异常
  - delete
```
public int delete(String sql)
           throws DeleteException
```
    Description copied from interface: ITemplateDeleteAbility
    
    按给定的条件删除记录，实体本身的属性将放入到参数空间
    
    Specified by:
    
    delete in interface ITemplateDeleteAbility
    
    Parameters:
    
    sql - 使用模版语法的sql语句
    
    Returns:
    
    删除的数量
    
    Throws:
    
    DeleteException - 删除中各个阶段出现异常
  - delete
```
public int delete(ISQL template)
           throws DeleteException
```
    Description copied from interface: ITemplateDeleteAbility
    
    按给定的条件删除记录
    
    Specified by:
    
    delete in interface ITemplateDeleteAbility
    
    Parameters:
    
    template - sql模版对象
    
    Returns:
    
    删除的数量
    
    Throws:
    
    DeleteException - 删除中各个阶段出现异常
  - update
```
public int update(String sql)
           throws DeleteException
```
    Description copied from interface: ITemplateUpdateAbility
    
    按给定的条件更新记录，实体本身的属性将放入到参数空间
    
    Specified by:
    
    update in interface ITemplateUpdateAbility
    
    Parameters:
    
    sql - 使用模版语法的sql语句
    
    Returns:
    
    更新的数量
    
    Throws:
    
    DeleteException - 更新中各个阶段出现异常
  - update
```
public int update(ISQL template)
           throws DeleteException
```
    Description copied from interface: ITemplateUpdateAbility
    
    按给定的条件更新记录
    
    Specified by:
    
    update in interface ITemplateUpdateAbility
    
    Parameters:
    
    template - sql模版对象
    
    Returns:
    
    更新的数量
    
    Throws:
    
    DeleteException - 更新中各个阶段出现异常
  - pageSize
```
public Integer pageSize()
```
    Description copied from interface: IPageParam
    
    获取分页大小
    
    Specified by:
    
    pageSize in interface IPageParam
    
    Returns:
    
    分页大小
  - pageIndex
```
public Integer pageIndex()
```
    Description copied from interface: IPageParam
    
    获取当前分页编号，分页从1开始
    
    Specified by:
    
    pageIndex in interface IPageParam
    
    Returns:
    
    分页编号
  - pageSize
```
public void pageSize(Integer size)
```
    Description copied from interface: IPageParam
    
    设置分页大小
    
    Specified by:
    
    pageSize in interface IPageParam
    
    Parameters:
    
    size - 分页大小
  - pageIndex
```
public void pageIndex(Integer size)
```
    Description copied from interface: IPageParam
    
    设置当前页编号
    
    Specified by:
    
    pageIndex in interface IPageParam
    
    Parameters:
    
    size - 当前页
  - insert
```
public int insert(String sql)
           throws InsertException
```
    新增
    
    Specified by:
    
    insert in interface ITemplateInsertAbility<T extends TiEntity<T>>
    
    Parameters:
    
    sql - 使用模版语法的sql语句
    
    Returns:
    
    插入成功的数量
    
    Throws:
    
    InsertException - 插入各个阶段出现异常
  - insert
```
public int insert(ISQL template)
           throws InsertException
```
    新增
    
    Specified by:
    
    insert in interface ITemplateInsertAbility<T extends TiEntity<T>>
    
    Parameters:
    
    template - sql模版对象
    
    Returns:
    
    插入成功的数量
    
    Throws:
    
    InsertException - 插入各个阶段出现异常
  - insert
```
public int insert(List<T> entities)
           throws InsertException
```
    新增-多记录-高级，主键若指定了生成器将自动赋值，或指定为自增，也会自动赋值批量模式将单独成一个事务进行批量插入
    
    Specified by:
    
    insert in interface ITemplateInsertAbility<T extends TiEntity<T>>
    
    Parameters:
    
    entities - 列表对象
    
    Returns:
    
    插入成功的数量
    
    Throws:
    
    InsertException - 插入各个阶段出现异常

Class TiEntity<T extends TiEntity<T>>

Constructor Summary

Method Summary

Methods inherited from class com.gitee.oeoe.tisimple.ability.AbilityISQL

Methods inherited from class java.lang.Object

Constructor Detail

TiEntity

Method Detail

getPageFactory

setPageFactory

setTxManager

getTxManager

setConnection

getConnection

insert

delete

update

page

query

onlyOne

count

queryMap

queryMap

queryList

queryList

queryOne

queryOne

queryCount

queryCount

page

page

delete

delete

update

update

pageSize

pageIndex

pageSize

pageIndex

insert

insert

insert