Condition (Bee 1.9.5 API)

所有超级接口:

ConditionAssistant
```
public interface Condition
extends ConditionAssistant
```
为面向对象方式操作数据库提供封装的条件.Condition for operate DB with Object Oriented Programming way.
用户需要保证SQL的书写顺序,如order by应在group by的后面.
setMultiply,setAdd,set等方法仅用于SQL Update语句的set部分.
Users need to ensure the order of SQL writing, such as order by should be behind group by.
The methods setMultiply,setAdd,set just use in SQL Update 'set' part.

从以下版本开始:

1.6

作者:

Kingstar

方法概要

方法
限定符和类型	方法和说明
`Condition`	`and()` 默认自动加 'and'.Default will automatically add 'and'.
`Condition`	`between(String field, Number low, Number high)`
`Condition`	`between(String field, String low, String high)` between
`Condition`	`forUpdate()` 锁定查询的部分记录(仅用于SQL的单个表select).lock the select record with 'for update'.
`Condition`	`groupBy(String field)` group by
`Condition`	`having(FunctionType functionType, String field, Op Op, Number value)` having eg: having(FunctionType.MIN, "field", Op.ge, 60)-->having min(field)>=60
`Condition`	`lParentheses()` 添加左括号.Add left parentheses.
`Condition`	`notBetween(String field, Number low, Number high)` not between
`Condition`	`notBetween(String field, String low, String high)` not between
`Condition`	`op(String field, Op Op, Object value)` 添加一个表达式条件.Add a expression condition.
`Condition`	`opWithField(String field1, Op Op, String field2)` 添加一个表达式条件.Add a expression condition.
`Condition`	`or()` 添加 'or'.Add 'or'.
`Condition`	`orderBy(FunctionType functionType, String field, OrderType orderType)` order by eg: orderBy(FunctionType.MAX, "total", OrderType.DESC)-->order by max(total) desc
`Condition`	`orderBy(String field)` order by eg: orderBy("price")-->order by price
`Condition`	`orderBy(String field, OrderType orderType)` order by eg: orderBy("price", OrderType.DESC)-->order by price desc
`Condition`	`rParentheses()` 添加右括号.Add right parentheses.
`Condition`	`selectDistinctField(String fieldName)` 设置字段fieldName为distinct(fieldName) eg: selectDistinctField(fieldName) --> distinct(fieldName)
`Condition`	`selectDistinctField(String fieldName, String alias)` 设置字段fieldName为distinct(fieldName) eg: selectDistinctField(fieldName,alias) --> distinct(fieldName) as alias
`Condition`	`selectField(String fieldList)` 指定需要查询的部分字段(仅用于SQL的select).Specify the partial fields to be queried (only for select of SQL).
`Condition`	`selectFun(FunctionType functionType, String fieldForFun)` 设置使用函数查询结果.set select result with function.
`Condition`	`selectFun(FunctionType functionType, String fieldForFun, String alias)` 设置使用函数查询结果.set select result with function.
`Condition`	`set(String fieldName, Number num)` 设置需要更新的字段(仅用于SQL的update set);当要更新的字段也需要用于where条件时,可用该方法 Set the fields that need to be updated (only for update of SQL ); this method can be used when the set fields also need to be used for the where expression.
`Condition`	`set(String fieldName, String value)` 设置需要更新的字段(仅用于SQL的update set);当要更新的字段也需要用于where条件时,可用该方法 Set the fields that need to be updated (only for update of SQL); this method can be used when the set fields also need to be used for the where expression.
`Condition`	`setAdd(String field, Number num)` 设置需要更新的字段(仅用于SQL的update set),字段在自身基础上变化.Set the fields to be updated (for only update of SQL),and the field change on itself.
`Condition`	`setAdd(String field, String otherFieldName)` 设置需要更新的字段(仅用于SQL的update set),字段在自身基础上变化.Set the fields to be updated (for only update of SQL),and the field change on itself.
`Condition`	`setIncludeType(IncludeType includeType)` 设置IncludeType过滤参数.op,between,notBetween方法设置的字段,不受includeType的值影响.Set IncludeType.
`Condition`	`setMultiply(String field, Number num)` 设置需要更新的字段(仅用于SQL的update set),字段在自身基础上变化.Set the fields to be updated (for only update of SQL),and the field change on itself.
`Condition`	`setMultiply(String field, String otherFieldName)` 设置需要更新的字段(仅用于SQL的update set),字段在自身基础上变化.Set the fields to be updated (for only update of SQL),and the field change on itself.
`Condition`	`setWithField(String field1, String field2)` set one field with other field value eg: setWithField(field1,field2)--> set field1=field2
`Condition`	`size(Integer size)` 添加用于分页时设置每页返回的记录数量(仅用于SQL的select).For setting the size of the page(only for select of SQL).
`Condition`	`start(Integer start)` 添加用于分页时设置开始的页数(仅用于SQL的select).For setting the start of the page(only for select of SQL).

从接口继承的方法 org.teasoft.bee.osql.ConditionAssistant
getForUpdate, getIncludeType, getSelectField, getUpdatefields, getWhereFields, setSuidType

- 方法详细资料
  - start
```
Condition start(Integer start)
```
    添加用于分页时设置开始的页数(仅用于SQL的select).For setting the start of the page(only for select of SQL).
    无书写顺序限制.There is no restriction on writing order.
    
    参数:
    start - 开始下标(从0或1开始,eg:MySQL是0,Oracle是1). start index,min value is 0 or 1(eg:MySQL is 0,Oracle is 1).
    
    返回:
    Condition
  - size
```
Condition size(Integer size)
```
    添加用于分页时设置每页返回的记录数量(仅用于SQL的select).For setting the size of the page(only for select of SQL).
    无书写顺序限制.There is no restriction on writing order.
    
    参数:
    size - 结果集大小大于等于1. fetch result size (>0).
    
    返回:
    Condition
  - setIncludeType
```
Condition setIncludeType(IncludeType includeType)
```
    设置IncludeType过滤参数.op,between,notBetween方法设置的字段,不受includeType的值影响.Set IncludeType.
    如果Condition没有使用该方法设置,则按默认过滤方式处理.
    无书写顺序限制.There is no restriction on writing order.
    
    参数:
    includeType -
    
    返回:
    Condition
    从以下版本开始:
    
    1.7
  - op
```
Condition op(String field,
           Op Op,
           Object value)
```
    添加一个表达式条件.Add a expression condition.
    此方法不能用于SQL的update set.
    
    参数:
    field - 字段名.field name
    Op - 操作符.operator.
    value - 字段对应的值.value of the field.
    
    返回:
    Condition
  - opWithField
```
Condition opWithField(String field1,
                    Op Op,
                    String field2)
```
    添加一个表达式条件.Add a expression condition.
    此方法不能用于SQL的update set. eg: opWithField(field1,Op.gt,field2)-->where field1>field2
    
    参数:
    field1 - first field
    Op - 操作符.operator.
    field2 - second field
    
    返回:
    Condition
    从以下版本开始:
    
    1.9
  - and
```
Condition and()
```
    默认自动加 'and'.Default will automatically add 'and'.
    
    返回:
    Condition
  - or
```
Condition or()
```
    添加 'or'.Add 'or'.
    
    返回:
    Condition
  - lParentheses
```
Condition lParentheses()
```
    添加左括号.Add left parentheses.
    
    返回:
    Condition
  - rParentheses
```
Condition rParentheses()
```
    添加右括号.Add right parentheses.
    
    返回:
    Condition
  - between
```
Condition between(String field,
                Number low,
                Number high)
```
    参数:
    field -
    low -
    high -
    
    返回:
    Condition
  - notBetween
```
Condition notBetween(String field,
                   Number low,
                   Number high)
```
    not between
    
    参数:
    field -
    low -
    high -
    
    返回:
    Condition
  - between
```
Condition between(String field,
                String low,
                String high)
```
    between
    
    参数:
    field -
    low -
    high -
    
    返回:
    Condition
  - notBetween
```
Condition notBetween(String field,
                   String low,
                   String high)
```
    not between
    
    参数:
    field -
    low -
    high -
    
    返回:
    Condition
  - groupBy
```
Condition groupBy(String field)
```
    group by
    
    参数:
    field -
    
    返回:
    Condition
  - having
```
Condition having(FunctionType functionType,
               String field,
               Op Op,
               Number value)
```
    having eg: having(FunctionType.MIN, "field", Op.ge, 60)-->having min(field)>=60
    
    参数:
    functionType - SQL函数类型
    field - 实体字段,会被命名转换(如果需要).
    Op - 操作类型
    value - 值
    
    返回:
    Condition
  - orderBy
```
Condition orderBy(String field)
```
    order by eg: orderBy("price")-->order by price
    
    参数:
    field - 用于排序的字段名.field name.
    
    返回:
    Condition
  - orderBy
```
Condition orderBy(String field,
                OrderType orderType)
```
    order by eg: orderBy("price", OrderType.DESC)-->order by price desc
    
    参数:
    field - 用于排序的字段名.field name.
    orderType - 排序类型(asc或desc). order type(asc or desc)
    
    返回:
    Condition
  - orderBy
```
Condition orderBy(FunctionType functionType,
                String field,
                OrderType orderType)
```
    order by eg: orderBy(FunctionType.MAX, "total", OrderType.DESC)-->order by max(total) desc
    
    参数:
    functionType - SQL函数类型.Function type of SQL.
    field - 用于排序的字段名.field name.
    orderType - 排序类型(asc或desc). order type(asc or desc)
    
    返回:
    Condition
  - setAdd
```
Condition setAdd(String field,
               Number num)
```
    设置需要更新的字段(仅用于SQL的update set),字段在自身基础上变化.Set the fields to be updated (for only update of SQL),and the field change on itself.
    eg: setAdd("price",2.0)--> price=price+2.0
    
    参数:
    field -
    num -
    
    返回:
    Condition
    从以下版本开始:
    
    1.7.2
  - setMultiply
```
Condition setMultiply(String field,
                    Number num)
```
    设置需要更新的字段(仅用于SQL的update set),字段在自身基础上变化.Set the fields to be updated (for only update of SQL),and the field change on itself.
    eg: setMultiply("price",1.05)--> price=price*1.05
    
    参数:
    field -
    num -
    
    返回:
    Condition
    从以下版本开始:
    
    1.7.2
  - setAdd
```
Condition setAdd(String field,
               String otherFieldName)
```
    设置需要更新的字段(仅用于SQL的update set),字段在自身基础上变化.Set the fields to be updated (for only update of SQL),and the field change on itself.
    eg:setAdd("price","delta")--> price=price+delta
    
    参数:
    field -
    otherFieldName -
    
    返回:
    Condition
    从以下版本开始:
    
    1.8
  - setMultiply
```
Condition setMultiply(String field,
                    String otherFieldName)
```
    设置需要更新的字段(仅用于SQL的update set),字段在自身基础上变化.Set the fields to be updated (for only update of SQL),and the field change on itself.
    eg: setMultiply("price","delta")--> price=price*delta
    
    参数:
    field -
    otherFieldName - other fieldName
    
    返回:
    Condition
    从以下版本开始:
    
    1.8
  - set
```
Condition set(String fieldName,
            Number num)
```
    设置需要更新的字段(仅用于SQL的update set);当要更新的字段也需要用于where条件时,可用该方法
    Set the fields that need to be updated (only for update of SQL ); this method can be used when the set fields also need to be used for the where expression.
    eg: set("maxid", 1000)-->maxid=1000
    
    参数:
    fieldName - field name
    num -
    
    返回:
    Condition
    从以下版本开始:
    
    1.8
  - set
```
Condition set(String fieldName,
            String value)
```
    设置需要更新的字段(仅用于SQL的update set);当要更新的字段也需要用于where条件时,可用该方法
    Set the fields that need to be updated (only for update of SQL); this method can be used when the set fields also need to be used for the where expression.
    eg: set("name", 'bee')-->name='bee'
    
    参数:
    fieldName -
    value -
    
    返回:
    Condition
    从以下版本开始:
    
    1.8
  - setWithField
```
Condition setWithField(String field1,
                     String field2)
```
    set one field with other field value eg: setWithField(field1,field2)--> set field1=field2
    
    参数:
    field1 - first field
    field2 - second field
    
    返回:
    Condition
    从以下版本开始:
    
    1.9
  - selectField
```
Condition selectField(String fieldList)
```
    指定需要查询的部分字段(仅用于SQL的select).Specify the partial fields to be queried (only for select of SQL).
    
    参数:
    fieldList - 需要查询的字段,多个用逗号隔开. select fields,if more than one,separate with comma.
    
    返回:
    Condition
    从以下版本开始:
    
    1.8
  - selectDistinctField
```
Condition selectDistinctField(String fieldName)
```
    设置字段fieldName为distinct(fieldName) eg: selectDistinctField(fieldName) --> distinct(fieldName)
    
    参数:
    fieldName - 要设置为distinct的字段
    
    返回:
    Condition
    从以下版本开始:
    
    1.9
  - selectDistinctField
```
Condition selectDistinctField(String fieldName,
                            String alias)
```
    设置字段fieldName为distinct(fieldName) eg: selectDistinctField(fieldName,alias) --> distinct(fieldName) as alias
    
    参数:
    fieldName - 要设置为distinct的字段
    alias - 别名
    
    返回:
    Condition
    从以下版本开始:
    
    1.9
  - selectFun
```
Condition selectFun(FunctionType functionType,
                  String fieldForFun)
```
    设置使用函数查询结果.set select result with function.
    eg: condition.selectFun(FunctionType.COUNT, "*");-->count(*)
    
    参数:
    functionType - SQL函数类型.Function type of SQL.
    fieldForFun - 用于函数统计的字段名.field name for function.
    
    返回:
    Condition
    从以下版本开始:
    
    1.9
  - selectFun
```
Condition selectFun(FunctionType functionType,
                  String fieldForFun,
                  String alias)
```
    设置使用函数查询结果.set select result with function.
    eg:selectFun(FunctionType.MAX, "score","maxScore")-->max(score) as maxScore
    
    参数:
    functionType - SQL函数类型.Function type of SQL.
    fieldForFun - 用于函数统计的字段名.field name for function.
    alias - 统计结果的别名.alias name for the function result.
    
    返回:
    Condition
    从以下版本开始:
    
    1.9
  - forUpdate
```
Condition forUpdate()
```
    锁定查询的部分记录(仅用于SQL的单个表select).lock the select record with 'for update'.
    无书写顺序限制.There is no restriction on writing order.
    
    返回:
    Condition
    从以下版本开始:
    
    1.8

接口 Condition

方法概要

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

方法详细资料

start

size

setIncludeType

op

opWithField

and

or

lParentheses

rParentheses

between

notBetween

between

notBetween

groupBy

having

orderBy

orderBy

orderBy

setAdd

setMultiply

setAdd

setMultiply

set

set

setWithField

selectField

selectDistinctField

selectDistinctField

selectFun

selectFun

forUpdate