|
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 nichtnullsein.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 nichtnullsein. 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");