feat(core,repository,docs): add developer guide, improve ID generation and SQL handling

m0ver · m0ver · commit 09c70c876be7 · 2026-01-25T17:14:20.000+08:00
Add comprehensive DEVELOPER_GUIDE.md Bump version to 1.7.17 and update related scripts and docs Support returning user-generated IDs when "generate"=true across MySQL, SQLite, SQLServer, and Redis Unify appendAndGetId behavior: fallback to DB-generated ID only if no custom ID is provided Improve SQL parameter binding and add support for LONGTEXT and BOOLEAN Fix auto-increment field skipping logic in prepared statements Tighten Action mode validation to prevent CLI/HTTP misuse @yyfyfyang Improve SQL formatting, Javadoc wrapping, and general code style Minor refactors and dependency upgrade (Jupiter 6.0.2)
diff --git a/DEVELOPER_GUIDE.md b/DEVELOPER_GUIDE.md
@@ -26,7 +26,7 @@ Add the following dependency to your `pom.xml`:
 <dependency>
   <groupId>org.tinystruct</groupId>
   <artifactId>tinystruct</artifactId>
-  <version>1.7.16</version>
+  <version>1.7.17</version>
 </dependency>
 ```
 
diff --git a/README.md b/README.md
@@ -25,7 +25,7 @@ Installation and Getting Started Manually
 <dependency>
   <groupId>org.tinystruct</groupId>
   <artifactId>tinystruct</artifactId>
-  <version>1.7.16</version>
+  <version>1.7.17</version>
   <classifier>jar-with-dependencies</classifier> <!-- Optional -->
 </dependency>
 ```
@@ -91,7 +91,7 @@ Execute in CLI mode
 $ bin/dispatcher --version
 
   _/  '         _ _/  _     _ _/
-  /  /  /) (/ _)  /  /  (/ (  /  1.7.16
+  /  /  /) (/ _)  /  /  (/ (  /  1.7.17
            /
 ```
 ```tcsh
diff --git a/bin/dispatcher b/bin/dispatcher
@@ -17,7 +17,7 @@
 # ***************************************************************************
 
 ROOT="$(pwd)"
-VERSION="1.7.16"
+VERSION="1.7.17"
 cd "$(dirname "$0")" || exit
 cd "../"
 # Navigate to the root directory
diff --git a/bin/dispatcher.cmd b/bin/dispatcher.cmd
@@ -19,7 +19,7 @@
 set "MAVEN_REPO=%USERPROFILE%\.m2\repository\org\tinystruct\tinystruct"
 @REM Consolidate classpath entries, initialize ROOT and VERSION
 set "ROOT=%~dp0.."
-set "VERSION=1.7.16"
+set "VERSION=1.7.17"
 
 @REM Define the paths for tinystruct jars in the Maven repository
 set "DEFAULT_JAR_FILE=%MAVEN_REPO%\%VERSION%\tinystruct-%VERSION%.jar"
diff --git a/build.sh b/build.sh
@@ -25,7 +25,7 @@ elif [ -f "$HOME/.bash_profile" ]; then
 fi
 
 # Define variables
-TARGET_JAR="./target/tinystruct-1.7.16.jar"
+TARGET_JAR="./target/tinystruct-1.7.17.jar"
 NATIVE_NAME="dispatcher-native"
 MAIN_CLASS="org.tinystruct.system.Dispatcher"
 CONFIG_DIR="./bin/.metadata"
diff --git a/pom.xml b/pom.xml
@@ -4,7 +4,7 @@
     <modelVersion>4.0.0</modelVersion>
     <groupId>org.tinystruct</groupId>
     <artifactId>tinystruct</artifactId>
-    <version>1.7.16</version>
+    <version>1.7.17</version>
     <name>tinystruct framework</name>
     <description>A lightweight, modular Java application framework for web and CLI development,
         designed for AI integration and plugin-based architecture.
@@ -131,7 +131,7 @@
         <java.version>17</java.version>
         <jjwt.version>0.13.0</jjwt.version>
         <jna.version>5.18.1</jna.version>
-        <jupiter.version>6.0.1</jupiter.version>
+        <jupiter.version>6.0.2</jupiter.version>
         <kafka.version>4.1.1</kafka.version>
         <lettuce.version>7.2.1.RELEASE</lettuce.version>
         <maven.compiler.source>17</maven.compiler.source>
diff --git a/src/main/java/org/tinystruct/system/ApplicationManager.java b/src/main/java/org/tinystruct/system/ApplicationManager.java
@@ -24,7 +24,7 @@
 import java.util.concurrent.ConcurrentHashMap;
 
 public final class ApplicationManager {
-    public static final String VERSION = "1.7.16";
+    public static final String VERSION = "1.7.17";
     private static final ConcurrentHashMap<String, Application> applications = new ConcurrentHashMap<>();
     private static final ActionRegistry ROUTE_REGISTRY_INSTANCE = ActionRegistry.getInstance();
     private static Configuration<String> settings;
