yang_base/action/
request_id.rs1use std::borrow::Cow;
15use std::fmt;
16use std::sync::atomic::{AtomicU64, Ordering};
17
18static COUNTER: AtomicU64 = AtomicU64::new(0);
20
21#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash)]
26pub struct RequestId(u128);
27
28impl RequestId {
29 pub fn generate() -> Self {
33 let millis = chrono::Utc::now().timestamp_millis().max(0) as u128;
35 let counter = COUNTER.fetch_add(1, Ordering::Relaxed) as u128;
36 RequestId((millis << 64) | counter)
37 }
38
39 pub fn from_u128(v: u128) -> Self {
41 RequestId(v)
42 }
43
44 pub fn as_u128(&self) -> u128 {
46 self.0
47 }
48
49 pub fn parse_hex(s: &str) -> Option<Self> {
63 let s = s.trim();
64 let normalized = if s.contains('-') {
66 Cow::Owned(s.replace('-', ""))
67 } else {
68 Cow::Borrowed(s)
69 };
70 if normalized.is_empty() || normalized.len() > 32 {
71 return None;
72 }
73 u128::from_str_radix(&normalized, 16)
74 .ok()
75 .filter(|value| *value != 0)
76 .map(RequestId)
77 }
78}
79
80impl fmt::Display for RequestId {
81 fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
82 write!(f, "{:032x}", self.0)
84 }
85}
86
87impl Default for RequestId {
88 fn default() -> Self {
89 Self::generate()
90 }
91}
92
93#[cfg(test)]
94mod tests {
95 use super::*;
96
97 #[test]
98 fn generate_is_monotonic_within_process() {
99 let a = RequestId::generate();
100 let b = RequestId::generate();
101 assert_ne!(a, b, "连续生成的 request_id 不应相同");
103 assert!(b.as_u128() > a.as_u128(), "request_id 应单调递增");
104 }
105
106 #[test]
107 fn display_is_32_hex_chars() {
108 let id = RequestId::from_u128(0x0192_f4a1_c3d5_0000_0000_0000_0000_002a);
109 let s = id.to_string();
110 assert_eq!(s.len(), 32, "应为 32 位定宽十六进制: {}", s);
111 assert!(s.chars().all(|c| c.is_ascii_hexdigit()));
112 }
113
114 #[test]
115 fn parse_hex_roundtrip() {
116 let id = RequestId::from_u128(0xdead_beef);
117 let parsed = RequestId::parse_hex(&id.to_string()).expect("应能解析");
118 assert_eq!(id, parsed);
119 }
120
121 #[test]
122 fn parse_hex_rejects_invalid() {
123 assert!(RequestId::parse_hex("").is_none());
124 assert!(RequestId::parse_hex("xyz").is_none());
125 assert!(RequestId::parse_hex(&"f".repeat(33)).is_none());
127 }
128
129 #[test]
130 fn parse_hex_accepts_upstream_short_form() {
131 let parsed = RequestId::parse_hex("2a").expect("短十六进制应可解析");
132 assert_eq!(parsed.as_u128(), 0x2a);
133 }
134
135 #[test]
137 fn parse_hex_accepts_hyphenated_uuid() {
138 let uuid = "550e8400-e29b-41d4-a716-446655440000";
139 let parsed = RequestId::parse_hex(uuid).expect("UUID 应可解析");
140 assert_eq!(parsed.as_u128(), 0x550e8400_e29b_41d4_a716_446655440000);
141 assert!(RequestId::parse_hex("not-a-hex-id-zz").is_none());
143 }
144}