Skip to main content

uqa_execution/row_locks/
identity.rs

1//
2// Unified Query Algebra
3//
4// Copyright (c) 2023-2026 Cognica, Inc.
5//
6
7//! Stable in-process and cross-process lock identities.
8
9use super::{Arc, DocId};
10
11#[derive(Clone, Debug, PartialEq, Eq, Hash)]
12pub(super) enum ManagerIdentity {
13    Durable(uqa_storage::PersistentStorageIdentity),
14    Provider(usize),
15}
16
17#[derive(Clone, Debug, PartialEq, Eq, Hash)]
18pub(super) enum LockRelationIdentity {
19    Table(Arc<str>),
20    Index([u8; 16]),
21    DocumentIdentityReservations(Arc<str>),
22    BackendWriter,
23    KeyReservation([u8; 32]),
24    ScoringParameters(Arc<str>),
25    SharedObject {
26        class_id: u32,
27        oid: u32,
28    },
29    SharedObjectName {
30        class_id: u32,
31        name: Arc<str>,
32    },
33    SharedMemberName {
34        class_id: u32,
35        owner_class_id: u32,
36        owner_object_id: [u8; 16],
37        name: Arc<str>,
38    },
39    SharedObjectTuple {
40        class_id: u32,
41        oid: u32,
42    },
43}
44
45impl LockRelationIdentity {
46    pub(super) fn stable_bytes(&self) -> Vec<u8> {
47        match self {
48            Self::Table(name) => name.as_bytes().to_vec(),
49            Self::Index(identity) => {
50                let mut bytes = b"\xffindex".to_vec();
51                bytes.extend_from_slice(identity);
52                bytes
53            }
54            Self::DocumentIdentityReservations(name) => {
55                let mut bytes = Vec::with_capacity(1 + "document-identities".len() + name.len());
56                bytes.extend_from_slice(b"\xffdocument-identities");
57                bytes.extend_from_slice(name.as_bytes());
58                bytes
59            }
60            Self::BackendWriter => b"\xffbackend-writer".to_vec(),
61            Self::ScoringParameters(name) => {
62                let mut bytes = b"\xffscoring-parameters".to_vec();
63                bytes.extend_from_slice(name.as_bytes());
64                bytes
65            }
66            Self::KeyReservation(digest) => {
67                let mut bytes = Vec::with_capacity(1 + "key-reservation".len() + digest.len());
68                bytes.extend_from_slice(b"\xffkey-reservation");
69                bytes.extend_from_slice(digest);
70                bytes
71            }
72            Self::SharedObject { class_id, oid } => {
73                let mut bytes = b"\xffshared-object".to_vec();
74                bytes.extend_from_slice(&class_id.to_be_bytes());
75                bytes.extend_from_slice(&oid.to_be_bytes());
76                bytes
77            }
78            Self::SharedObjectName { class_id, name } => {
79                let mut bytes = b"\xffshared-object-name".to_vec();
80                bytes.extend_from_slice(&class_id.to_be_bytes());
81                bytes.extend_from_slice(name.as_bytes());
82                bytes
83            }
84            Self::SharedObjectTuple { class_id, oid } => {
85                let mut bytes = b"\xffshared-object-tuple".to_vec();
86                bytes.extend_from_slice(&class_id.to_be_bytes());
87                bytes.extend_from_slice(&oid.to_be_bytes());
88                bytes
89            }
90            Self::SharedMemberName {
91                class_id,
92                owner_class_id,
93                owner_object_id,
94                name,
95            } => {
96                let mut bytes = b"\xffshared-member-name".to_vec();
97                bytes.extend_from_slice(&class_id.to_be_bytes());
98                bytes.extend_from_slice(&owner_class_id.to_be_bytes());
99                bytes.extend_from_slice(owner_object_id);
100                bytes.extend_from_slice(name.as_bytes());
101                bytes
102            }
103        }
104    }
105}
106
107#[derive(Clone, Copy, Debug, PartialEq, Eq, Hash, PartialOrd, Ord)]
108pub struct RowLockKey {
109    pub table: u64,
110    pub doc_id: DocId,
111}