Struct kafka_protocol::messages::fetch_request::FetchRequest

#[non_exhaustive]
pub struct FetchRequest {

    pub cluster_id: Option<StrBytes>,
    pub replica_id: BrokerId,
    pub replica_state: ReplicaState,
    pub max_wait_ms: i32,
    pub min_bytes: i32,
    pub max_bytes: i32,
    pub isolation_level: i8,
    pub session_id: i32,
    pub session_epoch: i32,
    pub topics: Vec<FetchTopic>,
    pub forgotten_topics_data: Vec<ForgottenTopic>,
    pub rack_id: StrBytes,
    pub unknown_tagged_fields: BTreeMap<i32, Bytes>,
}

Valid versions: 0-16

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

cluster_id: Option<StrBytes>

The clusterId if known. This is used to validate metadata fetches prior to broker registration.

Supported API versions: 12-16

replica_id: BrokerId

The broker ID of the follower, of -1 if this request is from a consumer.

Supported API versions: 0-14

replica_state: ReplicaState

Supported API versions: 15-16

max_wait_ms: i32

The maximum time in milliseconds to wait for the response.

Supported API versions: 0-16

min_bytes: i32

The minimum bytes to accumulate in the response.

Supported API versions: 0-16

max_bytes: i32

The maximum bytes to fetch. See KIP-74 for cases where this limit may not be honored.

Supported API versions: 3-16

isolation_level: i8

This setting controls the visibility of transactional records. Using READ_UNCOMMITTED (isolation_level = 0) makes all records visible. With READ_COMMITTED (isolation_level = 1), non-transactional and COMMITTED transactional records are visible. To be more concrete, READ_COMMITTED returns all data from offsets smaller than the current LSO (last stable offset), and enables the inclusion of the list of aborted transactions in the result, which allows consumers to discard ABORTED transactional records

Supported API versions: 4-16

session_id: i32

The fetch session ID.

Supported API versions: 7-16

session_epoch: i32

The fetch session epoch, which is used for ordering requests in a session.

Supported API versions: 7-16

topics: Vec<FetchTopic>

The topics to fetch.

Supported API versions: 0-16

forgotten_topics_data: Vec<ForgottenTopic>

In an incremental fetch request, the partitions to remove.

Supported API versions: 7-16

rack_id: StrBytes

Rack ID of the consumer making this request

Supported API versions: 11-16

unknown_tagged_fields: BTreeMap<i32, Bytes>

Other tagged fields

Trait Implementations

impl Builder for FetchRequest

type Builder = FetchRequestBuilder

The derive_builder::Builder type for this protocol item.

fn builder() -> Self::Builder

Retrieve the builder for this protocol item.

impl Clone for FetchRequest

fn clone(&self) -> FetchRequest

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for FetchRequest

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Decodable for FetchRequest

fn decode<B: ByteBuf>(buf: &mut B, version: i16) -> Result<Self, DecodeError>

Decode the message from the provided buffer and version.

impl Default for FetchRequest

fn default() -> Self

Returns the “default value” for a type.

impl Encodable for FetchRequest

fn encode<B: ByteBufMut>( &self, buf: &mut B, version: i16 ) -> Result<(), EncodeError>

Encode the message into the target buffer.

fn compute_size(&self, version: i16) -> Result<usize, EncodeError>

Compute the total size of the message when encoded.

impl HeaderVersion for FetchRequest

fn header_version(version: i16) -> i16

Maps a header version to a given version for a particular API message.

impl Message for FetchRequest

const VERSIONS: VersionRange = _

The valid versions for this message.

const DEPRECATED_VERSIONS: Option<VersionRange> = _

The deprecated versions for this message.

impl PartialEq for FetchRequest

fn eq(&self, other: &FetchRequest) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Request for FetchRequest

const KEY: i16 = 1i16

The API key of this request.

type Response = FetchResponse

The response associated with this request.

impl StructuralPartialEq for FetchRequest