Skip to main content

kafka_client_engine/transaction/initialization/
capture.rs

1//! Linear public-boundary deadline capture for transaction initialization.
2
3use std::sync::Arc;
4
5use crate::clock::DeadlineCapture;
6
7use super::{
8    TransactionInitializationAccepted, TransactionInitializationAdmissionError,
9    TransactionInitializationRequest, shard::TransactionInitializationShardState,
10};
11
12/// One absolute initialization deadline captured before request conversion.
13#[must_use = "consume the capture to initialize one transactional owner"]
14pub struct TransactionInitializationCapture {
15    shared: Arc<TransactionInitializationShardState>,
16    deadline: DeadlineCapture,
17    lifetime: Arc<dyn Send + Sync>,
18}
19
20impl TransactionInitializationCapture {
21    pub(super) const fn new(
22        shared: Arc<TransactionInitializationShardState>,
23        deadline: DeadlineCapture,
24        lifetime: Arc<dyn Send + Sync>,
25    ) -> Self {
26        Self {
27            shared,
28            deadline,
29            lifetime,
30        }
31    }
32
33    /// Consumes this exact deadline while attempting bounded initialization.
34    pub fn initialize_transactional_owner(
35        self,
36        request: TransactionInitializationRequest,
37    ) -> Result<TransactionInitializationAccepted, TransactionInitializationAdmissionError> {
38        super::port::try_initialize_captured(&self.shared, self.deadline, request, self.lifetime)
39    }
40}
41
42impl std::fmt::Debug for TransactionInitializationCapture {
43    fn fmt(&self, formatter: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
44        formatter
45            .debug_struct("TransactionInitializationCapture")
46            .finish_non_exhaustive()
47    }
48}