Condition (QuickDAO 4.1.10 API)

所有超级接口:

Serializable

所有已知实现类:

AbstractCondition, OracleCondition, PostgreCondition, SQLServerCondition
```
public interface Condition<T>
extends Serializable
```
查询接口
本接口定义里单表查询接口,多表关联查询等方法

对于查询接口您需要知道以下几点
1. 实体类字段使用驼峰式命名映射到数据库中.例如字段firstName映射到数据库后字段名为first_name.
  如您使用了@ColumnName注解则以该注解设置的字段为准
2. 对于关联查询,主表别名为t,使用join方法添加的子表按照添加顺序依次为t1,t2,t3......
  如您使用了tableAliasName方法则以该方法设置的值为准
  
  关联查询默认关联主表中唯一一个类型为子表的成员变量.
```
         Parent{
             long id;
         }
         Child{
             long id;
             long parentId;
             Parent parent;
         }
         //关联Child类的唯一一个子表成员变量的parent属性
         joinTable(Parent.class,"parentId","id").compositField();
     
```
  若出现多个相同的子表成员变量,必须手动指定相应成员变量
```
         Parent{
             long id;
         }
         Child{
             long id;
             long fatherId;
             long motherId;

             Parent father;
             Parent mother;
         }
         //关联多个时需要手动指定
         joinTable(Parent.class,"fatherId","id","father").compositField();
         joinTable(Parent.class,"motherId","id","mother").compositField();
     
```
  若需返回关联实体字段,必须调用compositField方法
3. 当您调用getArray方法,返回字段名称均为表别名_字段名.例如主表中的firstName字段,则返回字段名称为t_first_name
4. 对于直接添加查询语句的方法,请注意查询语句参数将直接拼接到sql字符上,不会做任何转义操作,请注意SQL注入等安全问题

方法概要

所有方法实例方法抽象方法
限定符和类型	方法和说明
`Condition<T>`	`addBetweenQuery(String field, Object start, Object end)` 添加between语句
`Condition<T>`	`addColumn(Condition subQuery)` 添加select子查询
`Condition<T>`	`addColumn(Condition subQuery, String columnNameAlias)` 添加select子查询
`Condition<T>`	`addColumn(String... fields)` 添加自定义字段,具体映射规则请看Condition类的JavaDoc注释
`Condition<T>`	`addColumnExclude(String... excludeFields)` 添加指定排除字段外的主表字段此方法仅能调用一次,请一次性指定所有需要排除的字段
`Condition<T>`	`addEmptyQuery(String field)` 添加空查询
`Condition<T>`	`addExistSubQuery(Condition subQuery)` 添加exist子查询
`Condition<T>`	`addInQuery(String field, Collection values)` 添加范围查询语句
`Condition<T>`	`addInQuery(String field, Object... values)` 添加范围查询语句
`Condition<T>`	`addInQuery(String field, String inQuery)` 添加范围查询语句
`Condition<T>`	`addInsert(com.alibaba.fastjson.JSONArray array)` 批量插入记录,参数value的key值为数据库表对应的字段名称返回结果时每个arrayl里面的JSONObject的键generatedKeys会设置自增id的值
`Condition<T>`	`addInsert(com.alibaba.fastjson.JSONObject value)` 插入记录,参数value的key值为数据库表对应的字段名称返回结果时value的键generatedKeys会设置自增id的值
`Condition<T>`	`addInsert(String field, Object value)` 添加插入字段,用于`Response.insert()`方法
`Condition<T>`	`addLikeQuery(String field, Object value)` 添加Like查询
`Condition<T>`	`addNotEmptyQuery(String field)` 添加非空查询
`Condition<T>`	`addNotExistSubQuery(Condition subQuery)` 添加not exist子查询
`Condition<T>`	`addNotInQuery(String field, Collection values)` 添加范围查询语句
`Condition<T>`	`addNotInQuery(String field, Object... values)` 添加范围查询语句
`Condition<T>`	`addNotInQuery(String field, String inQuery)` 添加范围查询语句
`Condition<T>`	`addNotLikeQuery(String field, Object value)` 添加Not Like查询
`Condition<T>`	`addNotNullQuery(String field)` 添加非空查询
`Condition<T>`	`addNullQuery(String field)` 添加空查询
`Condition<T>`	`addQuery(String field, Object value)` 添加字段查询
`Condition<T>`	`addQuery(String field, String operator, Object value)` 添加字段查询
`Condition<T>`	`addRawQuery(String query, Object... parameterList)` 自定义查询语句,具体映射规则请看此`Condition`
`Condition<T>`	`addSubQuery(String field, String operator, Condition subQuery)` 添加where子查询
`Condition<T>`	`addUpdate(String field, Object value)` 添加更新字段,用于`Response.update()`方法
`Condition<T>`	`clone()` 执行并返回Response实例
`Condition<T>`	`compositField()` 返回子表实体类字段信息
`<E> SubCondition<E,T>`	`crossJoinTable(Class<E> clazz)` cross join 关联表,获取笛卡尔积调用本方法时请先查看Condition类JavaDoc注释
`SubCondition<?,T>`	`crossJoinTable(String tableName)` cross join 关联表,获取笛卡尔积调用本方法时请先查看Condition类JavaDoc注释
`Condition<T>`	`distinct()` 添加distinct关键字
`Response<T>`	`execute()` 执行并返回Response实例
`Query`	`getQuery()` 获取Condition信息
`Condition<T>`	`groupBy(String... fields)` 添加分组查询
`Condition<T>`	`having(String having, Object... parameterList)` 添加having查询调用本方法时请先查看Condition类JavaDoc注释
`Condition<T>`	`having(String field, String operator, Condition subQuery)` 添加having子查询调用本方法时请先查看Condition类JavaDoc注释
`<E> SubCondition<E,T>`	`joinTable(Class<E> clazz, String primaryField, String joinTableField)` 关联表查询调用本方法时请先查看Condition类JavaDoc注释
`<E> SubCondition<E,T>`	`joinTable(Class<E> clazz, String primaryField, String joinTableField, String compositField)` 关联表查询调用本方法时请先查看Condition类JavaDoc注释
`<E> SubCondition<E,T>`	`joinTable(Condition<E> joinCondition, String primaryField, String joinConditionField)` 关联子查询调用本方法时请先查看Condition类JavaDoc注释调用本方法将在sql语句中拼接如下字符串 join #{condition子表} as t1 on t.primaryField = t1.joinTableField
`SubCondition<?,T>`	`joinTable(String tableName, String primaryField, String joinTableField)` 关联表查询调用本方法时请先查看Condition类JavaDoc注释调用本方法将在sql语句中拼接如下字符串 join #{clazz} as t1 on t.primaryField = t1.joinTableField
`LambdaCondition<T>`	`lambdaCondition()` 获取lambdaCondition对象
`Condition<T>`	`limit(long offset, long limit)` 分页操作请注意,oracle数据库调用分页方法后请直接执行execute方法
`Condition<T>`	`or()` 添加Or查询条件,返回一个新的OrCondition对象在返回Condition对象上添加的查询条件,会以or(......)的方式拼接到SQL字符串上.
`Condition<T>`	`or(String or, Object... parameterList)` 添加or查询,具体映射规则请看此`Condition`
`Condition<T>`	`order(String field, String asc)` 设置指定字段排序方式
`Condition<T>`	`orderBy(String... field)` 根据指定字段升序排列
`Condition<T>`	`orderByDesc(String... field)` 根据指定字段降序排列
`Condition<T>`	`page(int pageNum, int pageSize)` 分页操作请注意,oracle数据库调用分页方法后请直接执行execute方法
`Condition<T>`	`perBatchCommit(int perBatchCommit)` 批量插入时单次批量插入个数
`Condition<T>`	`setColumnTypeMapping(ColumnTypeMapping columnTypeMapping)` 设置返回列类型转换
`Condition<T>`	`tableAliasName(String tableAliasName)` 设置主表别名
`Condition<T>`	`union(Condition<T> condition)` 添加联合查询,需确保返回字段个数和含义一致默认union类型为 union
`Condition<T>`	`union(Condition<T> condition, UnionType unionType)` 添加联合查询,需确保返回字段个数和含义一致

- 方法详细资料
  - tableAliasName
```
Condition<T> tableAliasName(String tableAliasName)
```
    设置主表别名
    
    参数:
    
    tableAliasName - 主表别名
  - 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,
                        String inQuery)
```
    添加范围查询语句
    
    参数:
    
    field - 字段名
    
    inQuery - 英文逗号隔开的字段值
  - addInQuery
```
Condition<T> addInQuery(String field,
                        Object... values)
```
    添加范围查询语句
    
    参数:
    
    field - 字段名
    
    values - 指明在该范围内的值
  - addInQuery
```
Condition<T> addInQuery(String field,
                        Collection values)
```
    添加范围查询语句
    
    参数:
    
    field - 字段名
    
    values - 指明在该范围内的值
  - addNotInQuery
```
Condition<T> addNotInQuery(String field,
                           String inQuery)
```
    添加范围查询语句
    
    参数:
    
    field - 字段名
    
    inQuery - 英文逗号隔开的字段值
  - addNotInQuery
```
Condition<T> addNotInQuery(String field,
                           Object... values)
```
    添加范围查询语句
    
    参数:
    
    field - 字段名
    
    values - 指明在不该范围内的值
  - addNotInQuery
```
Condition<T> addNotInQuery(String field,
                           Collection 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 - 字段值
  - addNotLikeQuery
```
Condition<T> addNotLikeQuery(String field,
                             Object value)
```
    添加Not Like查询
    
    参数:
    
    field - 字段名
    
    value - 字段值
  - addQuery
```
Condition<T> addQuery(String field,
                      Object value)
```
    添加字段查询
    
    参数:
    
    field - 字段名
    
    value - 字段值
  - addQuery
```
Condition<T> addQuery(String field,
                      String operator,
                      Object value)
```
    添加字段查询
    
    参数:
    
    field - 字段名
    
    operator - 操作符,可为>,>=,=,<<=
    
    value - 字段值
  - addRawQuery
```
Condition<T> addRawQuery(String query,
                         Object... parameterList)
```
    自定义查询语句,具体映射规则请看此Condition
    
    参数:
    
    query - 子查询条件,可使用?占位符
    
    parameterList - 占位符参数列表,可为null
  - addSubQuery
```
Condition<T> addSubQuery(String field,
                         String operator,
                         Condition subQuery)
```
    添加where子查询
    
    参数:
    
    field - 字段名
    
    operator - 操作符,可为>,>=,=,<<=
    
    subQuery - 子查询语句
  - addExistSubQuery
```
Condition<T> addExistSubQuery(Condition subQuery)
```
    添加exist子查询
    
    参数:
    
    subQuery - 子查询语句
  - addNotExistSubQuery
```
Condition<T> addNotExistSubQuery(Condition subQuery)
```
    添加not exist子查询
    
    参数:
    
    subQuery - 子查询语句
  - addColumn
```
Condition<T> addColumn(String... fields)
```
    添加自定义字段,具体映射规则请看Condition类的JavaDoc注释
    
    参数:
    
    fields - 自定义查询列
    
    另请参阅:
    
    Condition
  - addColumnExclude
```
Condition<T> addColumnExclude(String... excludeFields)
```
    添加指定排除字段外的主表字段
    此方法仅能调用一次,请一次性指定所有需要排除的字段
    
    参数:
    
    excludeFields - 指定主表排除字段
    
    另请参阅:
    
    Condition
  - setColumnTypeMapping
```
Condition<T> setColumnTypeMapping(ColumnTypeMapping columnTypeMapping)
```
    设置返回列类型转换
    
    参数:
    
    columnTypeMapping - 列类型转换函数,参数为列信息,返回列的类型
    
    另请参阅:
    
    Condition
  - addColumn
```
Condition<T> addColumn(Condition subQuery)
```
    添加select子查询
    
    参数:
    
    subQuery - 子查询
  - addColumn
```
Condition<T> addColumn(Condition subQuery,
                       String columnNameAlias)
```
    添加select子查询
    
    参数:
    
    subQuery - 子查询
    
    columnNameAlias - 指定子查询返回列名的别名
  - addInsert
```
Condition<T> addInsert(String field,
                       Object value)
```
    添加插入字段,用于Response.insert()方法
    
    参数:
    
    field - 待更新的字段
    
    value - 待更新字段的值
  - addInsert
```
Condition<T> addInsert(com.alibaba.fastjson.JSONObject value)
```
    插入记录,参数value的key值为数据库表对应的字段名称
    
    返回结果时value的键generatedKeys会设置自增id的值
    
    参数:
    
    value - 待插入记录
  - addInsert
```
Condition<T> addInsert(com.alibaba.fastjson.JSONArray array)
```
    批量插入记录,参数value的key值为数据库表对应的字段名称
    
    返回结果时每个arrayl里面的JSONObject的键generatedKeys会设置自增id的值
    
    参数:
    
    array - 待插入记录
  - addUpdate
```
Condition<T> addUpdate(String field,
                       Object value)
```
    添加更新字段,用于Response.update()方法
    
    参数:
    
    field - 待更新的字段
    
    value - 待更新字段的值
  - 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查询条件,返回一个新的OrCondition对象
    在返回Condition对象上添加的查询条件,会以or(......)的方式拼接到SQL字符串上.
```
     Condition condition= dao.query(User.class);
     condition.or().addQuery("username","quickdao")
               .addQuery("password","123456");
     //继续对主condition进行操作
     condition.....
 
```
    以上代码最终拼接字符串为
    or (t.username = 'quickado' and t.password = '123456')
  - or
```
Condition<T> or(String or,
                Object... parameterList)
```
    添加or查询,具体映射规则请看此Condition
    
    参数:
    
    or - or查询语句,可使用?占位符
    
    parameterList - 占位符参数值,无参数时可为null
  - groupBy
```
Condition<T> groupBy(String... fields)
```
    添加分组查询
    
    参数:
    
    fields - 分组字段
  - having
```
Condition<T> having(String having,
                    Object... parameterList)
```
    添加having查询
    调用本方法时请先查看Condition类JavaDoc注释
    
    参数:
    
    having - having查询子句,可使用?占位符
    
    parameterList - 占位符参数值
    
    另请参阅:
    
    Condition
  - having
```
Condition<T> having(String field,
                    String operator,
                    Condition subQuery)
```
    添加having子查询
    调用本方法时请先查看Condition类JavaDoc注释
    
    参数:
    
    field - 字段名
    
    operator - 操作符,可为>,>=,=,<<=
    
    subQuery - 子查询语句
  - crossJoinTable
```
<E> SubCondition<E,T> crossJoinTable(Class<E> clazz)
```
    cross join 关联表,获取笛卡尔积
    调用本方法时请先查看Condition类JavaDoc注释
    
    参数:
    
    clazz - 待关联的子表
  - crossJoinTable
```
SubCondition<?,T> crossJoinTable(String tableName)
```
    cross join 关联表,获取笛卡尔积
    调用本方法时请先查看Condition类JavaDoc注释
    
    参数:
    
    tableName - 待关联的子表
  - joinTable
```
<E> SubCondition<E,T> joinTable(Class<E> clazz,
                                String primaryField,
                                String joinTableField)
```
    关联表查询
    调用本方法时请先查看Condition类JavaDoc注释
    
    参数:
    
    clazz - 待关联的子表
    
    primaryField - 主表关联字段
    
    joinTableField - 子表关联字段
  - joinTable
```
<E> SubCondition<E,T> joinTable(Class<E> clazz,
                                String primaryField,
                                String joinTableField,
                                String compositField)
```
    关联表查询
    调用本方法时请先查看Condition类JavaDoc注释
    
    参数:
    
    clazz - 待关联的子表
    
    primaryField - 主表关联字段
    
    joinTableField - 子表关联字段
    
    compositField - 子表实体类成员变量名
  - joinTable
```
<E> SubCondition<E,T> joinTable(Condition<E> joinCondition,
                                String primaryField,
                                String joinConditionField)
```
    关联子查询
    调用本方法时请先查看Condition类JavaDoc注释
    
    调用本方法将在sql语句中拼接如下字符串
    
    join #{condition子表} as t1 on t.primaryField = t1.joinTableField
    
    参数:
    
    joinCondition - 关联Condition
    
    primaryField - 主表关联字段
    
    joinConditionField - 子查询关联字段
  - joinTable
```
SubCondition<?,T> joinTable(String tableName,
                            String primaryField,
                            String joinTableField)
```
    关联表查询
    调用本方法时请先查看Condition类JavaDoc注释
    
    调用本方法将在sql语句中拼接如下字符串
    
    join #{clazz} as t1 on t.primaryField = t1.joinTableField
    
    参数:
    
    tableName - 待关联的子表
    
    primaryField - 主表关联字段
    
    joinTableField - 子表关联字段
  - order
```
Condition<T> order(String field,
                   String asc)
```
    设置指定字段排序方式
    
    参数:
    
    field - 升序排列字段名
    
    asc - 排序方式,值为asc或者desc
  - orderBy
```
Condition<T> orderBy(String... field)
```
    根据指定字段升序排列
    
    参数:
    
    field - 升序排列字段名
  - orderByDesc
```
Condition<T> orderByDesc(String... field)
```
    根据指定字段降序排列
    
    参数:
    
    field - 降序排列字段名
  - limit
```
Condition<T> limit(long offset,
                   long limit)
```
    分页操作 请注意,oracle数据库调用分页方法后请直接执行execute方法
    
    参数:
    
    offset - 偏移量
    
    limit - 返回个数
  - page
```
Condition<T> page(int pageNum,
                  int pageSize)
```
    分页操作 请注意,oracle数据库调用分页方法后请直接执行execute方法
    
    参数:
    
    pageNum - 第几页
    
    pageSize - 每页个数
  - compositField
```
Condition<T> compositField()
```
    返回子表实体类字段信息
    
    另请参阅:
    
    cn.schoolwow.quickdao.query.condition.Condition#joinTable(Class, String, String)} ()}, cn.schoolwow.quickdao.query.condition.Condition#joinTable(Class, String, String, String)} ()}
  - perBatchCommit
```
Condition<T> perBatchCommit(int perBatchCommit)
```
    批量插入时单次批量插入个数
    
    参数:
    
    perBatchCommit - 指定单次批量插入个数
  - lambdaCondition
```
LambdaCondition<T> lambdaCondition()
```
    获取lambdaCondition对象
  - execute
```
Response<T> execute()
```
    执行并返回Response实例
  - clone
```
Condition<T> clone()
```
    执行并返回Response实例
  - getQuery
```
Query getQuery()
```
    获取Condition信息

接口 Condition<T>

方法概要

方法详细资料

tableAliasName

distinct

addNullQuery

addNotNullQuery

addEmptyQuery

addNotEmptyQuery

addInQuery

addInQuery

addInQuery

addNotInQuery

addNotInQuery

addNotInQuery

addBetweenQuery

addLikeQuery

addNotLikeQuery

addQuery

addQuery

addRawQuery

addSubQuery

addExistSubQuery

addNotExistSubQuery

addColumn

addColumnExclude

setColumnTypeMapping

addColumn

addColumn

addInsert

addInsert

addInsert

addUpdate

union

union

or

or

groupBy

having

having

crossJoinTable

crossJoinTable

joinTable

joinTable

joinTable

joinTable

order

orderBy

orderByDesc

limit

page

compositField

perBatchCommit

lambdaCondition

execute

clone

getQuery