use std::{error::Error, fmt};
use kafka_driver::{
ApiVersion, CoordinatorKeyError, RequestOptions, Route, RoutedCall, SubmitError, TrafficClass,
};
use kafka_wire::{HeartbeatRequest, HeartbeatResponse};
use crate::{
clock::OperationDeadline,
protocol::consumer::{
CLASSIC_HEARTBEAT_MAX_VERSION, CLASSIC_HEARTBEAT_MIN_VERSION,
CLASSIC_STATIC_HEARTBEAT_VERSION,
},
};
use super::{super::DriverOwner, group_coordinator_route::group_coordinator_route};
pub(super) const HEARTBEAT_MIN_VERSION: ApiVersion = ApiVersion::new(CLASSIC_HEARTBEAT_MIN_VERSION);
pub(super) const HEARTBEAT_MAX_VERSION: ApiVersion = ApiVersion::new(CLASSIC_HEARTBEAT_MAX_VERSION);
pub(super) const STATIC_HEARTBEAT_VERSION: ApiVersion =
ApiVersion::new(CLASSIC_STATIC_HEARTBEAT_VERSION);
#[derive(Debug)]
pub(crate) enum ClassicHeartbeatSubmitError {
GroupMismatch,
InvalidGroup(CoordinatorKeyError),
Driver(SubmitError),
}
impl fmt::Display for ClassicHeartbeatSubmitError {
fn fmt(&self, formatter: &mut fmt::Formatter<'_>) -> fmt::Result {
match self {
Self::GroupMismatch => {
write!(formatter, "Heartbeat route and request groups differ")
}
Self::InvalidGroup(source) => {
write!(formatter, "invalid Heartbeat coordinator key: {source}")
}
Self::Driver(source) => write!(formatter, "driver rejected Heartbeat: {source}"),
}
}
}
impl Error for ClassicHeartbeatSubmitError {
fn source(&self) -> Option<&(dyn Error + 'static)> {
match self {
Self::GroupMismatch => None,
Self::InvalidGroup(source) => Some(source),
Self::Driver(source) => Some(source),
}
}
}
impl DriverOwner {
pub(crate) fn submit_tracked_classic_heartbeat(
&self,
group: &str,
request: HeartbeatRequest,
deadline: OperationDeadline,
) -> Result<RoutedCall<HeartbeatResponse>, ClassicHeartbeatSubmitError> {
let route = classic_heartbeat_route(group, &request)?;
let static_membership = request.group_instance_id.is_some();
self.driver
.request_tracked_with(
route,
request,
classic_heartbeat_options(deadline, static_membership),
)
.map_err(ClassicHeartbeatSubmitError::Driver)
}
}
pub(super) fn classic_heartbeat_route(
group: &str,
request: &HeartbeatRequest,
) -> Result<Route, ClassicHeartbeatSubmitError> {
if request.group_id.as_str() != group {
return Err(ClassicHeartbeatSubmitError::GroupMismatch);
}
group_coordinator_route(group).map_err(ClassicHeartbeatSubmitError::InvalidGroup)
}
pub(super) const fn classic_heartbeat_options(
deadline: OperationDeadline,
static_membership: bool,
) -> RequestOptions {
let options =
RequestOptions::new(deadline.transport()).with_traffic_class(TrafficClass::Control);
if static_membership {
options
.with_minimum_version(STATIC_HEARTBEAT_VERSION)
.with_maximum_version(STATIC_HEARTBEAT_VERSION)
} else {
options
.with_minimum_version(HEARTBEAT_MIN_VERSION)
.with_maximum_version(HEARTBEAT_MAX_VERSION)
}
}