35 lines
1.4 KiB
Plaintext
35 lines
1.4 KiB
Plaintext
|
/*
|
|||
|
|
* Copyright (c) 2025 SimcuTeam. All rights reserved.
|
|||
|
|
* 移植自 C# 项目 SimApi（E:\simcu\simapi-net），遵循 MIT 许可证。
|
|||
|
|
* 声明式签名校验注解（对齐 C# SimApi.Attributes.SimApiSignAttribute）。
|
|||
|
|
*
|
|||
|
|
* 标注在控制器方法或类上，请求派发时（SimApiRequestDelegateFactory）自动执行验签：
|
|||
|
|
* - 提取 appId / timestamp / nonce / sign（Query 优先，其次 Header）
|
|||
|
|
* - 通过 keyProvider（DI 解析）获取密钥
|
|||
|
|
* - 过期校验 + nonce 去重（需缓存）
|
|||
|
|
* - 拼接 SignFields + appId + timestamp + nonce + key，MD5 比对
|
|||
|
|
*
|
|||
|
|
* 用法：
|
|||
|
|
* @SimApiSign // 默认 SimApiSignProviderBase（应用需注册实现）
|
|||
|
|
* @SimApiSign["MySignProvider"] // 指定 provider 类型名（DI 注册的实现类）
|
|||
|
|
*
|
|||
|
|
* 说明：仓颉注解参数须为编译期常量，无法直接持有 Type；
|
|||
|
|
* 故 keyProvider 用类型名 String，运行时经 TypeInfo.get 解析后从 DI 取实例。
|
|||
|
|
*/
|
|||
|
|
|
|||
|
|
package simapi.annotations
|
|||
|
|
|
|||
|
|
@Annotation[target: [MemberFunction, Type]]
|
|||
|
|
public class SimApiSign {
|
|||
|
|
/// 签名提供器类型名（DI 注册的 SimApiSignProviderBase 实现类名）
|
|||
|
|
public let keyProvider: String
|
|||
|
|
|
|||
|
|
public const init() {
|
|||
|
|
this.keyProvider = ""
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
public const init(keyProvider: String) {
|
|||
|
|
this.keyProvider = keyProvider
|
|||
|
|
}
|
|||
|
|
}
|