[v0.3.2] 版本更新

- [A] 对于UPDATE类型的SQL操作采用 try-with-resources 形式获取链接与statement，避免中途报错而导致相关流未关闭。 - [U] 声明 setKeyIndex(int) 过时并移除 defaultKeyIndex() 方法，改为更明确的 setReturnGeneratedKeys(boolean) 与 returnGeneratedKeys() 方法，避免填入错误的index。
2026-06-05 00:25:32 +08:00 · 2022-01-29 03:01:10 +08:00
parent 7d11131b97
commit f5d04bb0bb
22 changed files with 446 additions and 271 deletions
@@ -5,7 +5,7 @@
    <parent>
        <groupId>cc.carm.lib</groupId>
        <artifactId>easysql-parent</artifactId>
-        <version>0.3.1</version>
+        <version>0.3.2</version>
    </parent>
    <modelVersion>4.0.0</modelVersion>

@@ -6,39 +6,50 @@ 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);
+	}
+
+	/**
+	 * 设定该操作是否返回自增键序列。
+	 *
+	 * @return {@link PreparedSQLUpdateBatchAction}
+	 */
+	PreparedSQLUpdateBatchAction setReturnGeneratedKeys(boolean returnGeneratedKey);

 }
@@ -4,24 +4,34 @@ import cc.carm.lib.easysql.api.SQLAction;

 public interface SQLUpdateAction extends SQLAction<Integer> {

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

-    /**
-     * 默认主键序列的数值为 -1 (≤0) ，即默认返回发生变更的行数。
-     *
-     * @return 默认主键序列
-     */
-    default SQLUpdateAction defaultKeyIndex() {
-        return setKeyIndex(-1); // will return changed lines number
-    }
+	/**
+	 * 设定该操作返回自增键序列。
+	 *
+	 * @return {@link SQLUpdateAction}
+	 */
+	default SQLUpdateAction returnGeneratedKey() {
+		return setReturnGeneratedKey(true);
+	}

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

 }