SuidRich (Bee 1.8 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删除数据.Delete record according to 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 type.
`<T> int`	`insert(T[] entity, int batchSize)` 批量插入数据.Insert records by batch type.
`<T> int`	`insert(T[] entity, int batchSize, String excludeFields)` 批量插入数据,且可以指定不用插入的字段列表 Insert record by batch type,and can point out which field(s) don't need to insert.
`<T> int`	`insert(T[] entity, String excludeFields)` 批量插入数据,且可以声明不用插入的字段列表 Insert record by batch type,and can point out which field(s) don't need to insert.
`<T> int`	`insert(T entity, IncludeType includeType)` 根据实体对象entity插入数据.Insert record according to entity.
`<T> List<T>`	`select(T entity, IncludeType includeType)` 根据实体对象entity查询数据.Select record according to entity.
`<T> List<T>`	`select(T entity, IncludeType includeType, Condition condition)` 已过时。 `Suid.select(Object,Condition)`方法中,可以通过condition设置includeType.
`<T> List<T>`	`select(T entity, int size)` 根据实体对象entity查询数据,且可以分页 Select record(s) according to entity object,and can specify page information.
`<T> List<T>`	`select(T entity, int start, int size)` 根据实体对象entity查询数据,且可以分页 Select record(s) according to entity object,and can specify page information.
`<T> List<T>`	`select(T entity, String selectFields)` 查询实体时,只查询部分一部分字段.Just select some fields.
`<T> List<T>`	`select(T entity, String selectFields, int start, int size)` 查询实体时,只查询部分一部分字段,且可以分页 Just select some fields,and can specify page information.
`<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格式结果 Select and return data in Json format according to entity object.
`<T> String`	`selectJson(T entity, IncludeType includeType)` 根据实体对象entity查询并返回Json格式的数据 Select and return data in Json format according to entity object.
`<T> String`	`selectJson(T entity, IncludeType includeType, Condition condition)` 根据实体对象entity查询数据,并以Json格式返回 Select and return data in Json format according to entity object.
`<T> T`	`selectOne(T entity)` 查询一个实体.Select one record.
`<T> List<T>`	`selectOrderBy(T entity, String orderFields)` 查询应用排序的结果,排序的字段默认按升序排列 Select result with order,order type default is:asc
`<T> List<T>`	`selectOrderBy(T entity, String orderFields, OrderType[] orderTypes)` 查询应用排序的结果 Select result with order.
`<T> List<String[]>`	`selectString(T entity)` 查询实体,每个字段都是以字符串类型返回 Select entity,every field will return the string type.
`<T> List<String[]>`	`selectString(T entity, String selectFields)` 查询部分字段,每个字段都是以字符串类型返回 Select some field, every field will return the string type.
`<T> String`	`selectWithFun(T entity, FunctionType functionType, String fieldForFun)` 使用函数查询结果.Select result with function.
`<T> int`	`update(T entity, Condition condition)` 当SQL update的set表达式通过Condition定义时,可以不用再指定set使用的字段.
`<T> int`	`update(T entity, IncludeType includeType)` 根据实体对象entity更新数据.Update record according to entity.
`<T> int`	`update(T entity, String updateFields)` 更新记录,且可以指定需要更新的字段.Update record, can list update fields.
`<T> int`	`update(T entity, String updateFields, Condition condition)` 更新记录,且可以指定需要更新的字段,高级条件可通过Condition参数设置.Update record, can list update fields.
`<T> int`	`update(T entity, String updateFields, IncludeType includeType)` 根据实体对象entity更新数据,可以指定需要更新的字段.Update record according to entity.
`<T> int`	`updateBy(T entity, String whereFields)` 更新记录,且可以指定作为条件的字段.Update record according to whereFields.
`<T> int`	`updateBy(T entity, String whereFields, Condition condition)` 更新记录,且可以指定作为条件的字段.Update record according to whereFields.
`<T> int`	`updateBy(T entity, String whereFields, IncludeType includeType)` 更新记录,且可以指定作为条件的字段和指定字段的过滤类型.Update record according to whereFields.

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

- 方法详细资料
  - select
```
<T> List<T> select(T entity,
                 int size)
```
    根据实体对象entity查询数据,且可以分页
    Select record(s) according to entity object,and can specify page information.
    
    参数:
    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 field as filter condition,
    the operator is equal sign.eg:field=value
    size - 结果集大小大于等于1. fetch result size (>0).
    
    返回:
    可包含多个实体(多条记录)的list. list which contains more than one entity.
  - select
```
<T> List<T> select(T entity,
                 int start,
                 int size)
```
    根据实体对象entity查询数据,且可以分页
    Select record(s) according to entity object,and can specify page information.
    
    参数:
    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 field 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. list can contain more than one entity
  - select
```
<T> List<T> select(T entity,
                 String selectFields)
```
    查询实体时,只查询部分一部分字段.Just select some fields.
    
    参数:
    entity - 实体类对象,且不能为空
    selectFields - 需要查询的字段,多个用逗号隔开. select fields,if more than one,separate with comma.
    
    返回:
    可包含多个实体(多条记录)的list. list which contains more than one entity.
  - select
```
<T> List<T> select(T entity,
                 String selectFields,
                 int start,
                 int size)
```
    查询实体时,只查询部分一部分字段,且可以分页
    Just select some fields,and can specify page information.
    
    参数:
    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).
    
    返回:
    可包含多个实体(多条记录)的list. list which contains more than one entity.
    从以下版本开始:
    
    1.4.3
  - selectString
```
<T> List<String[]> selectString(T entity)
```
    查询实体,每个字段都是以字符串类型返回
    Select entity,every field will return the string type.
    
    参数:
    entity - 实体类对象,且不能为空
    
    返回:
    可包含多个String数组结构的多条记录的list. list can contain more than one record with String array struct.
  - 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.
    
    返回:
    可包含多个String数组结构的多条记录的list. list can contain more than one record with String array struct.
  - selectJson
```
<T> String selectJson(T entity)
```
    根据实体对象entity查询数据,并返回Json格式结果
    Select and return data in Json format according to entity object.
    
    参数:
    entity - 与表对应的实体对象,且不能为空 entity中非null与非空字符串作为过虑条件,操作符是等号.eg:field=value
    
    返回:
    可包含多个实体(多条记录)的list转换成的json格式的字符串.
    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
    
    返回:
    返回使用函数查询结果.Result select result with function.
  - selectOrderBy
```
<T> List<T> selectOrderBy(T entity,
                        String orderFields)
```
    查询应用排序的结果,排序的字段默认按升序排列 Select result with order,order type default is:asc
    
    参数:
    entity - 传入的实体对象,且不能为空
    orderFields - 排序字段列表,多个用逗号隔开
    
    返回:
    可包含多个有排序的实体(多条记录)的list. list which contains more than one entity.
  - selectOrderBy
```
<T> List<T> selectOrderBy(T entity,
                        String orderFields,
                        OrderType[] orderTypes)
```
    查询应用排序的结果 Select result with order.
    
    参数:
    entity - 传入的实体对象,且不能为空
    orderFields - 排序字段列表,多个用逗号隔开
    orderTypes - 排序类型列表
    
    返回:
    可包含多个有排序的实体(多条记录)的list. list which contains more than one entity.
  - update
```
<T> int update(T entity,
             String updateFields)
```
    更新记录,且可以指定需要更新的字段.Update record, can list update fields.
    
    参数:
    entity - 实体类对象,不能为空
    updateFields - 需要更新的字段列表,多个字段用逗号隔开(列表中有的字段都会更新),该属性不允许为空,
    默认每个字段会被转化成SQL update的set表达式;其它非空,非null的字段作为过滤条件,转成SQL的where表达式.
    
    返回:
    成功更新的记录数.the numbers of update record(s) successfully.
  - update
```
<T> int update(T entity,
             String updateFields,
             IncludeType includeType)
```
    根据实体对象entity更新数据,可以指定需要更新的字段.Update record according to entity.
    
    参数:
    entity - 与表对应的实体对象,且不能为空 id为null不作为过滤条件
    updateFields - 需要更新的字段列表,多个字段用逗号隔开(列表中有的字段都会更新),该属性不允许为空,且不受includeType参数的影响,默认每个字段会被转化成SQL update的set表达式
    includeType - 空字符串与null是否包含设置(是否作为过滤条件)
    
    返回:
    成功更新的记录数.the numbers of update record(s) successfully.
  - insert
```
<T> int insert(T[] entity)
```
    批量插入数据.Insert records by batch type.
    
    参数:
    entity - 与表对应的实体对象,且不能为空. table's entity(do not allow null).
    
    返回:
    成功插入的记录行数. the number of inserted record(s) successfully.
  - insert
```
<T> int insert(T[] entity,
             int batchSize)
```
    批量插入数据.Insert records by batch type.
    
    参数:
    entity - 与表对应的实体对象,且不能为空. table's entity(do not allow null).
    batchSize -
    
    返回:
    成功插入的记录行数. the number of inserted record(s) successfully.
  - insert
```
<T> int insert(T[] entity,
             String excludeFields)
```
    批量插入数据,且可以声明不用插入的字段列表
    Insert record by batch type,and can point out which field(s) don't need to insert.
    
    参数:
    entity - 与表对应的实体对象,且不能为空. table's entity(do not allow null).
    excludeFields - 声明不用插入的字段列表.fields list that don't need to insert .
    
    返回:
    成功插入的记录行数. the number of inserted record(s) successfully.
  - insert
```
<T> int insert(T[] entity,
             int batchSize,
             String excludeFields)
```
    批量插入数据,且可以指定不用插入的字段列表
    Insert record by batch type,and can point out which field(s) don't need to insert.
    
    参数:
    entity - 与表对应的实体对象,且不能为空. table's entity(do not allow null).
    batchSize - 批操作数量大小.batch size.
    excludeFields - 声明不用插入的字段列表.Don't insert fields list.
    
    返回:
    成功插入的记录行数. the number of inserted record(s) successfully.
  - select
```
<T> List<T> select(T entity,
                 IncludeType includeType)
```
    根据实体对象entity查询数据.Select record according to entity.
    
    参数:
    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 field as filter condition,
    the operator is equal sign.eg:field=value
    includeType - 空字符串与null是否包含设置
    
    返回:
    可包含多个实体(多条记录)的list. list which contains more than one entity.
  - update
```
<T> int update(T entity,
             IncludeType includeType)
```
    根据实体对象entity更新数据.Update record according to entity.
    
    参数:
    entity - 与表对应的实体对象,且不能为空;entity中id字段不能为空,作为过虑条件 id为null不作为过滤条件
    includeType - 空字符串与null是否包含设置
    
    返回:
    成功更新的记录数.the numbers of update record(s) successfully.
  - insert
```
<T> int insert(T entity,
             IncludeType includeType)
```
    根据实体对象entity插入数据.Insert record according to entity.
    
    参数:
    entity - 与表对应的实体对象,且不能为空
    includeType - 空字符串与null是否包含设置
    
    返回:
    成功插入的记录行数. the number of inserted record(s) successfully.
  - delete
```
<T> int delete(T entity,
             IncludeType includeType)
```
    根据实体对象entity删除数据.Delete record according to entity.
    
    参数:
    entity - 与表对应的实体对象,且不能为空 id为null不作为过滤条件
    includeType - 空字符串与null是否包含设置
    
    返回:
    成功删除的记录行数. the number of deleted record(s) successfully.
  - selectJson
```
<T> String selectJson(T entity,
                    IncludeType includeType)
```
    根据实体对象entity查询并返回Json格式的数据
    Select and return data in Json format according to entity object.
    
    参数:
    entity - 与表对应的实体对象,且不能为空 id为null不作为过滤条件
    includeType - 空字符串与null是否包含设置
    
    返回:
    可包含多个实体(多条记录)的list转换成的json格式的字符串.
    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.
    
    返回:
    可包含多个实体(多条记录)的list. list which contains more than one entity.
    从以下版本开始:
    
    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.
    
    返回:
    可包含多个实体(多条记录)的list. list which contains more than one entity.
    从以下版本开始:
    
    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.
    
    返回:
    可包含多个实体(多条记录)的list. list which contains more than one entity.
    从以下版本开始:
    
    1.4
  - deleteById
```
int deleteById(Class c,
             Integer id)
```
    根据id删除记录.Delete record by id.
    
    参数:
    c - 实体类类型,且不能为空
    id - 实体id字段的值. value of entity's id field.
    
    返回:
    成功删除的记录行数. the number of deleted record(s) successfully.
    从以下版本开始:
    
    1.4
  - deleteById
```
int deleteById(Class c,
             Long id)
```
    根据id删除记录.Delete record by id.
    
    参数:
    c - 实体类类型,且不能为空
    id - 实体id字段的值. value of entity's id field.
    
    返回:
    成功删除的记录行数. the number of deleted record(s) successfully.
    从以下版本开始:
    
    1.4
  - deleteById
```
int deleteById(Class c,
             String ids)
```
    根据id删除记录.Delete record by id.
    
    参数:
    c - 实体类类型,且不能为空
    ids - 实体id字段的值,多个用逗号隔开.ids values of entity's id field.
    
    返回:
    成功删除的记录行数. the number of deleted record(s) successfully.
    从以下版本开始:
    
    1.4
  - select
```
@Deprecated
<T> List<T> select(T entity,
                            IncludeType includeType,
                            Condition condition)
```
    已过时。 Suid.select(Object,Condition)方法中,可以通过condition设置includeType.
    
    根据实体对象entity查询数据.Select record according to entity.
    
    参数:
    entity - 与表对应的实体对象,且不能为空 id为null时不作为过滤条件
    includeType - 空字符串与null是否包含设置
    condition - entity默认有值的字段会转成field=value的形式,其它形式可通过condition指定.condition使用过的字段,默认情况不会再处理.
    If the field of entity 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. list which contains more than one entity.
    从以下版本开始:
    
    1.6
  - selectJson
```
<T> String selectJson(T entity,
                    IncludeType includeType,
                    Condition condition)
```
    根据实体对象entity查询数据,并以Json格式返回
    Select and return data in Json format according to entity object.
    
    参数:
    entity - 与表对应的实体对象,且不能为空 id为null不作为过滤条件
    includeType - 空字符串与null是否包含设置
    condition - entity默认有值的字段会转成field=value的形式,其它形式可通过condition指定.condition使用过的字段,默认情况不会再处理.
    If the field of entity 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格式的字符串.
    Json string, it transform from list which can contain more than one entity.
    从以下版本开始:
    
    1.6
  - updateBy
```
<T> int updateBy(T entity,
               String whereFields)
```
    更新记录,且可以指定作为条件的字段.Update record according to whereFields.
    
    参数:
    entity - 实体类对象,不能为空没指定为whereFields的字段,作为set部分,默认只处理非空,非null的字段
    whereFields - 作为SQL中where条件的字段列表,多个字段用逗号隔开(列表中有的字段都会作为条件); 指定作为条件的,都转换.id为null不作为过滤条件
    
    返回:
    成功更新的记录数.the numbers of update record(s) successfully.
    从以下版本开始:
    
    1.6
  - updateBy
```
<T> int updateBy(T entity,
               String whereFields,
               IncludeType includeType)
```
    更新记录,且可以指定作为条件的字段和指定字段的过滤类型.Update record according to whereFields.
    
    参数:
    entity - 与表对应的实体对象,且不能为空没指定为whereFields的字段,作为set部分.
    whereFields - 作为SQL中where条件的字段列表,多个字段用逗号隔开(列表中有的字段都会作为条件); 指定作为条件的,都转换.id为null不作为过滤条件
    includeType - 空字符串与null是否包含设置(是否作为过滤条件)
    
    返回:
    成功更新的记录数.the numbers of update record(s) successfully.
    从以下版本开始:
    
    1.6
  - updateBy
```
<T> int updateBy(T entity,
               String whereFields,
               Condition condition)
```
    更新记录,且可以指定作为条件的字段.Update record according to whereFields.
    
    参数:
    entity - 实体类对象,不能为空没指定为whereFields的字段,作为set部分(默认只处理非空,非null的字段)
    whereFields - 作为SQL中where条件的字段列表,多个字段用逗号隔开(列表中有的字段都会作为条件); 指定作为条件的,都转换.id为null不作为过滤条件
    condition - 用来设置默认情况不能表达的条件. 若condition没有设置IncludeType,默认过滤NULL和空字符串(但condition中op,between,notBetween方法设置的字段,不受includeType的值影响.)
    
    返回:
    成功更新的记录数.the numbers of update record(s) successfully.
    从以下版本开始:
    
    1.7.2
  - update
```
<T> int update(T entity,
             String updateFields,
             Condition condition)
```
    更新记录,且可以指定需要更新的字段,高级条件可通过Condition参数设置.Update record, can list update fields.
    
    参数:
    entity - 实体类对象,不能为空 entity默认有值的字段会转成field=value的形式,其它形式可通过condition指定.condition中op,between等方法设置的转换到where中的字段,默认情况不会再处理.
    If the field of entity is not null or empty, it will be translate to field=value.Other can define with condition.
    updateFields - 需要更新的字段列表,多个字段用逗号隔开(列表中有的字段都会更新),该属性不允许为空,
    默认updateFields的每个字段会被转化成SQL update的set表达式;其它非空,非null的字段作为过滤条件,转成SQL的where表达式.
    condition - 若condition没有设置IncludeType,默认过滤NULL和空字符串(但condition中op,between,notBetween方法设置的字段,不受includeType的值影响.)
    
    返回:
    成功更新的记录数.the numbers of update record(s) successfully.
    从以下版本开始:
    
    1.7.2
  - update
```
<T> int update(T entity,
             Condition condition)
```
    当SQL update的set表达式通过Condition定义时,可以不用再指定set使用的字段.
    
    参数:
    entity - 实体类对象,不能为空 entity默认有值的字段会转成field=value的形式,其它形式可通过condition指定.condition中op,between等方法设置的转换到where中的字段,默认情况不会再处理.
    If the field of entity is not null or empty, it will be translate to field=value.Other can define with condition.
    condition - 若condition没有设置IncludeType,默认过滤NULL和空字符串(但condition中op,between,notBetween方法设置的字段,不受includeType的值影响.)
    
    返回:
    成功更新的记录数.the numbers of update record(s) successfully.
    从以下版本开始:
    
    1.8

接口 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

updateBy

update

update