Interface Unmatched

All Known Implementing Classes:

Unmatched.Absent, Unmatched.Computed, Unmatched.Delegate, Unmatched.Fail, Unmatched.Fixed, Unmatched.Identity

public sealed interface Unmatched
permits Unmatched.Absent, Unmatched.Identity, Unmatched.Fixed, Unmatched.Computed, Unmatched.Fail, Unmatched.Delegate

What a Mapping answers with when the requested key has no entry.

Every mode but Unmatched.Delegate answers on its own; Unmatched.Delegate hands the question to another mapping, whose own fallback then decides.

This replaces the (ELSE) clause of the Groovy mapping DSL, whose value could be any Groovy expression. The vocabulary here is closed and therefore exhaustively checkable: a mapping file can only declare one of the modes below, and Unmatched.Computed can only name a function that a MappingFunctionRegistry knows about.

Since:

6.0

Nested Class Summary

Nested Classes

Modifier and Type	Interface	Description
static final record	Unmatched.Absent	No fallback — an unmatched key has no value.
static final record	Unmatched.Computed	The value is computed by a named function resolved against a MappingFunctionRegistry.
static final record	Unmatched.Delegate	Another mapping answers instead.
static final record	Unmatched.Fail	An unmatched key is an error.
static final record	Unmatched.Fixed	A constant value.
static final record	Unmatched.Identity	The key itself is the value.

Field Summary

Fields

Modifier and Type	Field	Description
static final Unmatched	ABSENT
static final Unmatched	FAIL
static final Unmatched	IDENTITY

Method Summary

Static Methods

Modifier and Type	Method	Description
static Unmatched	computed(String ref)
static Unmatched	delegate(String mapping)
static Unmatched	fixed(String value)

Field Details

ABSENT

static final Unmatched ABSENT

IDENTITY

static final Unmatched IDENTITY

FAIL

static final Unmatched FAIL

Method Details

fixed

static Unmatched fixed(String value)

computed

static Unmatched computed(String ref)

delegate

static Unmatched delegate(String mapping)