feat(request): 实现请求参数获取方法

- 完成 ReqParam/ReqParams 方法实现，用于获取 URL 参数并返回 *Obj
- 完成 ReqForm/ReqForms 方法实现，用于获取表单数据并返回 *Obj
- 完成 ReqJson/ReqJsons 方法实现，用于获取 JSON Body 并返回 *Obj
- 完成 ReqFile/ReqFiles 方法实现，用于获取上传文件
- 完成 ReqData/ReqDatas 方法实现，用于统一封装请求数据获取并返回 *Obj
- 更新计划文件状态，标记所有相关功能模块为已完成

examples/hotimedb_examples.go

@@ -372,7 +372,7 @@ func Example7_AggregateQuery_Fixed(db *db.HoTimeDB) {
 }
 
 // 示例8: 事务处理（修正版）
-func Example8_Transaction_Fixed(db *db.HoTimeDB) {
+func Example8_Transaction_Fixed(database *db.HoTimeDB) {
 	fmt.Println("=== 事务处理示例 ===")
 
 	// 模拟转账操作
@@ -380,7 +380,7 @@ func Example8_Transaction_Fixed(db *db.HoTimeDB) {
 	toUserId := int64(2)
 	amount := 100.0
 
-	success := db.Action(func(tx db.HoTimeDB) bool {
+	success := database.Action(func(tx db.HoTimeDB) bool {
 		// 检查转出账户余额（单条件）
 		fromUser := tx.Get("user", "balance", common.Map{"id": fromUserId})
 		if fromUser == nil {
@@ -445,22 +445,22 @@ func Example8_Transaction_Fixed(db *db.HoTimeDB) {
 		fmt.Println("事务执行成功")
 	} else {
 		fmt.Println("事务回滚")
-		if db.LastErr.GetError() != nil {
-			fmt.Println("错误原因:", db.LastErr.GetError())
+		if database.LastErr.GetError() != nil {
+			fmt.Println("错误原因:", database.LastErr.GetError())
 		}
 	}
 }
 
 // 示例9: 缓存机制（修正版）
-func Example9_CacheSystem_Fixed(db *db.HoTimeDB) {
+func Example9_CacheSystem_Fixed(database *db.HoTimeDB) {
 	fmt.Println("=== 缓存机制示例 ===")
 
 	// 设置缓存（实际项目中需要配置缓存参数）
-	db.HoTimeCache = &cache.HoTimeCache{}
+	database.HoTimeCache = &cache.HoTimeCache{}
 
 	// 第一次查询（会缓存结果）
 	fmt.Println("第一次查询（会缓存）...")
-	users1 := db.Select("user", "*", common.Map{
+	users1 := database.Select("user", "*", common.Map{
 		"status": 1, // 单条件
 		"LIMIT":  10,
 	})
@@ -468,7 +468,7 @@ func Example9_CacheSystem_Fixed(db *db.HoTimeDB) {
 
 	// 第二次相同查询（从缓存获取）
 	fmt.Println("第二次相同查询（从缓存获取）...")
-	users2 := db.Select("user", "*", common.Map{
+	users2 := database.Select("user", "*", common.Map{
 		"status": 1, // 单条件
 		"LIMIT":  10,
 	})
@@ -476,7 +476,7 @@ func Example9_CacheSystem_Fixed(db *db.HoTimeDB) {
 
 	// 更新操作会清除缓存
 	fmt.Println("执行更新操作（会清除缓存）...")
-	affected := db.Update("user", common.Map{
+	affected := database.Update("user", common.Map{
 		"updated_time[#]": "NOW()",
 	}, common.Map{
 		"id": 1, // 单条件
@@ -485,7 +485,7 @@ func Example9_CacheSystem_Fixed(db *db.HoTimeDB) {
 
 	// 再次查询（重新从数据库获取并缓存）
 	fmt.Println("更新后再次查询（重新缓存）...")
-	users3 := db.Select("user", "*", common.Map{
+	users3 := database.Select("user", "*", common.Map{
 		"status": 1, // 单条件
 		"LIMIT":  10,
 	})
@@ -493,20 +493,20 @@ func Example9_CacheSystem_Fixed(db *db.HoTimeDB) {
 }
 
 // 示例10: 性能优化技巧（修正版）
-func Example10_PerformanceOptimization_Fixed(db *db.HoTimeDB) {
+func Example10_PerformanceOptimization_Fixed(database *db.HoTimeDB) {
 	fmt.Println("=== 性能优化技巧示例 ===")
 
 	// IN查询优化（连续数字自动转为BETWEEN）
 	fmt.Println("IN查询优化示例...")
-	users := db.Select("user", "*", common.Map{
+	users := database.Select("user", "*", common.Map{
 		"id": []int{1, 2, 3, 4, 5, 10, 11, 12, 13, 20}, // 单个IN条件，会被优化
 	})
 	fmt.Printf("查询到 %d 个用户\n", len(users))
-	fmt.Println("执行的SQL:", db.LastQuery)
+	fmt.Println("执行的SQL:", database.LastQuery)
 
 	// 批量插入（使用事务）
 	fmt.Println("\n批量插入示例...")
-	success := db.Action(func(tx db.HoTimeDB) bool {
+	success := database.Action(func(tx db.HoTimeDB) bool {
 		for i := 1; i <= 100; i++ {
 			id := tx.Insert("user_batch", common.Map{
 				"name":            fmt.Sprintf("批量用户%d", i),
@@ -534,7 +534,7 @@ func Example10_PerformanceOptimization_Fixed(db *db.HoTimeDB) {
 
 	// 索引友好的查询（修正版）
 	fmt.Println("\n索引友好的查询...")
-	recentUsers := db.Select("user", "*", common.Map{
+	recentUsers := database.Select("user", "*", common.Map{
 		"AND": common.Map{
 			"created_time[>]": "2023-01-01", // 假设created_time有索引
 			"status":          1,            // 假设status有索引
@@ -766,6 +766,66 @@ correctUsers4 := db.Select("user", "*", common.Map{
 	_ = db
 }
 
+// BatchInsertExample 批量插入示例
+func BatchInsertExample(database *db.HoTimeDB) {
+	fmt.Println("\n=== 批量插入示例 ===")
+
+	// 批量插入用户（使用 []Map 格式）
+	affected := database.BatchInsert("user", []common.Map{
+		{"name": "批量用户1", "email": "batch1@example.com", "age": 25, "status": 1},
+		{"name": "批量用户2", "email": "batch2@example.com", "age": 30, "status": 1},
+		{"name": "批量用户3", "email": "batch3@example.com", "age": 28, "status": 1},
+	})
+	fmt.Printf("批量插入了 %d 条用户记录\n", affected)
+
+	// 批量插入日志（使用 [#] 标记直接 SQL）
+	logAffected := database.BatchInsert("log", []common.Map{
+		{"user_id": 1, "action": "login", "ip": "192.168.1.1", "created_time[#]": "NOW()"},
+		{"user_id": 2, "action": "logout", "ip": "192.168.1.2", "created_time[#]": "NOW()"},
+		{"user_id": 3, "action": "view", "ip": "192.168.1.3", "created_time[#]": "NOW()"},
+	})
+	fmt.Printf("批量插入了 %d 条日志记录\n", logAffected)
+}
+
+// UpsertExample Upsert（插入或更新）示例
+func UpsertExample(database *db.HoTimeDB) {
+	fmt.Println("\n=== Upsert示例 ===")
+
+	// Upsert 用户数据（使用 Slice 格式）
+	// 如果 id 存在则更新，不存在则插入
+	affected := database.Upsert("user",
+		common.Map{
+			"id":    1,
+			"name":  "张三更新",
+			"email": "zhang_updated@example.com",
+			"age":   26,
+		},
+		common.Slice{"id"},                   // 唯一键
+		common.Slice{"name", "email", "age"}, // 冲突时更新的字段
+	)
+	fmt.Printf("Upsert 影响了 %d 行\n", affected)
+
+	// Upsert 使用 [#] 直接 SQL
+	affected2 := database.Upsert("user_stats",
+		common.Map{
+			"user_id":        1,
+			"login_count[#]": "login_count + 1",
+			"last_login[#]":  "NOW()",
+		},
+		common.Slice{"user_id"},
+		common.Slice{"login_count", "last_login"},
+	)
+	fmt.Printf("统计 Upsert 影响了 %d 行\n", affected2)
+
+	// 也支持可变参数形式
+	affected3 := database.Upsert("user",
+		common.Map{"id": 2, "name": "李四", "status": 1},
+		common.Slice{"id"},
+		"name", "status", // 可变参数
+	)
+	fmt.Printf("可变参数 Upsert 影响了 %d 行\n", affected3)
+}
+
 // 运行所有修正后的示例
 func RunAllFixedExamples() {
 	fmt.Println("开始运行HoTimeDB所有修正后的示例...")
@@ -776,6 +836,10 @@ func RunAllFixedExamples() {
 
 	fmt.Println("请根据实际环境配置数据库连接后运行相应示例")
 	fmt.Println("所有示例代码已修正完毕，语法正确！")
+	fmt.Println("")
+	fmt.Println("新增功能示例说明：")
+	fmt.Println("  - BatchInsertExample(db): 批量插入示例，使用 []Map 格式")
+	fmt.Println("  - UpsertExample(db):      插入或更新示例")
 }
 
 func main() {