[0.3.7] 修复Javadoc错误

[0.3.7] 版本更新
- `[A]` 为 UpdateBuilder 添加 `#addColumnValue(String,Object)` 方法。 - `[A]` 补充部分Builder的JavaDoc。
2026-06-05 09:01:26 +08:00 · 2022-02-11 21:25:40 +08:00 · 2022-02-11 21:22:03 +08:00 · 2022-02-11 21:19:58 +08:00 · 2022-02-11 21:12:32 +08:00 · 2022-02-10 20:49:05 +08:00
19 changed files with 616 additions and 240 deletions
@@ -1,3 +1,14 @@
 # 欢迎使用 EasySQL ！

-这个项目刚刚创建，详细的Javadoc与开发指南还在补充，请给我一点时间~
+这个项目刚刚创建，详细的Javadoc与开发指南还在补充，请给我一点时间~
+
+
+## 目录
+
+- [Bob的EasySQL之旅(HikariCP)](USAGE-HIKARI.md) `@Ghost-Chu`
+
+## 实例项目
+以下是一些实例项目，可供各位参考。
+
+- UltraDepository 超级仓库插件 `@CarmJos`
+  - [storage/MySQLStorage](https://github.com/CarmJos/UltraDepository/blob/master/src/main/java/cc/carm/plugin/ultradepository/storage/impl/MySQLStorage.java)
@@ -0,0 +1,288 @@
+> 本文档由 GitHub 用户 @Ghost-chu 创建。  
+> 本文撰写于 2022/02/09，适配 EasySQL 版本 `v0.3.6`。  
+> 本文基于 `EasySQL-HikariPool` 版本编写。
+
+# EasySQL - HikariPool 使用指南
+
+## 和 EasySQL 说你好：创建你的第一个 SQLManager
+
+```java
+public class HiEasySQL {
+    public static void createYourSQLManager() {
+        HikariConfig hikari = YOUR_HIKARI_CONFIG;
+        SQLManager sqlManager = EasySQL.createManager(hikari);
+        try {
+            if (!sqlManager.getConnection().isValid(5)) {
+                logger.warning("Connection invalid!");
+            }
+        } catch (SQLException e) {
+            logger.warning("Failed to connect to database!", e);
+        }
+    }
+}
+```
+
+至此，你已经创建了一个 SQLManager 对象，与 EasySQL 的故事由此开始。
+
+## SQL起步： 查询 (Query)
+
+EasySQL 可以使用异步查询以避免产生性能影响和手动关闭连接的麻烦。本节我们将展示使用 "异步查询" 的示例代码，并讲解如何使用 "查询处理器" 和 "错误处理器"。
+
+```java
+public class HiEasySQL {
+    public static void trySomeQuery(SQLManager sqlManager) {
+        sqlManager.createQuery() // 创建一个查询
+                .inTable("table_name") // 指定表名
+                .selectColumns("name", "sex", "age") // 选择 "name", "sex", "age" 三个列
+                .addCondition("name", "Bob") // 限定条件，"name" 必须是 Bob
+                .build()/*构建查询体*/.executeAsync(
+                        (query) -> { /*处理查询结果-SQLQuery*/ },
+                        ((exception, sqlAction) -> { /*SQL异常处理-SQLExceptionHandler*/ })
+                ); // 异步查询~~~~
+    }
+}
+```
+
+### SQLQuery
+
+SQLQuery 是 EasySQL 执行查询类请求统一返回的对象，包括如下内容：
+
+* ResultSet - 查询结果
+* SQLAction - 执行的 SQL 操作
+* Action - 操作类型
+* ExecuteTime - 查询耗时
+* SQLContent - 最终执行的 SQL 语句的内容
+
+如果需要，SQLQuery 还额外提供了一些其他信息，如：
+
+* SQLManager - 创建此 SQLQuery 对象的 SQLManager 实例
+* Connection - 执行 SQL 操作的链接
+
+等信息。
+
+### SQLExceptionHandler
+
+当出现 SQLException 异常时，如果你在查询中指定了一个 SQLExceptionHandler，则会被调用。 SQLExceptionHandler 接受两个参数：
+
+* SQLException - 发生的 SQL 异常
+* SQLAction - 执行的 SQL 操作
+
+### SQLAction
+
+SQLAction 包含 EasySQL 在处理 SQL 请求时所使用到的信息：
+
+* SQLContent - 最终执行的 SQL 语句的内容
+* ActionUUID - 执行的 SQL 操作的唯一标识
+* ShortID - 执行的 SQL 操作的短 ID (短8位)
+* CreateTime - SQLAction 创建的时间
+* SQLManager - 与 SQLAction 有关的 SQLManager 的实例
+
+## 不仅能读，也得能写： 插入(Insert)
+
+除了 SELECT 查询操作以外，EasySQL 也当然支持 INSERT 插入操作。
+
+```java
+public class HiEasySQL {
+    public static void doSomeInsert(SQLManager sqlManager) {
+        sqlManager.createInsert("table_name")
+                .setColumnNames("name", "sex", "age")
+                .setParams("Alex", "female", 16)
+                .executeAsync();
+    }
+}
+```
+
+EasySQL 使用 PreparedStatement 来填充参数，无需担心 SQL 注入问题。  
+对于常见类型，EasySQL 也对正确的对其进行转换。
+
+### 静默处理
+
+细心的的小伙伴可能发现，这一次我们的 executeAsync 内容为空，没有任何 Handler。  
+在这种情况下， EasySQL 将会静默失败，不会产生任何日志。
+
+## 信息总是千变万化的：更新(Update)
+
+Bob 是个喜欢改名的人，于是他今天给自己起了个新名字叫 Steve。因此我们需要更新数据库中已经存在的数据：
+
+```java
+public class HiEasySQL {
+    public static void updateSomething(SQLManager sqlManager) {
+        sqlManager.createUpdate("table_name")
+                .addCondition("name", "Bob")
+                .setColumnValues("name", "Steve")
+                .build().executeAsync();
+    }
+}
+
+```
+
+至此，Bob 就改名为 Steve 啦！
+
+## 旧的不去，新的不来：删除(Delete)
+
+最近 Steve 把它人生中买的一套房给卖了，于是我们需要将这套房从数据库中删除。  
+不过，Steve 说它不记得这套房子是多久之前买的了，不过肯定是 10 年之前。
+
+```java
+public class HiEasySQL {
+    public static void sayGoodBye(SQLManager sqlManager) {
+        Date date = new Date(); // 使用当前日期时间戳创建一个 Date
+        date.setYear(date.getYear() - 10); // 把时间滑动到 10 年之前
+        sqlManager.createDelete("steve_house") // 进行删除
+                .addTimeCondition("purchase_date", new Date(0), date) // 选择从1970年1月1日0点一直到10年前的所有数据
+                .build()
+                .executeAsync(); //执行
+    }
+}
+```
+
+现在 Steve 真的没有他的这套房了。
+
+## 不管有没有，反正都要写：替换(Replace)
+
+Steve 买了一盒牛奶，他要在他的购物清单中标记牛奶已经买了。  
+不过，Steve 忘记了自己有没有将牛奶加入过购物清单。但是如果暴力 INSERT 肯定会出错，但是又觉得写个 INSERT OR UPDATE 太麻烦了，于是这件棘手的事情又丢到了我们的头上来。
+
+```java
+public class HiEasySQL {
+    public static void putAnyway(SQLManager sqlManager) {
+        sqlManager.createReplace("steve_list")
+                .setColumnNames("item", "purchased")
+                .setParams("milk", true)
+                .executeAsync();
+    }
+}
+```
+
+生活总有简单的方法不是吗？
+
+## 上司的任务：建表
+
+Steve 的公司老板开发了一个 IM 软件，但是 Steve 公司运维是土豆，不会搞SQL。  
+最要命的是，Steve 的公司老板还不让你碰生产环境，于是你便不能指望土豆会去帮你完成建表的任务了。  
+除此之外，由于 IM 软件上的网友特能叭叭，你还需要稍微考虑下性能问题。不然你可能会被送去西伯利亚。
+
+```java
+public class HiEasySQL {
+    public static void newTablePlease(SQLManager sqlManager) {
+        sqlManager.createTable("steve_im_history")
+                .addColumn("id", "BIGINT NOT NULL", "记录ID")
+                .addColumn("sender", "VARCHAR NOT NULL", "网友UUID")
+                .addColumn("message", "TEXT NULL", "网友发言")
+                .addAutoIncrementColumn("id") //设置 id 列自增
+                .setIndex(IndexType.PRIMARY_KEY, null, "id", "sender") //配置主键
+                .setIndex(IndexType.INDEX, "sender_message_index", "sender", "message") //配置索引
+                .build().executeAsync();
+    }
+}
+```
+
+## 上司的任务2：改表
+
+Steve 的公司老板和 Steve 提出了一个需求，迫不得已，Steve 要修改表结构。  
+然而此时表内已经存储了大量数据，不能删表再建，Steve 要想个办法对表做出相应的修改。
+
+```java
+public class HiEasySQL {
+    public static void newTablePlease(SQLManager sqlManager) {
+        sqlManager.alterTable("steve_im_history")
+                .addColumn("ipAddress", "VARCHAR(255)")
+                .executeAsync();
+        sqlManager.alterTable("steve_im_history")
+                .modifyColumn("message", "LONGTEXT")
+                .executeAsync();
+    }
+}
+
+```
+
+多亏了我们的大力帮助。现在，Steve 被送去了南极担任公司的重要工作了。
+
+## 北极熊的快乐生活：批量操作
+
+Steve 到达南极之后，南极的员工把2FA密钥塞给Steve便骑着海豚跑路了。于是 Steve 除了日常工作以外还要照看公司的北极熊。  
+北极熊饲养区有一套设备，监控生活在南极的北极熊的生活状态。设备每 1 小时会把缓存的数据存入到服务器里。  
+然而，员工跑路的时候删库格盘了，现在 Steve 要自己想办法解决这个烂摊子了。
+
+```java
+public class HiEasySQL {
+    public static void iDontLikeHere(SQLManager sqlManager) {
+        sqlManager.createInsertBatch("polarbear")
+                .setColumnNames("name", "temp", "hunger")
+                .addParamsBatch("Karl", -17, 100)
+                .addParamsBatch("Lucy", -3, 80)
+                .addParamsBatch("Lily", -10, 70)
+                .setReturnGeneratedKey(true)// 设定在后续返回自增主键
+                .executeAsync((list) -> {/*新增行的自增主键*/});
+    }
+}
+```
+
+## 北极熊的熊猫之旅！？：复杂查询
+
+Steve 翻看着跑路员工留下的为数不多的资料，发现公司在南极培育北极熊是为了让它们变成熊猫！  
+只要满足 “温度 < -100C, 饱食度 > 70, 名字中带有 `PANDAKING` 关键字并以符合条件的北极熊门的名字倒序排序后的第一条” 的北极熊就有希望变成熊猫！  
+现在 Steve 已经迫不及待的看看是哪只熊猫如此幸运了！
+
+```java
+public class HiEasySQL {
+    public static void noBearsPlease(SQLManager sqlManager) {
+        sqlManager.createQuery()
+                .inTable("panda_king_proj")
+                .addCondition("temp", "<", -100)
+                .addCondition("hunger", ">", 70)
+                .addCondition("name", "LIKE", "PANDAKING")
+                .orderBy("name", false)
+                .setLimit(1)
+                .build().executeAsync((result) -> {
+                    if (result.getResultSet().next()) {
+                        System.out.println(result.getResultSet().getString("name"));
+                    }
+                });
+    }
+}
+```
+
+## 同步请求
+
+经历人生坎坷后的 Steve 回到了自己的家：因为没能培育出熊猫来，他的老板 Async 炒了他，女友 Lambda 甩了他，连朋友 Handler 都放 Steve 鸽子，于是现在他很讨厌任何带有这两个名字的东西。
+
+```java
+public class HiEasySQL {
+    public static void syncLover(SQLManager sqlManager) {
+        try (SQLQuery query = sqlManager.createQuery().inTable("the_end")
+                .addCondition("thanks_read", "this_stupid_guide")
+                .build().execute()) {
+            ResultSet set = query.getResultSet(); // SQLQuery 关闭时，ResultSet 会一同关闭
+            if (set.next()) {
+                set.getString("see_you_next_time");
+            }
+        } catch (Exception exception) {
+            exception.printStackTrace();
+        }
+    }
+}
+```
+
+当然，有时候 Steve 也会选择更优雅一点的方式。
+
+```java
+import org.jetbrains.annotations.Nullable;
+
+import java.sql.SQLException;
+
+public class HiEasySQL {
+    // 调用此方法，直接返回结果，再在调用处统一处理错误
+    public static @Nullable String eleganceNeverGone(SQLManager sqlManager) throws SQLException {
+        return sqlManager.createQuery().inTable("the_end")
+                .addCondition("thanks_read", "this_stupid_guide")
+                .build().executeFunction(query -> {
+                    if (!query.getResultSet().next()) return null;
+                    else return query.getResultSet().getString("see_you_next_time");
+                });
+    }
+}
+```
+
+Steve 终究能找到继续生活下去的办法 :)
+
@@ -21,7 +21,7 @@ jobs:
          java-version: '11'
          distribution: 'adopt'
      - name: "Package"
-        run: mvn -B package --file pom.xml -Dmaven.javadoc.skip=true
+        run: mvn -B package --file pom.xml -Dgpg.skip
      - name: "Target Stage"
        run: mkdir staging && cp */target/*.jar staging
      - name: "Upload artifact"
@@ -5,7 +5,7 @@
    <parent>
        <groupId>cc.carm.lib</groupId>
        <artifactId>easysql-parent</artifactId>
-        <version>0.3.6</version>
+        <version>0.3.7</version>
    </parent>
    <modelVersion>4.0.0</modelVersion>

@@ -48,6 +48,7 @@ public interface PreparedSQLUpdateBatchAction extends SQLAction<List<Integer>> {
 	/**
 	 * 设定该操作是否返回自增键序列。
 	 *
+	 * @param returnGeneratedKey 是否返回自增键序列
 	 * @return {@link PreparedSQLUpdateBatchAction}
 	 */
 	PreparedSQLUpdateBatchAction setReturnGeneratedKeys(boolean returnGeneratedKey);
@@ -4,34 +4,35 @@ import cc.carm.lib.easysql.api.SQLAction;

 public interface SQLUpdateAction extends SQLAction<Integer> {

-	/**
-	 * 设定自增主键的序列
-	 *
-	 * @param keyColumnIndex 自增主键的序列
-	 *                       <br>若该值 ＞ 0，则 {@link #execute()} 返回自增主键数值
-	 *                       <br>若该值 ≤ 0，则 {@link #execute()} 返回变更的行数
-	 * @return {@link SQLUpdateAction}
-	 * @see #setReturnGeneratedKey(boolean)
-	 */
-	@Deprecated
-	default SQLUpdateAction setKeyIndex(int keyColumnIndex) {
-		return setReturnGeneratedKey(keyColumnIndex > 0);
-	}
+    /**
+     * 设定自增主键的序列
+     *
+     * @param keyColumnIndex 自增主键的序列
+     *                       <br>若该值 ＞ 0，则 {@link #execute()} 返回自增主键数值
+     *                       <br>若该值 ≤ 0，则 {@link #execute()} 返回变更的行数
+     * @return {@link SQLUpdateAction}
+     * @see #setReturnGeneratedKey(boolean)
+     */
+    @Deprecated
+    default SQLUpdateAction setKeyIndex(int keyColumnIndex) {
+        return setReturnGeneratedKey(keyColumnIndex > 0);
+    }

-	/**
-	 * 设定该操作返回自增键序列。
-	 *
-	 * @return {@link SQLUpdateAction}
-	 */
-	default SQLUpdateAction returnGeneratedKey() {
-		return setReturnGeneratedKey(true);
-	}
+    /**
+     * 设定该操作返回自增键序列。
+     *
+     * @return {@link SQLUpdateAction}
+     */
+    default SQLUpdateAction returnGeneratedKey() {
+        return setReturnGeneratedKey(true);
+    }

-	/**
-	 * 设定该操作是否返回自增键序列。
-	 *
-	 * @return {@link SQLUpdateAction}
-	 */
-	SQLUpdateAction setReturnGeneratedKey(boolean returnGeneratedKey);
+    /**
+     * 设定该操作是否返回自增键序列。
+     *
+     * @param returnGeneratedKey 是否返回自增键序列
+     * @return {@link SQLUpdateAction}
+     */
+    SQLUpdateAction setReturnGeneratedKey(boolean returnGeneratedKey);

 }
@@ -10,45 +10,75 @@ import java.util.LinkedHashMap;

 public interface ConditionalBuilder<B extends ConditionalBuilder<B, T>, T extends SQLAction<?>> extends SQLBuilder {

-	/**
-	 * 将现有条件构建完整的SQL语句用于执行。
-	 *
-	 * @return {@link cc.carm.lib.easysql.api.SQLAction}
-	 */
-	T build();
+    /**
+     * 将现有条件构建完整的SQL语句用于执行。
+     *
+     * @return {@link SQLAction}
+     */
+    T build();

-	/**
-	 * 设定取出的条数
-	 *
-	 * @param limit 条数限制
-	 * @return {@link B}
-	 */
-	B setLimit(int limit);
+    /**
+     * 设定限定的条目数
+     *
+     * @param limit 条数限制
+     * @return {@link B}
+     */
+    B setLimit(int limit);

-	B setConditions(@Nullable String condition);
+    /**
+     * 直接设定条件的源文本,不需要以WHERE开头。
+     * <br>如 {@code id = 1 AND name = 'test' OR name = 'test2'} 。
+     *
+     * @param condition 条件文本，不需要以WHERE开头。
+     * @return {@link B}
+     */
+    B setConditions(@Nullable String condition);

-	B setConditions(LinkedHashMap<@NotNull String, @Nullable Object> conditionSQLs);
+    /**
+     * 直接设定每个条件的文本与其对应数值,将以AND链接，且不需要以WHERE开头。
+     * <br>条件如 {@code id = ? }，问号将被以对应的数值填充。。
+     *
+     * @param conditionSQLs 条件内容，将以AND链接，且不需要以WHERE开头。
+     * @return {@link B}
+     */
+    B setConditions(LinkedHashMap<@NotNull String, @Nullable Object> conditionSQLs);

-	B addCondition(@Nullable String condition);
+    B addCondition(@Nullable String condition);

-	B addCondition(@NotNull String queryName, @NotNull String operator, @Nullable Object queryValue);
+    B addCondition(@NotNull String columnName, @NotNull String operator, @Nullable Object queryValue);

-	default B addCondition(@NotNull String queryName, @Nullable Object queryValue) {
-		return addCondition(queryName, "=", queryValue);
-	}
+    default B addCondition(@NotNull String columnName, @Nullable Object queryValue) {
+        return addCondition(columnName, "=", queryValue);
+    }

-	B addCondition(@NotNull String[] queryNames, @Nullable Object[] queryValues);
+    B addCondition(@NotNull String[] columnNames, @Nullable Object[] queryValues);

-	B addNotNullCondition(@NotNull String queryName);
+    B addNotNullCondition(@NotNull String columnName);

-	default B addTimeCondition(@NotNull String queryName, long startMillis, long endMillis) {
-		return addTimeCondition(queryName,
-				startMillis > 0 ? new Date(startMillis) : null,
-				endMillis > 0 ? new Date(endMillis) : null
-		);
-	}
+    /**
+     * 添加时间的限定条件。 若设定了开始时间，则限定条件为 {@code endMillis >= startMillis}；
+     *
+     * @param columnName  判断的行
+     * @param startMillis 开始时间戳，若{@code <0}则不作限定
+     * @param endMillis   结束时间戳，若{@code <0}则不作限定
+     * @return {@link B}
+     */
+    default B addTimeCondition(@NotNull String columnName, long startMillis, long endMillis) {
+        return addTimeCondition(columnName,
+                startMillis > 0 ? new Date(startMillis) : null,
+                endMillis > 0 ? new Date(endMillis) : null
+        );
+    }

-	B addTimeCondition(@NotNull String queryName, @Nullable java.util.Date startDate, @Nullable java.util.Date endDate);
+    /**
+     * 添加时间的限定条件。 若设定了开始时间，则限定条件为 {@code endDate >= startTime}；
+     *
+     * @param columnName 判断的行
+     * @param startDate  开始时间，若为null则不作限定
+     * @param endDate    结束时间，若为null则不作限定
+     * @return {@link B}
+     */
+    B addTimeCondition(@NotNull String columnName, @Nullable java.util.Date startDate, @Nullable java.util.Date endDate);


 }
@@ -1,20 +1,56 @@
 package cc.carm.lib.easysql.api.builder;

 import cc.carm.lib.easysql.api.SQLAction;
+import org.jetbrains.annotations.NotNull;
+import org.jetbrains.annotations.Nullable;

 import java.util.LinkedHashMap;

 public interface UpdateBuilder extends ConditionalBuilder<UpdateBuilder, SQLAction<Integer>> {

-	String getTableName();
+    String getTableName();

-	UpdateBuilder setColumnValues(LinkedHashMap<String, Object> columnData);
+    /**
+     * 添加一条需要更新的字段名与值
+     *
+     * @param columnName  字段名
+     * @param columnValue 字段名对应的值
+     * @return {@link UpdateBuilder}
+     * @since 0.3.7
+     */
+    UpdateBuilder addColumnValue(@NotNull String columnName, @Nullable Object columnValue);

-	UpdateBuilder setColumnValues(String[] columnNames, Object[] columnValues);
+    /**
+     * 设定更新的全部字段值 <b>(此操作会覆盖之前的设定)</b>
+     * <p> <b>此操作会覆盖之前的设定</b>
+     *
+     * @param columnData 字段名和值的键值对
+     * @return {@link UpdateBuilder}
+     */
+    UpdateBuilder setColumnValues(LinkedHashMap<@NotNull String, @Nullable Object> columnData);

-	default UpdateBuilder setColumnValues(String columnName, Object columnValue) {
-		return setColumnValues(new String[]{columnName}, new Object[]{columnValue});
-	}
+    /**
+     * 设定更新的全部字段值 <b>(此操作会覆盖之前的设定)</b>
+     * <p> <b>此操作会覆盖之前的设定</b>
+     *
+     * @param columnNames  字段名
+     * @param columnValues 字段名对应的值
+     * @return {@link UpdateBuilder}
+     */
+    UpdateBuilder setColumnValues(@NotNull String[] columnNames, @Nullable Object[] columnValues);
+
+    /**
+     * 设定更新的全部字段值 <b>(此操作会覆盖之前的设定)</b>
+     * <p> 如需同时更新多条字段，请使用 {@link #setColumnValues(String[], Object[])} 或 {@link #setColumnValues(LinkedHashMap)}
+     * <br>也可以使用 {@link #addColumnValue(String, Object)} 一条条的添加字段
+     *
+     * @param columnName  字段名
+     * @param columnValue 字段名对应的值
+     * @return {@link UpdateBuilder}
+     */
+    default UpdateBuilder setColumnValues(@NotNull String columnName, @Nullable Object columnValue) {
+        return setColumnValues(new String[]{columnName}, new Object[]{columnValue});
+    }


 }
@@ -8,8 +8,10 @@ package cc.carm.lib.easysql.api.builder;
@Deprecated
 public interface UpsertBuilder {

-	String getTableName();
+    String getTableName();

-	UpsertBuilder setColumnNames(String[] columnNames, String updateColumn);
+    default UpsertBuilder setColumnNames(String[] columnNames, String updateColumn) {
+        throw new UnsupportedOperationException("Please use REPLACE .");
+    }

 }
@@ -5,7 +5,7 @@
    <parent>
        <artifactId>easysql-parent</artifactId>
        <groupId>cc.carm.lib</groupId>
-        <version>0.3.6</version>
+        <version>0.3.7</version>
    </parent>
    <modelVersion>4.0.0</modelVersion>

@@ -53,40 +53,40 @@ public abstract class AbstractConditionalBuilder<B extends ConditionalBuilder<B,

 	@Override
 	public B addCondition(
-			@NotNull String queryName, @NotNull String operator, @Nullable Object queryValue
+			@NotNull String columnName, @NotNull String operator, @Nullable Object queryValue
 	) {
-		addCondition(withBackQuote(queryName) + " " + operator + " ?");
+		addCondition(withBackQuote(columnName) + " " + operator + " ?");
 		this.conditionParams.add(queryValue);
 		return getThis();
 	}

 	@Override
 	public B addCondition(
-			@NotNull String[] queryNames, @Nullable Object[] queryValues
+			@NotNull String[] columnNames, @Nullable Object[] queryValues
 	) {
-		if (queryValues == null || queryNames.length != queryValues.length) {
+		if (queryValues == null || columnNames.length != queryValues.length) {
 			throw new RuntimeException("queryNames are not match with queryValues");
 		}
-		for (int i = 0; i < queryNames.length; i++) {
-			addCondition(queryNames[i], queryValues[i]);
+		for (int i = 0; i < columnNames.length; i++) {
+			addCondition(columnNames[i], queryValues[i]);
 		}
 		return getThis();
 	}


 	@Override
-	public B addNotNullCondition(@NotNull String queryName) {
-		return addCondition(withBackQuote(queryName) + " IS NOT NULL");
+	public B addNotNullCondition(@NotNull String columnName) {
+		return addCondition(withBackQuote(columnName) + " IS NOT NULL");
 	}


 	@Override
 	public B addTimeCondition(
-			@NotNull String queryName, @Nullable Date startDate, @Nullable Date endDate
+			@NotNull String columnName, @Nullable Date startDate, @Nullable Date endDate
 	) {
 		if (startDate == null && endDate == null) return getThis(); // 都不限定时间，不用判断了
 		if (startDate != null) {
-			addCondition(withBackQuote(queryName) + " BETWEEN ? AND ?");
+			addCondition(withBackQuote(columnName) + " BETWEEN ? AND ?");
 			this.conditionParams.add(startDate);
 			if (endDate != null) {
 				this.conditionParams.add(endDate);
@@ -100,7 +100,7 @@ public abstract class AbstractConditionalBuilder<B extends ConditionalBuilder<B,
 				}
 			}
 		} else {
-			addCondition(queryName, "<=", endDate);
+			addCondition(columnName, "<=", endDate);
 		}
 		return getThis();
 	}
@@ -147,7 +147,7 @@ public class TableCreateBuilderImpl extends AbstractSQLBuilder implements TableC
 			indexBuilder.append(", ");

 			for (int i = 0; i < moreColumns.length; i++) {
-				indexBuilder.append(moreColumns[i]);
+				indexBuilder.append(withBackQuote(moreColumns[i]));
 				if (i != moreColumns.length - 1) indexBuilder.append(", ");
 			}

@@ -6,78 +6,85 @@ import cc.carm.lib.easysql.api.action.PreparedSQLUpdateAction;
 import cc.carm.lib.easysql.api.builder.UpdateBuilder;
 import cc.carm.lib.easysql.manager.SQLManagerImpl;
 import org.jetbrains.annotations.NotNull;
+import org.jetbrains.annotations.Nullable;

-import java.util.*;
+import java.util.ArrayList;
+import java.util.Iterator;
+import java.util.LinkedHashMap;
+import java.util.List;

 import static cc.carm.lib.easysql.api.SQLBuilder.withBackQuote;

 public class UpdateBuilderImpl
-		extends AbstractConditionalBuilder<UpdateBuilder, SQLAction<Integer>>
-		implements UpdateBuilder {
+        extends AbstractConditionalBuilder<UpdateBuilder, SQLAction<Integer>>
+        implements UpdateBuilder {

-	String tableName;
+    String tableName;

-	List<String> columnNames;
-	List<Object> columnValues;
+    @NotNull LinkedHashMap<String, Object> columnData;

-	public UpdateBuilderImpl(@NotNull SQLManagerImpl manager, @NotNull String tableName) {
-		super(manager);
-		this.tableName = tableName;
-	}
+    public UpdateBuilderImpl(@NotNull SQLManagerImpl manager, @NotNull String tableName) {
+        super(manager);
+        this.tableName = tableName;
+        this.columnData = new LinkedHashMap<>();
+    }

-	@Override
-	public PreparedSQLUpdateAction build() {
+    @Override
+    public PreparedSQLUpdateAction build() {

-		StringBuilder sqlBuilder = new StringBuilder();
+        StringBuilder sqlBuilder = new StringBuilder();

-		sqlBuilder.append("UPDATE ").append(withBackQuote(getTableName())).append(" SET ");
+        sqlBuilder.append("UPDATE ").append(withBackQuote(getTableName())).append(" SET ");

-		Iterator<String> iterator = this.columnNames.iterator();
-		while (iterator.hasNext()) {
-			sqlBuilder.append(withBackQuote(iterator.next())).append(" = ?");
-			if (iterator.hasNext()) sqlBuilder.append(" , ");
-		}
-		List<Object> allParams = new ArrayList<>(this.columnValues);
+        Iterator<String> iterator = this.columnData.keySet().iterator();
+        while (iterator.hasNext()) {
+            sqlBuilder.append(withBackQuote(iterator.next())).append(" = ?");
+            if (iterator.hasNext()) sqlBuilder.append(" , ");
+        }
+        List<Object> allParams = new ArrayList<>(this.columnData.values());

-		if (hasConditions()) {
-			sqlBuilder.append(" ").append(buildConditionSQL());
-			allParams.addAll(getConditionParams());
-		}
+        if (hasConditions()) {
+            sqlBuilder.append(" ").append(buildConditionSQL());
+            allParams.addAll(getConditionParams());
+        }

-		if (limit > 0) sqlBuilder.append(" ").append(buildLimitSQL());
+        if (limit > 0) sqlBuilder.append(" ").append(buildLimitSQL());

-		return new PreparedSQLUpdateActionImpl(getManager(), sqlBuilder.toString(), allParams);
-	}
+        return new PreparedSQLUpdateActionImpl(getManager(), sqlBuilder.toString(), allParams);
+    }

-	@Override
-	public String getTableName() {
-		return tableName;
-	}
+    @Override
+    public String getTableName() {
+        return tableName;
+    }

-	@Override
-	public UpdateBuilder setColumnValues(LinkedHashMap<String, Object> columnData) {
-		this.columnNames = new ArrayList<>();
-		this.columnValues = new ArrayList<>();
-		columnData.forEach((name, value) -> {
-			this.columnNames.add(name);
-			this.columnValues.add(value);
-		});
-		return this;
-	}
+    @Override
+    public UpdateBuilder addColumnValue(@NotNull String columnName, Object columnValue) {
+        this.columnData.put(columnName, columnValue);
+        return this;
+    }

-	@Override
-	public UpdateBuilder setColumnValues(String[] columnNames, Object[] columnValues) {
-		if (columnNames.length != columnValues.length) {
-			throw new RuntimeException("columnNames are not match with columnValues");
-		}
-		this.columnNames = Arrays.asList(columnNames);
-		this.columnValues = Arrays.asList(columnValues);
-		return this;
-	}
+    @Override
+    public UpdateBuilder setColumnValues(LinkedHashMap<String, Object> columnData) {
+        this.columnData = columnData;
+        return this;
+    }
+
+    @Override
+    public UpdateBuilder setColumnValues(@NotNull String[] columnNames, @Nullable Object[] columnValues) {
+        if (columnNames.length != columnValues.length) {
+            throw new RuntimeException("columnNames are not match with columnValues");
+        }
+        LinkedHashMap<String, Object> columnData = new LinkedHashMap<>();
+        for (int i = 0; i < columnNames.length; i++) {
+            columnData.put(columnNames[i], columnValues[i]);
+        }
+        return setColumnValues(columnData);
+    }


-	@Override
-	protected UpdateBuilder getThis() {
-		return this;
-	}
+    @Override
+    protected UpdateBuilder getThis() {
+        return this;
+    }
 }
@@ -5,7 +5,7 @@
    <parent>
        <artifactId>easysql-parent</artifactId>
        <groupId>cc.carm.lib</groupId>
-        <version>0.3.6</version>
+        <version>0.3.7</version>
        <relativePath>../../pom.xml</relativePath>
    </parent>
    <modelVersion>4.0.0</modelVersion>
@@ -15,119 +15,119 @@ import java.util.UUID;
@SuppressWarnings("all")
 public class EasySQLDemo {

-	public void createTable(SQLManager sqlManager) {
-		// 同步创建表
-		sqlManager.createTable("users")
+    public void createTable(SQLManager sqlManager) {
+        // 同步创建表
+        sqlManager.createTable("users")
 //				.addColumn("id", "INT(11) AUTO_INCREMENT NOT NULL PRIMARY KEY")
-				.addAutoIncrementColumn("id", NumberType.INT, true, true)
-				.addColumn("uuid", "VARCHAR(32) NOT NULL UNIQUE KEY")
-				.addColumn("username", "VARCHAR(16) NOT NULL")
-				.addColumn("age", "TINYINT NOT NULL DEFAULT 1")
-				.addColumn("email", "VARCHAR(32)")
-				.addColumn("phone", "VARCHAR(16)")
-				.addColumn("registerTime", "DATETIME NOT NULL")
+                .addAutoIncrementColumn("id", NumberType.INT, true, true)
+                .addColumn("uuid", "VARCHAR(32) NOT NULL UNIQUE KEY")
+                .addColumn("username", "VARCHAR(16) NOT NULL")
+                .addColumn("age", "TINYINT NOT NULL DEFAULT 1")
+                .addColumn("email", "VARCHAR(32)")
+                .addColumn("phone", "VARCHAR(16)")
+                .addColumn("registerTime", "DATETIME NOT NULL")
 //				.addColumn("INDEX `phone`") // 原始方法添加索引
-				.setIndex("username", IndexType.UNIQUE_KEY) // 添加唯一索引
-				.setIndex(IndexType.INDEX, "contact", "email", "phone") //添加联合索引 (示例)
-				.build().execute(null /* 不处理错误 */);
+                .setIndex("username", IndexType.UNIQUE_KEY) // 添加唯一索引
+                .setIndex(IndexType.INDEX, "contact", "email", "phone") //添加联合索引 (示例)
+                .build().execute(null /* 不处理错误 */);

-		sqlManager.createTable("user_ipaddr")
-				.addAutoIncrementColumn("id", NumberType.INT, true, true)
-				.addColumn("uuid", "VARCHAR(32) NOT NULL")
-				.addColumn("ip", "VARCHAR(16)")
-				.addColumn("time", "DATETIME NOT NULL")
-				.addForeignKey("uuid", null,
-						"users", "uuid",
-						ForeignKeyRule.CASCADE, ForeignKeyRule.CASCADE
-				)
-				.build().execute(null /* 不处理错误 */);
-	}
+        sqlManager.createTable("user_ipaddr")
+                .addAutoIncrementColumn("id", NumberType.INT, true, true)
+                .addColumn("uuid", "VARCHAR(32) NOT NULL")
+                .addColumn("ip", "VARCHAR(16)")
+                .addColumn("time", "DATETIME NOT NULL")
+                .addForeignKey("uuid", null,
+                        "users", "uuid",
+                        ForeignKeyRule.CASCADE, ForeignKeyRule.CASCADE
+                )
+                .build().execute(null /* 不处理错误 */);
+    }

-	public void alertTable(SQLManager sqlManager) {
-		// 同步更新表
-		sqlManager.alterTable("users")
-				.modifyColumn("age", "TINYINT NOT NULL DEFAULT 0")
-				.execute(null /* 不处理错误 */);
-	}
+    public void alertTable(SQLManager sqlManager) {
+        // 同步更新表
+        sqlManager.alterTable("users")
+                .modifyColumn("age", "TINYINT NOT NULL DEFAULT 0")
+                .execute(null /* 不处理错误 */);
+    }


-	public void sqlQuery(SQLManager sqlManager) {
-		// 同步SQL查询
-		try (SQLQuery query = sqlManager.createQuery()
-				.inTable("users") // 在users表中查询
-				.selectColumns("id", "name") // 选中 id 与 name列
-				.addCondition("age", ">", 18) // 限定 age 要大于5
-				.addCondition("email", null) // 限定查询 email 字段为空
-				.addNotNullCondition("phone") // 限定 phone 字段不为空
-				.addTimeCondition("registerTime", // 时间字段
-						System.currentTimeMillis() - 100000, //限制开始时间
-						-1//不限制结束时间
-				).build().execute()) {
-			ResultSet resultSet = query.getResultSet();
-			//do something
+    public void sqlQuery(SQLManager sqlManager) {
+        // 同步SQL查询
+        try (SQLQuery query = sqlManager.createQuery()
+                .inTable("users") // 在users表中查询
+                .selectColumns("id", "name") // 选中 id 与 name列
+                .addCondition("age", ">", 18) // 限定 age 要大于5
+                .addCondition("email", null) // 限定查询 email 字段为空
+                .addNotNullCondition("phone") // 限定 phone 字段不为空
+                .addTimeCondition("registerTime", // 时间字段
+                        System.currentTimeMillis() - 100000, //限制开始时间
+                        -1//不限制结束时间
+                ).build().execute()) {
+            ResultSet resultSet = query.getResultSet();
+            //do something

-		} catch (SQLException exception) {
-			exception.printStackTrace();
-		}
+        } catch (SQLException exception) {
+            exception.printStackTrace();
+        }

-		UUID userUUID = sqlManager.createQuery()
-				.inTable("users") // 在users表中查询
-				.selectColumns("uuid")
-				.addCondition("id", 5) // 限定 id 为 5
-				.setLimit(1) // 只取出一个数据
-				.build().execute(query -> {
-					//可以直接进行数据处理
-					ResultSet result = query.getResultSet();
-					return result.next() ? UUIDUtil.toUUID(result.getString("uuid")) : null;
-				}, (exception, action) -> {
-					// 处理异常，不想处理直接填null
-				});
+        UUID userUUID = sqlManager.createQuery()
+                .inTable("users") // 在users表中查询
+                .selectColumns("uuid")
+                .addCondition("id", 5) // 限定 id 为 5
+                .setLimit(1) // 只取出一个数据
+                .build().execute(query -> {
+                    //可以直接进行数据处理
+                    ResultSet result = query.getResultSet();
+                    return result.next() ? UUIDUtil.toUUID(result.getString("uuid")) : null;
+                }, (exception, action) -> {
+                    // 处理异常，不想处理直接填null
+                });

-	}
+    }

-	public void sqlQueryAsync(SQLManager sqlManager) {
-		// 异步SQL查询
-		sqlManager.createQuery()
-				.inTable("users") // 在users表中查询
-				.addCondition("id", 5) // 限定 id 为 5
-				.setLimit(1) // 只取出一个数据
-				.build().executeAsync(success -> {
-					ResultSet resultSet = success.getResultSet();
-					if (resultSet != null && resultSet.next()) {
-						String username = resultSet.getString("username");
-					}
-				}, (exception, action) -> {
-					//do something
-					long createTIme = action.getCreateTime();
-					String shortID = action.getShortID();
-					String sqlContent = action.getSQLContent();
-				});
-	}
+    public void sqlQueryAsync(SQLManager sqlManager) {
+        // 异步SQL查询
+        sqlManager.createQuery()
+                .inTable("users") // 在users表中查询
+                .addCondition("id", 5) // 限定 id 为 5
+                .setLimit(1) // 只取出一个数据
+                .build().executeAsync(success -> {
+                    ResultSet resultSet = success.getResultSet();
+                    if (resultSet != null && resultSet.next()) {
+                        String username = resultSet.getString("username");
+                    }
+                }, (exception, action) -> {
+                    //do something
+                    long createTIme = action.getCreateTime();
+                    String shortID = action.getShortID();
+                    String sqlContent = action.getSQLContent();
+                });
+    }

-	public void sqlInsert(SQLManager sqlManager) {
-		// 同步SQL插入 （不使用try-catch的情况下，返回的数值可能为空。）
-		Integer id = sqlManager.createInsert("users")
-				.setColumnNames("username", "phone", "email", "registerTime")
-				.setParams("CarmJos", "18888888888", "carm@carm.cc", TimeDateUtils.getCurrentTime())
-				.setKeyIndex(1) // 设定自增主键的index，将会在后续返回自增主键
-				.execute((exception, action) -> {
-					// 处理异常
-					System.out.println("#" + action.getShortID() + " -> " + action.getSQLContent());
-					exception.printStackTrace();
-				});
+    public void sqlInsert(SQLManager sqlManager) {
+        // 同步SQL插入 （不使用try-catch的情况下，返回的数值可能为空。）
+        Integer id = sqlManager.createInsert("users")
+                .setColumnNames("username", "phone", "email", "registerTime")
+                .setParams("CarmJos", "18888888888", "carm@carm.cc", TimeDateUtils.getCurrentTime())
+                .setReturnGeneratedKey(true)// 设定在后续返回自增主键
+                .execute((exception, action) -> {
+                    // 处理异常
+                    System.out.println("#" + action.getShortID() + " -> " + action.getSQLContent());
+                    exception.printStackTrace();
+                });

-		try {
-			Integer userID = sqlManager.createInsert("users")
-					.setColumnNames("username", "phone", "email", "registerTime")
-					.setParams("CarmJos", "18888888888", "carm@carm.cc", TimeDateUtils.getCurrentTime())
-					.setKeyIndex(1) // 设定自增主键的index，将会在后续返回自增主键
-					.execute();
+        try {
+            Integer userID = sqlManager.createInsert("users")
+                    .setColumnNames("username", "phone", "email", "registerTime")
+                    .setParams("CarmJos", "18888888888", "carm@carm.cc", TimeDateUtils.getCurrentTime())
+                    .setReturnGeneratedKey(true)
+                    .execute();

-			System.out.println("新用户的ID为 " + userID);
+            System.out.println("新用户的ID为 " + userID);

-		} catch (SQLException exception) {
-			exception.printStackTrace();
-		}
-	}
+        } catch (SQLException exception) {
+            exception.printStackTrace();
+        }
+    }

 }
@@ -5,7 +5,7 @@
    <parent>
        <artifactId>easysql-parent</artifactId>
        <groupId>cc.carm.lib</groupId>
-        <version>0.3.6</version>
+        <version>0.3.7</version>
        <relativePath>../../pom.xml</relativePath>
    </parent>
    <modelVersion>4.0.0</modelVersion>
@@ -44,7 +44,7 @@
        <dependency>
            <groupId>org.slf4j</groupId>
            <artifactId>slf4j-api</artifactId>
-            <version>1.7.35</version>
+            <version>1.7.36</version>
            <scope>compile</scope>
        </dependency>

@@ -17,7 +17,7 @@
    <groupId>cc.carm.lib</groupId>
    <artifactId>easysql-parent</artifactId>
    <packaging>pom</packaging>
-    <version>0.3.6</version>
+    <version>0.3.7</version>

    <modules>
        <module>easysql-api</module>
@@ -5,7 +5,7 @@
    <parent>
        <artifactId>easysql-parent</artifactId>
        <groupId>cc.carm.lib</groupId>
-        <version>0.3.6</version>
+        <version>0.3.7</version>
        <relativePath>../../pom.xml</relativePath>
    </parent>
    <modelVersion>4.0.0</modelVersion>
@@ -5,7 +5,7 @@
    <parent>
        <artifactId>easysql-parent</artifactId>
        <groupId>cc.carm.lib</groupId>
-        <version>0.3.6</version>
+        <version>0.3.7</version>
        <relativePath>../../pom.xml</relativePath>
    </parent>
    <modelVersion>4.0.0</modelVersion>
Author	SHA1	Message	Date
carm	e3844493e5	[0.3.7] 修复Javadoc错误	2022-02-11 21:25:40 +08:00
carm	7772bc58d6	[0.3.7] 版本更新 - `[A]` 为 UpdateBuilder 添加 `#addColumnValue(String,Object)` 方法。 - `[A]` 补充部分Builder的JavaDoc。	2022-02-11 21:22:03 +08:00
carm	54166b4289	[0.3.7] 版本更新 - `[A]` 为 UpdateBuilder 添加 `#addColumnValue(String,Object)` 方法。 - `[A]` 补充部分Builder的JavaDoc。	2022-02-11 21:19:58 +08:00
carm	bcf9d257a9	[0.3.7] 版本更新 - `[A]` 为 UpdateBuilder 添加 `#addColumnValue(String,Object)` 方法。 - `[A]` 补充部分Builder的JavaDoc。	2022-02-11 21:12:32 +08:00
carm	0efd526c75	[ci skip]添加实例项目	2022-02-10 20:49:05 +08:00
carm	22a8172490	完善帮助	2022-02-10 20:31:26 +08:00
carm	5444015b8b	Merge pull request #30 from Ghost-chu/master Documention or Story?	2022-02-10 19:48:35 +08:00
Ghost_chu	1ab23aa14f	修复修正+混淆改善	2022-02-10 18:57:21 +08:00
Ghost_chu	0f4bf90f56	文档：添加缺失的 java 标记	2022-02-10 17:48:37 +08:00
Ghost_chu	8e57305b83	添加蠢爆了的 EasySQL 使用指南	2022-02-10 17:47:04 +08:00
carm	855a08050f	Merge pull request #29 from CarmJos/dependabot/maven/org.slf4j-slf4j-api-1.7.36 Bump slf4j-api from 1.7.35 to 1.7.36	2022-02-09 20:43:53 +08:00
dependabot[bot]	904f1bdfda	Bump slf4j-api from 1.7.35 to 1.7.36 Bumps [slf4j-api](https://github.com/qos-ch/slf4j) from 1.7.35 to 1.7.36. - [Release notes](https://github.com/qos-ch/slf4j/releases) - [Commits](https://github.com/qos-ch/slf4j/compare/v_1.7.35...v_1.7.36) --- updated-dependencies: - dependency-name: org.slf4j:slf4j-api dependency-type: direct:production update-type: version-update:semver-patch ... Signed-off-by: dependabot[bot] <support@github.com>	2022-02-09 08:45:20 +00:00
carm	508a560eed	Merge pull request #28 from Ghost-chu/patch-1 修复 extraColumns 缺少 BackQuote 的问题	2022-02-06 14:01:19 +08:00
Ghost_chu	469c204d4c	修复 extraColumns 缺少 BackQuote 的问题	2022-02-06 14:00:50 +08:00