UpsertOperator (hsweb-easy-orm-rdb 4.1.1 API)

java.lang.Object
- org.hswebframework.ezorm.rdb.operator.dml.upsert.UpsertOperator

直接已知子类:

DefaultUpsertOperator
```
public abstract class UpsertOperator
extends Object
```
upsert 操作器,用于执行upsert请求

从以下版本开始:

4.0

作者:

zhouhao

构造器概要

构造器
构造器和说明

UpsertOperator()

构造器
构造器和说明
`UpsertOperator()`

方法概要

所有方法实例方法抽象方法具体方法
限定符和类型	方法和说明
`<T> UpsertOperator`	`columns(StaticMethodReferenceColumn<T>... columns)` 使用静态方法引用来描述列名,与`columns(String...)`一样的效果.
`abstract UpsertOperator`	`columns(String... columns)` 设置列,和`values(Object...)`配合使用,如: operator.columns("id","name") .values(id,name);
`abstract UpsertOperator`	`doNothingOnConflict(boolean doNothing)` 设置当数据已存在时是否不做任何操作,注意: 只有部分数据库支持此操作.
`abstract SaveResultOperator`	`execute()` 执行,调用此方法不会立即执行sql, 需要调用`SaveResultOperator.sync()`或者`SaveResultOperator.reactive()`来执行并获取结果.
`abstract UpsertOperator`	`ignoreUpdate(String... columns)` 忽略更新的列,如果是执行update,则忽略更新指定的列.
`UpsertOperator`	`value(Map<String,Object> values)` 使用Map来描述列和值,Map的key为列名,Map的值为值
`abstract UpsertOperator`	`value(String column, Object value)` 与`value(String, Object, boolean)`相同.默认不忽略更新.
`abstract UpsertOperator`	`value(String column, Object value, boolean ignoreUpdate)` 设置列名和值,不能与`columns(String...)`一起用,同时设置是否忽略更新列.
`abstract UpsertOperator`	`values(List<Map<String,Object>> values)` 使用Map来描述列和多个值
`<T> UpsertOperator`	`values(MethodReferenceColumn<T>... columns)` 使用方法引用来描述列和值.例如: User user = ....; operator.values(user::getId,user::getName);
`abstract UpsertOperator`	`values(Object... values)` 设置值列表,与`columns(String...)`配合使用
`abstract UpsertOperator`	`where(java.util.function.Consumer<Conditional<?>> dsl)` 指定当执行update时的条件

从类继承的方法 java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- 构造器详细资料
  - UpsertOperator
```
public UpsertOperator()
```
- 方法详细资料
  - columns
```
public abstract UpsertOperator columns(String... columns)
```
    设置列,和values(Object...)配合使用,如:
```
     operator.columns("id","name")
              .values(id,name);
 
```
    参数:
    
    columns - 列名
    
    返回:
    
    this
  - values
```
public abstract UpsertOperator values(Object... values)
```
    设置值列表,与columns(String...)配合使用
    
    参数:
    
    values - 值列表
    
    返回:
    
    this
  - ignoreUpdate
```
public abstract UpsertOperator ignoreUpdate(String... columns)
```
    忽略更新的列,如果是执行update,则忽略更新指定的列.
    
    参数:
    
    columns - 列名
    
    返回:
    
    this
    
    另请参阅:
    
    UpsertColumn#isUpdateIgnore()
  - value
```
public abstract UpsertOperator value(String column,
                                     Object value)
```
    与value(String, Object, boolean)相同.默认不忽略更新.
    
    参数:
    
    column - 列名
    
    value - 值
    
    返回:
    
    值
  - value
```
public abstract UpsertOperator value(String column,
                                     Object value,
                                     boolean ignoreUpdate)
```
    设置列名和值,不能与columns(String...)一起用,同时设置是否忽略更新列. 忽略更新的列在更新的时候不会执行更新.
    
    参数:
    
    column - 列名
    
    value - 值
    
    ignoreUpdate - 是否忽略更新列.
    
    返回:
    
    this
  - doNothingOnConflict
```
public abstract UpsertOperator doNothingOnConflict(boolean doNothing)
```
    设置当数据已存在时是否不做任何操作,注意: 只有部分数据库支持此操作.
    
    参数:
    
    doNothing - 是否不做任何操作
    
    返回:
    
    this
  - columns
```
@SafeVarargs
public final <T> UpsertOperator columns(StaticMethodReferenceColumn<T>... columns)
```
    使用静态方法引用来描述列名,与columns(String...)一样的效果. 例如:
```
     operator.columns(User::getId,User::getName)
              .values(id,name);
 
```
    类型参数:
    
    T - 方法所在类的类型
    
    参数:
    
    columns - 方法引用列
    
    返回:
    
    this
    
    另请参阅:
    
    StaticMethodReferenceColumn
  - values
```
@SafeVarargs
public final <T> UpsertOperator values(MethodReferenceColumn<T>... columns)
```
    使用方法引用来描述列和值.例如:
```
     User user = ....;
     operator.values(user::getId,user::getName);

 
```
    类型参数:
    
    T - 方法所在类的类型
    
    参数:
    
    columns - 列名
    
    返回:
    
    this
    
    另请参阅:
    
    MethodReferenceColumn
  - value
```
public UpsertOperator value(Map<String,Object> values)
```
    使用Map来描述列和值,Map的key为列名,Map的值为值
    
    参数:
    
    values - map
    
    返回:
    
    this
  - where
```
public abstract UpsertOperator where(java.util.function.Consumer<Conditional<?>> dsl)
```
    指定当执行update时的条件
    
    参数:
    
    dsl - 条件构造器
    
    返回:
    
    this
    
    从以下版本开始:
    
    4.0.10
  - values
```
public abstract UpsertOperator values(List<Map<String,Object>> values)
```
    使用Map来描述列和多个值
    
    参数:
    
    values - 多个值
    
    返回:
    
    this
  - execute
```
public abstract SaveResultOperator execute()
```
    执行,调用此方法不会立即执行sql, 需要调用SaveResultOperator.sync()或者SaveResultOperator.reactive()来执行并获取结果.
    
    返回:
    
    结果操作器

类 UpsertOperator

构造器概要

方法概要

从类继承的方法 java.lang.Object

构造器详细资料

UpsertOperator

方法详细资料

columns

values

ignoreUpdate

value

value

doNothingOnConflict

columns

values

value

where

values

execute