Index (BabelQueue Core 1.4.0 API)

A B C D E F G H I J L M O P Q R S T U V W
All Classes and Interfaces|All Packages|Constant Field Values|Serialized Form

A

accepts(Envelope) - Static method in class com.babelqueue.EnvelopeCodec: Whether a consumer should accept this envelope: rejects a missing URN, an unsupported meta.schema_version, missing data or a blank trace_id — the consumer-side counterpart to the producer JSON Schema.
ack(Redrive.Reserved) - Method in interface com.babelqueue.Redrive.Transport: Acknowledge (remove) a previously reserved message.
all() - Static method in record class com.babelqueue.Redrive.Options: Redrive every message back to its source queue.
annotate(Envelope, String, String) - Static method in class com.babelqueue.DeadLetters: Annotate using the envelope's current attempts and no error detail.
annotate(Envelope, String, String, int, String, String) - Static method in class com.babelqueue.DeadLetters: Return a copy of the envelope with a DeadLetter block attached, recording why and where it failed.
attempts() - Method in record class com.babelqueue.DeadLetter: Returns the value of the attempts record component.
attempts() - Method in record class com.babelqueue.Envelope: Returns the value of the attempts record component.

B

BabelQueueException - Exception in com.babelqueue: Base unchecked exception for all BabelQueue failures.
BabelQueueException(String) - Constructor for exception com.babelqueue.BabelQueueException
BabelQueueException(String, Throwable) - Constructor for exception com.babelqueue.BabelQueueException
body() - Method in record class com.babelqueue.Redrive.Reserved: Returns the value of the body record component.
bypass() - Method in record class com.babelqueue.Redrive.Options: Returns the value of the bypass record component.
bypass(boolean) - Method in record class com.babelqueue.Redrive.Options
bypassed() - Method in record class com.babelqueue.Redrive.Item: Returns the value of the bypassed record component.
bypassExternalEffects(Replay.Effect) - Static method in class com.babelqueue.Replay: Runs effect unless the current message is a replay, in which case it is skipped.

C

check(SchemaProvider, String, Map<String, Object>) - Static method in class com.babelqueue.schema.SchemaValidation: The first data violation for (urn, data), or null when it is valid or when no schema is registered for the URN (opt-in).
com.babelqueue - package com.babelqueue: BabelQueue — Polyglot Queues, Simplified.
com.babelqueue.idempotency - package com.babelqueue.idempotency: Optional idempotency helper (ADR-0022): dedupe a consume handler on meta.id.
com.babelqueue.otel - package com.babelqueue.otel: Optional OpenTelemetry tracing for babelqueue (ADR-0025) — the Java mirror of the Go babelqueue-go/otel module.
com.babelqueue.schema - package com.babelqueue.schema: Optional per-URN data schema validation (ADR-0024): a dependency-free subset Draft-07 validator (PayloadValidator), a SchemaProvider (with the in-memory MapProvider), and the SchemaValidation producer/consumer helpers.
createdAt() - Method in record class com.babelqueue.Meta: Returns the value of the createdAt record component.

D

data() - Method in record class com.babelqueue.Envelope: Returns the value of the data record component.
DEAD_LETTER - Static variable in class com.babelqueue.UnknownUrnStrategy: Route to the dead-letter queue.
deadLetter() - Method in record class com.babelqueue.Envelope: Returns the value of the deadLetter record component.
DeadLetter - Record Class in com.babelqueue: The additive block appended to an Envelope when a message is dead-lettered.
DeadLetter(String, String, String, long, String, int, String) - Constructor for record class com.babelqueue.DeadLetter: Creates an instance of a DeadLetter record class.
DeadLetters - Class in com.babelqueue: Builds the additive dead_letter block for an Envelope.
decode(String) - Static method in class com.babelqueue.EnvelopeCodec: Parse a raw JSON body into an Envelope.
DELETE - Static variable in class com.babelqueue.UnknownUrnStrategy: Drop the message.
dryRun() - Method in record class com.babelqueue.Redrive.Options: Returns the value of the dryRun record component.
dryRun(boolean) - Method in record class com.babelqueue.Redrive.Options

E

encode(Envelope) - Static method in class com.babelqueue.EnvelopeCodec: Encode the envelope as compact UTF-8 JSON.
Envelope - Record Class in com.babelqueue: The canonical BabelQueue wire message: a strict, language-neutral JSON shape ({job, trace_id, data, meta, attempts}) that every SDK produces and consumes identically — no language-specific serialization on the wire.
Envelope(String, String, Map<String, Object>, Meta, int, DeadLetter) - Constructor for record class com.babelqueue.Envelope: Creates an instance of a Envelope record class.
EnvelopeCodec - Class in com.babelqueue: Builds, encodes and decodes the canonical BabelQueue envelope — the single Java implementation of the wire format.
equals(Object) - Method in record class com.babelqueue.DeadLetter: Indicates whether some other object is "equal to" this one.
equals(Object) - Method in record class com.babelqueue.Envelope: Indicates whether some other object is "equal to" this one.
equals(Object) - Method in record class com.babelqueue.Meta: Indicates whether some other object is "equal to" this one.
equals(Object) - Method in record class com.babelqueue.Redrive.Item: Indicates whether some other object is "equal to" this one.
equals(Object) - Method in record class com.babelqueue.Redrive.Options: Indicates whether some other object is "equal to" this one.
equals(Object) - Method in record class com.babelqueue.Redrive.Reserved: Indicates whether some other object is "equal to" this one.
equals(Object) - Method in record class com.babelqueue.Redrive.Result: Indicates whether some other object is "equal to" this one.
error() - Method in record class com.babelqueue.DeadLetter: Returns the value of the error record component.
exception() - Method in record class com.babelqueue.DeadLetter: Returns the value of the exception record component.

F

FAIL - Static variable in class com.babelqueue.UnknownUrnStrategy: Surface an error; let the worker decide.
failedAt() - Method in record class com.babelqueue.DeadLetter: Returns the value of the failedAt record component.
forget(String) - Method in class com.babelqueue.idempotency.InMemoryStore
forget(String) - Method in interface com.babelqueue.idempotency.Store: Drops an id from the store (manual eviction; a backend may also expire ids).
from() - Method in record class com.babelqueue.Redrive.Item: Returns the value of the from record component.
fromMessage(PolyglotMessage) - Static method in class com.babelqueue.EnvelopeCodec: Build the envelope from a PolyglotMessage on the default queue.
fromMessage(PolyglotMessage, String) - Static method in class com.babelqueue.EnvelopeCodec: Build the envelope from a PolyglotMessage.

G

getBabelTraceId() - Method in interface com.babelqueue.HasTraceId: The trace id to reuse, or null to mint a new one.
getBabelUrn() - Method in interface com.babelqueue.PolyglotMessage: The stable URN that identifies this message across languages.

H

handle() - Method in record class com.babelqueue.Redrive.Reserved: Returns the value of the handle record component.
handle(Envelope) - Method in interface com.babelqueue.idempotency.Handler: Handles one message.
Handler - Interface in com.babelqueue.idempotency: A consume handler: processes one decoded Envelope.
hashCode() - Method in record class com.babelqueue.DeadLetter: Returns a hash code value for this object.
hashCode() - Method in record class com.babelqueue.Envelope: Returns a hash code value for this object.
hashCode() - Method in record class com.babelqueue.Meta: Returns a hash code value for this object.
hashCode() - Method in record class com.babelqueue.Redrive.Item: Returns a hash code value for this object.
hashCode() - Method in record class com.babelqueue.Redrive.Options: Returns a hash code value for this object.
hashCode() - Method in record class com.babelqueue.Redrive.Reserved: Returns a hash code value for this object.
hashCode() - Method in record class com.babelqueue.Redrive.Result: Returns a hash code value for this object.
HasTraceId - Interface in com.babelqueue: Optionally implemented alongside PolyglotMessage to continue an existing distributed trace instead of minting a fresh one.
HEADER_REPLAY_BYPASS - Static variable in class com.babelqueue.Replay: The out-of-band transport header Redrive stamps (with bypass) on a replayed message, and that a consume adapter surfaces to the handler via Replay.process(java.util.Map<java.lang.String, java.lang.String>, com.babelqueue.Replay.Effect).
headers() - Method in record class com.babelqueue.Redrive.Reserved: Returns the value of the headers record component.

I

id() - Method in record class com.babelqueue.Meta: Returns the value of the id record component.
Idempotent - Class in com.babelqueue.idempotency: Wraps a Handler so a message whose meta.id was already processed successfully is skipped instead of run again (ADR-0022) — the Java mirror of the PHP Idempotent::wrap, Go idempotency.Wrap, Python wrap, and Node Wrap helpers.
InMemoryStore - Class in com.babelqueue.idempotency: Process-local, thread-safe Store backed by a concurrent set.
InMemoryStore() - Constructor for class com.babelqueue.idempotency.InMemoryStore
InvalidPayloadException - Exception in com.babelqueue.schema: Raised when a message's data does not match the JSON Schema registered for its URN (ADR-0024).
InvalidPayloadException(String, String) - Constructor for exception com.babelqueue.schema.InvalidPayloadException
isReplay() - Static method in class com.babelqueue.Replay: Reports whether the message currently being handled was redriven with the replay-bypass marker — i.e.
Item(String, String, String, String, String, String, boolean, boolean) - Constructor for record class com.babelqueue.Redrive.Item: Creates an instance of a Item record class.
items() - Method in record class com.babelqueue.Redrive.Result: Returns the value of the items record component.

J

job() - Method in record class com.babelqueue.Envelope: Returns the value of the job record component.

L

lang() - Method in record class com.babelqueue.DeadLetter: Returns the value of the lang record component.
lang() - Method in record class com.babelqueue.Meta: Returns the value of the lang record component.

M

make(String, Map<String, Object>) - Static method in class com.babelqueue.EnvelopeCodec: Build the canonical envelope for a (urn, data) pair on the default queue.
make(String, Map<String, Object>, String, String) - Static method in class com.babelqueue.EnvelopeCodec: Build the canonical envelope for a (urn, data) pair.
MapProvider - Class in com.babelqueue.schema: In-memory SchemaProvider, for tests and for embedding schemas in code.
MapProvider(Map<String, Map<String, Object>>) - Constructor for class com.babelqueue.schema.MapProvider
max() - Method in record class com.babelqueue.Redrive.Options: Returns the value of the max record component.
max(int) - Method in record class com.babelqueue.Redrive.Options
messageId() - Method in record class com.babelqueue.Redrive.Item: Returns the value of the messageId record component.
meta() - Method in record class com.babelqueue.Envelope: Returns the value of the meta record component.
Meta - Record Class in com.babelqueue: The immutable per-message metadata block of a Envelope.
Meta(String, String, String, int, long) - Constructor for record class com.babelqueue.Meta: Creates an instance of a Meta record class.

O

Options(String, int, boolean, Predicate<Envelope>, boolean) - Constructor for record class com.babelqueue.Redrive.Options: Creates an instance of a Options record class.
originalQueue() - Method in record class com.babelqueue.DeadLetter: Returns the value of the originalQueue record component.

P

PayloadValidator - Class in com.babelqueue.schema: Validates a message's data block against a per-URN JSON Schema (ADR-0024).
PolyglotMessage - Interface in com.babelqueue: A message that can be produced as a polyglot envelope.
pop(String) - Method in interface com.babelqueue.Redrive.Transport: Reserve the next message from queue, or null when it is empty.
process(Map<String, String>, Replay.Effect) - Static method in class com.babelqueue.Replay: Runs body with the replay flag derived from a reserved message's transport headers (the presence of Replay.HEADER_REPLAY_BYPASS), restoring the prior flag afterwards.
publish(Tracer, String, Map<String, Object>, Sender) - Static method in class com.babelqueue.otel.Tracing: Publishes (urn, data) to the "default" queue under a PRODUCER span.
publish(Tracer, String, Map<String, Object>, String, Sender) - Static method in class com.babelqueue.otel.Tracing: Emits a PRODUCER span publish <urn>, carrying the active trace's id into the built envelope's trace_id so the downstream consumer recovers the same trace, then writes the envelope via send.
publish(String, String) - Method in interface com.babelqueue.Redrive.Transport: Publish an already-encoded body to queue.
publishWithHeaders(String, String, Map<String, String>) - Method in interface com.babelqueue.Redrive.HeaderPublisher

Q

queue() - Method in record class com.babelqueue.Meta: Returns the value of the queue record component.

R

reason() - Method in record class com.babelqueue.DeadLetter: Returns the value of the reason record component.
reason() - Method in record class com.babelqueue.Redrive.Item: Returns the value of the reason record component.
redrive(Redrive.Transport, String, Redrive.Options) - Static method in class com.babelqueue.Redrive: Drains dead-lettered messages off dlq and re-publishes each (reset) to its source queue or opts.toQueue.
Redrive - Class in com.babelqueue: DLQ redrive tooling — safe replay off the dead-letter queue (ADR-0026).
Redrive.HeaderPublisher - Interface in com.babelqueue: An optional Redrive.Transport capability: publish a body together with out-of-band transport headers (e.g.
Redrive.Item - Record Class in com.babelqueue: What happened to one message during a Redrive.redrive(com.babelqueue.Redrive.Transport, java.lang.String, com.babelqueue.Redrive.Options) run.
Redrive.Options - Record Class in com.babelqueue: Options for a Redrive.redrive(com.babelqueue.Redrive.Transport, java.lang.String, com.babelqueue.Redrive.Options) run; immutable, built with the fluent withers from Redrive.Options.all().
Redrive.Reserved - Record Class in com.babelqueue: A reserved DLQ message: its raw body, a transport-specific handle used to ack it, and any out-of-band transport headers (e.g.
Redrive.Result - Record Class in com.babelqueue: Summary of a Redrive.redrive(com.babelqueue.Redrive.Transport, java.lang.String, com.babelqueue.Redrive.Options) run.
Redrive.Transport - Interface in com.babelqueue: The minimal transport surface Redrive.redrive(com.babelqueue.Redrive.Transport, java.lang.String, com.babelqueue.Redrive.Options) needs, implemented over any broker.
redriven() - Method in record class com.babelqueue.Redrive.Item: Returns the value of the redriven record component.
redriven() - Method in record class com.babelqueue.Redrive.Result: Returns the value of the redriven record component.
RELEASE - Static variable in class com.babelqueue.UnknownUrnStrategy: Requeue for another consumer.
remember(String) - Method in class com.babelqueue.idempotency.InMemoryStore
remember(String) - Method in interface com.babelqueue.idempotency.Store: Records this message id as processed.
Replay - Class in com.babelqueue: Replay-Bypass — a side-effect guard for DLQ replay (ADR-0027).
Replay.Effect - Interface in com.babelqueue: An action that may throw — the external side of a handler.
Reserved(String, Object) - Constructor for record class com.babelqueue.Redrive.Reserved: A reserved message with no out-of-band headers.
Reserved(String, Object, Map<String, String>) - Constructor for record class com.babelqueue.Redrive.Reserved: Creates an instance of a Reserved record class.
reset(Envelope) - Static method in class com.babelqueue.Redrive: Returns a copy of env reset for reprocessing: the dead_letter block is removed and attempts reset to 0; job, trace_id, data and meta are preserved verbatim.
Result(int, int, List<Redrive.Item>) - Constructor for record class com.babelqueue.Redrive.Result: Creates an instance of a Result record class.
run() - Method in interface com.babelqueue.Replay.Effect

S

SCHEMA_VERSION - Static variable in class com.babelqueue.EnvelopeCodec: The wire envelope schema version this core implements.
schemaFor(String) - Method in class com.babelqueue.schema.MapProvider
schemaFor(String) - Method in interface com.babelqueue.schema.SchemaProvider: The decoded JSON Schema registered for urn, or null when none is.
SchemaProvider - Interface in com.babelqueue.schema: A source of per-URN data schemas, keyed on the message URN (ADR-0024).
SchemaValidation - Class in com.babelqueue.schema: Optional per-URN data schema validation for a babelqueue producer or consumer (ADR-0024).
schemaVersion() - Method in record class com.babelqueue.Meta: Returns the value of the schemaVersion record component.
seen(String) - Method in class com.babelqueue.idempotency.InMemoryStore
seen(String) - Method in interface com.babelqueue.idempotency.Store: Whether this message id has already been processed (remembered).
select() - Method in record class com.babelqueue.Redrive.Options: Returns the value of the select record component.
select(Predicate<Envelope>) - Method in record class com.babelqueue.Redrive.Options
send(Envelope) - Method in interface com.babelqueue.otel.Sender: Sends one already-built envelope to its destination.
Sender - Interface in com.babelqueue.otel: Performs the actual transport write for Tracing.publish(io.opentelemetry.api.trace.Tracer, java.lang.String, java.util.Map<java.lang.String, java.lang.Object>, com.babelqueue.otel.Sender).
skipped() - Method in record class com.babelqueue.Redrive.Result: Returns the value of the skipped record component.
SOURCE_LANG - Static variable in class com.babelqueue.EnvelopeCodec: The value stamped into meta.lang for envelopes produced here.
Store - Interface in com.babelqueue.idempotency: A pluggable record of message ids that have already been processed, keyed on the envelope's meta.id.

T

to() - Method in record class com.babelqueue.Redrive.Item: Returns the value of the to record component.
toPayload() - Method in interface com.babelqueue.PolyglotMessage: The pure-JSON payload (no class instances).
toQueue() - Method in record class com.babelqueue.Redrive.Options: Returns the value of the toQueue record component.
toQueue(String) - Method in record class com.babelqueue.Redrive.Options
toString() - Method in record class com.babelqueue.DeadLetter: Returns a string representation of this record class.
toString() - Method in record class com.babelqueue.Envelope: Returns a string representation of this record class.
toString() - Method in record class com.babelqueue.Meta: Returns a string representation of this record class.
toString() - Method in record class com.babelqueue.Redrive.Item: Returns a string representation of this record class.
toString() - Method in record class com.babelqueue.Redrive.Options: Returns a string representation of this record class.
toString() - Method in record class com.babelqueue.Redrive.Reserved: Returns a string representation of this record class.
toString() - Method in record class com.babelqueue.Redrive.Result: Returns a string representation of this record class.
traceId() - Method in record class com.babelqueue.Envelope: Returns the value of the traceId record component.
traceId() - Method in record class com.babelqueue.Redrive.Item: Returns the value of the traceId record component.
traceIdOf(String) - Static method in class com.babelqueue.otel.Tracing: Maps an envelope trace_id to a deterministic 32-hex OTel trace id: a UUID maps to its hex bytes; any other string is hashed (SHA-256, first 16 bytes).
Tracing - Class in com.babelqueue.otel: Optional OpenTelemetry tracing for a babelqueue producer or consumer (ADR-0025) — the Java mirror of the Go babelqueue-go/otel, Python babelqueue.otel and Node @babelqueue/core/otel helpers.

U

UnknownUrnException - Exception in com.babelqueue: Raised when no handler is mapped for a message URN.
UnknownUrnException(String) - Constructor for exception com.babelqueue.UnknownUrnException
UnknownUrnStrategy - Class in com.babelqueue: What a consumer does with a message whose URN has no registered handler.
urn() - Method in record class com.babelqueue.Redrive.Item: Returns the value of the urn record component.
urn() - Method in exception com.babelqueue.schema.InvalidPayloadException
urn(Envelope) - Static method in class com.babelqueue.EnvelopeCodec: The message URN — the canonical job, with the urn alias resolved by EnvelopeCodec.decode(java.lang.String).
uuidOf(String) - Static method in class com.babelqueue.otel.Tracing: Formats a 32-hex OTel trace id as a canonical UUID string — the form a producer stamps into the message's trace_id so a consumer can recover the same trace id via Tracing.traceIdOf(java.lang.String).

V

validate(SchemaProvider, String, Map<String, Object>) - Static method in class com.babelqueue.schema.SchemaValidation: Validate (urn, data) against its registered schema, throwing otherwise.
validate(Map<String, Object>, Object) - Static method in class com.babelqueue.schema.PayloadValidator: The first violation of value against schema as "<json-pointer>: <reason>", or null when it conforms.
violation() - Method in exception com.babelqueue.schema.InvalidPayloadException

W

wrap(Store, Handler) - Static method in class com.babelqueue.idempotency.Idempotent: Returns handler wrapped with dedupe on meta.id against store.
wrap(SchemaProvider, Handler) - Static method in class com.babelqueue.schema.SchemaValidation: Returns handler wrapped to validate each message's data against its URN's schema before the handler runs (consumer-side safety net).
wrapHandler(Tracer, Handler) - Static method in class com.babelqueue.otel.Tracing: Wraps a consume handler to emit a CONSUMER span per message, in the OTel trace derived from the envelope's trace_id, recording the handler's error/status.

A B C D E F G H I J L M O P Q R S T U V W
All Classes and Interfaces|All Packages|Constant Field Values|Serialized Form