Condition (QuickDAO 3.1 API)

所有已知实现类:

AbstractCondition, H2Condition, MySQLCondition, PostgreCondition, SQLiteCondition, SQLServerCondition
```
public interface Condition<T>
```
查询接口

字段概要

字段
限定符和类型字段和说明

static String mainTableAlias

字段
限定符和类型	字段和说明
`static String`	`mainTableAlias`

方法概要

所有方法实例方法抽象方法
限定符和类型	方法和说明
`Condition<T>`	`addAggerate(String aggerate, String field)` 添加聚合字段,用于`Response.getAggerateList()` 默认返回字段名为aggerate(field)
`Condition<T>`	`addAggerate(String aggerate, String field, String alias)` 添加聚合字段,用于`Response.getAggerateList()`
`Condition<T>`	`addBetweenQuery(String field, Object start, Object end)` 添加between语句
`Condition<T>`	`addColumn(String field)` 部分查询,用于`Response.getPartList()`
`Condition<T>`	`addColumns(String[] fields)` 部分查询,用于`Response.getPartList()`
`Condition<T>`	`addEmptyQuery(String field)` 添加空查询
`Condition<T>`	`addInQuery(String field, List values)` 添加范围查询语句
`Condition<T>`	`addInQuery(String field, Object[] values)` 添加范围查询语句
`Condition<T>`	`addJSONObjectQuery(com.alibaba.fastjson.JSONObject queryCondition)` 添加自定义查询条件 { {field}:{value},字段查询 {field}Start:{value},添加大于等于查询 {field}End:{value},添加小于等于查询 {field}LIKE:[array],添加Like查询 {field}IN:[array],添加IN查询 {field}NOTNULL:{value},添加not null查询 {field}NULL:{value},添加null查询 _orderBy:{value},升序排列 _orderByDesc:{value},降序排列 _pageNumber:{value},页码 _pageSize:{value},每页个数 //关联查询部分 _joinTables:[ { _class:{className} 关联类,例如top.cqscrb.courage.entity.User _primaryField:{primaryField} 主表关联字段 _joinTableField:{joinTableField} 子表关联字段 {field}:{value},字段查询 {field}Start:{value},添加大于等于查询 {field}End:{value},添加小于等于查询 {field}IN:[array],添加IN查询 {field}NOTNULL:{value},添加not null查询 {field}NULL:{value},添加null查询 _orderBy:{value},升序排列 _orderByDesc:{value},降序排列 _joinTables:[...] } ] }
`Condition<T>`	`addLikeQuery(String field, Object value)` 添加Like查询
`Condition<T>`	`addNotEmptyQuery(String field)` 添加非空查询
`Condition<T>`	`addNotInQuery(String field, List values)` 添加范围查询语句
`Condition<T>`	`addNotInQuery(String field, Object[] values)` 添加范围查询语句
`Condition<T>`	`addNotNullQuery(String field)` 添加非空查询
`Condition<T>`	`addNullQuery(String field)` 添加空查询
`Condition<T>`	`addQuery(String query)` 添加自定义查询条件调用此方法您需要知道以下几点实体类字段使用驼峰式命名映射到数据库中.例如字段firstName映射到数据库后字段名为first_name 对于所有的查询语句,主表别名为t,使用join方法添加的表按照添加顺序依次为t1,t2,t3......
`Condition<T>`	`addQuery(String field, Object value)` 添加字段查询
`Condition<T>`	`addQuery(String field, String operator, Object value)` 添加字段查询
`Condition<T>`	`addSpecialColumn(String field)` 自定义查询列,用于`Response.getPartList()`
`Condition<T>`	`addSpecialColumns(String[] fields)` 自定义查询列,用于`Response.getPartList()`
`Condition<T>`	`addUpdate(String field, Object value)` 添加更新字段,用于`Response.update()`方法
`Condition<T>`	`compositField()` 返回子表实体类字段信息
`Condition<T>`	`distinct()` 添加distinct关键字
`Condition<T>`	`excludeColumn(String field)` 排除部分字段,用于`Response.getPartList()`
`Condition<T>`	`excludeColumn(String[] fields)` 排除部分字段,用于`Response.getPartList()`
`Response<T>`	`execute()` 执行并返回Response实例
`Condition<T>`	`groupBy(String field)` 添加分组查询
`Condition<T>`	`groupBy(String[] fields)` 添加分组查询
`SubCondition<T>`	`joinTable(Class clazz, String primaryField, String joinTableField)` 关联表查询主表,表别名为t 子表,依据关联顺序别名依次为t1,t2,t3......
`SubCondition<T>`	`joinTable(Class clazz, String primaryField, String joinTableField, String compositField)` 关联表查询主表,表别名为t 子表,依据关联顺序别名依次为t1,t2,t3......
`Condition<T>`	`limit(long offset, long limit)` 分页操作
`Condition<T>`	`or()` 添加Or查询条件
`Condition<T>`	`orderBy(String field)` 根据指定字段升序排列
`Condition<T>`	`orderByDesc(String field)` 根据指定字段降序排列
`Condition<T>`	`page(int pageNum, int pageSize)` 分页操作
`Condition<T>`	`union(Condition<T> condition)` 添加联合查询,需确保返回字段个数和含义一致默认union类型为 union
`Condition<T>`	`union(Condition<T> condition, UnionType unionType)` 添加联合查询,需确保返回字段个数和含义一致

- 字段详细资料
  - mainTableAlias
```
static final String mainTableAlias
```
    另请参阅:
    
    常量字段值
- 方法详细资料
  - distinct
```
Condition<T> distinct()
```
    添加distinct关键字
  - addNullQuery
```
Condition<T> addNullQuery(String field)
```
    添加空查询
    
    参数:
    
    field - 指明哪个字段为Null
  - addNotNullQuery
```
Condition<T> addNotNullQuery(String field)
```
    添加非空查询
    
    参数:
    
    field - 指明哪个字段不为Null
  - addEmptyQuery
```
Condition<T> addEmptyQuery(String field)
```
    添加空查询
    
    参数:
    
    field - 指明哪个字段不为空字符串
  - addNotEmptyQuery
```
Condition<T> addNotEmptyQuery(String field)
```
    添加非空查询
    
    参数:
    
    field - 指明哪个字段不为空字符串
  - addInQuery
```
Condition<T> addInQuery(String field,
                        Object[] values)
```
    添加范围查询语句
    
    参数:
    
    field - 字段名
    
    values - 指明在该范围内的值
  - addInQuery
```
Condition<T> addInQuery(String field,
                        List values)
```
    添加范围查询语句
    
    参数:
    
    field - 字段名
    
    values - 指明在该范围内的值
  - addNotInQuery
```
Condition<T> addNotInQuery(String field,
                           Object[] values)
```
    添加范围查询语句
    
    参数:
    
    field - 字段名
    
    values - 指明在不该范围内的值
  - addNotInQuery
```
Condition<T> addNotInQuery(String field,
                           List values)
```
    添加范围查询语句
    
    参数:
    
    field - 字段名
    
    values - 指明在不该范围内的值
  - addBetweenQuery
```
Condition<T> addBetweenQuery(String field,
                             Object start,
                             Object end)
```
    添加between语句
    
    参数:
    
    field - 字段名
    
    start - 范围开始值
    
    end - 范围结束值
  - addLikeQuery
```
Condition<T> addLikeQuery(String field,
                          Object value)
```
    添加Like查询
    
    参数:
    
    field - 字段名
    
    value - 字段值
  - addQuery
```
Condition<T> addQuery(String query)
```
    添加自定义查询条件
    调用此方法您需要知道以下几点
    1. 实体类字段使用驼峰式命名映射到数据库中.例如字段firstName映射到数据库后字段名为first_name
    2. 对于所有的查询语句,主表别名为t,使用join方法添加的表按照添加顺序依次为t1,t2,t3......
    3. 返回字段名称均为表别名_字段名.例如主表中的firstName字段,则对应数据库返回列名为t_first_name
    4. 本方法的query参数将直接拼接到sql字符上,不会做任何转义操作,请注入SQL注入安全相关问题
    参数:
    
    query - 子查询条件
  - addQuery
```
Condition<T> addQuery(String field,
                      Object value)
```
    添加字段查询
    
    参数:
    
    field - 字段名
    
    value - 字段值
  - addQuery
```
Condition<T> addQuery(String field,
                      String operator,
                      Object value)
```
    添加字段查询
    
    参数:
    
    field - 字段名
    
    operator - 操作符,可为>,>=,=,<<=
    
    value - 字段值
  - addJSONObjectQuery
```
Condition<T> addJSONObjectQuery(com.alibaba.fastjson.JSONObject queryCondition)
```
    添加自定义查询条件
    { {field}:{value},字段查询 {field}Start:{value},添加大于等于查询 {field}End:{value},添加小于等于查询 {field}LIKE:[array],添加Like查询 {field}IN:[array],添加IN查询 {field}NOTNULL:{value},添加not null查询 {field}NULL:{value},添加null查询 _orderBy:{value},升序排列 _orderByDesc:{value},降序排列 _pageNumber:{value},页码 _pageSize:{value},每页个数 //关联查询部分 _joinTables:[ { _class:{className} 关联类,例如top.cqscrb.courage.entity.User _primaryField:{primaryField} 主表关联字段 _joinTableField:{joinTableField} 子表关联字段 {field}:{value},字段查询 {field}Start:{value},添加大于等于查询 {field}End:{value},添加小于等于查询 {field}IN:[array],添加IN查询 {field}NOTNULL:{value},添加not null查询 {field}NULL:{value},添加null查询 _orderBy:{value},升序排列 _orderByDesc:{value},降序排列 _joinTables:[...] } ] }
  - union
```
Condition<T> union(Condition<T> condition)
```
    添加联合查询,需确保返回字段个数和含义一致默认union类型为 union
    
    参数:
    
    condition - 联合查询条件
  - union
```
Condition<T> union(Condition<T> condition,
                   UnionType unionType)
```
    添加联合查询,需确保返回字段个数和含义一致
    
    参数:
    
    condition - 联合查询条件
    
    unionType - 指定union查询类型
    
    另请参阅:
    
    UnionType
  - or
```
Condition<T> or()
```
    添加Or查询条件
  - addUpdate
```
Condition<T> addUpdate(String field,
                       Object value)
```
    添加更新字段,用于Response.update()方法
    
    参数:
    
    field - 待更新的字段
    
    value - 待更新字段的值
  - addAggerate
```
Condition<T> addAggerate(String aggerate,
                         String field)
```
    添加聚合字段,用于Response.getAggerateList()
    
    默认返回字段名为aggerate(field)
    
    参数:
    
    aggerate - 聚合函数,例如COUNT,SUM,MAX,MIN,AVG
    
    field - 字段名
  - addAggerate
```
Condition<T> addAggerate(String aggerate,
                         String field,
                         String alias)
```
    添加聚合字段,用于Response.getAggerateList()
    
    参数:
    
    aggerate - COUNT,SUM,MAX,MIN,AVG
    
    field - 字段名
    
    alias - 聚合字段别名
  - groupBy
```
Condition<T> groupBy(String field)
```
    添加分组查询
    
    参数:
    
    field - 分组字段
  - groupBy
```
Condition<T> groupBy(String[] fields)
```
    添加分组查询
    
    参数:
    
    fields - 分组字段
  - joinTable
```
SubCondition<T> joinTable(Class clazz,
                          String primaryField,
                          String joinTableField)
```
    关联表查询
    - 主表,表别名为t
    - 子表,依据关联顺序别名依次为t1,t2,t3......
    调用本方法将在sql语句中拼接如下字符串 join #{clazz} as t1 on t.primaryField = t1.joinTableField
    
    本方法默认关联主表中唯一一个类型为子表的成员变量,若出现多个相同的子表成员变量,则会抛出异常.例如以下代码:
```
     Parent{
         long id;
     }
     Child{
         long id;
         long parentId;
         Parent parent;
     }
     joinTable(Parent.class,"parentId","id");
 
```
    本方法会自动关联Child类的唯一一个子表成员变量的parent属性
    
    注意:需要返回关联实体类字段时,需要调用compositField()方法才会返回关联实体类对象
    参数:
    
    clazz - 待关联的子表
    
    primaryField - 主表关联字段
    
    joinTableField - 子表关联字段
  - joinTable
```
SubCondition<T> joinTable(Class clazz,
                          String primaryField,
                          String joinTableField,
                          String compositField)
```
    关联表查询
    - 主表,表别名为t
    - 子表,依据关联顺序别名依次为t1,t2,t3......
    调用本方法将在sql语句中拼接如下字符串 join #{clazz} as t1 on t.primaryField = t1.joinTableField
    
    本方法用于手动指定需要关联的子表实体类成员变量名.当出现多个相同的子表成员变量,需要手动指定关联实体类成员变量.例如以下代码:
```
     Parent{
         long id;
     }
     Child{
         long id;
         long fatherId;
         long motherId;

         Parent father;
         Parent mother;
     }
     joinTable(Parent.class,"fatherId","id","father");
     joinTable(Parent.class,"motherId","id","mother");
 
```
    注意:需要返回关联实体类字段时,需要调用compositField()方法才会返回关联实体类对象
    参数:
    
    clazz - 待关联的子表
    
    primaryField - 主表关联字段
    
    joinTableField - 子表关联字段
    
    compositField - 子表实体类成员变量名
  - orderBy
```
Condition<T> orderBy(String field)
```
    根据指定字段升序排列
    
    参数:
    
    field - 升序排列字段名
  - orderByDesc
```
Condition<T> orderByDesc(String field)
```
    根据指定字段降序排列
    
    参数:
    
    field - 降序排列字段名
  - limit
```
Condition<T> limit(long offset,
                   long limit)
```
    分页操作
    
    参数:
    
    offset - 偏移量
    
    limit - 返回个数
  - page
```
Condition<T> page(int pageNum,
                  int pageSize)
```
    分页操作
    
    参数:
    
    pageNum - 第几页
    
    pageSize - 每页个数
  - addColumn
```
Condition<T> addColumn(String field)
```
    部分查询,用于Response.getPartList()
    
    参数:
    
    field - 待返回字段名数组
  - addColumns
```
Condition<T> addColumns(String[] fields)
```
    部分查询,用于Response.getPartList()
    
    参数:
    
    fields - 待返回字段名数组
  - excludeColumn
```
Condition<T> excludeColumn(String field)
```
    排除部分字段,用于Response.getPartList()
    
    参数:
    
    field - 待返回字段名数组
  - excludeColumn
```
Condition<T> excludeColumn(String[] fields)
```
    排除部分字段,用于Response.getPartList()
    
    参数:
    
    fields - 待返回字段名数组
  - addSpecialColumn
```
Condition<T> addSpecialColumn(String field)
```
    自定义查询列,用于Response.getPartList()
    
    参数:
    
    field - 自定义查询列
  - addSpecialColumns
```
Condition<T> addSpecialColumns(String[] fields)
```
    自定义查询列,用于Response.getPartList()
    
    参数:
    
    fields - 自定义查询列
  - compositField
```
Condition<T> compositField()
```
    返回子表实体类字段信息
    
    另请参阅:
    
    cn.schoolwow.quickdao.dao.condition.Condition#joinTable(Class, String, String)} ()}, cn.schoolwow.quickdao.dao.condition.Condition#joinTable(Class, String, String,String)} ()}
  - execute
```
Response<T> execute()
```
    执行并返回Response实例

接口 Condition<T>

字段概要

方法概要

字段详细资料

mainTableAlias

方法详细资料

distinct

addNullQuery

addNotNullQuery

addEmptyQuery

addNotEmptyQuery

addInQuery

addInQuery

addNotInQuery

addNotInQuery

addBetweenQuery

addLikeQuery

addQuery

addQuery

addQuery

addJSONObjectQuery

union

union

or

addUpdate

addAggerate

addAggerate

groupBy

groupBy

joinTable

joinTable

orderBy

orderByDesc

limit

page

addColumn

addColumns

excludeColumn

excludeColumn

addSpecialColumn

addSpecialColumns

compositField

execute