Class KsuidParser
java.lang.Object
cloud.opencode.base.id.ksuid.KsuidParser
- All Implemented Interfaces:
IdParser<String, KsuidParser.ParsedKsuid>
KSUID Parser
KSUID解析器
Parses KSUID strings and extracts components.
解析KSUID字符串并提取组成部分。
Usage Examples | 使用示例:
KsuidParser parser = KsuidParser.create();
KsuidParser.ParsedKsuid parsed = parser.parse("0ujtsYcgvSTl8PAuAdqWYSMnLOv");
Instant time = parsed.time();
byte[] payload = parsed.payload();
Features | 主要功能:
- Parse KSUID strings to extract timestamp and payload - 解析KSUID字符串提取时间戳和负载
- Validate KSUID format and structure - 验证KSUID格式和结构
Security | 安全性:
- Thread-safe: Yes (immutable record) - 线程安全: 是(不可变记录)
- Null-safe: No - 空值安全: 否
Performance | 性能特性:
- Time complexity: O(1) - parse() decodes a fixed 27-character Base62 string into a 20-byte structure (4-byte timestamp + 16-byte payload) - 时间复杂度: O(1) - parse() 将固定 27 字符的 Base62 字符串解码为 20 字节结构(4 字节时间戳 + 16 字节负载)
- Space complexity: O(1) - produces a fixed-size ParsedKsuid record with a 16-byte payload array - 空间复杂度: O(1) - 生成包含 16 字节负载数组的固定大小 ParsedKsuid 记录
- Since:
- JDK 25, opencode-base-id V1.1.0
- Author:
- Leon Soo www.LeonSoo.com
- See Also:
-
Nested Class Summary
Nested ClassesModifier and TypeClassDescriptionstatic final recordParsed KSUID result 解析后的KSUID结果 -
Method Summary
Modifier and TypeMethodDescriptionstatic KsuidParsercreate()Creates a KSUID parser 创建KSUID解析器extractTimestamp(String ksuid) Extracts the timestamp from an ID 从ID中提取时间戳booleanValidates the ID format 验证ID格式Parses an ID to extract embedded information 解析ID以提取嵌入信息
-
Method Details
-
create
-
parse
Description copied from interface:IdParserParses an ID to extract embedded information 解析ID以提取嵌入信息- Specified by:
parsein interfaceIdParser<String, KsuidParser.ParsedKsuid>- Parameters:
ksuid- the ID to parse | 要解析的ID- Returns:
- parse result | 解析结果
-
extractTimestamp
Description copied from interface:IdParserExtracts the timestamp from an ID 从ID中提取时间戳- Specified by:
extractTimestampin interfaceIdParser<String, KsuidParser.ParsedKsuid>- Parameters:
ksuid- the ID | ID- Returns:
- timestamp | 时间戳
-
isValid
-