confluent_kafka/admin/
list_transactions_result.rs1use std::collections::HashMap;
18
19use crate::admin::TransactionListing;
20use crate::common::KafkaFuture;
21use crate::common::internals::KafkaFutureImpl;
22
23type BrokerFutures = HashMap<i32, KafkaFuture<Vec<TransactionListing>>>;
26
27#[derive(Clone, Debug)]
32#[doc(alias = "org.apache.kafka.clients.admin.ListTransactionsResult")]
33pub struct ListTransactionsResult {
34 future: KafkaFuture<BrokerFutures>,
35}
36
37impl ListTransactionsResult {
38 #[doc(alias = "org.apache.kafka.clients.admin.ListTransactionsResult#ListTransactionsResult")]
40 pub(crate) fn new(future: KafkaFuture<BrokerFutures>) -> Self {
41 Self { future }
42 }
43
44 #[doc(alias = "org.apache.kafka.clients.admin.ListTransactionsResult#all")]
52 pub fn all(&self) -> KafkaFuture<Vec<TransactionListing>> {
53 self.all_by_broker_id()
54 .then_apply(|map: HashMap<i32, Vec<TransactionListing>>| {
55 Ok(map.into_values().flatten().collect::<Vec<TransactionListing>>())
56 })
57 }
58
59 #[doc(alias = "org.apache.kafka.clients.admin.ListTransactionsResult#byBrokerId")]
69 pub fn by_broker_id(&self) -> KafkaFuture<BrokerFutures> {
70 self.future.clone()
71 }
72
73 #[doc(alias = "org.apache.kafka.clients.admin.ListTransactionsResult#allByBrokerId")]
82 pub fn all_by_broker_id(&self) -> KafkaFuture<HashMap<i32, Vec<TransactionListing>>> {
83 let all = KafkaFutureImpl::new();
84 let completer = all.clone();
85 self.future.on_complete(move |broker_futures| match broker_futures {
86 Err(error) => _ = completer.complete_with_error(error.clone()),
87 Ok(broker_futures) => {
88 let listings = KafkaFuture::join_map(broker_futures.clone().into_iter().collect());
89 listings.on_complete(move |listings| match listings {
90 Ok(listings) => _ = completer.complete(listings.clone()),
91 Err(error) => _ = completer.complete_with_error(error.clone()),
92 });
93 },
94 });
95 all.future()
96 }
97}
98
99#[cfg(test)]
100mod tests {
101 use super::*;
102 use crate::admin::TransactionState;
103 use crate::common::Error;
104 use crate::common::internals::KafkaFutureImpl;
105 use std::collections::HashSet;
106
107 fn listing(id: &str, producer_id: i64, state: TransactionState) -> TransactionListing {
108 TransactionListing::new(id, producer_id, state)
109 }
110
111 #[tokio::test]
113 async fn all_futures_fail_if_lookup_fails() {
114 let top: KafkaFutureImpl<BrokerFutures> = KafkaFutureImpl::new();
115 let result = ListTransactionsResult::new(top.future());
116 top.complete_with_error(Error::new(crate::common::protocol::Errors::UnknownServerError));
117 assert!(result.all().get().await.is_err());
118 assert!(result.all_by_broker_id().get().await.is_err());
119 assert!(result.by_broker_id().get().await.is_err());
120 }
121
122 #[tokio::test]
124 async fn all_futures_succeed() {
125 let top: KafkaFutureImpl<BrokerFutures> = KafkaFutureImpl::new();
126 let result = ListTransactionsResult::new(top.future());
127
128 let f1: KafkaFutureImpl<Vec<TransactionListing>> = KafkaFutureImpl::new();
129 let f2: KafkaFutureImpl<Vec<TransactionListing>> = KafkaFutureImpl::new();
130 top.complete(HashMap::from([(1, f1.future()), (2, f2.future())]));
131
132 let broker1 = vec![
133 listing("foo", 12345, TransactionState::Ongoing),
134 listing("bar", 98765, TransactionState::PrepareAbort),
135 ];
136 f1.complete(broker1.clone());
137 let broker2 = vec![listing("baz", 13579, TransactionState::CompleteCommit)];
138 f2.complete(broker2.clone());
139
140 let by_broker = result.by_broker_id().get().await.unwrap();
141 assert_eq!(by_broker.keys().copied().collect::<HashSet<_>>(), HashSet::from([1, 2]));
142 assert_eq!(by_broker[&1].get().await.unwrap(), broker1);
143 assert_eq!(by_broker[&2].get().await.unwrap(), broker2);
144
145 let all_by_broker = result.all_by_broker_id().get().await.unwrap();
146 assert_eq!(all_by_broker[&1], broker1);
147 assert_eq!(all_by_broker[&2], broker2);
148
149 let mut all_expected: HashSet<TransactionListing> = HashSet::new();
150 all_expected.extend(broker1);
151 all_expected.extend(broker2);
152 assert_eq!(
153 result.all().get().await.unwrap().into_iter().collect::<HashSet<_>>(),
154 all_expected
155 );
156 }
157
158 #[tokio::test]
160 async fn partial_failure() {
161 let top: KafkaFutureImpl<BrokerFutures> = KafkaFutureImpl::new();
162 let result = ListTransactionsResult::new(top.future());
163
164 let f1: KafkaFutureImpl<Vec<TransactionListing>> = KafkaFutureImpl::new();
165 let f2: KafkaFutureImpl<Vec<TransactionListing>> = KafkaFutureImpl::new();
166 top.complete(HashMap::from([(1, f1.future()), (2, f2.future())]));
167
168 let broker1 = vec![listing("foo", 12345, TransactionState::Ongoing)];
169 f1.complete(broker1.clone());
170 f2.complete_with_error(Error::new(crate::common::protocol::Errors::UnknownServerError));
171
172 let by_broker = result.by_broker_id().get().await.unwrap();
173 assert_eq!(by_broker.keys().copied().collect::<HashSet<_>>(), HashSet::from([1, 2]));
174 assert_eq!(by_broker[&1].get().await.unwrap(), broker1);
175
176 assert!(result.all().get().await.is_err());
177 assert!(result.all_by_broker_id().get().await.is_err());
178 assert!(by_broker[&2].get().await.is_err());
179 }
180}