reifydb_core/value/encoded/
uuid4.rs

1// Copyright (c) reifydb.com 2025
2// This file is licensed under the AGPL-3.0-or-later, see license.md file
3
4use std::ptr;
5
6use reifydb_type::{Type, Uuid4};
7use uuid::Uuid;
8
9use crate::value::encoded::{EncodedValues, EncodedValuesLayout};
10
11impl EncodedValuesLayout {
12	pub fn set_uuid4(&self, row: &mut EncodedValues, index: usize, value: Uuid4) {
13		let field = &self.fields[index];
14		debug_assert!(row.len() >= self.total_static_size());
15		debug_assert_eq!(field.r#type, Type::Uuid4);
16		row.set_valid(index, true);
17		unsafe {
18			// UUIDs are 16 bytes
19			ptr::write_unaligned(
20				row.make_mut().as_mut_ptr().add(field.offset) as *mut [u8; 16],
21				*value.as_bytes(),
22			);
23		}
24	}
25
26	pub fn get_uuid4(&self, row: &EncodedValues, index: usize) -> Uuid4 {
27		let field = &self.fields[index];
28		debug_assert!(row.len() >= self.total_static_size());
29		debug_assert_eq!(field.r#type, Type::Uuid4);
30		unsafe {
31			// UUIDs are 16 bytes
32			let bytes: [u8; 16] = ptr::read_unaligned(row.as_ptr().add(field.offset) as *const [u8; 16]);
33			Uuid4::from(Uuid::from_bytes(bytes))
34		}
35	}
36
37	pub fn try_get_uuid4(&self, row: &EncodedValues, index: usize) -> Option<Uuid4> {
38		if row.is_defined(index) {
39			Some(self.get_uuid4(row, index))
40		} else {
41			None
42		}
43	}
44}
45
46#[cfg(test)]
47mod tests {
48	use reifydb_type::{Type, Uuid4};
49
50	use crate::value::encoded::EncodedValuesLayout;
51
52	#[test]
53	fn test_set_get_uuid4() {
54		let layout = EncodedValuesLayout::new(&[Type::Uuid4]);
55		let mut row = layout.allocate();
56
57		let uuid = Uuid4::generate();
58		layout.set_uuid4(&mut row, 0, uuid.clone());
59		assert_eq!(layout.get_uuid4(&row, 0), uuid);
60	}
61
62	#[test]
63	fn test_try_get_uuid4() {
64		let layout = EncodedValuesLayout::new(&[Type::Uuid4]);
65		let mut row = layout.allocate();
66
67		assert_eq!(layout.try_get_uuid4(&row, 0), None);
68
69		let uuid = Uuid4::generate();
70		layout.set_uuid4(&mut row, 0, uuid.clone());
71		assert_eq!(layout.try_get_uuid4(&row, 0), Some(uuid));
72	}
73
74	#[test]
75	fn test_multiple_generations() {
76		let layout = EncodedValuesLayout::new(&[Type::Uuid4]);
77
78		// Generate multiple UUIDs and ensure they're different
79		let mut uuids = Vec::new();
80		for _ in 0..10 {
81			let mut row = layout.allocate();
82			let uuid = Uuid4::generate();
83			layout.set_uuid4(&mut row, 0, uuid.clone());
84			let retrieved = layout.get_uuid4(&row, 0);
85			assert_eq!(retrieved, uuid);
86			uuids.push(uuid);
87		}
88
89		// Ensure all generated UUIDs are unique
90		for i in 0..uuids.len() {
91			for j in (i + 1)..uuids.len() {
92				assert_ne!(uuids[i], uuids[j], "UUIDs should be unique");
93			}
94		}
95	}
96
97	#[test]
98	fn test_version_check() {
99		let layout = EncodedValuesLayout::new(&[Type::Uuid4]);
100		let mut row = layout.allocate();
101
102		let uuid = Uuid4::generate();
103		layout.set_uuid4(&mut row, 0, uuid.clone());
104		let retrieved = layout.get_uuid4(&row, 0);
105
106		// Verify it's a version 4 UUID
107		assert_eq!(retrieved.get_version_num(), 4);
108	}
109
110	#[test]
111	fn test_mixed_with_other_types() {
112		let layout = EncodedValuesLayout::new(&[Type::Uuid4, Type::Boolean, Type::Uuid4, Type::Int4]);
113		let mut row = layout.allocate();
114
115		let uuid1 = Uuid4::generate();
116		let uuid2 = Uuid4::generate();
117
118		layout.set_uuid4(&mut row, 0, uuid1.clone());
119		layout.set_bool(&mut row, 1, true);
120		layout.set_uuid4(&mut row, 2, uuid2.clone());
121		layout.set_i32(&mut row, 3, 42);
122
123		assert_eq!(layout.get_uuid4(&row, 0), uuid1);
124		assert_eq!(layout.get_bool(&row, 1), true);
125		assert_eq!(layout.get_uuid4(&row, 2), uuid2);
126		assert_eq!(layout.get_i32(&row, 3), 42);
127	}
128
129	#[test]
130	fn test_undefined_handling() {
131		let layout = EncodedValuesLayout::new(&[Type::Uuid4, Type::Uuid4]);
132		let mut row = layout.allocate();
133
134		let uuid = Uuid4::generate();
135		layout.set_uuid4(&mut row, 0, uuid.clone());
136
137		assert_eq!(layout.try_get_uuid4(&row, 0), Some(uuid));
138		assert_eq!(layout.try_get_uuid4(&row, 1), None);
139
140		layout.set_undefined(&mut row, 0);
141		assert_eq!(layout.try_get_uuid4(&row, 0), None);
142	}
143
144	#[test]
145	fn test_persistence() {
146		let layout = EncodedValuesLayout::new(&[Type::Uuid4]);
147		let mut row = layout.allocate();
148
149		let uuid = Uuid4::generate();
150		let uuid_string = uuid.to_string();
151
152		layout.set_uuid4(&mut row, 0, uuid.clone());
153		let retrieved = layout.get_uuid4(&row, 0);
154
155		assert_eq!(retrieved, uuid);
156		assert_eq!(retrieved.to_string(), uuid_string);
157		assert_eq!(retrieved.as_bytes(), uuid.as_bytes());
158	}
159
160	#[test]
161	fn test_clone_consistency() {
162		let layout = EncodedValuesLayout::new(&[Type::Uuid4]);
163		let mut row = layout.allocate();
164
165		let original_uuid = Uuid4::generate();
166		layout.set_uuid4(&mut row, 0, original_uuid.clone());
167
168		let retrieved_uuid = layout.get_uuid4(&row, 0);
169		assert_eq!(retrieved_uuid, original_uuid);
170
171		// Verify that the byte representation is identical
172		assert_eq!(retrieved_uuid.as_bytes(), original_uuid.as_bytes());
173	}
174
175	#[test]
176	fn test_multiple_fields() {
177		let layout = EncodedValuesLayout::new(&[Type::Uuid4, Type::Uuid4, Type::Uuid4]);
178		let mut row = layout.allocate();
179
180		let uuid1 = Uuid4::generate();
181		let uuid2 = Uuid4::generate();
182		let uuid3 = Uuid4::generate();
183
184		layout.set_uuid4(&mut row, 0, uuid1.clone());
185		layout.set_uuid4(&mut row, 1, uuid2.clone());
186		layout.set_uuid4(&mut row, 2, uuid3.clone());
187
188		assert_eq!(layout.get_uuid4(&row, 0), uuid1);
189		assert_eq!(layout.get_uuid4(&row, 1), uuid2);
190		assert_eq!(layout.get_uuid4(&row, 2), uuid3);
191
192		// Ensure all UUIDs are different
193		assert_ne!(uuid1, uuid2);
194		assert_ne!(uuid1, uuid3);
195		assert_ne!(uuid2, uuid3);
196	}
197
198	#[test]
199	fn test_format_consistency() {
200		let layout = EncodedValuesLayout::new(&[Type::Uuid4]);
201		let mut row = layout.allocate();
202
203		let uuid = Uuid4::generate();
204		let original_string = uuid.to_string();
205
206		layout.set_uuid4(&mut row, 0, uuid.clone());
207		let retrieved = layout.get_uuid4(&row, 0);
208		let retrieved_string = retrieved.to_string();
209
210		assert_eq!(original_string, retrieved_string);
211
212		// Verify UUID string format (8-4-4-4-12)
213		assert_eq!(original_string.len(), 36);
214		assert_eq!(original_string.matches('-').count(), 4);
215	}
216
217	#[test]
218	fn test_byte_level_storage() {
219		let layout = EncodedValuesLayout::new(&[Type::Uuid4]);
220		let mut row = layout.allocate();
221
222		let uuid = Uuid4::generate();
223		let original_bytes = *uuid.as_bytes();
224
225		layout.set_uuid4(&mut row, 0, uuid.clone());
226		let retrieved = layout.get_uuid4(&row, 0);
227		let retrieved_bytes = *retrieved.as_bytes();
228
229		assert_eq!(original_bytes, retrieved_bytes);
230
231		// Verify that it's exactly 16 bytes
232		assert_eq!(original_bytes.len(), 16);
233		assert_eq!(retrieved_bytes.len(), 16);
234	}
235}