重构: 源码文件蛇形命名, 接口去I头(BindRequestContext/SimApiAuthChecker), 清理C#相关说明, serialization依赖路径改 serialization-cj

src/controllers/simapi_common_controller.cj

@@ -0,0 +1,77 @@
+/*
+ * Copyright (c) 2025 SimcuTeam. All rights reserved.
+ * 遵循 MIT 许可证。
+ * Controllers/SimApiCommonController：通用内置路由。
+ */
+
+package simcu::simapi.controllers
+
+import std.collection.*
+import soulsoft_web_mvc.annotations.*
+import simcu::simapi.communications.*
+import simcu::simapi.configurations.*
+import simcu::simapi.helpers.*
+
+/**
+ * 通用控制器：错误反馈、WebConfig、用户信息。
+ * 控制器直接返回 SimApiBaseResponse / SimApiResponse<T>。
+ */
+public class SimApiCommonController <: SimApiBaseController {
+    private let _options: SimApiOptions
+
+    public init(options: SimApiOptions) {
+        this._options = options
+    }
+
+    /**
+     * GET /exception/{code}：错误反馈页面（始终注册）。
+     * 抛 SimApiException，由异常中间件统一输出。
+     */
+    @HttpGet["exception/{code}"]
+    public func exceptionHandler(@FromRoute code: Int64): Unit {
+        SimApiError.error(code: code)
+    }
+
+    /**
+     * POST/GET /config：给前端的自定义信息（含版本）。
+     * 对应路由 [HttpPost, HttpGet] 无路径，
+     * 由 MapControllerRoute(pattern=WebConfigRoute) 注册；soulsoft 约定路由不支持 defaults，故用特性路由直接对齐路径。
+     */
+    @HttpGet["/config"]
+    public func webConfig(): HashMap<String, Any> {
+        webConfigMap()
+    }
+
+    @HttpPost["/config"]
+    public func webConfigPost(): HashMap<String, Any> {
+        webConfigMap()
+    }
+
+    /**
+     * POST /user/info：获取已登录用户信息（需登录）。
+     * 返回 SimApiLoginItem 由 SimApiResponseFilter 自动封装（data 为登录信息对象）。
+     */
+    @HttpPost["/user/info"]
+    public func userInfo(): SimApiLoginItem {
+        requireLogin()
+        loginInfo
+    }
+
+    private func versionsMap(): HashMap<String, Any> {
+        var map = HashMap<String, Any>()
+        map["SimApi"] = SimApiUtil.simApiVersion
+        map["App"] = SimApiUtil.appVersion
+        map
+    }
+
+    private func webConfigMap(): HashMap<String, Any> {
+        var map = HashMap<String, Any>()
+        for ((key, value) in _options.webConfig) {
+            map[key] = value
+        }
+        if (_options.webConfigIncludeVersion) {
+            map["Versions"] = versionsMap()
+        }
+        map
+    }
+}