Java：所有 Demo 升级 APIJSON, apijson-framework, 自身版本为 4.8.3，升级 apijson-column, mysql-connector-java 分别至 1.1.5, 8.0.27；完善每个 Demo 类的说明并带上相关链接

Author: TommyLemon

.gitignore

@@ -13,3 +13,4 @@ APIJSON-Java-Server/APIJSONDemo/.idea
 APIJSON-Java-Server/APIJSONDemo-HikariCP/.settings
 APIJSON-Java-Server/APIJSONBoot-MultiConnectionPool/.settings
 APIJSON-Java-Server/APIJSONBoot-MultiDataSource/.settings
+APIJSON-Java-Server/APIJSONBoot-MultiDataSource/.idea

APIJSON-Java-Server/APIJSONBoot-MultiDataSource/pom.xml

@@ -5,7 +5,7 @@
 
 	<groupId>apijson.boot</groupId>
 	<artifactId>apijson-boot</artifactId>
-	<version>4.8.0</version>
+	<version>4.8.3</version>
 	<!-- <packaging>jar</packaging> -->
 
 	<name>APIJSONBoot-MultiDataSource</name>
@@ -53,21 +53,21 @@
 
 
 		<!-- 可使用 libs 目录的 apijson-orm.jar, apijson-framework.jar, apijson-column.jar 来替代，两种方式二选一 <<<<<<<<<< -->
-		<!-- <dependency>
+		<dependency>
 			<groupId>com.github.Tencent</groupId>
 			<artifactId>APIJSON</artifactId>
-			<version>4.8.0</version>
+			<version>4.8.3</version>
 		</dependency>
 		 <dependency>
 			<groupId>com.github.APIJSON</groupId>
 			<artifactId>apijson-framework</artifactId>
-			<version>4.8.0</version>
+			<version>4.8.3</version>
 		</dependency>
 		<dependency>
 			<groupId>com.github.APIJSON</groupId>
 			<artifactId>apijson-column</artifactId>
-			<version>1.1.3</version>
-		</dependency> -->
+			<version>1.1.5</version>
+		</dependency>
 		<!-- 可使用 libs 目录的 apijson-orm.jar, apijson-framework.jar, apijson-column.jar 来替代，两种方式二选一 >>>>>>>>>> -->
 
 		<!-- 需要用的数据库 JDBC 驱动 -->

APIJSON-Java-Server/APIJSONBoot-MultiDataSource/src/main/java/apijson/boot/DemoApplication.java

@@ -61,8 +61,10 @@
 import unitauto.jar.UnitAutoApp;
 
 
-/**SpringBootApplication
- * 右键这个类 > Run As > Java Application
+/**Demo SpringBoot Application 主应用程序启动类  
+ * 右键这个类 > Run As > Java Application  
+ * 具体见 SpringBoot 文档  
+ * https://www.springcloud.cc/spring-boot.html#using-boot-locating-the-main-class
  * @author Lemon
  */
 @Configuration

APIJSON-Java-Server/APIJSONBoot-MultiDataSource/src/main/java/apijson/boot/DemoController.java

@@ -87,7 +87,11 @@
 import apijson.orm.exception.OutOfRangeException;
 
 
-/**数据相关的控制器，包括通用增删改查接口等
+/**请求路由入口控制器，包括通用增删改查接口等，转交给 APIJSON 的 Parser 来处理
+ * 具体见 SpringBoot 文档
+ * https://www.springcloud.cc/spring-boot.html#boot-features-spring-mvc
+ * 以及 APIJSON 通用文档 3.设计规范 3.1 操作方法  
+ * https://github.com/Tencent/APIJSON/blob/master/Document.md#3.1
  * <br > 建议全通过HTTP POST来请求:
  * <br > 1.减少代码 - 客户端无需写HTTP GET,PUT等各种方式的请求代码
  * <br > 2.提高性能 - 无需URL encode和decode

APIJSON-Java-Server/APIJSONBoot-MultiDataSource/src/main/java/apijson/demo/DemoFunctionParser.java

@@ -32,7 +32,8 @@
 import apijson.orm.JSONRequest;
 
 
-/**可远程调用的函数类
+/**可远程调用的函数类，用于自定义业务逻辑处理
+ * 具体见 https://github.com/Tencent/APIJSON/issues/101
  * @author Lemon
  */
 public class DemoFunctionParser extends APIJSONFunctionParser {

APIJSON-Java-Server/APIJSONBoot-MultiDataSource/src/main/java/apijson/demo/DemoObjectParser.java

@@ -27,7 +27,7 @@
 import apijson.orm.SQLConfig;
 
 
-/**简化Parser，getObject和getArray(getArrayConfig)都能用
+/**对象解析器，用来简化 Parser
  * @author Lemon
  */
 public class DemoObjectParser extends APIJSONObjectParser {

APIJSON-Java-Server/APIJSONBoot-MultiDataSource/src/main/java/apijson/demo/DemoParser.java

@@ -23,6 +23,7 @@
 
 
 /**请求解析器
+ * 具体见 https://github.com/Tencent/APIJSON/issues/38
  * @author Lemon
  */
 public class DemoParser extends APIJSONParser {

APIJSON-Java-Server/APIJSONBoot-MultiDataSource/src/main/java/apijson/demo/DemoSQLConfig.java

@@ -33,8 +33,10 @@
 import apijson.orm.AbstractSQLConfig;
 
 
-/**SQL 配置
+/**SQL配置
  * TiDB 用法和 MySQL 一致
+ * 具体见详细的说明文档 C.开发说明 C-1-1.修改数据库链接  
+ * https://github.com/Tencent/APIJSON/blob/master/%E8%AF%A6%E7%BB%86%E7%9A%84%E8%AF%B4%E6%98%8E%E6%96%87%E6%A1%A3.md#c-1-1%E4%BF%AE%E6%94%B9%E6%95%B0%E6%8D%AE%E5%BA%93%E9%93%BE%E6%8E%A5
  * @author Lemon
  */
 public class DemoSQLConfig extends APIJSONSQLConfig {

APIJSON-Java-Server/APIJSONBoot-MultiDataSource/src/main/java/apijson/demo/DemoSQLExecutor.java

@@ -28,7 +28,8 @@
 import apijson.orm.SQLConfig;
 
 
-/**SQL 执行
+/**SQL 执行器，支持连接池及多数据源
+ * 具体见 https://github.com/Tencent/APIJSON/issues/151
  * @author Lemon
  */
 public class DemoSQLExecutor extends APIJSONSQLExecutor {

APIJSON-Java-Server/APIJSONBoot-MultiDataSource/src/main/java/apijson/demo/DemoVerifier.java

@@ -17,7 +17,8 @@
 import apijson.framework.APIJSONVerifier;
 
 
-/**权限验证器
+/**安全校验器，校验请求参数、角色与权限等
+ * 具体见 https://github.com/Tencent/APIJSON/issues/12
  * @author Lemon
  */
 public class DemoVerifier extends APIJSONVerifier {

APIJSON-Java-Server/APIJSONBoot/libs/apijson-column-1.1.3.jar renamed to APIJSON-Java-Server/APIJSONBoot/libs/apijson-column-1.1.5.jar

@@ -5,7 +5,7 @@
 
 	<groupId>apijson.boot</groupId>
 	<artifactId>apijson-boot</artifactId>
-	<version>4.8.0</version>
+	<version>4.8.3</version>
 	<!-- <packaging>jar</packaging> -->
 
 	<name>APIJSONBoot</name>
@@ -34,7 +34,7 @@
 
 		<!-- 单元测试：可使用 libs 目录的 unitauto-java.jar 和 unitauto-jar.jar 来替代，两种方式二选一 
 			<<<<<<<<< -->
-		<dependency>
+ 		<dependency>
 			<groupId>com.github.TommyLemon</groupId>
 			<artifactId>unitauto-java</artifactId>
 			<version>2.6.3</version>
@@ -56,25 +56,25 @@
 		<dependency>
 			<groupId>com.github.Tencent</groupId>
 			<artifactId>APIJSON</artifactId>
-			<version>4.8.0</version>
+			<version>4.8.3</version>
 		</dependency>
 		 <dependency>
 			<groupId>com.github.APIJSON</groupId>
 			<artifactId>apijson-framework</artifactId>
-			<version>4.8.0</version>
+			<version>4.8.3</version>
 		</dependency>
 		<dependency>
 			<groupId>com.github.APIJSON</groupId>
 			<artifactId>apijson-column</artifactId>
-			<version>1.1.3</version>
+			<version>1.1.5</version>
 		</dependency>
 		<!-- 可使用 libs 目录的 apijson-orm.jar, apijson-framework.jar, apijson-column.jar 来替代，两种方式二选一 >>>>>>>>>> -->
 
 		<!-- 需要用的数据库 JDBC 驱动 -->
 		<dependency>
 			<groupId>mysql</groupId>
 			<artifactId>mysql-connector-java</artifactId>
-			<version>8.0.22</version>
+			<version>8.0.27</version>
 		</dependency>
 		<dependency>
 			<groupId>org.postgresql</groupId>

APIJSON-Java-Server/APIJSONBoot/libs/apijson-framework-4.8.1.jar

@@ -61,8 +61,10 @@
 import unitauto.jar.UnitAutoApp;
 
 
-/**SpringBootApplication
- * 右键这个类 > Run As > Java Application
+/**Demo SpringBoot Application 主应用程序启动类  
+ * 右键这个类 > Run As > Java Application  
+ * 具体见 SpringBoot 文档  
+ * https://www.springcloud.cc/spring-boot.html#using-boot-locating-the-main-class
  * @author Lemon
  */
 @Configuration