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

This commit is contained in:
2026-08-25 13:43:26 +08:00
parent 829f009229
commit 30e5f165f2
56 changed files with 319 additions and 332 deletions
@@ -1,7 +1,7 @@
/*
* Copyright (c) 2025 SimcuTeam. All rights reserved.
* 移植自 C# 项目 SimApiE:\simcu\simapi-net),遵循 MIT 许可证。
* 声明式 AES body 解密注解(对齐 C# SimApi.Attributes.AesBodyAttribute
* 遵循 MIT 许可证。
* 声明式 AES body 解密注解。
*
* 标注在控制器方法参数上,请求派发时(SimApiRequestDelegateFactory)自动解密并反序列化:
* - 读取请求体 {"data": "密文"}
@@ -1,12 +1,12 @@
/*
* Copyright (c) 2025 SimcuTeam. All rights reserved.
* 移植自 C# 项目 SimApiE:\simcu\simapi-net),遵循 MIT 许可证。
* 遵循 MIT 许可证。
*/
package simcu::simapi.annotations
/**
* 原样响应注解(对齐 C# SimApi.Attributes.OriginResponseAttribute
* 原样响应注解。
*
* 标注在控制器方法或类上,请求派发时 SimApiRequestDelegateFactory 跳过
* 统一响应封装(SimApiBaseResponse 包装),接口返回什么就输出什么。
@@ -1,25 +1,25 @@
/*
* Copyright (c) 2025 SimcuTeam. All rights reserved.
* 移植自 C# 项目 SimApiE:\simcu\simapi-net),遵循 MIT 许可证。
* 遵循 MIT 许可证。
*/
package simcu::simapi.annotations
/**
* 声明式鉴权注解(对齐 C# SimApi.Attributes.SimApiAuthAttribute
* 声明式鉴权注解。
*
* 标注在控制器方法或类上,请求派发时(SimApiRequestDelegateFactory)自动执行鉴权:
* - 未登录(无 LoginInfo)→ 401
* - type 非空且登录用户类型不匹配 → 403
* - 遍历执行所有已注册的 ISimApiAuthChecker
* - 遍历执行所有已注册的 SimApiAuthChecker
*
* 用法:
* @SimApiAuth // 任意已登录用户
* @SimApiAuth["admin"] // 仅 admin 类型
* @SimApiAuth["admin,user"] // admin 或 user 类型(对齐 C# type.Split(",")
* @SimApiAuth["admin,user"] // admin 或 user 类型
*
* 说明:仓颉注解参数须为编译期常量,String 无法作为 const 值数组元素,
* 故与 C# 的 string[] 不同,这里用逗号分隔字符串对齐 C# 多类型。
* 故用逗号分隔字符串表示多种类型。
*/
@Annotation[target: [MemberFunction, Type]]
public class SimApiAuth {
@@ -1,7 +1,7 @@
/*
* Copyright (c) 2025 SimcuTeam. All rights reserved.
* 移植自 C# 项目 SimApiE:\simcu\simapi-net),遵循 MIT 许可证。
* 声明式签名校验注解(对齐 C# SimApi.Attributes.SimApiSignAttribute
* 遵循 MIT 许可证。
* 声明式签名校验注解。
*
* 标注在控制器方法或类上,请求派发时(SimApiRequestDelegateFactory)自动执行验签:
* - 提取 appId / timestamp / nonce / signQuery 优先,其次 Header