SuidRich (Bee 1.7.1 API)

所有超级接口:

Suid

所有已知子接口:

ObjSQLRichService

所有已知实现类:

ObjSQLRichAbstractServiceImpl
```
public interface SuidRich
extends Suid
```
数据库操作接口,包括查,改,增,删 Suid (select,update,insert,delete), 该接口比Suid接口提供更多的参数选择.Database operation: Suid (select,update,insert,delete), it supports more parameters than Suid.

从以下版本开始:

1.0

作者:

Kingstar Create on 2013-6-30 22:06:18

方法概要

方法
限定符和类型	方法和说明
`<T> int`	`delete(T entity, IncludeType includeType)` 根据实体对象entity删除数据
`int`	`deleteById(Class c, Integer id)` 根据id删记录.delete record by id.
`int`	`deleteById(Class c, Long id)` 根据id删记录.delete record by id.
`int`	`deleteById(Class c, String ids)` 根据id删记录.delete record by id.
`<T> int[]`	`insert(T[] entity)` 批量插入数据. insert records by batch.
`<T> int[]`	`insert(T[] entity, int batchSize)`
`<T> int[]`	`insert(T[] entity, int batchSize, String excludeFieldList)` 批量插入数据,可以指定不插入的字段.
`<T> int[]`	`insert(T[] entity, String excludeFieldList)`
`<T> int`	`insert(T entity, IncludeType includeType)` 根据实体对象entity插入数据
`<T> List<T>`	`select(T entity, IncludeType includeType)` 根据实体对象entity查询数据.
`<T> List<T>`	`select(T entity, IncludeType includeType, Condition condition)` 已过时。 Suid的 select(T entity,Condition condition)方法中,可以通过condition设置includeType.
`<T> List<T>`	`select(T entity, int size)` 根据实体对象entity查询数据 According to entity object select records from database.
`<T> List<T>`	`select(T entity, int start, int size)` 根据实体对象entity查询数据 According to entity object select records from database.
`<T> List<T>`	`select(T entity, String selectFields)`
`<T> List<T>`	`select(T entity, String selectFields, int start, int size)`
`<T> List<T>`	`selectById(T entity, Integer id)` 根据id查询记录. select record by id.
`<T> List<T>`	`selectById(T entity, Long id)` 根据id查询记录. select record by id.
`<T> List<T>`	`selectById(T entity, String ids)` 根据id查询记录. select record by id.
`<T> String`	`selectJson(T entity)` 根据实体对象entity查询数据,并返回Json格式结果.
`<T> String`	`selectJson(T entity, IncludeType includeType)` 根据实体对象entity查询数据
`<T> String`	`selectJson(T entity, IncludeType includeType, Condition condition)` 根据实体对象entity查询数据,并以Json格式返回
`<T> T`	`selectOne(T entity)` 查询一个实体.
`<T> List<T>`	`selectOrderBy(T entity, String orderFieldList)` 应用排序查询结果,排序的字段默认按升序排列.
`<T> List<T>`	`selectOrderBy(T entity, String orderFieldList, OrderType[] orderTypes)` 应用排序查询结果.
`<T> List<String[]>`	`selectString(T entity)` 查询实体,每个字段都是以字符串类型返回.
`<T> List<String[]>`	`selectString(T entity, String selectFields)` 查询部分字段,每个字段都是以字符串类型返回.
`<T> String`	`selectWithFun(T entity, FunctionType functionType, String fieldForFun)` 使用函数查询结果.select result with function.
`<T> int`	`update(T entity, IncludeType includeType)` 根据实体对象entity更新数据
`<T> int`	`update(T entity, String updateFieldList)` 更新记录,且可以指定需要更新的字段.
`<T> int`	`update(T entity, String updateFieldList, IncludeType includeType)` 根据实体对象entity更新数据,可以指定需要更新的字段.
`<T> int`	`updateBy(T entity, String whereFieldList)` 更新记录,且可以指定作为条件的字段.
`<T> int`	`updateBy(T entity, String whereFieldList, IncludeType includeType)` 更新记录,且可以指定作为条件的字段和指定字段的过滤类型 update record according to whereFieldList.

从接口继承的方法 org.teasoft.bee.osql.Suid
delete, insert, select, select, update

- 方法详细资料
  - select
```
<T> List<T> select(T entity,
                 int size)
```
    根据实体对象entity查询数据 According to entity object select records from database.
    
    参数:
    entity - 实体类对象,且不能为空. table's entity(do not allow null). entity中非null且非空字符串作为过虑条件,操作符是等号.eg:field=value entity corresponding to table and can not be null. If the field value is not null and not empty string as filter condition, the operator is equal sign.eg:field=value
    size - 结果集大小大于等于1. fetch result size (>0).
    
    返回:
    返回可包含多个实体(多条记录)的list. return list can contain more than one entity
  - select
```
<T> List<T> select(T entity,
                 int start,
                 int size)
```
    根据实体对象entity查询数据 According to entity object select records from database.
    
    参数:
    entity - 实体类对象,且不能为空. table's entity(do not allow null). entity中非null且非空字符串作为过虑条件,操作符是等号.eg:field=value entity corresponding to table and can not be null. If the field value is not null and not empty string as filter condition, the operator is equal sign.eg:field=value
    start - 开始下标(从0或1开始,eg:MySQL是0,Oracle是1). start index,min value is 0 or 1(eg:MySQL is 0,Oracle is 1).
    size - 结果集大小大于等于1. fetch result size (>0).
    
    返回:
    返回可包含多个实体(多条记录)的list. return list can contain more than one entity
  - select
```
<T> List<T> select(T entity,
                 String selectFields)
```
    参数:
    entity - 实体类对象,且不能为空
    selectFields - 需要查询的字段,多个用逗号隔开. select fields,if more than one,separate with comma.
    
    返回:
  - select
```
<T> List<T> select(T entity,
                 String selectFields,
                 int start,
                 int size)
```
    参数:
    entity - 实体类对象,且不能为空
    selectFields - 需要查询的字段,多个用逗号隔开. select fields,if more than one,separate with comma.
    start - 开始下标(从0或1开始,eg:MySQL是0,Oracle是1). start index,min value is 0 or 1(eg:MySQL is 0,Oracle is 1).
    size - 结果集大小大于等于1. fetch result size (>0).
    
    返回:
    从以下版本开始:
    
    1.4.3
  - selectString
```
<T> List<String[]> selectString(T entity)
```
    查询实体,每个字段都是以字符串类型返回. select entity,every field will return the string type.
    
    参数:
    entity - 实体类对象,且不能为空
    
    返回:
  - selectString
```
<T> List<String[]> selectString(T entity,
                              String selectFields)
```
    查询部分字段,每个字段都是以字符串类型返回. select some field, every field will return the string type.
    
    参数:
    entity - 实体类对象,且不能为空
    selectFields - 需要查询的字段,多个用逗号隔开. select fields,if more than one,separate with comma.
    
    返回:
  - selectJson
```
<T> String selectJson(T entity)
```
    根据实体对象entity查询数据,并返回Json格式结果. select Json type result by entity.
    
    参数:
    entity - 与表对应的实体对象,且不能为空 entity中非null与非空字符串作为过虑条件,操作符是等号.eg:field=value
    
    返回:
    返回可包含多个实体(多条记录)的list转换成的json格式的字符串. return Json string, it transform from list which can contain more than one entity.
    从以下版本开始:
    
    1.1
  - selectOne
```
<T> T selectOne(T entity)
```
    查询一个实体. select one record.
    
    参数:
    entity - 实体类对象
    
    返回:
    只返回一个实体,数量不为1测返回null.return one record,if the size do not equal one, return null.
  - selectWithFun
```
<T> String selectWithFun(T entity,
                       FunctionType functionType,
                       String fieldForFun)
```
    使用函数查询结果.select result with function.
    
    参数:
    entity - 传入的实体对象,且不能为空
    fieldForFun - 需要使用函数的字段
    functionType - MAX,MIN,SUM,AVG,COUNT
    
    返回:
  - selectOrderBy
```
<T> List<T> selectOrderBy(T entity,
                        String orderFieldList)
```
    应用排序查询结果,排序的字段默认按升序排列. select result by key:order,order type default is:asc
    
    参数:
    entity - 传入的实体对象,且不能为空
    orderFieldList - 排序字段列表,多个用逗号隔开
    
    返回:
    返回有排序的结果集
  - selectOrderBy
```
<T> List<T> selectOrderBy(T entity,
                        String orderFieldList,
                        OrderType[] orderTypes)
```
    应用排序查询结果. select result by key:order.
    
    参数:
    entity - 传入的实体对象,且不能为空
    orderFieldList - 排序字段列表,多个用逗号隔开
    orderTypes - 排序类型列表
    
    返回:
    返回有排序的结果集
  - update
```
<T> int update(T entity,
             String updateFieldList)
```
    更新记录,且可以指定需要更新的字段. update record, can list update fields.
    
    参数:
    entity - 实体类对象,不能为空
    updateFieldList - 需要更新的字段列表,多个字段用逗号隔开(列表中有的字段都会更新);其它非空,非null的字段作为过滤条件
    
    返回:
  - update
```
<T> int update(T entity,
             String updateFieldList,
             IncludeType includeType)
```
    根据实体对象entity更新数据,可以指定需要更新的字段. update record according to entity.
    
    参数:
    entity - 与表对应的实体对象,且不能为空 id为null不作为过滤条件
    updateFieldList - 需要更新的字段列表,多个字段用逗号隔开(列表中有的字段都会更新)
    includeType - 空字符串与null是否包含设置(是否作为过滤条件)
    
    返回:
    更新的记录数
  - insert
```
<T> int[] insert(T[] entity)
```
    批量插入数据. insert records by batch.
    
    参数:
    entity - 与表对应的实体对象,且不能为空. table's entity(do not allow null).
    
    返回:
  - insert
```
<T> int[] insert(T[] entity,
               int batchSize)
```
    参数:
    entity - 与表对应的实体对象,且不能为空. table's entity(do not allow null).
    batchSize -
    
    返回:
  - insert
```
<T> int[] insert(T[] entity,
               String excludeFieldList)
```
    参数:
    entity - 与表对应的实体对象,且不能为空. table's entity(do not allow null).
    excludeFieldList -
    
    返回:
  - insert
```
<T> int[] insert(T[] entity,
               int batchSize,
               String excludeFieldList)
```
    批量插入数据,可以指定不插入的字段.
    
    参数:
    entity - 与表对应的实体对象,且不能为空. table's entity(do not allow null).
    batchSize - 批操作数量大小.batch size.
    excludeFieldList - 不插入的字段列表.don't insert fields list.
    
    返回:
  - select
```
<T> List<T> select(T entity,
                 IncludeType includeType)
```
    根据实体对象entity查询数据. select record according to entity.
    
    参数:
    entity - 与表对应的实体对象,且不能为空 id为时null不作为过滤条件
    includeType - 空字符串与null是否包含设置
    
    返回:
    返回的list可包含多个实体(多条记录)
  - update
```
<T> int update(T entity,
             IncludeType includeType)
```
    根据实体对象entity更新数据
    
    参数:
    entity - 与表对应的实体对象,且不能为空;entity中id字段不能为空,作为过虑条件 id为null不作为过滤条件
    includeType - 空字符串与null是否包含设置
    
    返回:
    更新的记录数
  - insert
```
<T> int insert(T entity,
             IncludeType includeType)
```
    根据实体对象entity插入数据
    
    参数:
    entity - 与表对应的实体对象,且不能为空
    includeType - 空字符串与null是否包含设置
    
    返回:
    成功插入的记录数
  - delete
```
<T> int delete(T entity,
             IncludeType includeType)
```
    根据实体对象entity删除数据
    
    参数:
    entity - 与表对应的实体对象,且不能为空 id为null不作为过滤条件
    includeType - 空字符串与null是否包含设置
    
    返回:
    成功删除的记录数
  - selectJson
```
<T> String selectJson(T entity,
                    IncludeType includeType)
```
    根据实体对象entity查询数据
    
    参数:
    entity - 与表对应的实体对象,且不能为空 id为null不作为过滤条件
    includeType - 空字符串与null是否包含设置
    
    返回:
    返回可包含多个实体(多条记录)的list转换成的json格式的字符串. return Json string, it transform from list which can contain more than one entity.
    从以下版本开始:
    
    1.1
  - selectById
```
<T> List<T> selectById(T entity,
                     Integer id)
```
    根据id查询记录. select record by id.
    
    参数:
    entity - 实体类对象,且不能为空
    id - 实体id字段的值.value of entity's id field.
    
    返回:
    返回查询对象列表
    从以下版本开始:
    
    1.4
  - selectById
```
<T> List<T> selectById(T entity,
                     Long id)
```
    根据id查询记录. select record by id.
    
    参数:
    entity - 实体类对象,且不能为空
    id - 实体id字段的值.value of entity's id field.
    
    返回:
    返回查询对象列表
    从以下版本开始:
    
    1.4
  - selectById
```
<T> List<T> selectById(T entity,
                     String ids)
```
    根据id查询记录. select record by id.
    
    参数:
    entity - 实体类对象,且不能为空
    ids - 实体id字段的值,多个用逗号隔开.values of entity's id field.
    
    返回:
    返回查询对象列表
    从以下版本开始:
    
    1.4
  - deleteById
```
int deleteById(Class c,
             Integer id)
```
    根据id删记录.delete record by id.
    
    参数:
    c - 实体类类型,且不能为空
    id -
    
    返回:
    返回成功删除记录数
    从以下版本开始:
    
    1.4
  - deleteById
```
int deleteById(Class c,
             Long id)
```
    根据id删记录.delete record by id.
    
    参数:
    c - 实体类类型,且不能为空
    id - 实体id字段的值. value of entity's id field.
    
    返回:
    返回成功删除记录数
    从以下版本开始:
    
    1.4
  - deleteById
```
int deleteById(Class c,
             String ids)
```
    根据id删记录.delete record by id.
    
    参数:
    c - 实体类类型,且不能为空
    ids - 实体id字段的值,多个用逗号隔开.ids values of entity's id field.
    
    返回:
    返回成功删除记录数
    从以下版本开始:
    
    1.4
  - select
```
@Deprecated
<T> List<T> select(T entity,
                            IncludeType includeType,
                            Condition condition)
```
    已过时。 Suid的 select(T entity,Condition condition)方法中,可以通过condition设置includeType.
    
    根据实体对象entity查询数据. select record according to entity.
    
    参数:
    entity - 与表对应的实体对象,且不能为空 id为时null不作为过滤条件
    includeType - 空字符串与null是否包含设置
    condition - 默认有值的字段会转成field=value的形式,其它形式可通过condition指定.condition使用过的字段,默认情况不会再处理. if the field is not null or empty, it will be translate to field=value.Other can define with condition.
    
    返回:
    返回的list可包含多个实体(多条记录)
    从以下版本开始:
    
    1.6
  - selectJson
```
<T> String selectJson(T entity,
                    IncludeType includeType,
                    Condition condition)
```
    根据实体对象entity查询数据,并以Json格式返回
    
    参数:
    entity - 与表对应的实体对象,且不能为空 id为null不作为过滤条件
    includeType - 空字符串与null是否包含设置
    condition - 默认有值的字段会转成field=value的形式,其它形式可通过condition指定.condition使用过的字段,默认情况不会再处理. if the field is not null or empty, it will be translate to field=value.Other can define with condition. 若condition没有设置IncludeType,默认过滤NULL和空字符串(但condition中op,between,notBetween方法设置的字段,不受includeType的值影响.)
    
    返回:
    返回可包含多个实体(多条记录)的list转换成的json格式的字符串. return Json string, it transform from list which can contain more than one entity.
    从以下版本开始:
    
    1.6
  - updateBy
```
<T> int updateBy(T entity,
               String whereFieldList)
```
    更新记录,且可以指定作为条件的字段. update record according to whereFieldList.
    
    参数:
    entity - 实体类对象,不能为空没指定为whereFieldList的字段,作为set部分,默认只处理非空,非null的字段
    whereFieldList - 作为条件的字段列表,多个字段用逗号隔开(列表中有的字段都会作为条件); 指定作为条件的,都转换.id为null不作为过滤条件
    
    返回:
    从以下版本开始:
    
    1.6
  - updateBy
```
<T> int updateBy(T entity,
               String whereFieldList,
               IncludeType includeType)
```
    更新记录,且可以指定作为条件的字段和指定字段的过滤类型 update record according to whereFieldList.
    
    参数:
    entity - 与表对应的实体对象,且不能为空没指定为whereFieldList的字段,作为set部分.
    whereFieldList - 作为条件的字段列表,多个字段用逗号隔开(列表中有的字段都会作为条件); 指定作为条件的,都转换.id为null不作为过滤条件
    includeType - 空字符串与null是否包含设置(是否作为过滤条件)
    
    返回:
    更新的记录数
    从以下版本开始:
    
    1.6

接口 SuidRich

方法概要

从接口继承的方法 org.teasoft.bee.osql.Suid

方法详细资料

select

select

select

select

selectString

selectString

selectJson

selectOne

selectWithFun

selectOrderBy

selectOrderBy

update

update

insert

insert

insert

insert

select

update

insert

delete

selectJson

selectById

selectById

selectById

deleteById

deleteById

deleteById

select

selectJson

updateBy

updateBy