Interface McpLocalizationResult

All Known Implementing Classes:

McpLocalizationResult.Failure, McpLocalizationResult.Localized, McpLocalizationResult.UseDefaultText

@ThreadSafe
public sealed interface McpLocalizationResult
permits McpLocalizationResult.Localized, McpLocalizationResult.UseDefaultText, McpLocalizationResult.Failure

Immutable outcome of localizing one MCP presentation field.

This is a closed domain; exhaustive switches are supported, and any new alternative requires an explicit reviewed contract amendment.

Author:

Mark Allen

Nested Class Summary

Nested Classes

Modifier and Type	Interface	Description
static final class	McpLocalizationResult.Failure	Reports an unexpected lookup failure without carrying a throwable, message, key, coordinate, locale, revision, or other diagnostic data.
static final class	McpLocalizationResult.Localized	Text successfully resolved for the localization context.
static final class	McpLocalizationResult.UseDefaultText	Requests publication of the canonical default text for this field.

Method Summary

Static Methods

Modifier and Type	Method	Description
static @NonNull McpLocalizationResult.Failure	failure()	Creates the data-free outcome for an unexpected localization lookup failure.
static @NonNull McpLocalizationResult.Localized	localized(@NonNull String text)	Creates text successfully resolved for the localization context.
static @NonNull McpLocalizationResult.UseDefaultText	useDefaultText()

Method Details

localized

static @NonNull McpLocalizationResult.Localized localized(@NonNull String text)

Creates text successfully resolved for the localization context. The provider owns locale matching and fallback, so the text may come from the selected locale, a parent locale, or a localization-library fallback.

Parameters:

text - localized nonblank text

Returns:

localized result

Throws:

NullPointerException - if text is null

IllegalArgumentException - if text is blank

useDefaultText

static @NonNull McpLocalizationResult.UseDefaultText useDefaultText()

Returns:

result requesting the canonical default field

failure

static @NonNull McpLocalizationResult.Failure failure()

Creates the data-free outcome for an unexpected localization lookup failure. This outcome applies the localizer's whole-response failure policy; it is not an ordinary missing-translation result.

Returns:

failure result