feat: add @Trim: "name,tag" to trim string values for keys

TommyLemon · TommyLemon · commit bccb5ef51a2f · 2026-02-22T02:45:23.000+08:00
diff --git a/APIJSONORM/src/main/java/apijson/JSONMap.java b/APIJSONORM/src/main/java/apijson/JSONMap.java
@@ -194,6 +194,7 @@ default JSONMap<M, L> setUserIdIn(List<Object> list) {
 	String KEY_RAW = "@raw"; // 自定义原始 SQL 片段
 	String KEY_JSON = "@json"; // 把字段转为 JSON 输出
 	String KEY_STRING = "@string"; // 把字段转为 String 输入
+	String KEY_TRIM = "@trim"; // 去除首位空格等空白字符
 	String KEY_METHOD = "@method"; // json 对象配置操作方法
 	String KEY_GET = "@get"; // json 对象配置操作方法
 	String KEY_GETS = "@gets"; // json 对象配置操作方法
@@ -229,6 +230,7 @@ default JSONMap<M, L> setUserIdIn(List<Object> list) {
 			KEY_RAW,
 			KEY_JSON,
 			KEY_STRING,
+			KEY_TRIM,
 			KEY_METHOD,
 			KEY_GET,
 			KEY_GETS,
@@ -548,6 +550,14 @@ default JSONMap<M, L> setString(String keys) {
 		return puts(KEY_STRING, keys);
 	}
 
+	/**set keys to cast to string
+	 * @param keys  "key0,key1,key2..."
+	 * @return
+	 */
+	default JSONMap<M, L> setTrim(String keys) {
+		return puts(KEY_TRIM, keys);
+	}
+
 	//JSONObject内关键词 key >>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
 
 
diff --git a/APIJSONORM/src/main/java/apijson/orm/AbstractObjectParser.java b/APIJSONORM/src/main/java/apijson/orm/AbstractObjectParser.java
@@ -62,6 +62,7 @@ public AbstractObjectParser<T, M, L> setParser(Parser<T, M, L> parser) {
 	 */
 	protected final boolean drop;
 	private List<String> stringKeyList;
+	private List<String> trimKeyList;
 
 	/**for single object
 	 */
@@ -109,6 +110,11 @@ public AbstractObjectParser(@NotNull M request, String parentPath, SQLConfig<T,
 			String[] sks = StringUtil.split(str);
 			stringKeyList = sks == null || sks.length <= 0 ? null : Arrays.asList(sks);
 			request.remove(KEY_STRING);
+
+			String trim = getString(request, KEY_TRIM);
+			String[] trims = StringUtil.split(trim);
+			trimKeyList = trims == null || trims.length <= 0 ? null : Arrays.asList(trims);
+			request.remove(KEY_TRIM);
 		}
     }
 
@@ -286,13 +292,16 @@ public AbstractObjectParser<T, M, L> parse(String name, boolean isReuse) throws
                             //     hasOtherKeyNotFun = true;
                             // }
 
-							if (stringKeyList != null && stringKeyList.contains(key)) {
-								// 统一格式 String val = value == null || value instanceof String ? (String) value : JSON.toJSONString(value);
-								if (onParse(key, JSON.toJSONString(value)) == false) {
-									invalidate();
-								}
+							boolean isTrim = (trimKeyList != null && trimKeyList.contains(key));
+							boolean toStr = isTrim || (stringKeyList != null && stringKeyList.contains(key));
+							if (toStr) {
+								value = JSON.toJSONString(value);
 							}
-							else if (startsWithAt || key.endsWith("@") || (key.endsWith("<>") && value instanceof Map<?, ?>)) {
+							if (isTrim && value != null) {
+								value = StringUtil.trim(value);
+							}
+
+							if (startsWithAt || key.endsWith("@") || (key.endsWith("<>") && value instanceof Map<?, ?>)) {
 								if (onParse(key, value) == false) {
 									invalidate();
 								}
@@ -1242,6 +1251,9 @@ public void recycle() {
 		if (stringKeyList != null) { // 避免被全局关键词覆盖 && ! stringKeyList.isEmpty()) {
 			request.put(KEY_STRING, StringUtil.get(stringKeyList.toArray()));
 		}
+		if (trimKeyList != null) { // 避免被全局关键词覆盖 && ! trimKeyList.isEmpty()) {
+			request.put(KEY_TRIM, StringUtil.get(trimKeyList.toArray()));
+		}
 
 		method = null;
 		parentPath = null;
diff --git a/APIJSONORM/src/main/java/apijson/orm/AbstractVerifier.java b/APIJSONORM/src/main/java/apijson/orm/AbstractVerifier.java
