use kafka_client_core::DeliveryStatus;
use kafka_driver::{ApiVersion, CallFailure, RequestError, RouteFailureToken, RouteKind};
use kafka_wire::InitProducerIdResponse;
use super::super::request_failure_delivery;
#[derive(Clone, Copy, Debug, Eq, PartialEq)]
pub(crate) enum TransactionInitDriverFailureKind {
DeadlineElapsed,
Compatibility,
InvalidResponse,
Transport,
}
#[derive(Clone, Copy)]
pub(crate) enum TransactionInitTerminalFact<'a> {
Response {
selected_version: Option<i16>,
response: &'a InitProducerIdResponse,
},
Failed {
kind: TransactionInitDriverFailureKind,
delivery: DeliveryStatus,
},
}
#[must_use = "transaction coordinator route evidence must survive core settlement"]
pub(crate) struct TransactionInitTerminal {
result: Result<InitProducerIdResponse, RequestError>,
selected_version: Option<i16>,
route_token: Option<RouteFailureToken>,
coordinator_refresh_completed: bool,
}
impl TransactionInitTerminal {
pub(crate) fn fact(&self) -> TransactionInitTerminalFact<'_> {
match &self.result {
Ok(response) => TransactionInitTerminalFact::Response {
selected_version: self.selected_version,
response,
},
Err(error) => TransactionInitTerminalFact::Failed {
kind: failure_kind(error),
delivery: request_failure_delivery(error),
},
}
}
pub(super) fn take_transaction_coordinator_refresh_token(
&mut self,
) -> Option<RouteFailureToken> {
let route_kind = self.route_token.as_ref().map(RouteFailureToken::kind);
if needs_transaction_coordinator_refresh(&self.fact(), route_kind) {
self.route_token.take()
} else {
None
}
}
pub(super) fn mark_coordinator_refresh_completed(&mut self) {
self.coordinator_refresh_completed = true;
}
pub(crate) fn retry_safe_after_refresh(&self) -> bool {
self.coordinator_refresh_completed
&& matches!(
self.fact(),
TransactionInitTerminalFact::Response { response, .. }
if matches!(response.error_code, 14..=16)
)
}
pub(crate) fn discard(self) {
drop(self.route_token);
}
}
pub(super) fn needs_transaction_coordinator_refresh(
fact: &TransactionInitTerminalFact<'_>,
route_kind: Option<RouteKind>,
) -> bool {
let stale_broker = matches!(
fact,
TransactionInitTerminalFact::Response { response, .. }
if matches!(response.error_code, 14..=16)
);
route_kind == Some(RouteKind::Coordinator)
&& (stale_broker
|| matches!(
fact,
TransactionInitTerminalFact::Failed {
kind: TransactionInitDriverFailureKind::Transport
| TransactionInitDriverFailureKind::DeadlineElapsed,
..
}
))
}
pub(super) fn retain_transaction_init_terminal(
selected_version: Option<ApiVersion>,
result: Result<InitProducerIdResponse, RequestError>,
route_token: Option<RouteFailureToken>,
) -> TransactionInitTerminal {
TransactionInitTerminal {
result,
selected_version: selected_version.map(ApiVersion::value),
route_token,
coordinator_refresh_completed: false,
}
}
fn failure_kind(error: &RequestError) -> TransactionInitDriverFailureKind {
match error {
RequestError::Rejected {
failure: CallFailure::DeadlineExceeded,
..
} => TransactionInitDriverFailureKind::DeadlineElapsed,
RequestError::Rejected {
failure: CallFailure::CorrelationMismatch { .. },
..
}
| RequestError::Decode(_) => TransactionInitDriverFailureKind::InvalidResponse,
RequestError::Encode(_)
| RequestError::UnsupportedVersion { .. }
| RequestError::ApiUnavailable { .. }
| RequestError::VersionLimitUnavailable { .. }
| RequestError::VersionFloorUnavailable { .. }
| RequestError::VersionBoundsInvalid { .. } => {
TransactionInitDriverFailureKind::Compatibility
}
_ => TransactionInitDriverFailureKind::Transport,
}
}