Auto Light Dark
Auto Light Dark
German English

setContextExtension

Versionshinweise

2026.11


Code

CloudEventContextBuilder setContextExtension(CloudEventContextBuilder builder, String key, Object value)

Beschreibung

Fügt dem Ereignis ein benutzerdefiniertes Erweiterungsattribut hinzu. Eine vorhandene Erweiterung mit demselben Schlüssel wird ersetzt.

Im Structured-Modus werden Erweiterungen als Eigenschaften der obersten Ebene des JSON-Dokuments gesendet. Im Binary-Modus werden sie als HTTP-Header mit dem Präfix ce- gesendet.

Parameter

  • builder (CloudEventContextBuilder) - Der zu ändernde Kontext-Builder.

  • key (String) - Der Name des Erweiterungsattributs. Darf nicht null sein.

    Der Name darf nur aus Kleinbuchstaben (a-z) und Ziffern (0-9) bestehen, andernfalls tritt ein Fehler auf. Er sollte nicht länger als 20 Zeichen sein, dies wird aber nicht geprüft.

  • value (Object) - Der Wert des Erweiterungsattributs. Darf nicht null sein. Es sollten einfache Werte wie Text, Zahlen oder Booleans verwendet werden, da Erweiterungen im Binary-Modus als HTTP-Header gesendet werden.

Rückgabe

CloudEventContextBuilder - Der übergebene Kontext-Builder zum Verketten von Aufrufen.

Beispiele

// add a custom attribute to correlate events
builder = CloudEventUtils.setContextExtension(builder, "correlationid", "4711");