[0.3.7] 版本更新

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

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

@@ -4,34 +4,35 @@ import cc.carm.lib.easysql.api.SQLAction;
 
 public interface SQLUpdateAction extends SQLAction<Integer> {
 
-	/**
-	 * 设定自增主键的序列
-	 *
-	 * @param keyColumnIndex 自增主键的序列
-	 *                       <br>若该值 ＞ 0，则 {@link #execute()} 返回自增主键数值
-	 *                       <br>若该值 ≤ 0，则 {@link #execute()} 返回变更的行数
-	 * @return {@link SQLUpdateAction}
-	 * @see #setReturnGeneratedKey(boolean)
-	 */
-	@Deprecated
-	default SQLUpdateAction setKeyIndex(int keyColumnIndex) {
-		return setReturnGeneratedKey(keyColumnIndex > 0);
-	}
+    /**
+     * 设定自增主键的序列
+     *
+     * @param keyColumnIndex 自增主键的序列
+     *                       <br>若该值 ＞ 0，则 {@link #execute()} 返回自增主键数值
+     *                       <br>若该值 ≤ 0，则 {@link #execute()} 返回变更的行数
+     * @return {@link SQLUpdateAction}
+     * @see #setReturnGeneratedKey(boolean)
+     */
+    @Deprecated
+    default SQLUpdateAction setKeyIndex(int keyColumnIndex) {
+        return setReturnGeneratedKey(keyColumnIndex > 0);
+    }
 
-	/**
-	 * 设定该操作返回自增键序列。
-	 *
-	 * @return {@link SQLUpdateAction}
-	 */
-	default SQLUpdateAction returnGeneratedKey() {
-		return setReturnGeneratedKey(true);
-	}
+    /**
+     * 设定该操作返回自增键序列。
+     *
+     * @return {@link SQLUpdateAction}
+     */
+    default SQLUpdateAction returnGeneratedKey() {
+        return setReturnGeneratedKey(true);
+    }
 
-	/**
-	 * 设定该操作是否返回自增键序列。
-	 *
-	 * @return {@link SQLUpdateAction}
-	 */
-	SQLUpdateAction setReturnGeneratedKey(boolean returnGeneratedKey);
+    /**
+     * 设定该操作是否返回自增键序列。
+     *
+     * @param returnGeneratedKey 是否返回自增键序列
+     * @return {@link SQLUpdateAction}
+     */
+    SQLUpdateAction setReturnGeneratedKey(boolean returnGeneratedKey);
 
 }

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

@@ -59,8 +59,8 @@ public interface ConditionalBuilder<B extends ConditionalBuilder<B, T>, T extend
      * 添加时间的限定条件。 若设定了开始时间，则限定条件为 {@code endMillis >= startMillis}；
      *
      * @param columnName  判断的行
-     * @param startMillis 开始时间戳，若<0则不作限定
-     * @param endMillis   结束时间戳，若<0则不作限定
+     * @param startMillis 开始时间戳，若{@code <0}则不作限定
+     * @param endMillis   结束时间戳，若{@code <0则不作限定
      * @return {@link B}
      */
     default B addTimeCondition(@NotNull String columnName, long startMillis, long endMillis) {

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

@@ -120,7 +120,7 @@ public class EasySQLDemo {
             Integer userID = sqlManager.createInsert("users")
                     .setColumnNames("username", "phone", "email", "registerTime")
                     .setParams("CarmJos", "18888888888", "carm@carm.cc", TimeDateUtils.getCurrentTime())
-                    .setKeyIndex(1) // 设定自增主键的index，将会在后续返回自增主键
+                    .setReturnGeneratedKey(true)
                     .execute();
 
             System.out.println("新用户的ID为 " + userID);