org.teasoft.bee.osql

接口 SuidRich

所有超级接口:

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.
SQL UPDATE语句包括两大部分SET和WHERE,SuidRich采取指定其中一样,另一样尽量采用默认的实现方式.所以有关更新的方法分为两部分:
update和updateBy.
update方法中,String updateFields参数(若有),可以指明要更新的字段,其余字段则有可能转为SQL UPDATE语句的WHERE部分(默认过
滤NULL和空字符串,可通过IncludeType显示设置).
updateBy方法中,String whereFields(若有),可以指明用于SQL中WHERE的字段.当指定了whereFields, 没在whereFields的字段,将默认
转换为SQL UPDATE语句的SET部分(默认过滤NULL和空字符串,可通过IncludeType显示设置).
同一个实体的某个属性的值,若用于WHERE部分了,再用于UPDATE SET部分就没有意义(因为此时它们的值是一样的),但可以用Condition的
set(String fieldName, Number num)等方法设置;Condition的方法set,setMultiply,setAdd,setWithField,是在处理WHERE字段前
已完成处理的,所以不受指定的WHERE条件字段的影响.
update和updateBy方法的Condition设置的字段都会被解析,不受IncludeType的限制,也不受updateFields参数和whereFields参数的影响.

从以下版本开始:

1.0

作者:

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

方法概要

方法

限定符和类型	方法和说明
<T> int	count(T entity) 统计记录总数.total number of statistical records.
<T> int	count(T entity, Condition condition) 统计记录总数.total number of statistical records.
<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> boolean	exist(T entity) 检测实体对应记录是否存在.Check whether the entity corresponding record exist
<T> int	insert(List<T> entityList) 批量插入数据.Insert records by batch type.
<T> int	insert(List<T> entityList, int batchSize) 批量插入数据.Insert records by batch type.
<T> int	insert(List<T> entityList, int batchSize, String excludeFields) 批量插入数据,且可以指定不用插入的字段列表 Insert record by batch type,and can point out which field(s) don't need to insert.
<T> int	insert(List<T> entityList, String excludeFields) 批量插入数据,且可以声明不用插入的字段列表 Insert record by batch type,and can point out which field(s) don't need to insert.
<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.can set includeType via condition.
<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> T	selectById(T entity, Integer id) 根据id查询记录.Select record by id.
<T> T	selectById(T entity, Long id) 根据id查询记录.Select record by id.
<T> T	selectById(T entity, String id) 根据id查询记录.Select record by id.
<T> List<T>	selectByIds(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, Condition condition) 根据实体对象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) 已过时。 selectJson(Object,Condition)方法中,可以通过condition设置includeType.can set includeType via condition.
<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, Condition condition) 不以具体实体结构返回数据,而是用字符数组的List Instead of returning data in a entity structure, it uses a character array in List.
<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 one function,Just select one function.
<T> String	selectWithFun(T entity, FunctionType functionType, String fieldForFun, Condition condition) 使用函数查询一个统计结果,通过Condition可添加复杂过滤条件(一次只查询一个统计结果) Select result with one function,just select one function at a time.
SuidRich	setDynamicParameter(String para, String value) 为动态表名、实体名参数设置值.set dynamic parameter for dynamic table & entity name 本方法的调用要早于select,update,insert,delete等方法.
<T> int	update(T entity, Condition condition) 更新记录,高级条件可通过Condition参数设置 Update record,and can help with Condition.
<T> int	update(T entity, IncludeType includeType) 根据实体对象entity中id更新该实体对象的数据.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.
<T> int	updateById(T entity, Condition condition) 此方法,相当于调用SuidRich接口的 updateBy(entity,"id",condition); it is equivalent to updateBy(entity,"id",condition)

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

beginSameConnection, delete, delete, endSameConnection, insert, insertAndReturnId, select, select, 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 - 实体类对象,且不能为空.table's entity(do not allow null).

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 - 实体类对象,且不能为空.table's entity(do not allow null).

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 - 实体类对象,且不能为空.table's entity(do not allow null).

返回:

可包含多个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 - 实体类对象,且不能为空.table's entity(do not allow null).

selectFields - 需要查询的字段,多个用逗号隔开. Select fields,if more than one,separate with comma.

返回:

可包含多个String数组结构的多条记录的list. list can contain more than one record with String array struct.

selectString

<T> List<String[]> selectString(T entity,
                              Condition condition)

不以具体实体结构返回数据,而是用字符数组的List
Instead of returning data in a entity structure, it uses a character array in List.

参数:

entity - 实体类对象,且不能为空.table's entity(do not allow null).

condition - condition.若condition没有设置IncludeType,默认过滤NULL和空字符串(但condition中op,between,notBetween方法设置的字段,不受includeType的值影响.)

返回:

可包含多个String数组结构的多条记录的list. list can contain more than one record with String array struct.

从以下版本开始:

1.9

selectJson

<T> String selectJson(T entity)

根据实体对象entity查询数据,并返回Json格式结果
Select and return data in Json format according to entity object.

参数:

entity - 与表对应的实体对象,且不能为空.table's entity(do not allow null). 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 one function,Just select one function.

参数:

entity - 传入的实体对象,且不能为空.table's entity(do not allow null).

functionType - MAX,MIN,SUM,AVG,COUNT

fieldForFun - 需要使用函数的字段.field for function.

返回:

一个函数查询的结果.one function result.

selectWithFun

<T> String selectWithFun(T entity,
                       FunctionType functionType,
                       String fieldForFun,
                       Condition condition)

使用函数查询一个统计结果,通过Condition可添加复杂过滤条件(一次只查询一个统计结果) Select result with one function,just select one function at a time.

参数:

entity - 传入的实体对象,且不能为空.table's entity(do not allow null).

functionType - MAX,MIN,SUM,AVG,COUNT

fieldForFun - 需要使用函数的字段.field for function.

condition - condition.若condition没有设置IncludeType,默认过滤NULL和空字符串(但condition中op,between,notBetween方法设置的字段,不受includeType的值影响.)
在此,condition的selectFun方法将被忽略.here will ignore the condition's selectFun method.

返回:

一个函数查询的结果.one function result.

从以下版本开始:

1.9

count

<T> int count(T entity)

统计记录总数.total number of statistical records.

参数:

entity - 实体类对象,且不能为空. table's entity(do not allow null).

返回:

统计记录行数. total number of records that satisfy the condition.

从以下版本开始:

1.9

count

<T> int count(T entity,
            Condition condition)

统计记录总数.total number of statistical records.

参数:

entity - 实体类对象,且不能为空. table's entity(do not allow null).

condition - condition用于设置过滤条件.condition as filter the record.

返回:

统计记录行数. total number of records that satisfy the condition.

从以下版本开始:

1.9

selectOrderBy

<T> List<T> selectOrderBy(T entity,
                        String orderFields)

查询应用排序的结果,排序的字段默认按升序排列 Select result with order,order type default is:asc

参数:

entity - 传入的实体对象,且不能为空.table's entity(do not allow null).

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 - 传入的实体对象,且不能为空.table's entity(do not allow null).

orderFields - 排序字段列表,多个用逗号隔开.order fields,if more than one,separate with comma.

orderTypes - 排序类型列表

返回:

可包含多个有排序的实体(多条记录)的list. list which contains more than one entity.

update

<T> int update(T entity,
             String updateFields)

更新记录,且可以指定需要更新的字段.Update record, can list update fields.

参数:

entity - 实体类对象,不能为空.table's entity(do not allow null).

updateFields - 需要更新的字段列表,多个字段用逗号隔开(列表中有的字段都会更新),该属性不允许为空,
除了updateFields中声明要更新的字段,其它非空,非null的字段作为过滤条件,转成SQL的where表达式.
For the list of fields to be updated, multiple fields are separated by commas (those fields will be updated).
This attribute cannot be empty. By default, each field will be converted to a set expression of SQL update.

返回:

成功更新的记录数.the numbers of update record(s) successfully.

update

<T> int update(T entity,
             String updateFields,
             IncludeType includeType)

根据实体对象entity更新数据,可以指定需要更新的字段.Update record according to entity.

参数:

entity - 与表对应的实体对象,且不能为空.table's entity(do not allow null). id为null不作为过滤条件

updateFields - 需要更新的字段列表,多个字段用逗号隔开(列表中有的字段都会更新),该属性不允许为空,且不受includeType参数的影响,默认每个字段会被转化成SQL update的set表达式
For the list of fields to be updated, multiple fields are separated by commas (those fields will be updated).
This attribute cannot be empty and is not affected by the includeType parameter. By default, each field will be
converted to a set expression of SQL update.

includeType - 空字符串与null是否作为过滤条件.whether null string and null as a filter conditions.

返回:

成功更新的记录数.the numbers of update record(s) successfully.

insert

<T> int insert(T[] entity)

批量插入数据.Insert records by batch type.

参数:

entity - 与表对应的实体对象数组,且不能为空. table's entity array(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 array(do not allow null).

batchSize - 批操作数量大小.batch size.

返回:

成功插入的记录行数. 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 array(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 array(do not allow null).

batchSize - 批操作数量大小.batch size.

excludeFields - 声明不用插入的字段列表.Don't insert fields list.

返回:

成功插入的记录行数. the number of inserted record(s) successfully.

insert

<T> int insert(List<T> entityList)

批量插入数据.Insert records by batch type.

参数:

entityList - 与表对应的实体对象链表,且不能为空. table's entity list(do not allow null).

返回:

成功插入的记录行数. the number of inserted record(s) successfully.

从以下版本开始:

1.9

insert

<T> int insert(List<T> entityList,
             int batchSize)

批量插入数据.Insert records by batch type.

参数:

entityList - 与表对应的实体对象链表,且不能为空. table's entity list(do not allow null).

batchSize - 批操作数量大小.batch size.

返回:

成功插入的记录行数. the number of inserted record(s) successfully.

从以下版本开始:

1.9

insert

<T> int insert(List<T> entityList,
             String excludeFields)

批量插入数据,且可以声明不用插入的字段列表
Insert record by batch type,and can point out which field(s) don't need to insert.

参数:

entityList - 与表对应的实体对象链表,且不能为空. table's entity list(do not allow null).

excludeFields - 声明不用插入的字段列表.fields list that don't need to insert .

返回:

成功插入的记录行数. the number of inserted record(s) successfully.

从以下版本开始:

1.9

insert

<T> int insert(List<T> entityList,
             int batchSize,
             String excludeFields)

批量插入数据,且可以指定不用插入的字段列表
Insert record by batch type,and can point out which field(s) don't need to insert.

参数:

entityList - 与表对应的实体对象链表,且不能为空. table's entity list(do not allow null).

batchSize - 批操作数量大小.batch size.

excludeFields - 声明不用插入的字段列表.Don't insert fields list.

返回:

成功插入的记录行数. the number of inserted record(s) successfully.

从以下版本开始:

1.9

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中id更新该实体对象的数据.Update record according to entity.

参数:

entity - 与表对应的实体对象,且不能为空;entity中id字段不能为空,作为过虑条件.id为null将引发ObjSQLException.
table's entity(do not allow null),The id field in entity cannot be empty as a filtering condition.

includeType - 空字符串与null是否包含设置

返回:

成功更新的记录数.the numbers of update record(s) successfully.

insert

<T> int insert(T entity,
             IncludeType includeType)

根据实体对象entity插入数据.Insert record according to entity.

参数:

entity - 与表对应的实体对象,且不能为空.table's entity(do not allow null).

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不作为过滤条件.table's entity(do not allow 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不作为过滤条件.table's entity(do not allow null).

includeType - 空字符串与null是否包含设置

返回:

可包含多个实体(多条记录)的list转换成的json格式的字符串.
Json string, it transform from list which can contain more than one entity.

从以下版本开始:

1.1

selectById

<T> T selectById(T entity,
               Integer id)

根据id查询记录.Select record by id.

参数:

entity - 实体类对象,且不能为空.table's entity(do not allow null).

id - 实体id字段的值.value of entity's id field.

返回:

返回id对应的实体.return one entity which owns this id.

从以下版本开始:

1.9

selectById

<T> T selectById(T entity,
               Long id)

根据id查询记录.Select record by id.

参数:

entity - 实体类对象,且不能为空.table's entity(do not allow null).

id - 实体id字段的值.value of entity's id field.

返回:

返回id对应的实体.return one entity which owns this id.

从以下版本开始:

1.9

selectById

<T> T selectById(T entity,
               String id)

根据id查询记录.Select record by id.

参数:

entity - 实体类对象,且不能为空.table's entity(do not allow null).

id - 实体id字段的值.value of entity's id field.

返回:

返回id对应的实体.return one entity which owns this id.

从以下版本开始:

1.9

selectByIds

<T> List<T> selectByIds(T entity,
                      String ids)

根据id查询记录.Select record by id.

参数:

entity - 实体类对象,且不能为空.table's entity(do not allow null).

ids - 实体id字段的值,多个用逗号隔开.values of entity's id field,if more than one,separate with comma.

返回:

可包含多个实体(多条记录)的list. list which contains more than one entity.

从以下版本开始:

1.9

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,if more than one,separate with comma.

返回:

成功删除的记录行数. 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.can set includeType via condition.

根据实体对象entity查询数据.Select record according to entity.

参数:

entity - 与表对应的实体对象,且不能为空,id为null不作为过滤条件.table's entity(do not allow null).

includeType - 空字符串与null是否包含设置

condition - entity默认有值的字段会转成field=value的形式,其它形式可通过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

@Deprecated
<T> String selectJson(T entity,
                               IncludeType includeType,
                               Condition condition)

已过时。 selectJson(Object,Condition)方法中,可以通过condition设置includeType.can set includeType via condition.

根据实体对象entity查询数据,并以Json格式返回
Select and return data in Json format according to entity object.

参数:

entity - 与表对应的实体对象,且不能为空,id为null不作为过滤条件.table's entity(do not allow null).

includeType - 空字符串与null是否包含设置

condition - entity默认有值的字段会转成field=value的形式,其它形式可通过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

selectJson

<T> String selectJson(T entity,
                    Condition condition)

根据实体对象entity查询数据,并以Json格式返回
Select and return data in Json format according to entity object.

参数:

entity - 与表对应的实体对象,且不能为空, id为null不作为过滤条件.table's entity(do not allow null).

condition - entity默认有值的字段会转成field=value的形式,其它形式可通过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.9

updateBy

<T> int updateBy(T entity,
               String whereFields)

更新记录,且可以指定作为条件的字段.Update record according to whereFields.

参数:

entity - 实体类对象,不能为空.table's entity(do not allow null). 没指定为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是否作为过滤条件.whether null string and null as a filter conditions.

返回:

成功更新的记录数.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 - 实体类对象,不能为空.table's entity(do not allow null). 没指定为whereFields的字段,作为set部分(默认只处理非空,非null的字段)

whereFields - 作为SQL中where条件的字段列表,多个字段用逗号隔开(列表中有的字段都会作为条件); 指定作为条件的,都转换.id为null不作为过滤条件.
需要注意的是,用condition的op方法设置的条件,即使whereFields没有声明,也会转换.
Notice:the method op of condition also maybe converted to the where expression.

condition - 用来设置默认情况不能表达的条件. 若condition没有设置IncludeType,默认过滤NULL和空字符串(但condition中op,between,notBetween方法设置的字段,不受includeType的值影响.)

返回:

成功更新的记录数.the numbers of update record(s) successfully.

从以下版本开始:

1.7.2

updateById

<T> int updateById(T entity,
                 Condition condition)

此方法,相当于调用SuidRich接口的 updateBy(entity,"id",condition); it is equivalent to updateBy(entity,"id",condition)

参数:

entity - 实体类对象,不能为空.table's entity(do not allow null). entity中除了id字段,作为set部分(默认只处理非空,非null的字段)

condition - 用来设置默认情况不能表达的条件. 若condition没有设置IncludeType,默认过滤NULL和空字符串(但condition中op,between,notBetween方法设置的字段,不受includeType的值影响.)
需要注意的是,condition用op设置的条件,也有可能转换为where部分的过滤条件.

返回:

成功更新的记录数.the numbers of update record(s) successfully.

从以下版本开始:

1.9

update

<T> int update(T entity,
             String updateFields,
             Condition condition)

更新记录,且可以指定需要更新的字段,高级条件可通过Condition参数设置.Update record, can list update fields.

参数:

entity - 实体类对象,不能为空.table's entity(do not allow null). entity默认有值的字段会转成field=value的形式,其它形式可通过condition指定.
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中setMultiply,setAdd,set方法设置的字段不受此限制.The methods setMultiply,setAdd,set in condition are not subject to this restriction.
For the list of fields to be updated, multiple fields are separated by commas (those fields will be updated).
This attribute cannot be empty and is not affected by the includeType parameter. By default, each field will be
converted to a set expression of SQL update.

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)

更新记录,高级条件可通过Condition参数设置 Update record,and can help with Condition.
当SQL update的set表达式通过Condition定义时,可以不用再指定set使用的字段.

参数:

entity - 实体类对象,不能为空.table's entity(do not allow null). entity默认有值的字段会转成field=value的形式,其它形式可通过condition指定.
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

setDynamicParameter

SuidRich setDynamicParameter(String para,
                           String value)

为动态表名、实体名参数设置值.set dynamic parameter for dynamic table & entity name
本方法的调用要早于select,update,insert,delete等方法.
This method is called earlier than the select, update, insert, delete methods.
本方法与Suid接口中的同名方法效果一样,只是为了方便链式编程.
This method has the same effect as the same name method in suid interface,
only for the convenience of chain programming

指定者:

setDynamicParameter 在接口中 Suid

参数:

para - parameter name

value - parameter value

返回:

SuidRich

从以下版本开始:

1.9

exist

<T> boolean exist(T entity)

检测实体对应记录是否存在.Check whether the entity corresponding record exist

参数:

entity - 实体类对象,不能为空.table's entity(do not allow null).

返回:

true,if have the record;or return false.

从以下版本开始:

1.9