Struct QuotaViolationError 

pub struct QuotaViolationError { /* private fields */ }

Raised when a sensor records a value that takes a metric outside the bounds configured as its quota.

Corresponds to Java’s QuotaViolationException. It has no entry in Errors, so it carries no protocol code.

Java extends chain: QuotaViolationException -> KafkaException

Hand-written rather than declared with kafka_error_type! because it adds subclass state (the metric, the recorded value and the bound) and overrides toString() instead of taking the generated "<TypeName>: <message>" form.

Two deliberate deviations from the Java class:

• Java holds the KafkaMetric itself and exposes it as metric(). This holds the metric’s MetricName, because KafkaMetric owns a Box<dyn Measurable> and so is neither Clone nor Debug — both of which Error requires. Nothing is lost for a client: Java’s own toString() uses only metric.metricName(), and the client has no caller of metric() (the broker’s ClientQuotaManager is the only one in the Kafka tree).
• Java overrides fillInStackTrace() to skip capturing a stack trace, since quota violations are frequent and the trace is never read. Rust errors do not capture one at all, so there is nothing to suppress.

Implementations

impl QuotaViolationError

pub fn new(metric_name: MetricName, value: f64, bound: f64) -> Self

Create the error, mirroring Java’s QuotaViolationException(KafkaMetric metric, double value, double bound).

pub fn metric_name(&self) -> &MetricName

The name of the metric that violated its quota.

Stands in for Java’s metric() — see the type-level note.

pub fn value(&self) -> f64

The value that was recorded. Mirrors Java’s value().

pub fn bound(&self) -> f64

The quota bound that was crossed. Mirrors Java’s bound().

pub fn source(&self) -> Option<&Error>

The underlying cause, if any. Mirrors Java’s getCause().

Trait Implementations

impl Clone for QuotaViolationError

fn clone(&self) -> QuotaViolationError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for QuotaViolationError

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

Formats the value using the given formatter.

impl Display for QuotaViolationError

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

Java’s toString() override: getClass().getName() + ": '" + metric.metricName() + "' violated quota. Actual: " + value + ", Threshold: " + bound.

impl Error for QuotaViolationError

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0: use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0: replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.