[0.3.7] 修复Javadoc错误

- `[A]` 为 UpdateBuilder 添加 `#addColumnValue(String,Object)` 方法。
- `[A]` 补充部分Builder的JavaDoc。

.documentation/README.md

@@ -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)

.documentation/USAGE-HIKARI.md

@@ -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 终究能找到继续生活下去的办法 :)
+

.github/ISSUE_TEMPLATE/bugs_report.md

@@ -1,6 +1,9 @@
 ---
-name: 问题提交 about: 描述问题并提交，帮助我们对其进行检查与修复。 title: ''
-labels: bug assignees: ''
+name: 问题提交 
+about: 描述问题并提交，帮助我们对其进行检查与修复。 
+title: ''
+labels: bug 
+assignees: ''
 
 ---
 

.github/ISSUE_TEMPLATE/feature_issues.md

@@ -1,7 +1,9 @@
 ---
-name: 功能需求 about: 希望我们提供更多的功能。 title: ''
-labels: enhancement assignees: ''
-
+name: 功能需求 
+about: 希望我们提供更多的功能。 
+title: ''
+labels: enhancement 
+assignees: ''
 ---
 
 ### **功能简述**

.github/dependabot.yml

@@ -0,0 +1,11 @@
+# To get started with Dependabot version updates, you'll need to specify which
+# package ecosystems to update and where the package manifests are located.
+# Please see the documentation for all configuration options:
+# https://help.github.com/github/administering-a-repository/configuration-options-for-dependency-updates
+
+version: 2
+updates:
+  - package-ecosystem: "maven" # See documentation for possible values
+    directory: "/" # Location of package manifests
+    schedule:
+      interval: "daily"

.github/workflows/maven.yml

@@ -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"

README.md

@@ -48,8 +48,16 @@
 
 <project>
     <repositories>
+
         <repository>
-            <!--采用github依赖库，安全稳定，但需要配置 (推荐)-->
+            <!--采用Maven中心库，安全稳定，但版本更新需要等待同步-->
+            <id>maven</id>
+            <name>Maven Central</name>
+            <url>https://repo1.maven.org/maven2</url>
+        </repository>
+        
+        <repository>
+            <!--采用github依赖库，实时更新，但需要配置 (推荐) -->
             <id>EasySQL</id>
             <name>GitHub Packages</name>
             <url>https://maven.pkg.github.com/CarmJos/EasySQL</url>
@@ -130,7 +138,11 @@
 
 ```groovy
 repositories {
-    // 采用github依赖库，安全稳定，但需要配置 (推荐)
+
+    // 采用Maven中心库，安全稳定，但版本更新需要等待同步 
+    mavenCentral()
+    
+    // 采用github依赖库，实时更新，但需要配置 (推荐)
     maven { url 'https://maven.pkg.github.com/CarmJos/EasySQL' }
 
     // 采用我的私人依赖库，简单方便，但可能因为变故而无法使用
@@ -202,4 +214,4 @@ dependencies {
 > MIT 协议是所有开源许可中最宽松的一个，除了必须包含许可声明外，再无任何限制。
 >
 > *以上文字来自 [五种开源协议GPL,LGPL,BSD,MIT,Apache](https://www.oschina.net/question/54100_9455) 。*
-</details>
+</details> 

easysql-api/pom.xml

@@ -5,7 +5,7 @@
     <parent>
         <groupId>cc.carm.lib</groupId>
         <artifactId>easysql-parent</artifactId>
-        <version>0.3.1</version>
+        <version>0.3.7</version>
     </parent>
     <modelVersion>4.0.0</modelVersion>
 
@@ -19,7 +19,7 @@
     <artifactId>easysql-api</artifactId>
     <packaging>jar</packaging>
 
-    <name>00-EasySQL-API</name>
+    <name>EasySQL-API</name>
     <description>EasySQL的接口部分。用于打包到公共项目的API中，避免项目过大。</description>
     <url>https://github.com/CarmJos/EasySQL</url>
 
@@ -44,12 +44,12 @@
 
     <issueManagement>
         <system>GitHub Issues</system>
-        <url>${project.url}/issues</url>
+        <url>https://github.com/CarmJos/EasySQL/issues</url>
     </issueManagement>
 
     <ciManagement>
         <system>GitHub Actions</system>
-        <url>${project.url}/actions/workflows/maven.yml</url>
+        <url>https://github.com/CarmJos/EasySQL/actions/workflows/maven.yml</url>
     </ciManagement>
 
     <build>

easysql-api/src/main/java/cc/carm/lib/easysql/api/SQLAction.java

@@ -98,7 +98,7 @@ public interface SQLAction<T> {
 	 */
 	@Nullable
 	default <R> R execute(@NotNull SQLFunction<T, R> function,
-						  @Nullable SQLExceptionHandler exceptionHandler) {
+	                      @Nullable SQLExceptionHandler exceptionHandler) {
 		return execute(function, null, exceptionHandler);
 	}
 
@@ -114,8 +114,8 @@ public interface SQLAction<T> {
 	@Nullable
 	@Contract("_,!null,_ -> !null")
 	default <R> R execute(@NotNull SQLFunction<T, R> function,
-						  @Nullable R defaultResult,
-						  @Nullable SQLExceptionHandler exceptionHandler) {
+	                      @Nullable R defaultResult,
+	                      @Nullable SQLExceptionHandler exceptionHandler) {
 		try {
 			return executeFunction(function, defaultResult);
 		} catch (SQLException exception) {
@@ -133,7 +133,7 @@ public interface SQLAction<T> {
 	 * @throws SQLException 当SQL操作出现问题时抛出
 	 */
 	@Nullable
-	default <R> R executeFunction(@NotNull SQLFunction<T, R> function) throws SQLException {
+	default <R> R executeFunction(@NotNull SQLFunction<@NotNull T, R> function) throws SQLException {
 		return executeFunction(function, null);
 	}
 
@@ -148,11 +148,10 @@ public interface SQLAction<T> {
 	 */
 	@Nullable
 	@Contract("_,!null -> !null")
-	default <R> R executeFunction(@NotNull SQLFunction<T, R> function,
-								  @Nullable R defaultResult) throws SQLException {
+	default <R> R executeFunction(@NotNull SQLFunction<@NotNull T, R> function,
+	                              @Nullable R defaultResult) throws SQLException {
 		try {
-			T value = execute();
-			R result = function.apply(value);
+			R result = function.apply(execute());
 			return result == null ? defaultResult : result;
 		} catch (SQLException exception) {
 			throw new SQLException(exception);
@@ -182,7 +181,7 @@ public interface SQLAction<T> {
 	 * @param failure 异常处理器 默认为 {@link SQLAction#defaultExceptionHandler()}
 	 */
 	void executeAsync(@Nullable SQLHandler<T> success,
-					  @Nullable SQLExceptionHandler failure);
+	                  @Nullable SQLExceptionHandler failure);
 
 	default void handleException(@Nullable SQLExceptionHandler handler, SQLException exception) {
 		if (handler == null) handler = defaultExceptionHandler();

easysql-api/src/main/java/cc/carm/lib/easysql/api/SQLBuilder.java

@@ -11,11 +11,22 @@ import org.jetbrains.annotations.NotNull;
  */
 public interface SQLBuilder {
 
-    /**
-     * 得到承载该Builder的对应{@link SQLManager}
-     *
-     * @return {@link SQLManager}
-     */
-    @NotNull SQLManager getManager();
+	/**
+	 * 得到承载该Builder的对应{@link SQLManager}
+	 *
+	 * @return {@link SQLManager}
+	 */
+	@NotNull SQLManager getManager();
+
+
+	static @NotNull String withBackQuote(@NotNull String str) {
+		str = str.trim();
+		return str.startsWith("`") && str.endsWith("`") ? str : "`" + str + "`";
+	}
+
+	static @NotNull String withQuote(@NotNull String str) {
+		str = str.trim();
+		return str.startsWith("'") && str.endsWith("'") ? str : "'" + str + "'";
+	}
 
 }

easysql-api/src/main/java/cc/carm/lib/easysql/api/action/PreparedSQLUpdateBatchAction.java

@@ -6,39 +6,51 @@ import java.util.List;
 
 public interface PreparedSQLUpdateBatchAction extends SQLAction<List<Integer>> {
 
-    /**
-     * 设定多组SQL语句中所有 ? 对应的参数
-     *
-     * @param allParams 所有参数内容
-     * @return {@link PreparedSQLUpdateBatchAction}
-     */
-    PreparedSQLUpdateBatchAction setAllParams(Iterable<Object[]> allParams);
+	/**
+	 * 设定多组SQL语句中所有 ? 对应的参数
+	 *
+	 * @param allParams 所有参数内容
+	 * @return {@link PreparedSQLUpdateBatchAction}
+	 */
+	PreparedSQLUpdateBatchAction setAllParams(Iterable<Object[]> allParams);
 
-    /**
-     * 添加一组SQL语句中所有 ? 对应的参数
-     *
-     * @param params 参数内容
-     * @return {@link PreparedSQLUpdateBatchAction}
-     */
-    PreparedSQLUpdateBatchAction addParamsBatch(Object... params);
+	/**
+	 * 添加一组SQL语句中所有 ? 对应的参数
+	 *
+	 * @param params 参数内容
+	 * @return {@link PreparedSQLUpdateBatchAction}
+	 */
+	PreparedSQLUpdateBatchAction addParamsBatch(Object... params);
 
-    /**
-     * 设定自增主键的序列
-     *
-     * @param keyColumnIndex 自增主键的序列
-     *                       <br>若该值 ＞ 0，则 {@link #execute()} 返回自增主键数值
-     *                       <br>若该值 ≤ 0，则 {@link #execute()} 返回变更的行数
-     * @return {@link PreparedSQLUpdateBatchAction}
-     */
-    PreparedSQLUpdateBatchAction setKeyIndex(int keyColumnIndex);
+	/**
+	 * 设定自增主键的序列
+	 *
+	 * @param keyColumnIndex 自增主键的序列
+	 *                       <br>若该值 ＞ 0，则 {@link #execute()} 返回自增主键数值
+	 *                       <br>若该值 ≤ 0，则 {@link #execute()} 返回变更的行数
+	 * @return {@link PreparedSQLUpdateBatchAction}
+	 * @see #setReturnGeneratedKeys(boolean)
+	 */
+	@Deprecated
+	default PreparedSQLUpdateBatchAction setKeyIndex(int keyColumnIndex) {
+		return setReturnGeneratedKeys(keyColumnIndex > 0);
+	}
 
-    /**
-     * 默认主键序列的数值为 -1 (≤0) ，即默认返回发生变更的行数。
-     *
-     * @return 默认主键序列
-     */
-    default PreparedSQLUpdateBatchAction defaultKeyIndex() {
-        return setKeyIndex(-1); // will return changed lines number
-    }
+	/**
+	 * 设定该操作返回自增键序列。
+	 *
+	 * @return {@link PreparedSQLUpdateBatchAction}
+	 */
+	default PreparedSQLUpdateBatchAction returnGeneratedKeys() {
+		return setReturnGeneratedKeys(true);
+	}
+
+	/**
+	 * 设定该操作是否返回自增键序列。
+	 *
+	 * @param returnGeneratedKey 是否返回自增键序列
+	 * @return {@link PreparedSQLUpdateBatchAction}
+	 */
+	PreparedSQLUpdateBatchAction setReturnGeneratedKeys(boolean returnGeneratedKey);
 
 }

easysql-api/src/main/java/cc/carm/lib/easysql/api/action/SQLUpdateAction.java

@@ -11,17 +11,28 @@ public interface SQLUpdateAction extends SQLAction<Integer> {
      *                       <br>若该值 ＞ 0，则 {@link #execute()} 返回自增主键数值
      *                       <br>若该值 ≤ 0，则 {@link #execute()} 返回变更的行数
      * @return {@link SQLUpdateAction}
+     * @see #setReturnGeneratedKey(boolean)
      */
-    SQLUpdateAction setKeyIndex(int keyColumnIndex);
-
-    /**
-     * 默认主键序列的数值为 -1 (≤0) ，即默认返回发生变更的行数。
-     *
-     * @return 默认主键序列
-     */
-    default SQLUpdateAction defaultKeyIndex() {
-        return setKeyIndex(-1); // will return changed lines number
+    @Deprecated
+    default SQLUpdateAction setKeyIndex(int keyColumnIndex) {
+        return setReturnGeneratedKey(keyColumnIndex > 0);
     }
 
+    /**
+     * 设定该操作返回自增键序列。
+     *
+     * @return {@link SQLUpdateAction}
+     */
+    default SQLUpdateAction returnGeneratedKey() {
+        return setReturnGeneratedKey(true);
+    }
+
+    /**
+     * 设定该操作是否返回自增键序列。
+     *
+     * @param returnGeneratedKey 是否返回自增键序列
+     * @return {@link SQLUpdateAction}
+     */
+    SQLUpdateAction setReturnGeneratedKey(boolean returnGeneratedKey);
 
 }

easysql-api/src/main/java/cc/carm/lib/easysql/api/action/SQLUpdateBatchAction.java

@@ -15,6 +15,7 @@ public interface SQLUpdateBatchAction extends SQLAction<List<Integer>> {
 	 */
 	SQLUpdateBatchAction addBatch(@NotNull String sql);
 
+	@Override
 	default @NotNull String getSQLContent() {
 		return getSQLContents().get(0);
 	}

easysql-api/src/main/java/cc/carm/lib/easysql/api/action/query/QueryAction.java

@@ -32,20 +32,10 @@ import java.sql.SQLException;
  */
 public interface QueryAction extends SQLAction<SQLQuery> {
 
-	/**
-	 * 执行语句并处理返回值
-	 *
-	 * @param defaultResult 默认结果，若处理后的结果为null，则返回该值
-	 * @param function      处理方法
-	 * @param <R>           需要返回的内容
-	 * @return 指定类型数据
-	 * @throws SQLException 当SQL操作出现问题时抛出
-	 */
-	@Nullable
-	@Contract("!null, _ -> !null")
-	default <R> R executeFunction(@Nullable R defaultResult,
-								  @NotNull SQLFunction<SQLQuery, R> function) throws SQLException {
-
+	@Override
+	@Contract("_,!null -> !null")
+	default <R> @Nullable R executeFunction(@NotNull SQLFunction<@NotNull SQLQuery, R> function,
+	                                        @Nullable R defaultResult) throws SQLException {
 		try (SQLQuery value = execute()) {
 			R result = function.apply(value);
 			return result == null ? defaultResult : result;

easysql-api/src/main/java/cc/carm/lib/easysql/api/builder/ConditionalBuilder.java

@@ -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);
 
 
 }

easysql-api/src/main/java/cc/carm/lib/easysql/api/builder/TableCreateBuilder.java

@@ -8,6 +8,10 @@ import cc.carm.lib.easysql.api.enums.NumberType;
 import org.jetbrains.annotations.NotNull;
 import org.jetbrains.annotations.Nullable;
 
+import static cc.carm.lib.easysql.api.SQLBuilder.withBackQuote;
+import static cc.carm.lib.easysql.api.SQLBuilder.withQuote;
+
+
 public interface TableCreateBuilder extends SQLBuilder {
 
 	/**
@@ -63,7 +67,7 @@ public interface TableCreateBuilder extends SQLBuilder {
 	 * @return {@link TableCreateBuilder}
 	 */
 	default TableCreateBuilder addColumn(@NotNull String columnName, @NotNull String settings) {
-		return addColumn("`" + columnName + "` " + settings);
+		return addColumn(withBackQuote(columnName) + " " + settings);
 	}
 
 	/**
@@ -76,7 +80,7 @@ public interface TableCreateBuilder extends SQLBuilder {
 	 * @return {@link TableCreateBuilder}
 	 */
 	default TableCreateBuilder addColumn(@NotNull String columnName, @NotNull String settings, @NotNull String comments) {
-		return addColumn(columnName, settings + " COMMENT '" + comments + "'");
+		return addColumn(columnName, settings + " COMMENT " + withQuote(comments));
 	}
 
 	/**
@@ -91,7 +95,7 @@ public interface TableCreateBuilder extends SQLBuilder {
 	 * @return {@link TableCreateBuilder}
 	 */
 	TableCreateBuilder addAutoIncrementColumn(@NotNull String columnName, @Nullable NumberType numberType,
-											  boolean asPrimaryKey, boolean unsigned);
+	                                          boolean asPrimaryKey, boolean unsigned);
 
 	/**
 	 * 为该表添加一个INT类型的自增主键列
@@ -104,7 +108,7 @@ public interface TableCreateBuilder extends SQLBuilder {
 	 * @return {@link TableCreateBuilder}
 	 */
 	default TableCreateBuilder addAutoIncrementColumn(@NotNull String columnName,
-													  boolean asPrimaryKey, boolean unsigned) {
+	                                                  boolean asPrimaryKey, boolean unsigned) {
 		return addAutoIncrementColumn(columnName, NumberType.INT, asPrimaryKey, unsigned);
 	}
 
@@ -146,7 +150,7 @@ public interface TableCreateBuilder extends SQLBuilder {
 	 * @return {@link TableCreateBuilder}
 	 */
 	default TableCreateBuilder setIndex(@NotNull String columnName,
-										@NotNull IndexType type) {
+	                                    @NotNull IndexType type) {
 		return setIndex(type, null, columnName);
 	}
 
@@ -164,7 +168,7 @@ public interface TableCreateBuilder extends SQLBuilder {
 	 * @return {@link TableCreateBuilder}
 	 */
 	TableCreateBuilder setIndex(@NotNull IndexType type, @Nullable String indexName,
-								@NotNull String columnName, @NotNull String... moreColumns);
+	                            @NotNull String columnName, @NotNull String... moreColumns);
 
 
 	/**
@@ -197,7 +201,7 @@ public interface TableCreateBuilder extends SQLBuilder {
 	 * @return {@link TableCreateBuilder}
 	 */
 	default TableCreateBuilder addForeignKey(@NotNull String tableColumn,
-											 @NotNull String foreignTable, @NotNull String foreignColumn) {
+	                                         @NotNull String foreignTable, @NotNull String foreignColumn) {
 		return addForeignKey(tableColumn, null, foreignTable, foreignColumn);
 	}
 
@@ -217,7 +221,7 @@ public interface TableCreateBuilder extends SQLBuilder {
 	 * @return {@link TableCreateBuilder}
 	 */
 	default TableCreateBuilder addForeignKey(@NotNull String tableColumn, @Nullable String constraintName,
-											 @NotNull String foreignTable, @NotNull String foreignColumn) {
+	                                         @NotNull String foreignTable, @NotNull String foreignColumn) {
 		return addForeignKey(tableColumn, constraintName, foreignTable, foreignColumn, null, null);
 	}
 
@@ -239,8 +243,8 @@ public interface TableCreateBuilder extends SQLBuilder {
 	 * @return {@link TableCreateBuilder}
 	 */
 	TableCreateBuilder addForeignKey(@NotNull String tableColumn, @Nullable String constraintName,
-									 @NotNull String foreignTable, @NotNull String foreignColumn,
-									 @Nullable ForeignKeyRule updateRule, @Nullable ForeignKeyRule deleteRule);
+	                                 @NotNull String foreignTable, @NotNull String foreignColumn,
+	                                 @Nullable ForeignKeyRule updateRule, @Nullable ForeignKeyRule deleteRule);
 
 	default String defaultTablesSettings() {
 		return "ENGINE=InnoDB DEFAULT CHARSET=utf8";

easysql-api/src/main/java/cc/carm/lib/easysql/api/builder/UpdateBuilder.java

@@ -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});
+    }
 
 
 }

easysql-api/src/main/java/cc/carm/lib/easysql/api/builder/UpsertBuilder.java

@@ -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 .");
+    }
 
 }

easysql-api/src/main/java/cc/carm/lib/easysql/api/enums/ForeignKeyRule.java

@@ -28,7 +28,7 @@ public enum ForeignKeyRule {
 	 */
 	CASCADE("CASCADE");
 
-	String ruleName;
+	final String ruleName;
 
 	ForeignKeyRule(String ruleName) {
 		this.ruleName = ruleName;

easysql-api/src/main/java/cc/carm/lib/easysql/api/enums/IndexType.java

@@ -29,7 +29,7 @@ public enum IndexType {
 	FULLTEXT_INDEX("FULLTEXT");
 
 
-	String name;
+	final String name;
 
 	IndexType(String name) {
 		this.name = name;

easysql-impl/pom.xml

@@ -5,7 +5,7 @@
     <parent>
         <artifactId>easysql-parent</artifactId>
         <groupId>cc.carm.lib</groupId>
-        <version>0.3.1</version>
+        <version>0.3.7</version>
     </parent>
     <modelVersion>4.0.0</modelVersion>
 
@@ -19,7 +19,7 @@
     <artifactId>easysql-impl</artifactId>
     <packaging>jar</packaging>
 
-    <name>01-EasySQL-Impl</name>
+    <name>EasySQL-Impl</name>
     <description>EasySQL的实现部分。</description>
     <url>https://github.com/CarmJos/EasySQL</url>
 
@@ -44,12 +44,12 @@
 
     <issueManagement>
         <system>GitHub Issues</system>
-        <url>${project.url}/issues</url>
+        <url>https://github.com/CarmJos/EasySQL/issues</url>
     </issueManagement>
 
     <ciManagement>
         <system>GitHub Actions</system>
-        <url>${project.url}/actions/workflows/maven.yml</url>
+        <url>https://github.com/CarmJos/EasySQL/actions/workflows/maven.yml</url>
     </ciManagement>
 
     <dependencies>

easysql-impl/src/main/java/cc/carm/lib/easysql/action/AbstractSQLAction.java

@@ -65,7 +65,7 @@ public abstract class AbstractSQLAction<T> implements SQLAction<T> {
 	}
 
 	protected void outputDebugMessage() {
-		getManager().debug("#" + getShortID() + " -> { " + getSQLContent() + " }");
+		getManager().debug("# " + getShortID() + " -> { " + getSQLContent() + " }");
 	}
 
 	@Override

easysql-impl/src/main/java/cc/carm/lib/easysql/action/PreparedSQLBatchUpdateActionImpl.java

@@ -15,63 +15,60 @@ import java.util.List;
 import java.util.stream.Collectors;
 
 public class PreparedSQLBatchUpdateActionImpl
-        extends AbstractSQLAction<List<Integer>>
-        implements PreparedSQLUpdateBatchAction {
+		extends AbstractSQLAction<List<Integer>>
+		implements PreparedSQLUpdateBatchAction {
 
-    int keyIndex = -1;
-    List<Object[]> allParams;
+	boolean returnKeys = false;
+	List<Object[]> allParams;
 
-    public PreparedSQLBatchUpdateActionImpl(@NotNull SQLManagerImpl manager, @NotNull String sql) {
-        super(manager, sql);
-        this.allParams = new ArrayList<>();
-    }
+	public PreparedSQLBatchUpdateActionImpl(@NotNull SQLManagerImpl manager, @NotNull String sql) {
+		super(manager, sql);
+		this.allParams = new ArrayList<>();
+	}
 
-    @Override
-    public PreparedSQLUpdateBatchAction setAllParams(Iterable<Object[]> allParams) {
-        List<Object[]> paramsList = new ArrayList<>();
-        allParams.forEach(paramsList::add);
-        this.allParams = paramsList;
-        return this;
-    }
+	@Override
+	public PreparedSQLUpdateBatchAction setAllParams(Iterable<Object[]> allParams) {
+		List<Object[]> paramsList = new ArrayList<>();
+		allParams.forEach(paramsList::add);
+		this.allParams = paramsList;
+		return this;
+	}
 
-    @Override
-    public PreparedSQLUpdateBatchAction addParamsBatch(Object[] params) {
-        this.allParams.add(params);
-        return this;
-    }
+	@Override
+	public PreparedSQLUpdateBatchAction addParamsBatch(Object... params) {
+		this.allParams.add(params);
+		return this;
+	}
 
-    @Override
-    public PreparedSQLUpdateBatchAction setKeyIndex(int keyColumnIndex) {
-        this.keyIndex = keyColumnIndex;
-        return this;
-    }
+	@Override
+	public PreparedSQLUpdateBatchAction setReturnGeneratedKeys(boolean returnGeneratedKey) {
+		this.returnKeys = returnGeneratedKey;
+		return this;
+	}
 
-    @Override
-    public @NotNull List<Integer> execute() throws SQLException {
-        List<Integer> returnedValues;
-        Connection connection = getManager().getConnection();
-        PreparedStatement statement = StatementUtil.createPrepareStatementBatch(
-                connection, getSQLContent(), allParams, keyIndex > 0
-        );
-        outputDebugMessage();
-        if (keyIndex > 0) {
-            statement.executeBatch();
-            List<Integer> generatedKeys = new ArrayList<>();
-            ResultSet resultSet = statement.getGeneratedKeys();
-            if (resultSet != null) {
-                while (resultSet.next()) generatedKeys.add(resultSet.getInt(keyIndex));
-                resultSet.close();
-            }
-            returnedValues = generatedKeys;
-        } else {
-            int[] executed = statement.executeBatch();
-            returnedValues = Arrays.stream(executed).boxed().collect(Collectors.toList());
-        }
+	@Override
+	public @NotNull List<Integer> execute() throws SQLException {
+		try (Connection connection = getManager().getConnection()) {
+			try (PreparedStatement statement = StatementUtil.createPrepareStatementBatch(
+					connection, getSQLContent(), allParams, returnKeys
+			)) {
 
-        statement.close();
-        connection.close();
+				outputDebugMessage();
+				int[] executed = statement.executeBatch();
 
-        return returnedValues;
-    }
+				if (!returnKeys) return Arrays.stream(executed).boxed().collect(Collectors.toList());
+				else {
+					try (ResultSet resultSet = statement.getGeneratedKeys()) {
+						List<Integer> generatedKeys = new ArrayList<>();
+						while (resultSet.next()) {
+							generatedKeys.add(resultSet.getInt(1));
+						}
+						return generatedKeys;
+					}
+				}
+			}
+
+		}
+	}
 
 }

easysql-impl/src/main/java/cc/carm/lib/easysql/action/PreparedSQLUpdateActionImpl.java

@@ -24,18 +24,18 @@ public class PreparedSQLUpdateActionImpl
 	}
 
 	public PreparedSQLUpdateActionImpl(@NotNull SQLManagerImpl manager, @NotNull String sql,
-									   @Nullable List<Object> params) {
+	                                   @Nullable List<Object> params) {
 		this(manager, sql, params == null ? null : params.toArray());
 	}
 
 	public PreparedSQLUpdateActionImpl(@NotNull SQLManagerImpl manager, @NotNull String sql,
-									   @Nullable Object[] params) {
+	                                   @Nullable Object[] params) {
 		super(manager, sql);
 		this.params = params;
 	}
 
 	@Override
-	public PreparedSQLUpdateActionImpl setParams(Object[] params) {
+	public PreparedSQLUpdateActionImpl setParams(Object... params) {
 		this.params = params;
 		return this;
 	}
@@ -53,28 +53,25 @@ public class PreparedSQLUpdateActionImpl
 
 	@Override
 	public @NotNull Integer execute() throws SQLException {
-		int value = -1;
+		try (Connection connection = getManager().getConnection()) {
+
+			try (PreparedStatement statement = StatementUtil.createPrepareStatement(
+					connection, getSQLContent(), params, returnGeneratedKeys
+			)) {
+
+				outputDebugMessage();
+
+				int changes = statement.executeUpdate();
+				if (!returnGeneratedKeys) return changes;
+				else {
+					try (ResultSet resultSet = statement.getGeneratedKeys()) {
+						return resultSet.next() ? resultSet.getInt(1) : -1;
+					}
+				}
 
-		Connection connection = getManager().getConnection();
-		PreparedStatement statement = StatementUtil.createPrepareStatement(
-				connection, getSQLContent(), params, keyIndex > 0
-		);
-		outputDebugMessage();
-		if (keyIndex > 0) {
-			statement.executeUpdate();
-			ResultSet resultSet = statement.getGeneratedKeys();
-			if (resultSet != null) {
-				if (resultSet.next()) value = resultSet.getInt(keyIndex);
-				resultSet.close();
 			}
-		} else {
-			value = statement.executeUpdate();
 		}
 
-		statement.close();
-		connection.close();
-
-		return value;
 	}
 
 }

easysql-impl/src/main/java/cc/carm/lib/easysql/action/SQLUpdateActionImpl.java

@@ -13,42 +13,36 @@ public class SQLUpdateActionImpl
 		extends AbstractSQLAction<Integer>
 		implements SQLUpdateAction {
 
-    int keyIndex = -1;
+	boolean returnGeneratedKeys = false;
 
-    public SQLUpdateActionImpl(@NotNull SQLManagerImpl manager, @NotNull String sql) {
-        super(manager, sql);
-    }
+	public SQLUpdateActionImpl(@NotNull SQLManagerImpl manager, @NotNull String sql) {
+		super(manager, sql);
+	}
 
-    @Override
-    public @NotNull Integer execute() throws SQLException {
-        int returnedValue = -1;
-        Connection connection = getManager().getConnection();
-        Statement statement = connection.createStatement();
-        outputDebugMessage();
-        if (keyIndex > 0) {
-            statement.executeUpdate(getSQLContent(), Statement.RETURN_GENERATED_KEYS);
-            ResultSet resultSet = statement.getGeneratedKeys();
-            if (resultSet != null) {
-                if (resultSet.next()) {
-                    returnedValue = resultSet.getInt(keyIndex);
-                }
-                resultSet.close();
-            }
-        } else {
-            returnedValue = statement.executeUpdate(getSQLContent());
-        }
+	@Override
+	public @NotNull Integer execute() throws SQLException {
+		try (Connection connection = getManager().getConnection()) {
+			try (Statement statement = connection.createStatement()) {
+				outputDebugMessage();
 
-        statement.close();
-        connection.close();
+				if (!returnGeneratedKeys) {
+					return statement.executeUpdate(getSQLContent());
+				} else {
+					statement.executeUpdate(getSQLContent(), Statement.RETURN_GENERATED_KEYS);
 
-        return returnedValue;
-    }
+					try (ResultSet resultSet = statement.getGeneratedKeys()) {
+						return resultSet.next() ? resultSet.getInt(1) : -1;
+					}
+				}
+			}
+		}
+	}
 
 
-    @Override
-    public SQLUpdateActionImpl setKeyIndex(int keyIndex) {
-        this.keyIndex = keyIndex;
-        return this;
-    }
+	@Override
+	public SQLUpdateAction setReturnGeneratedKey(boolean returnGeneratedKey) {
+		this.returnGeneratedKeys = returnGeneratedKey;
+		return this;
+	}
 
 }

easysql-impl/src/main/java/cc/carm/lib/easysql/action/SQLUpdateBatchActionImpl.java

@@ -36,27 +36,28 @@ public class SQLUpdateBatchActionImpl
 
 	@Override
 	public @NotNull List<Integer> execute() throws SQLException {
-		Connection connection = getManager().getConnection();
-		Statement statement = connection.createStatement();
-		outputDebugMessage();
+		try (Connection connection = getManager().getConnection()) {
+
+			try (Statement statement = connection.createStatement()) {
+				outputDebugMessage();
+
+				for (String content : this.sqlContents) {
+					statement.addBatch(content);
+				}
+
+				int[] executed = statement.executeBatch();
+
+				return Arrays.stream(executed).boxed().collect(Collectors.toList());
+			}
 
-		for (String content : this.sqlContents) {
-			statement.addBatch(content);
 		}
-		int[] executed = statement.executeBatch();
-		List<Integer> returnedValues = Arrays.stream(executed).boxed().collect(Collectors.toList());
-
-		statement.close();
-		connection.close();
-
-		return returnedValues;
 	}
 
 	@Override
 	protected void outputDebugMessage() {
-		getManager().debug("#" + getShortID() + " -> {");
-		for (String content : getSQLContents()) getManager().debug("  " + content);
-		getManager().debug("}");
+		getManager().debug("# " + getShortID() + " -> [");
+		for (String content : getSQLContents()) getManager().debug(" { " + content + " }");
+		getManager().debug("]");
 
 	}
 

easysql-impl/src/main/java/cc/carm/lib/easysql/action/query/PreparedQueryActionImpl.java

@@ -9,7 +9,6 @@ import org.jetbrains.annotations.Nullable;
 
 import java.sql.Connection;
 import java.sql.PreparedStatement;
-import java.sql.ResultSet;
 import java.sql.SQLException;
 import java.util.ArrayList;
 import java.util.List;
@@ -25,7 +24,7 @@ public class PreparedQueryActionImpl extends QueryActionImpl implements Prepared
 	}
 
 	@Override
-	public PreparedQueryActionImpl setParams(@Nullable Object[] params) {
+	public PreparedQueryActionImpl setParams(@Nullable Object... params) {
 		this.params = params;
 		return this;
 	}
@@ -54,21 +53,34 @@ public class PreparedQueryActionImpl extends QueryActionImpl implements Prepared
 
 		Connection connection = getManager().getConnection();
 		PreparedStatement preparedStatement;
-		if (handler == null) {
-			preparedStatement = StatementUtil.createPrepareStatement(connection, getSQLContent(), this.params);
-		} else {
-			preparedStatement = connection.prepareStatement(getSQLContent());
-			handler.accept(preparedStatement);
+		try {
+			if (handler == null) {
+				preparedStatement = StatementUtil.createPrepareStatement(connection, getSQLContent(), this.params);
+			} else {
+				preparedStatement = connection.prepareStatement(getSQLContent());
+				handler.accept(preparedStatement);
+			}
+		} catch (SQLException exception) {
+			connection.close();
+			throw exception;
 		}
 
-		long executeTime = System.currentTimeMillis();
-		ResultSet resultSet = preparedStatement.executeQuery();
+		try {
+			long executeTime = System.currentTimeMillis();
+			SQLQueryImpl query = new SQLQueryImpl(
+					getManager(), this,
+					connection, preparedStatement,
+					preparedStatement.executeQuery(),
+					executeTime
+			);
+			getManager().getActiveQuery().put(getActionUUID(), query);
 
-		return new SQLQueryImpl(
-				getManager(), this,
-				connection, preparedStatement, resultSet,
-				executeTime
-		);
+			return query;
+		} catch (SQLException exception) {
+			preparedStatement.close();
+			connection.close();
+			throw exception;
+		}
 
 	}
 }

easysql-impl/src/main/java/cc/carm/lib/easysql/action/query/QueryActionImpl.java

@@ -10,7 +10,6 @@ import cc.carm.lib.easysql.query.SQLQueryImpl;
 import org.jetbrains.annotations.NotNull;
 
 import java.sql.Connection;
-import java.sql.ResultSet;
 import java.sql.SQLException;
 import java.sql.Statement;
 
@@ -24,21 +23,32 @@ public class QueryActionImpl extends AbstractSQLAction<SQLQuery> implements Quer
 	public @NotNull SQLQueryImpl execute() throws SQLException {
 
 		Connection connection = getManager().getConnection();
-		Statement statement = connection.createStatement();
+		Statement statement;
 
+		try {
+			statement = connection.createStatement();
+		} catch (SQLException ex) {
+			connection.close();
+			throw ex;
+		}
+		
 		outputDebugMessage();
+		try {
+			long executeTime = System.currentTimeMillis();
+			SQLQueryImpl query = new SQLQueryImpl(
+					getManager(), this,
+					connection, statement,
+					statement.executeQuery(getSQLContent()),
+					executeTime
+			);
+			getManager().getActiveQuery().put(getActionUUID(), query);
 
-		long executeTime = System.currentTimeMillis();
-		ResultSet resultSet = statement.executeQuery(getSQLContent());
-		SQLQueryImpl query = new SQLQueryImpl(
-				getManager(), this,
-				connection, statement, resultSet,
-				executeTime
-		);
-
-		getManager().getActiveQuery().put(getActionUUID(), query);
-
-		return query;
+			return query;
+		} catch (SQLException exception) {
+			statement.close();
+			connection.close();
+			throw exception;
+		}
 	}
 
 

easysql-impl/src/main/java/cc/carm/lib/easysql/builder/impl/AbstractConditionalBuilder.java

@@ -14,6 +14,8 @@ import java.util.Date;
 import java.util.Iterator;
 import java.util.LinkedHashMap;
 
+import static cc.carm.lib.easysql.api.SQLBuilder.withBackQuote;
+
 public abstract class AbstractConditionalBuilder<B extends ConditionalBuilder<B, T>, T extends SQLAction<?>>
 		extends AbstractSQLBuilder implements ConditionalBuilder<B, T> {
 
@@ -51,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("`" + 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 (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("`" + 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("`" + queryName + "` BETWEEN ? AND ?");
+			addCondition(withBackQuote(columnName) + " BETWEEN ? AND ?");
 			this.conditionParams.add(startDate);
 			if (endDate != null) {
 				this.conditionParams.add(endDate);
@@ -98,7 +100,7 @@ public abstract class AbstractConditionalBuilder<B extends ConditionalBuilder<B,
 				}
 			}
 		} else {
-			addCondition(queryName, "<=", endDate);
+			addCondition(columnName, "<=", endDate);
 		}
 		return getThis();
 	}
@@ -118,9 +120,9 @@ public abstract class AbstractConditionalBuilder<B extends ConditionalBuilder<B,
 			Iterator<String> iterator = conditionSQLs.iterator();
 			while (iterator.hasNext()) {
 				conditionBuilder.append(iterator.next());
-				if (iterator.hasNext()) conditionBuilder.append(" ");
+				if (iterator.hasNext()) conditionBuilder.append(" AND ");
 			}
-			return conditionBuilder.toString();
+			return conditionBuilder.toString().trim();
 		} else {
 			return null;
 		}

easysql-impl/src/main/java/cc/carm/lib/easysql/builder/impl/DeleteBuilderImpl.java

@@ -7,6 +7,8 @@ import cc.carm.lib.easysql.api.builder.DeleteBuilder;
 import cc.carm.lib.easysql.manager.SQLManagerImpl;
 import org.jetbrains.annotations.NotNull;
 
+import static cc.carm.lib.easysql.api.SQLBuilder.withBackQuote;
+
 public class DeleteBuilderImpl
 		extends AbstractConditionalBuilder<DeleteBuilder, SQLAction<Integer>>
 		implements DeleteBuilder {
@@ -23,7 +25,7 @@ public class DeleteBuilderImpl
 
 		StringBuilder sqlBuilder = new StringBuilder();
 
-		sqlBuilder.append("DELETE FROM `").append(getTableName()).append("`");
+		sqlBuilder.append("DELETE FROM ").append(withBackQuote(getTableName()));
 
 		if (hasConditions()) sqlBuilder.append(" ").append(buildConditionSQL());
 		if (limit > 0) sqlBuilder.append(" ").append(buildLimitSQL());

easysql-impl/src/main/java/cc/carm/lib/easysql/builder/impl/InsertBuilderImpl.java

@@ -9,6 +9,8 @@ import org.jetbrains.annotations.NotNull;
 import java.util.Iterator;
 import java.util.List;
 
+import static cc.carm.lib.easysql.api.SQLBuilder.withBackQuote;
+
 public abstract class InsertBuilderImpl<T extends SQLAction<?>>
 		extends AbstractSQLBuilder implements InsertBuilder<T> {
 
@@ -23,10 +25,10 @@ public abstract class InsertBuilderImpl<T extends SQLAction<?>>
 		int valueLength = columnNames.size();
 		StringBuilder sqlBuilder = new StringBuilder();
 
-		sqlBuilder.append("INSERT IGNORE INTO `").append(tableName).append("`(");
+		sqlBuilder.append("INSERT IGNORE INTO ").append(withBackQuote(tableName)).append("(");
 		Iterator<String> iterator = columnNames.iterator();
 		while (iterator.hasNext()) {
-			sqlBuilder.append("`").append(iterator.next()).append("`");
+			sqlBuilder.append(withBackQuote(iterator.next()));
 			if (iterator.hasNext()) sqlBuilder.append(", ");
 		}
 

easysql-impl/src/main/java/cc/carm/lib/easysql/builder/impl/ReplaceBuilderImpl.java

@@ -9,6 +9,8 @@ import org.jetbrains.annotations.NotNull;
 import java.util.Iterator;
 import java.util.List;
 
+import static cc.carm.lib.easysql.api.SQLBuilder.withBackQuote;
+
 public abstract class ReplaceBuilderImpl<T extends SQLAction<?>>
 		extends AbstractSQLBuilder implements ReplaceBuilder<T> {
 
@@ -23,10 +25,10 @@ public abstract class ReplaceBuilderImpl<T extends SQLAction<?>>
 		int valueLength = columnNames.size();
 		StringBuilder sqlBuilder = new StringBuilder();
 
-		sqlBuilder.append("REPLACE INTO `").append(tableName).append("`(");
+		sqlBuilder.append("REPLACE INTO ").append(withBackQuote(tableName)).append("(");
 		Iterator<String> iterator = columnNames.iterator();
 		while (iterator.hasNext()) {
-			sqlBuilder.append("`").append(iterator.next()).append("`");
+			sqlBuilder.append(withBackQuote(iterator.next()));
 			if (iterator.hasNext()) sqlBuilder.append(", ");
 		}
 

easysql-impl/src/main/java/cc/carm/lib/easysql/builder/impl/TableAlterBuilderImpl.java

@@ -9,6 +9,9 @@ import cc.carm.lib.easysql.manager.SQLManagerImpl;
 import org.jetbrains.annotations.NotNull;
 import org.jetbrains.annotations.Nullable;
 
+import static cc.carm.lib.easysql.api.SQLBuilder.withBackQuote;
+import static cc.carm.lib.easysql.api.SQLBuilder.withQuote;
+
 public class TableAlterBuilderImpl extends AbstractSQLBuilder implements TableAlterBuilder {
 
 	protected final @NotNull String tableName;
@@ -25,28 +28,28 @@ public class TableAlterBuilderImpl extends AbstractSQLBuilder implements TableAl
 	@Override
 	public SQLAction<Integer> renameTo(@NotNull String newTableName) {
 		return new SQLUpdateActionImpl(getManager(),
-				"ALTER TABLE `" + getTableName() + "` RENAME TO `" + newTableName + "`"
+				"ALTER TABLE " + withBackQuote(getTableName()) + " RENAME TO " + withBackQuote(newTableName) + ""
 		);
 	}
 
 	@Override
 	public SQLAction<Integer> changeComment(@NotNull String newTableComment) {
 		return new SQLUpdateActionImpl(getManager(),
-				"ALTER TABLE `" + getTableName() + "` COMMENT '" + newTableComment + "'"
+				"ALTER TABLE " + withBackQuote(getTableName()) + " COMMENT " + withQuote(newTableComment)
 		);
 	}
 
 	@Override
 	public SQLAction<Integer> setAutoIncrementIndex(int index) {
 		return new SQLUpdateActionImpl(getManager(),
-				"ALTER TABLE `" + getTableName() + "` AUTO_INCREMENT=" + index
+				"ALTER TABLE " + withBackQuote(getTableName()) + " AUTO_INCREMENT=" + index
 		);
 	}
 
 	@Override
 	public SQLAction<Integer> addIndex(@NotNull IndexType indexType, @NotNull String indexName, @NotNull String columnName, @NotNull String... moreColumns) {
 		return createAction(
-				"ALTER TABLE `" + getTableName() + "` ADD "
+				"ALTER TABLE " + withBackQuote(getTableName()) + " ADD "
 						+ TableCreateBuilderImpl.buildIndexSettings(indexType, indexName, columnName, moreColumns)
 		);
 	}
@@ -54,21 +57,21 @@ public class TableAlterBuilderImpl extends AbstractSQLBuilder implements TableAl
 	@Override
 	public SQLAction<Integer> dropIndex(@NotNull String indexName) {
 		return createAction(
-				"ALTER TABLE `" + getTableName() + "` DROP INDEX `" + indexName + "`"
+				"ALTER TABLE " + withBackQuote(getTableName()) + " DROP INDEX " + withBackQuote(indexName)
 		);
 	}
 
 	@Override
 	public SQLAction<Integer> dropForeignKey(@NotNull String keySymbol) {
 		return createAction(
-				"ALTER TABLE `" + getTableName() + "` DROP FOREIGN KEY `" + keySymbol + "`"
+				"ALTER TABLE " + withBackQuote(getTableName()) + " DROP FOREIGN KEY " + withBackQuote(keySymbol)
 		);
 	}
 
 	@Override
 	public SQLAction<Integer> dropPrimaryKey() {
 		return createAction(
-				"ALTER TABLE `" + getTableName() + "` DROP PRIMARY KEY"
+				"ALTER TABLE " + withBackQuote(getTableName()) + " DROP PRIMARY KEY"
 		);
 	}
 
@@ -77,14 +80,14 @@ public class TableAlterBuilderImpl extends AbstractSQLBuilder implements TableAl
 		String orderSettings = null;
 		if (afterColumn != null) {
 			if (afterColumn.length() > 0) {
-				orderSettings = "AFTER `" + afterColumn + "`";
+				orderSettings = "AFTER " + withBackQuote(afterColumn);
 			} else {
 				orderSettings = "FIRST";
 			}
 		}
 
 		return createAction(
-				"ALTER TABLE `" + getTableName() + "` ADD `" + columnName + "` " + settings
+				"ALTER TABLE " + withBackQuote(getTableName()) + " ADD " + withBackQuote(columnName) + " " + settings
 						+ (orderSettings != null ? " " + orderSettings : "")
 		);
 	}
@@ -92,35 +95,35 @@ public class TableAlterBuilderImpl extends AbstractSQLBuilder implements TableAl
 	@Override
 	public SQLAction<Integer> renameColumn(@NotNull String columnName, @NotNull String newName) {
 		return createAction(
-				"ALTER TABLE `" + getTableName() + "` RENAME COLUMN `" + columnName + "` TO `" + newName + "`"
+				"ALTER TABLE " + withBackQuote(getTableName()) + " RENAME COLUMN " + withBackQuote(columnName) + " TO " + withBackQuote(newName)
 		);
 	}
 
 	@Override
 	public SQLAction<Integer> modifyColumn(@NotNull String columnName, @NotNull String settings) {
 		return createAction(
-				"ALTER TABLE `" + getTableName() + "` MODIFY COLUMN `" + columnName + "` " + settings
+				"ALTER TABLE " + withBackQuote(getTableName()) + " MODIFY COLUMN " + withBackQuote(columnName) + " " + settings
 		);
 	}
 
 	@Override
 	public SQLAction<Integer> removeColumn(@NotNull String columnName) {
 		return createAction(
-				"ALTER TABLE `" + getTableName() + "` DROP `" + columnName + "`"
+				"ALTER TABLE " + withBackQuote(getTableName()) + " DROP " + withBackQuote(columnName)
 		);
 	}
 
 	@Override
 	public SQLAction<Integer> setColumnDefault(@NotNull String columnName, @NotNull String defaultValue) {
 		return createAction(
-				"ALTER TABLE `" + getTableName() + "` ALTER `" + columnName + "` SET DEFAULT " + defaultValue
+				"ALTER TABLE " + withBackQuote(getTableName()) + " ALTER " + withBackQuote(columnName) + " SET DEFAULT " + defaultValue
 		);
 	}
 
 	@Override
 	public SQLAction<Integer> removeColumnDefault(@NotNull String columnName) {
 		return createAction(
-				"ALTER TABLE `" + getTableName() + "` ALTER `" + columnName + "` DROP DEFAULT"
+				"ALTER TABLE " + withBackQuote(getTableName()) + " ALTER " + withBackQuote(columnName) + " DROP DEFAULT"
 		);
 	}
 

easysql-impl/src/main/java/cc/carm/lib/easysql/builder/impl/TableCreateBuilderImpl.java

@@ -15,6 +15,9 @@ import java.util.ArrayList;
 import java.util.Arrays;
 import java.util.List;
 
+import static cc.carm.lib.easysql.api.SQLBuilder.withBackQuote;
+import static cc.carm.lib.easysql.api.SQLBuilder.withQuote;
+
 public class TableCreateBuilderImpl extends AbstractSQLBuilder implements TableCreateBuilder {
 
 	protected final @NotNull String tableName;
@@ -44,7 +47,7 @@ public class TableCreateBuilderImpl extends AbstractSQLBuilder implements TableC
 	@Override
 	public SQLUpdateAction build() {
 		StringBuilder createSQL = new StringBuilder();
-		createSQL.append("CREATE TABLE IF NOT EXISTS `").append(tableName).append("`");
+		createSQL.append("CREATE TABLE IF NOT EXISTS ").append(withBackQuote(tableName));
 		createSQL.append("(");
 		createSQL.append(String.join(", ", columns));
 		if (indexes.size() > 0) {
@@ -58,7 +61,7 @@ public class TableCreateBuilderImpl extends AbstractSQLBuilder implements TableC
 		createSQL.append(") ").append(getTableSettings());
 
 		if (tableComment != null) {
-			createSQL.append(" COMMENT '").append(tableComment).append("'");
+			createSQL.append(" COMMENT ").append(withQuote(tableComment));
 		}
 
 		return new SQLUpdateActionImpl(getManager(), createSQL.toString());
@@ -72,7 +75,7 @@ public class TableCreateBuilderImpl extends AbstractSQLBuilder implements TableC
 
 	@Override
 	public TableCreateBuilder addAutoIncrementColumn(@NotNull String columnName, @Nullable NumberType numberType,
-													 boolean asPrimaryKey, boolean unsigned) {
+	                                                 boolean asPrimaryKey, boolean unsigned) {
 		return addColumn(columnName,
 				(numberType == null ? NumberType.INT : numberType).name()
 						+ (unsigned ? " UNSIGNED " : " ")
@@ -82,26 +85,26 @@ public class TableCreateBuilderImpl extends AbstractSQLBuilder implements TableC
 
 	@Override
 	public TableCreateBuilder setIndex(@NotNull IndexType type, @Nullable String indexName,
-									   @NotNull String columnName, @NotNull String... moreColumns) {
+	                                   @NotNull String columnName, @NotNull String... moreColumns) {
 		this.indexes.add(buildIndexSettings(type, indexName, columnName, moreColumns));
 		return this;
 	}
 
 	@Override
 	public TableCreateBuilder addForeignKey(@NotNull String tableColumn, @Nullable String constraintName,
-											@NotNull String foreignTable, @NotNull String foreignColumn,
-											@Nullable ForeignKeyRule updateRule, @Nullable ForeignKeyRule deleteRule) {
+	                                        @NotNull String foreignTable, @NotNull String foreignColumn,
+	                                        @Nullable ForeignKeyRule updateRule, @Nullable ForeignKeyRule deleteRule) {
 		StringBuilder keyBuilder = new StringBuilder();
 
 		keyBuilder.append("CONSTRAINT ");
 		if (constraintName == null) {
-			keyBuilder.append("`").append("fk_").append(tableColumn).append("_").append(foreignTable).append("`");
+			keyBuilder.append(withBackQuote("fk_" + tableColumn + "_" + foreignTable));
 		} else {
-			keyBuilder.append("`").append(constraintName).append("`");
+			keyBuilder.append(withBackQuote(constraintName));
 		}
 		keyBuilder.append(" ");
-		keyBuilder.append("FOREIGN KEY (`").append(tableColumn).append("`) ");
-		keyBuilder.append("REFERENCES `").append(foreignTable).append("`(`").append(foreignColumn).append("`)");
+		keyBuilder.append("FOREIGN KEY (").append(withBackQuote(tableColumn)).append(") ");
+		keyBuilder.append("REFERENCES ").append(withBackQuote(foreignTable)).append("(").append(withBackQuote(foreignColumn)).append(")");
 
 		if (updateRule != null) keyBuilder.append(" ON UPDATE ").append(updateRule.getRuleName());
 		if (deleteRule != null) keyBuilder.append(" ON DELETE ").append(deleteRule.getRuleName());
@@ -111,7 +114,7 @@ public class TableCreateBuilderImpl extends AbstractSQLBuilder implements TableC
 	}
 
 	@Override
-	public TableCreateBuilder setColumns(@NotNull String[] columns) {
+	public TableCreateBuilder setColumns(@NotNull String... columns) {
 		this.columns = Arrays.asList(columns);
 		return this;
 	}
@@ -129,22 +132,22 @@ public class TableCreateBuilderImpl extends AbstractSQLBuilder implements TableC
 	}
 
 	protected static String buildIndexSettings(@NotNull IndexType indexType, @Nullable String indexName,
-											   @NotNull String columnName, @NotNull String... moreColumns) {
+	                                           @NotNull String columnName, @NotNull String... moreColumns) {
 
 		StringBuilder indexBuilder = new StringBuilder();
 
 		indexBuilder.append(indexType.getName()).append(" ");
 		if (indexName != null) {
-			indexBuilder.append("`").append(indexName).append("`");
+			indexBuilder.append(withBackQuote(indexName));
 		}
 		indexBuilder.append("(");
-		indexBuilder.append("`").append(columnName).append("`");
+		indexBuilder.append(withBackQuote(columnName));
 
 		if (moreColumns.length > 0) {
 			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(", ");
 			}
 

easysql-impl/src/main/java/cc/carm/lib/easysql/builder/impl/TableQueryBuilderImpl.java

@@ -7,81 +7,83 @@ import cc.carm.lib.easysql.manager.SQLManagerImpl;
 import org.jetbrains.annotations.NotNull;
 import org.jetbrains.annotations.Nullable;
 
+import static cc.carm.lib.easysql.api.SQLBuilder.withBackQuote;
+
 public class TableQueryBuilderImpl
-        extends AbstractConditionalBuilder<TableQueryBuilder, PreparedQueryAction>
-        implements TableQueryBuilder {
+		extends AbstractConditionalBuilder<TableQueryBuilder, PreparedQueryAction>
+		implements TableQueryBuilder {
 
-    @NotNull String tableName;
+	@NotNull String tableName;
 
-    String[] columns;
+	String[] columns;
 
-    @Nullable String orderBy;
+	@Nullable String orderBy;
 
-    int[] pageLimit;
+	int[] pageLimit;
 
-    public TableQueryBuilderImpl(@NotNull SQLManagerImpl manager, @NotNull String tableName) {
-        super(manager);
-        this.tableName = tableName;
-    }
+	public TableQueryBuilderImpl(@NotNull SQLManagerImpl manager, @NotNull String tableName) {
+		super(manager);
+		this.tableName = tableName;
+	}
 
-    @Override
-    public PreparedQueryActionImpl build() {
-        StringBuilder sqlBuilder = new StringBuilder();
-        sqlBuilder.append("SELECT").append(" ");
-        if (columns == null || columns.length < 1) {
-            sqlBuilder.append("*");
-        } else {
-            for (int i = 0; i < columns.length; i++) {
-                String name = columns[i];
-                sqlBuilder.append("`").append(name).append("`");
-                if (i != columns.length - 1) {
-                    sqlBuilder.append(",");
-                }
-            }
-        }
+	@Override
+	public PreparedQueryActionImpl build() {
+		StringBuilder sqlBuilder = new StringBuilder();
+		sqlBuilder.append("SELECT").append(" ");
+		if (columns == null || columns.length < 1) {
+			sqlBuilder.append("*");
+		} else {
+			for (int i = 0; i < columns.length; i++) {
+				String name = columns[i];
+				sqlBuilder.append(withBackQuote(name));
+				if (i != columns.length - 1) {
+					sqlBuilder.append(",");
+				}
+			}
+		}
 
-        sqlBuilder.append(" ").append("FROM").append(" ");
-        sqlBuilder.append("`").append(tableName).append("`");
+		sqlBuilder.append(" ").append("FROM").append(" ").append(withBackQuote(tableName));
 
-        if (hasConditions()) sqlBuilder.append(" ").append(buildConditionSQL());
+		if (hasConditions()) sqlBuilder.append(" ").append(buildConditionSQL());
 
-        if (pageLimit != null && pageLimit.length == 2) {
-            sqlBuilder.append(" LIMIT ").append(pageLimit[0]).append(",").append(pageLimit[1]);
-        } else if (limit > 0) {
-            sqlBuilder.append(" ").append(buildLimitSQL());
-        }
+		if (orderBy != null) sqlBuilder.append(" ").append(orderBy);
 
-        if (orderBy != null) sqlBuilder.append(orderBy);
+		if (pageLimit != null && pageLimit.length == 2) {
+			sqlBuilder.append(" LIMIT ").append(pageLimit[0]).append(",").append(pageLimit[1]);
+		} else if (limit > 0) {
+			sqlBuilder.append(" ").append(buildLimitSQL());
+		}
 
-        return new PreparedQueryActionImpl(getManager(), sqlBuilder.toString())
-                .setParams(hasConditionParams() ? getConditionParams() : null);
-    }
 
-    @Override
-    public @NotNull String getTableName() {
-        return tableName;
-    }
+		return new PreparedQueryActionImpl(getManager(), sqlBuilder.toString())
+				.setParams(hasConditionParams() ? getConditionParams() : null);
+	}
 
-    @Override
-    public TableQueryBuilderImpl selectColumns(@NotNull String[] columnNames) {
-        this.columns = columnNames;
-        return this;
-    }
+	@Override
+	public @NotNull String getTableName() {
+		return tableName;
+	}
 
-    @Override
-    public TableQueryBuilder orderBy(@NotNull String columnName, boolean asc) {
-        this.orderBy = "ORDER BY `" + columnName + "` " + (asc ? "ASC" : "DESC");
-        return this;
-    }
+	@Override
+	public TableQueryBuilderImpl selectColumns(@NotNull String... columnNames) {
+		this.columns = columnNames;
+		return this;
+	}
 
-    @Override
-    public TableQueryBuilder setPageLimit(int start, int end) {
-        this.pageLimit = new int[]{start, end};
-        return this;
-    }
+	@Override
+	public TableQueryBuilder orderBy(@NotNull String columnName, boolean asc) {
+		this.orderBy = "ORDER BY " + withBackQuote(columnName) + " " + (asc ? "ASC" : "DESC");
+		return this;
+	}
 
-    @Override
-    protected TableQueryBuilderImpl getThis() {
-        return this;
-    }
+	@Override
+	public TableQueryBuilder setPageLimit(int start, int end) {
+		this.pageLimit = new int[]{start, end};
+		return this;
+	}
+
+	@Override
+	protected TableQueryBuilderImpl getThis() {
+		return this;
+	}
 }

easysql-impl/src/main/java/cc/carm/lib/easysql/builder/impl/UpdateBuilderImpl.java

@@ -6,76 +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(getTableName()).append("` SET ");
+        sqlBuilder.append("UPDATE ").append(withBackQuote(getTableName())).append(" SET ");
 
-		Iterator<String> iterator = this.columnNames.iterator();
-		while (iterator.hasNext()) {
-			sqlBuilder.append("`").append(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;
+    }
 }

easysql-impl/src/main/java/cc/carm/lib/easysql/manager/SQLManagerImpl.java

@@ -62,6 +62,7 @@ public class SQLManagerImpl implements SQLManager {
 		if (isDebugMode()) getLogger().info("[DEBUG] " + msg);
 	}
 
+	@Override
 	public Logger getLogger() {
 		return LOGGER;
 	}
@@ -103,7 +104,7 @@ public class SQLManagerImpl implements SQLManager {
 	}
 
 	@Override
-	public List<Integer> executeSQLBatch(@NotNull String sql, String[] moreSQL) {
+	public List<Integer> executeSQLBatch(@NotNull String sql, String... moreSQL) {
 		SQLUpdateBatchAction action = new SQLUpdateBatchActionImpl(this, sql);
 		if (moreSQL != null && moreSQL.length > 0) {
 			Arrays.stream(moreSQL).forEach(action::addBatch);

easysql-impl/src/main/java/cc/carm/lib/easysql/util/StatementUtil.java

@@ -128,16 +128,12 @@ public class StatementUtil {
 	 * @return 数据类型，默认为 {@link Types#VARCHAR}
 	 */
 	public static int getNullType(PreparedStatement statement, int paramIndex) {
-		int sqlType = Types.VARCHAR;
-
-		final ParameterMetaData pmd;
 		try {
-			pmd = statement.getParameterMetaData();
-			sqlType = pmd.getParameterType(paramIndex);
+			ParameterMetaData pmd = statement.getParameterMetaData();
+			return pmd.getParameterType(paramIndex);
 		} catch (SQLException ignore) {
+			return Types.VARCHAR;
 		}
-
-		return sqlType;
 	}
 
 	/**
@@ -201,6 +197,12 @@ public class StatementUtil {
 			// 其它数字类型按照默认类型传入
 		}
 
+		if (param instanceof Enum) {
+			//枚举类采用 name()
+			preparedStatement.setString(paramIndex, ((Enum<?>) param).name());
+			return;
+		}
+
 		// 其它参数类型直接传入
 		preparedStatement.setObject(paramIndex, param);
 	}

example/easysql-demo/pom.xml

@@ -5,7 +5,7 @@
     <parent>
         <artifactId>easysql-parent</artifactId>
         <groupId>cc.carm.lib</groupId>
-        <version>0.3.1</version>
+        <version>0.3.7</version>
         <relativePath>../../pom.xml</relativePath>
     </parent>
     <modelVersion>4.0.0</modelVersion>
@@ -22,7 +22,7 @@
     <artifactId>easysql-demo</artifactId>
     <packaging>jar</packaging>
 
-    <name>99-EasySQL-Demo</name>
+    <name>EasySQL-Demo</name>
     <description>EasySQL的演示部分</description>
     <url>https://github.com/CarmJos/EasySQL</url>
 

example/easysql-demo/src/main/java/EasySQLDemo.java

@@ -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();
+        }
+    }
 
 }

example/easysql-test/pom.xml

@@ -5,7 +5,7 @@
     <parent>
         <artifactId>easysql-parent</artifactId>
         <groupId>cc.carm.lib</groupId>
-        <version>0.3.1</version>
+        <version>0.3.7</version>
         <relativePath>../../pom.xml</relativePath>
     </parent>
     <modelVersion>4.0.0</modelVersion>
@@ -21,14 +21,14 @@
 
     <artifactId>easysql-test</artifactId>
 
-    <name>98-EasySQL-Demo</name>
+    <name>EasySQL-Test</name>
     <description>EasySQL的测试代码</description>
     <url>https://github.com/CarmJos/EasySQL</url>
 
     <dependencies>
         <dependency>
             <groupId>${project.parent.groupId}</groupId>
-            <artifactId>easysql-hikaricp</artifactId>
+            <artifactId>easysql-beecp</artifactId>
             <version>${project.version}</version>
             <scope>compile</scope>
         </dependency>
@@ -37,14 +37,14 @@
         <dependency>
             <groupId>mysql</groupId>
             <artifactId>mysql-connector-java</artifactId>
-            <version>8.0.25</version>
+            <version>8.0.28</version>
             <scope>compile</scope>
         </dependency>
 
         <dependency>
             <groupId>org.slf4j</groupId>
             <artifactId>slf4j-api</artifactId>
-            <version>1.7.29</version>
+            <version>1.7.36</version>
             <scope>compile</scope>
         </dependency>
 
@@ -84,7 +84,7 @@
             <plugin>
                 <groupId>org.apache.maven.plugins</groupId>
                 <artifactId>maven-shade-plugin</artifactId>
-                <version>3.2.3</version>
+                <version>3.2.4</version>
                 <executions>
                     <execution>
                         <phase>package</phase>

example/easysql-test/src/main/java/cc/carm/lib/easysql/testrunner/Main.java

@@ -2,22 +2,25 @@ package cc.carm.lib.easysql.testrunner;
 
 import cc.carm.lib.easysql.EasySQL;
 import cc.carm.lib.easysql.api.SQLManager;
-import cc.carm.lib.easysql.testrunner.tests.TableAlterTest;
+import cc.carm.lib.easysql.testrunner.tests.DeleteTest;
+import cc.carm.lib.easysql.testrunner.tests.QueryCloseTest;
+import cc.carm.lib.easysql.testrunner.tests.QueryFunctionTest;
 import cc.carm.lib.easysql.testrunner.tests.TableCreateTest;
-import cc.carm.lib.easysql.testrunner.tests.TableRenameTest;
 import org.jetbrains.annotations.NotNull;
-import org.jetbrains.annotations.Nullable;
+import org.jetbrains.annotations.TestOnly;
 
 import java.util.Iterator;
 import java.util.LinkedHashSet;
 import java.util.Scanner;
 import java.util.Set;
 
+@TestOnly
+@SuppressWarnings("all")
 public class Main {
 
 	public static void main(String[] args) {
 		if (args.length < 4) {
-			print("请提供以下参数： 数据库地址 数据库用户名 数据库密码");
+			print("请提供以下参数：<数据库驱动> <数据库地址(JDBC)> <数据库用户> <数据库密码> [是否采用DEBUG(y/n)]");
 			return;
 		}
 
@@ -40,8 +43,14 @@ public class Main {
 		print("加载测试类...");
 		Set<EasySQLTest> tests = new LinkedHashSet<>();
 		tests.add(new TableCreateTest());
-		tests.add(new TableAlterTest());
-		tests.add(new TableRenameTest());
+//		tests.add(new TableAlterTest());
+//		tests.add(new TableRenameTest());
+//		tests.add(new QueryNotCloseTest());
+		tests.add(new QueryCloseTest());
+//		tests.add(new SQLUpdateBatchTests());
+//		tests.add(new SQLUpdateReturnKeysTest());
+		tests.add(new QueryFunctionTest());
+		tests.add(new DeleteTest());
 
 		print("准备进行测试...");
 
@@ -73,21 +82,12 @@ public class Main {
 				success, (tests.size() - success)
 		);
 
-	}
+		EasySQL.shutdownManager(sqlManager);
 
+	}
 
 	public static void print(@NotNull String format, Object... params) {
 		System.out.printf((format) + "%n", params);
 	}
 
-	public static @Nullable EasySQLTest cast(@NotNull Class<?> value) {
-		if (!EasySQLTest.class.isAssignableFrom(value)) return null;
-		try {
-			return (EasySQLTest) value.newInstance();
-		} catch (InstantiationException | IllegalAccessException e) {
-			return null;
-		}
-
-	}
-
 }

example/easysql-test/src/main/java/cc/carm/lib/easysql/testrunner/tests/DeleteTest.java

@@ -0,0 +1,22 @@
+package cc.carm.lib.easysql.testrunner.tests;
+
+import cc.carm.lib.easysql.api.SQLManager;
+import cc.carm.lib.easysql.testrunner.EasySQLTest;
+
+import java.sql.SQLException;
+
+public class DeleteTest extends EasySQLTest {
+
+
+	@Override
+	public void onTest(SQLManager sqlManager) throws SQLException {
+
+		Integer changes = sqlManager.createDelete("test_user_table")
+				.addCondition("id", ">", 5)
+				.addNotNullCondition("username")
+				.build().execute();
+
+		System.out.println("change(s): " + changes);
+
+	}
+}

example/easysql-test/src/main/java/cc/carm/lib/easysql/testrunner/tests/QueryCloseTest.java

@@ -0,0 +1,31 @@
+package cc.carm.lib.easysql.testrunner.tests;
+
+import cc.carm.lib.easysql.api.SQLManager;
+import cc.carm.lib.easysql.api.SQLQuery;
+import cc.carm.lib.easysql.testrunner.EasySQLTest;
+
+import java.sql.ResultSet;
+import java.sql.SQLException;
+
+public class QueryCloseTest extends EasySQLTest {
+
+
+	@Override
+	public void onTest(SQLManager sqlManager) throws SQLException {
+
+		try (SQLQuery query = sqlManager.createQuery()
+				.inTable("test_user_table")
+				.orderBy("id", false)
+				.setLimit(5)
+				.build().execute()) {
+			ResultSet resultSet = query.getResultSet();
+
+			while (resultSet.next()) {
+
+				System.out.println("id: " + resultSet.getInt("id") + " username: " + resultSet.getString("username"));
+
+			}
+		}
+
+	}
+}

example/easysql-test/src/main/java/cc/carm/lib/easysql/testrunner/tests/QueryFunctionTest.java

@@ -0,0 +1,34 @@
+package cc.carm.lib.easysql.testrunner.tests;
+
+import cc.carm.lib.easysql.api.SQLManager;
+import cc.carm.lib.easysql.testrunner.EasySQLTest;
+
+import java.sql.SQLException;
+
+public class QueryFunctionTest extends EasySQLTest {
+
+
+	@Override
+	public void onTest(SQLManager sqlManager) throws SQLException {
+
+		Integer id_1 = sqlManager.createQuery()
+				.inTable("test_user_table")
+				.orderBy("id", false)
+				.setLimit(1)
+				.build().executeFunction(query -> {
+					if (!query.getResultSet().next()) return -1;
+					else return query.getResultSet().getInt("id");
+				});
+
+		System.out.println("id (ps): " + id_1);
+
+		Integer id_2 = sqlManager.createQuery().withSQL("SELECT id FROM test_user_table ORDER BY id DESC LIMIT 1")
+				.executeFunction(query -> {
+					if (!query.getResultSet().next()) return -1;
+					else return query.getResultSet().getInt("id");
+				});
+
+		System.out.println("id (s): " + id_2);
+
+	}
+}

example/easysql-test/src/main/java/cc/carm/lib/easysql/testrunner/tests/QueryNotCloseTest.java

@@ -0,0 +1,30 @@
+package cc.carm.lib.easysql.testrunner.tests;
+
+import cc.carm.lib.easysql.api.SQLManager;
+import cc.carm.lib.easysql.api.SQLQuery;
+import cc.carm.lib.easysql.testrunner.EasySQLTest;
+
+import java.sql.ResultSet;
+import java.sql.SQLException;
+
+public class QueryNotCloseTest extends EasySQLTest {
+
+	@Override
+	public void onTest(SQLManager sqlManager) throws SQLException {
+		SQLQuery query = sqlManager.createQuery()
+				.inTable("test_user_table")
+				.orderBy("id", false)
+				.setLimit(5)
+				.build().execute();
+
+		ResultSet resultSet = query.getResultSet();
+
+		while (resultSet.next()) {
+
+			System.out.println("id: " + resultSet.getInt("id") + " username: " + resultSet.getString("username"));
+
+		}
+
+
+	}
+}

example/easysql-test/src/main/java/cc/carm/lib/easysql/testrunner/tests/SQLUpdateBatchTests.java

@@ -0,0 +1,38 @@
+package cc.carm.lib.easysql.testrunner.tests;
+
+import cc.carm.lib.easysql.api.SQLManager;
+import cc.carm.lib.easysql.testrunner.EasySQLTest;
+
+import java.sql.SQLException;
+import java.util.Arrays;
+import java.util.List;
+import java.util.UUID;
+import java.util.stream.Collectors;
+import java.util.stream.IntStream;
+
+public class SQLUpdateBatchTests extends EasySQLTest {
+
+
+	@Override
+	public void onTest(SQLManager sqlManager) throws SQLException {
+
+		List<Integer> updates = sqlManager.createInsertBatch("test_user_table")
+				.setColumnNames("uuid", "username", "age")
+				.setAllParams(generateParams())
+				.execute();
+
+		System.out.println("changes " + Arrays.toString(updates.toArray()));
+
+	}
+
+	protected List<Object[]> generateParams() {
+		return IntStream.range(0, 5).mapToObj(i -> generateParam()).collect(Collectors.toList());
+	}
+
+	protected Object[] generateParam() {
+		UUID uuid = UUID.randomUUID();
+		return new Object[]{uuid, uuid.toString().substring(0, 5), (int) (Math.random() * 50)};
+	}
+
+
+}

example/easysql-test/src/main/java/cc/carm/lib/easysql/testrunner/tests/SQLUpdateReturnKeysTest.java

@@ -0,0 +1,24 @@
+package cc.carm.lib.easysql.testrunner.tests;
+
+import cc.carm.lib.easysql.api.SQLManager;
+
+import java.sql.SQLException;
+import java.util.Arrays;
+import java.util.List;
+
+public class SQLUpdateReturnKeysTest extends SQLUpdateBatchTests {
+
+
+	@Override
+	public void onTest(SQLManager sqlManager) throws SQLException {
+		List<Integer> generatedKeys = sqlManager.createInsertBatch("test_user_table")
+				.setColumnNames("uuid", "username", "age")
+				.setAllParams(generateParams())
+				.returnGeneratedKeys()
+				.execute();
+
+		System.out.println("generated " + Arrays.toString(generatedKeys.toArray()));
+	}
+
+
+}

example/easysql-test/src/main/resources/log4j2.xml

@@ -0,0 +1,26 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<Configuration status="WARN" packages="cc.carm.lib.easysql">
+    <Appenders>
+        <console name="Console" target="SYSTEM_OUT">
+            <PatternLayout pattern="[%d{HH:mm:ss} %level]: %msg%n"/>
+        </console>
+        <RollingRandomAccessFile name="File" fileName="logs/latest.log" filePattern="logs/%d{yyyy-MM-dd}-%i.log.gz">
+            <PatternLayout pattern="[%d{HH:mm:ss}] [%t/%level]: %msg%n"/>
+            <Policies>
+                <TimeBasedTriggeringPolicy/>
+                <OnStartupTriggeringPolicy/>
+            </Policies>
+        </RollingRandomAccessFile>
+    </Appenders>
+    <Loggers>
+        <root level="info">
+            <filters>
+                <MarkerFilter marker="NETWORK_PACKETS" onMatch="DENY" onMismatch="NEUTRAL"/>
+            </filters>
+            <!--            <AppenderRef ref="WINDOWS_COMPAT" level="info"/>-->
+            <AppenderRef ref="File"/>
+            <appender-ref ref="Console"/>
+        </root>
+    </Loggers>
+</Configuration>
+

pom.xml

@@ -5,8 +5,9 @@
     <modelVersion>4.0.0</modelVersion>
 
     <properties>
-        <maven.compiler.source>11</maven.compiler.source>
-        <maven.compiler.target>11</maven.compiler.target>
+        <java.version>8</java.version>
+        <maven.compiler.source>${java.version}</maven.compiler.source>
+        <maven.compiler.target>${java.version}</maven.compiler.target>
         <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
         <maven.compiler.encoding>UTF-8</maven.compiler.encoding>
         <sonar.organization>carmjos</sonar.organization>
@@ -16,7 +17,7 @@
     <groupId>cc.carm.lib</groupId>
     <artifactId>easysql-parent</artifactId>
     <packaging>pom</packaging>
-    <version>0.3.1</version>
+    <version>0.3.7</version>
 
     <modules>
         <module>easysql-api</module>
@@ -31,7 +32,7 @@
 
     <name>EasySQL</name>
     <description>简单便捷的数据库操作工具，可自选连接池。</description>
-    <url>https://github.com/CarmJos/${project.name}</url>
+    <url>https://github.com/CarmJos/EasySQL</url>
 
     <developers>
         <developer>
@@ -59,12 +60,12 @@
 
     <issueManagement>
         <system>GitHub Issues</system>
-        <url>${project.url}/issues</url>
+        <url>https://github.com/CarmJos/EasySQL/issues</url>
     </issueManagement>
 
     <ciManagement>
         <system>GitHub Actions</system>
-        <url>${project.url}/actions/workflows/maven.yml</url>
+        <url>https://github.com/CarmJos/EasySQL/actions/workflows/maven.yml</url>
     </ciManagement>
 
     <repositories>
@@ -95,11 +96,11 @@
 
     <distributionManagement>
 
-        <downloadUrl>${project.url}/releases</downloadUrl>
+        <downloadUrl>https://github.com/CarmJos/EasySQL/releases</downloadUrl>
         <site>
             <id>easysql-javadoc</id>
             <name>EasySQL JavaDoc (on Github Pages)</name>
-            <url>https://carmjos.github.io/EasySQL</url>
+            <url>https://CarmJos.github.io/EasySQL</url>
         </site>
 
     </distributionManagement>
@@ -116,7 +117,7 @@
         <dependency>
             <groupId>org.jetbrains</groupId>
             <artifactId>annotations</artifactId>
-            <version>22.0.0</version>
+            <version>23.0.0</version>
             <scope>provided</scope>
         </dependency>
 
@@ -133,7 +134,7 @@
             <plugin>
                 <groupId>org.apache.maven.plugins</groupId>
                 <artifactId>maven-gpg-plugin</artifactId>
-                <version>1.6</version>
+                <version>3.0.1</version>
                 <executions>
                     <execution>
                         <id>sign-artifacts</id>
@@ -153,7 +154,7 @@
             <plugin>
                 <groupId>org.apache.maven.plugins</groupId>
                 <artifactId>maven-release-plugin</artifactId>
-                <version>2.5.1</version>
+                <version>2.5.3</version>
                 <configuration>
                     <autoVersionSubmodules>true</autoVersionSubmodules>
                     <useReleaseProfile>false</useReleaseProfile>
@@ -169,7 +170,7 @@
                 <plugin>
                     <groupId>org.apache.maven.plugins</groupId>
                     <artifactId>maven-javadoc-plugin</artifactId>
-                    <version>3.2.0</version>
+                    <version>3.3.1</version>
                     <configuration>
                         <classifier>javadoc</classifier>
                         <detectJavaApiLink>false</detectJavaApiLink>
@@ -181,7 +182,6 @@
                         <includeDependencySources>true</includeDependencySources>
                         <dependencySourceIncludes>
                             <dependencySourceInclude>cc.carm.lib:*</dependencySourceInclude>
-                            <dependencySourceInclude>cn.beecp:*</dependencySourceInclude>
                         </dependencySourceIncludes>
                     </configuration>
                     <executions>
@@ -197,10 +197,10 @@
                 <plugin>
                     <groupId>org.apache.maven.plugins</groupId>
                     <artifactId>maven-compiler-plugin</artifactId>
-                    <version>3.8.1</version>
+                    <version>3.9.0</version>
                     <configuration>
-                        <source>1.8</source>
-                        <target>1.8</target>
+                        <source>${java.version}</source>
+                        <target>${java.version}</target>
                         <encoding>UTF-8</encoding>
                         <compilerArgument>-parameters</compilerArgument>
                     </configuration>
@@ -209,13 +209,13 @@
                 <plugin>
                     <groupId>org.apache.maven.plugins</groupId>
                     <artifactId>maven-jar-plugin</artifactId>
-                    <version>3.2.0</version>
+                    <version>3.2.2</version>
                 </plugin>
 
                 <plugin>
                     <groupId>org.apache.maven.plugins</groupId>
                     <artifactId>maven-source-plugin</artifactId>
-                    <version>3.2.0</version>
+                    <version>3.2.1</version>
                     <executions>
                         <execution>
                             <phase>package</phase>
@@ -229,7 +229,7 @@
                 <plugin>
                     <groupId>org.apache.maven.plugins</groupId>
                     <artifactId>maven-shade-plugin</artifactId>
-                    <version>3.2.3</version>
+                    <version>3.2.4</version>
                     <executions>
                         <execution>
                             <phase>package</phase>
@@ -257,7 +257,7 @@
                 <plugin>
                     <groupId>org.apache.maven.plugins</groupId>
                     <artifactId>maven-surefire-plugin</artifactId>
-                    <version>2.22.1</version>
+                    <version>2.22.2</version>
                     <configuration>
                         <useSystemClassLoader>false</useSystemClassLoader>
                     </configuration>

with-pool/easysql-beecp/pom.xml

@@ -5,7 +5,7 @@
     <parent>
         <artifactId>easysql-parent</artifactId>
         <groupId>cc.carm.lib</groupId>
-        <version>0.3.1</version>
+        <version>0.3.7</version>
         <relativePath>../../pom.xml</relativePath>
     </parent>
     <modelVersion>4.0.0</modelVersion>
@@ -20,7 +20,7 @@
     <artifactId>easysql-beecp</artifactId>
     <packaging>jar</packaging>
 
-    <name>12-EasySQL-BeeCP</name>
+    <name>EasySQL-BeeCP</name>
     <description>EasySQL的应用部分。此为BeeCP版本。</description>
     <url>https://github.com/CarmJos/EasySQL</url>
 
@@ -45,12 +45,12 @@
 
     <issueManagement>
         <system>GitHub Issues</system>
-        <url>${project.url}/issues</url>
+        <url>https://github.com/CarmJos/EasySQL/issues</url>
     </issueManagement>
 
     <ciManagement>
         <system>GitHub Actions</system>
-        <url>${project.url}/actions/workflows/maven.yml</url>
+        <url>https://github.com/CarmJos/EasySQL/actions/workflows/maven.yml</url>
     </ciManagement>
 
     <dependencies>
@@ -73,7 +73,7 @@
             <!--项目地址 https://github.com/Chris2018998/BeeCP  -->
             <groupId>com.github.chris2018998</groupId>
             <artifactId>beecp</artifactId>
-            <version>3.3.0</version>
+            <version>3.3.1</version>
             <optional>true</optional>
             <scope>compile</scope>
         </dependency>
@@ -101,7 +101,7 @@
             <plugin>
                 <groupId>org.apache.maven.plugins</groupId>
                 <artifactId>maven-shade-plugin</artifactId>
-                <version>3.2.3</version>
+                <version>3.2.4</version>
                 <executions>
                     <execution>
                         <phase>package</phase>

with-pool/easysql-hikaricp/pom.xml

@@ -5,7 +5,7 @@
     <parent>
         <artifactId>easysql-parent</artifactId>
         <groupId>cc.carm.lib</groupId>
-        <version>0.3.1</version>
+        <version>0.3.7</version>
         <relativePath>../../pom.xml</relativePath>
     </parent>
     <modelVersion>4.0.0</modelVersion>
@@ -19,7 +19,7 @@
 
     <artifactId>easysql-hikaricp</artifactId>
 
-    <name>11-EasySQL-HikariCP</name>
+    <name>EasySQL-HikariCP</name>
     <description>EasySQL的应用部分。此为HikariCP版本。</description>
     <url>https://github.com/CarmJos/EasySQL</url>
 
@@ -44,12 +44,12 @@
 
     <issueManagement>
         <system>GitHub Issues</system>
-        <url>${project.url}/issues</url>
+        <url>https://github.com/CarmJos/EasySQL/issues</url>
     </issueManagement>
 
     <ciManagement>
         <system>GitHub Actions</system>
-        <url>${project.url}/actions/workflows/maven.yml</url>
+        <url>https://github.com/CarmJos/EasySQL/actions/workflows/maven.yml</url>
     </ciManagement>
 
     <dependencies>
@@ -100,7 +100,7 @@
             <plugin>
                 <groupId>org.apache.maven.plugins</groupId>
                 <artifactId>maven-shade-plugin</artifactId>
-                <version>3.2.3</version>
+                <version>3.2.4</version>
                 <executions>
                     <execution>
                         <phase>package</phase>