use std::{error::Error, fmt, time::Instant};
use kafka_driver::{
ApiVersion, PartitionId, PartitionIdError, RequestOptions, Route, RoutedCall, SubmitError,
TopicName, TopicNameError, TrafficClass,
};
use kafka_wire::{FetchRequest, FetchResponse};
use crate::{driver::DriverOwner, protocol::fetch::FETCH_NAME_ROUTE_MAX_VERSION};
use super::route::BrokerId;
#[derive(Debug)]
pub(crate) enum FetchSubmitError {
InvalidTopic(TopicNameError),
InvalidPartition(PartitionIdError),
ExactBrokerRoutingUnavailable,
Driver(SubmitError),
}
impl fmt::Display for FetchSubmitError {
fn fmt(&self, formatter: &mut fmt::Formatter<'_>) -> fmt::Result {
match self {
Self::InvalidTopic(source) => write!(formatter, "invalid Fetch topic: {source}"),
Self::InvalidPartition(source) => {
write!(formatter, "invalid Fetch partition: {source}")
}
Self::ExactBrokerRoutingUnavailable => {
formatter.write_str("exact-broker Fetch routing is unavailable")
}
Self::Driver(source) => write!(formatter, "driver rejected Fetch: {source}"),
}
}
}
impl Error for FetchSubmitError {
fn source(&self) -> Option<&(dyn Error + 'static)> {
match self {
Self::InvalidTopic(source) => Some(source),
Self::InvalidPartition(source) => Some(source),
Self::ExactBrokerRoutingUnavailable => None,
Self::Driver(source) => Some(source),
}
}
}
impl DriverOwner {
pub(crate) fn submit_tracked_fetch(
&self,
topic: &str,
partition: i32,
request: FetchRequest,
deadline: Instant,
) -> Result<RoutedCall<FetchResponse>, FetchSubmitError> {
let topic = TopicName::new(topic.to_owned()).map_err(FetchSubmitError::InvalidTopic)?;
let partition = PartitionId::new(partition).map_err(FetchSubmitError::InvalidPartition)?;
let options = fetch_options_for_request(deadline, &request);
self.driver
.request_tracked_with(
Route::PartitionLeader { topic, partition },
request,
options,
)
.map_err(FetchSubmitError::Driver)
}
#[allow(
clippy::unused_self,
reason = "the driver capability boundary deliberately fails closed until exact-broker routing exists"
)]
pub(crate) fn submit_tracked_broker_fetch(
&self,
broker_id: BrokerId,
_request: FetchRequest,
_deadline: Instant,
) -> Result<RoutedCall<FetchResponse>, FetchSubmitError> {
let _requested_broker_id = broker_id.get();
Err(FetchSubmitError::ExactBrokerRoutingUnavailable)
}
}
pub(super) const fn fetch_options(deadline: Instant) -> RequestOptions {
RequestOptions::new(deadline)
.with_traffic_class(TrafficClass::LongPoll)
.with_maximum_version(ApiVersion::new(FETCH_NAME_ROUTE_MAX_VERSION))
}
pub(super) const fn fetch_options_for_request(
deadline: Instant,
request: &FetchRequest,
) -> RequestOptions {
let options = fetch_options(deadline);
if request.session_id > 0 {
options.with_minimum_version(ApiVersion::new(7))
} else {
options
}
}