org.teasoft.bee.osql.api.cqrs

Interface Query

All Superinterfaces:

CommOperate

public interface Query
extends CommOperate

Query type API.

Since:

2.5.2

Author:

Kingstar

Method Summary

Modifier and Type	Method and Description
void	beginSameConnection() declare begin Same Connection for some ORM operation.
<T> int	count(T entity) total number of statistical records.
<T> int	count(T entity, Condition condition) total number of statistical records.
void	endSameConnection() declare end Same Connection for some ORM operation.
<T> boolean	exist(T entity) Check whether the entity corresponding record exist
<T> List<T>	select(T entity) According to entity object select records from database.
<T> List<T>	select(T entity, Condition condition) Select the records according to entity and condition.
<T> List<T>	select(T entity, int size) Select record(s) according to entity object,and can specify page information.
<T> List<T>	select(T entity, int start, int size) Select record(s) according to entity object,and can specify page information.
<T> List<T>	select(T entity, int start, int size, String... selectFields) Just select some fields,and can specify page information.
<T> List<T>	select(T entity, String... selectFields) Just select some fields.
<T> T	selectById(Class<T> entityClass, Integer id) Select record by id.
<T> T	selectById(Class<T> entityClazz, Long id) Select record by id.
<T> T	selectById(Class<T> entityClass, String id) Select record by id.
<T> List<T>	selectByIds(Class<T> entityClass, String ids) Select record by id.
<T> T	selectFirst(T entity, Condition condition) select the first record.
<T> String	selectJson(T entity) Select and return data in Json format according to entity object.
<T> String	selectJson(T entity, Condition condition) Select and return data in Json format according to entity object.
<T> String	selectJson(T entity, int start, int size, String... selectFields) Just select some fields,and can specify page information.
<T> String	selectJson(T entity, String... selectFields) Just select some fields,and return Json string.
<T> T	selectOne(T entity) Select one record,if the size do not equal one, return null.
<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) 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) Select result with one function,just select one function at a time.

Methods inherited from interface org.teasoft.bee.osql.CommOperate

getDataSourceName, getInterceptorChain, setDataSourceName, setNameTranslateOneTime

Method Detail

select

<T> List<T> select(T entity)

According to entity object select records from database.

Parameters:

entity - table's entity(do not allow null).
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

Returns:

list which contains more than one entity.

select

<T> List<T> select(T entity,
                   Condition condition)

Select the records according to entity and condition.

Parameters:

entity - table's entity(do not allow null).

condition - If the field of entity is not null or empty, it will be translate to field=value.Other can define with condition.

Returns:

list which contains more than one entity.

Since:

1.6

select

<T> List<T> select(T entity,
                   int size)

Select record(s) according to entity object,and can specify page information.

Parameters:

entity - table's entity(do not allow null).
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 - fetch result size (>0).

Returns:

list which contains more than one entity.

select

<T> List<T> select(T entity,
                   int start,
                   int size)

Select record(s) according to entity object,and can specify page information.

Parameters:

entity - table's entity(do not allow null).
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 - start index,min value is 0 or 1(eg:MySQL is 0,Oracle is 1).

size - fetch result size (>0).

Returns:

list can contain more than one entity

select

<T> List<T> select(T entity,
                   String... selectFields)

Just select some fields.

Parameters:

entity - table's entity(do not allow null).

selectFields - select fields,if more than one,separate with comma in one selectField parameter or use variable parameter.

Returns:

list which contains more than one entity.

select

<T> List<T> select(T entity,
                   int start,
                   int size,
                   String... selectFields)

Just select some fields,and can specify page information.

Parameters:

entity - table's entity(do not allow null).

start - start index,min value is 0 or 1(eg:MySQL is 0,Oracle is 1).

size - fetch result size (>0).

selectFields - select fields,if more than one,separate with comma in one selectField parameter or use variable parameter.

Returns:

list which contains more than one entity.

Since:

1.4.3, 2.0

selectString

<T> List<String[]> selectString(T entity)

Select entity,every field will return the string type.

Parameters:

entity - table's entity(do not allow null).

Returns:

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.

Parameters:

entity - table's entity(do not allow null).

selectFields - Select fields,if more than one,separate with comma in one selectField parameter or use variable parameter.

Returns:

list can contain more than one record with String array struct.

selectString

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

Instead of returning data in a entity structure, it uses a character array in List.

Parameters:

entity - table's entity(do not allow null).

condition - Condition as filter the record.

Returns:

list can contain more than one record with String array struct.

Since:

1.9

selectJson

<T> String selectJson(T entity)

Select and return data in Json format according to entity object.

Parameters:

entity - table's entity(do not allow null).
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

Returns:

Json string, it transform from list which can contain more than one entity.

Since:

1.1

selectOne

<T> T selectOne(T entity)

Select one record,if the size do not equal one, return null.

Parameters:

entity - table's entity(do not allow null).

Returns:

return one record,if the size do not equal one, return null.

selectFirst

<T> T selectFirst(T entity,
                  Condition condition)

select the first record.

Parameters:

entity - table's entity(do not allow null).

Returns:

return the first record

selectWithFun

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

Select result with one function,Just select one function.

Parameters:

entity - table's entity(do not allow null).

functionType - MAX,MIN,SUM,AVG,COUNT

fieldForFun - field for function.

Returns:

one function result.
If the result set of statistics is empty,the count return 0,the other return empty string.

selectWithFun

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

Select result with one function,just select one function at a time.

Parameters:

entity - table's entity(do not allow null).

functionType - MAX,MIN,SUM,AVG,COUNT

fieldForFun - field for function.

condition - Condition as filter the record.
here will ignore the condition's selectFun method.

Returns:

one function result.
If the result set of statistics is empty,the count return 0,the other return empty string.

Since:

1.9

count

<T> int count(T entity)

total number of statistical records.

Parameters:

entity - table's entity(do not allow null).

Returns:

total number of records that satisfy the condition.

Since:

1.9

count

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

total number of statistical records.

Parameters:

entity - table's entity(do not allow null).

condition - Condition as filter the record.

Returns:

total number of records that satisfy the condition.

Since:

1.9

selectOrderBy

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

Select result with order,order type default is:asc

Parameters:

entity - table's entity(do not allow null).

orderFields - order fields,if more than one,separate with comma.

Returns:

list which contains more than one entity.

selectOrderBy

<T> List<T> selectOrderBy(T entity,
                          String orderFields,
                          OrderType[] orderTypes)

Select result with order.

Parameters:

entity - table's entity(do not allow null).

orderFields - order fields,if more than one,separate with comma.

orderTypes - Sort type list.

Returns:

list which contains more than one entity.

selectJson

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

Select and return data in Json format according to entity object.

Parameters:

entity - table's entity(do not allow null).

condition - Condition as filter the record.

Returns:

Json string, it transform from list which can contain more than one entity.

Since:

1.9

selectJson

<T> String selectJson(T entity,
                      String... selectFields)

Just select some fields,and return Json string.

Parameters:

entity - table's entity(do not allow null).

selectFields - select fields,if more than one,separate with comma in one selectField parameter or use variable parameter.

Returns:

Json string, it transform from list which can contain more than one entity.

Since:

1.9.8

selectJson

<T> String selectJson(T entity,
                      int start,
                      int size,
                      String... selectFields)

Just select some fields,and can specify page information.

Parameters:

entity - table's entity(do not allow null).

start - start index,min value is 0 or 1(eg:MySQL is 0,Oracle is 1).

size - fetch result size (>0).

selectFields - select fields,if more than one,separate with comma in one selectField parameter or use variable parameter.

Returns:

Json string, it transform from list which can contain more than one entity.

Since:

1.9.8, 2.0

selectById

<T> T selectById(Class<T> entityClass,
                 Integer id)

Select record by id.

Parameters:

entityClass - table's entity class(do not allow null).

id - value of entity's id field.

Returns:

return one entity which owns this id.

Since:

1.9

selectById

<T> T selectById(Class<T> entityClazz,
                 Long id)

Select record by id.

Parameters:

entityClazz - table's entity class(do not allow null).
The property value of returnType will not be parsed.

id - value of entity's id field.

Returns:

return one entity which owns this id.

Since:

1.9

selectById

<T> T selectById(Class<T> entityClass,
                 String id)

Select record by id.

Parameters:

entityClass - table's entity class(do not allow null).
The property value of returnType will not be parsed.

id - value of entity's id field.

Returns:

return one entity which owns this id.

Since:

1.9

selectByIds

<T> List<T> selectByIds(Class<T> entityClass,
                        String ids)

Select record by id.

Parameters:

entityClass - table's entity class(do not allow null).
The property value of returnType will not be parsed.

ids - values of entity's id field,if more than one,separate with comma.

Returns:

list which contains more than one entity.

Since:

1.9

exist

<T> boolean exist(T entity)

Check whether the entity corresponding record exist

Parameters:

entity - table's entity(do not allow null).

Returns:

true,if have the record;or return false.

Since:

1.9

beginSameConnection

void beginSameConnection()

declare begin Same Connection for some ORM operation.

Since:

1.9

endSameConnection

void endSameConnection()

declare end Same Connection for some ORM operation.

Since:

1.9