SqlBuilder (hutool-db 4.6.0 API)

java.lang.Object
- cn.hutool.db.sql.SqlBuilder

所有已实现的接口:

Builder<String>, Serializable
```
public class SqlBuilder
extends Object
implements Builder<String>
```
SQL构建器
首先拼接SQL语句，值使用 ? 占位
调用getParamValues()方法获得占位符对应的值

作者:

Looly

另请参阅:
序列化表格

嵌套类概要

嵌套类
限定符和类型类和说明

static class SqlBuilder.Join
SQL中多表关联用的关键字

嵌套类
限定符和类型	类和说明
`static class`	`SqlBuilder.Join` SQL中多表关联用的关键字

构造器概要

构造器
构造器和说明

SqlBuilder()

SqlBuilder(Wrapper wrapper)

构造器
构造器和说明
`SqlBuilder()`
`SqlBuilder(Wrapper wrapper)`

方法概要

方法
限定符和类型	方法和说明
`SqlBuilder`	`append(Object sqlFragment)` 追加SQL其它部分片段
`String`	`build()` 构建，默认打印SQL日志
`static SqlBuilder`	`create()` 创建SQL构建器
`static SqlBuilder`	`create(Wrapper wrapper)` 创建SQL构建器
`SqlBuilder`	`delete(String tableName)` 删除
`SqlBuilder`	`from(String... tableNames)` 添加 from语句
`String[]`	`getFieldArray()` 获得插入或更新的数据库字段列表
`List<String>`	`getFields()` 获得插入或更新的数据库字段列表
`Object[]`	`getParamValueArray()` 获得占位符对应的值列表
`List<Object>`	`getParamValues()` 获得占位符对应的值列表
`SqlBuilder`	`groupBy(String... fields)` 分组
`SqlBuilder`	`having(LogicalOperator logicalOperator, Condition... conditions)` 添加Having语句
`SqlBuilder`	`having(String having)` 添加Having语句
`<T> SqlBuilder`	`in(String field, T... values)` 多值选择
`SqlBuilder`	`insert(Entity entity)` 插入，使用默认的ANSI方言
`SqlBuilder`	`insert(Entity entity, DialectName dialectName)` 插入插入会忽略空的字段名及其对应值，但是对于有字段名对应值为`null`的情况不忽略
`SqlBuilder`	`insertPreFragment(Object sqlFragment)` 在SQL的开头补充SQL片段
`SqlBuilder`	`join(String tableName, SqlBuilder.Join join)` 多表关联
`SqlBuilder`	`on(LogicalOperator logicalOperator, Condition... conditions)` 配合JOIN的 ON语句，多表关联的条件语句只支持单一的逻辑运算符（例如多个条件之间）
`SqlBuilder`	`on(String on)` 配合JOIN的 ON语句，多表关联的条件语句只支持单一的逻辑运算符（例如多个条件之间）
`SqlBuilder`	`orderBy(Order... orders)` 排序
`SqlBuilder`	`query(Query query)` 构建查询SQL
`SqlBuilder`	`select(boolean isDistinct, Collection<String> fields)` 查询
`SqlBuilder`	`select(boolean isDistinct, String... fields)` 查询
`SqlBuilder`	`select(Collection<String> fields)` 查询（非Distinct）
`SqlBuilder`	`select(String... fields)` 查询（非Distinct）
`String`	`toString()`
`SqlBuilder`	`update(Entity entity)` 更新
`SqlBuilder`	`where(Condition... conditions)` 添加Where语句，所有逻辑之间为AND的关系
`SqlBuilder`	`where(LogicalOperator logicalOperator, Condition... conditions)` 添加Where语句只支持单一的逻辑运算符（例如多个条件之间）
`SqlBuilder`	`where(String where)` 添加Where语句

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

- 构造器详细资料
  - SqlBuilder
```
public SqlBuilder()
```
  - SqlBuilder
```
public SqlBuilder(Wrapper wrapper)
```
- 方法详细资料
  - create
```
public static SqlBuilder create()
```
    创建SQL构建器
    
    返回:
    SQL构建器
  - create
```
public static SqlBuilder create(Wrapper wrapper)
```
    创建SQL构建器
    
    参数:
    wrapper - 包装器
    
    返回:
    SQL构建器
  - insert
```
public SqlBuilder insert(Entity entity)
```
    插入，使用默认的ANSI方言
    
    参数:
    entity - 实体
    
    返回:
    自己
  - insert
```
public SqlBuilder insert(Entity entity,
                DialectName dialectName)
```
    插入
    插入会忽略空的字段名及其对应值，但是对于有字段名对应值为null的情况不忽略
    
    参数:
    entity - 实体
    dialectName - 方言名
    
    返回:
    自己
  - delete
```
public SqlBuilder delete(String tableName)
```
    删除
    
    参数:
    tableName - 表名
    
    返回:
    自己
  - update
```
public SqlBuilder update(Entity entity)
```
    更新
    
    参数:
    entity - 要更新的实体
    
    返回:
    自己
  - select
```
public SqlBuilder select(boolean isDistinct,
                String... fields)
```
    查询
    
    参数:
    isDistinct - 是否添加DISTINCT关键字（查询唯一结果）
    fields - 查询的字段
    
    返回:
    自己
  - select
```
public SqlBuilder select(boolean isDistinct,
                Collection<String> fields)
```
    查询
    
    参数:
    isDistinct - 是否添加DISTINCT关键字（查询唯一结果）
    fields - 查询的字段
    
    返回:
    自己
  - select
```
public SqlBuilder select(String... fields)
```
    查询（非Distinct）
    
    参数:
    fields - 查询的字段
    
    返回:
    自己
  - select
```
public SqlBuilder select(Collection<String> fields)
```
    查询（非Distinct）
    
    参数:
    fields - 查询的字段
    
    返回:
    自己
  - from
```
public SqlBuilder from(String... tableNames)
```
    添加 from语句
    
    参数:
    tableNames - 表名列表（多个表名用于多表查询）
    
    返回:
    自己
  - where
```
public SqlBuilder where(Condition... conditions)
```
    添加Where语句，所有逻辑之间为AND的关系
    
    参数:
    conditions - 条件，当条件为空时，只添加WHERE关键字
    
    返回:
    自己
    从以下版本开始:
    
    4.4.4
  - where
```
public SqlBuilder where(LogicalOperator logicalOperator,
               Condition... conditions)
```
    添加Where语句
    只支持单一的逻辑运算符（例如多个条件之间）
    
    参数:
    logicalOperator - 逻辑运算符
    conditions - 条件，当条件为空时，只添加WHERE关键字
    
    返回:
    自己
  - where
```
public SqlBuilder where(String where)
```
    添加Where语句
    
    参数:
    where - WHERE语句之后跟的条件语句字符串
    
    返回:
    自己
  - in
```
public <T> SqlBuilder in(String field,
                T... values)
```
    多值选择
    
    类型参数:
    T - 值类型
    参数:
    field - 字段名
    values - 值列表
    
    返回:
    自身
  - groupBy
```
public SqlBuilder groupBy(String... fields)
```
    分组
    
    参数:
    fields - 字段
    
    返回:
    自己
  - having
```
public SqlBuilder having(LogicalOperator logicalOperator,
                Condition... conditions)
```
    添加Having语句
    
    参数:
    logicalOperator - 逻辑运算符
    conditions - 条件
    
    返回:
    自己
  - having
```
public SqlBuilder having(String having)
```
    添加Having语句
    
    参数:
    having - 条件语句
    
    返回:
    自己
  - orderBy
```
public SqlBuilder orderBy(Order... orders)
```
    排序
    
    参数:
    orders - 排序对象
    
    返回:
    自己
  - join
```
public SqlBuilder join(String tableName,
              SqlBuilder.Join join)
```
    多表关联
    
    参数:
    tableName - 被关联的表名
    join - 内联方式
    
    返回:
    自己
  - on
```
public SqlBuilder on(LogicalOperator logicalOperator,
            Condition... conditions)
```
    配合JOIN的 ON语句，多表关联的条件语句
    只支持单一的逻辑运算符（例如多个条件之间）
    
    参数:
    logicalOperator - 逻辑运算符
    conditions - 条件
    
    返回:
    自己
  - on
```
public SqlBuilder on(String on)
```
    配合JOIN的 ON语句，多表关联的条件语句
    只支持单一的逻辑运算符（例如多个条件之间）
    
    参数:
    on - 条件
    
    返回:
    自己
  - insertPreFragment
```
public SqlBuilder insertPreFragment(Object sqlFragment)
```
    在SQL的开头补充SQL片段
    
    参数:
    sqlFragment - SQL片段
    
    返回:
    this
    从以下版本开始:
    
    4.1.3
  - append
```
public SqlBuilder append(Object sqlFragment)
```
    追加SQL其它部分片段
    
    参数:
    sqlFragment - SQL其它部分片段
    
    返回:
    this
  - query
```
public SqlBuilder query(Query query)
```
    构建查询SQL
    
    参数:
    query - Query
    
    返回:
    this
  - getFields
```
public List<String> getFields()
```
    获得插入或更新的数据库字段列表
    
    返回:
    插入或更新的数据库字段列表
  - getFieldArray
```
public String[] getFieldArray()
```
    获得插入或更新的数据库字段列表
    
    返回:
    插入或更新的数据库字段列表
  - getParamValues
```
public List<Object> getParamValues()
```
    获得占位符对应的值列表
    
    返回:
    占位符对应的值列表
  - getParamValueArray
```
public Object[] getParamValueArray()
```
    获得占位符对应的值列表
    
    返回:
    占位符对应的值列表
  - build
```
public String build()
```
    构建，默认打印SQL日志
    
    指定者:
    
    build 在接口中 Builder<String>
    
    返回:
    构建好的SQL语句
  - toString
```
public String toString()
```
    覆盖:
    
    toString 在类中 Object

类 SqlBuilder

嵌套类概要

构造器概要

方法概要

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

构造器详细资料

SqlBuilder

SqlBuilder

方法详细资料

create

create

insert

insert

delete

update

select

select

select

select

from

where

where

where

in

groupBy

having

having

orderBy

join

on

on

insertPreFragment

append

query

getFields

getFieldArray

getParamValues

getParamValueArray

build

toString