Class McpLocalizer

java.lang.Object

com.soklet.McpLocalizer

@ThreadSafe
public final class McpLocalizer
extends Object

Immutable server-wide MCP localization behavior and policy.

The configured fallback locale is the language of every canonical annotation and builder string hosted by the server and the locale of canonical default text. It is independent of a provider or localization library's terminal fallback locale. The application-owned context provider performs request-specific locale selection and fallback resolution and captures one immutable translation snapshot.

Author:

Mark Allen

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static final class	McpLocalizer.Builder	Single-threaded builder for an immutable localizer.

Method Summary

Modifier and Type	Method	Description
@NonNull McpLocalizationContextProvider	getContextProvider()
@NonNull McpLocalizationFailurePolicy	getFailurePolicy()	Returns the whole-response framework-catalog failure policy.
@NonNull Locale	getFallbackLocale()
@NonNull Integer	getMaximumLocalizableTextCountPerResponse()	Returns the maximum number of provider text lookups permitted while rendering one framework response.
static @NonNull McpLocalizer.Builder	withFallbackLocale(@NonNull Locale fallbackLocale, @NonNull McpLocalizationContextProvider localizationContextProvider)	Vends a builder primed with the canonical non-root fallback locale and application-owned context provider.

Methods inherited from class Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Details

withFallbackLocale

public static @NonNull McpLocalizer.Builder withFallbackLocale(@NonNull Locale fallbackLocale,
 @NonNull McpLocalizationContextProvider localizationContextProvider)

Vends a builder primed with the canonical non-root fallback locale and application-owned context provider.

Parameters:

fallbackLocale - canonical BCP 47 fallback locale

localizationContextProvider - request context provider

Returns:

localizer builder

Throws:

NullPointerException - if an argument is null

IllegalArgumentException - if fallbackLocale is not a canonical, non-root BCP 47 locale of at most 255 ASCII bytes

getFallbackLocale

public @NonNull Locale getFallbackLocale()

Returns:

configured canonical non-root fallback locale

getContextProvider

public @NonNull McpLocalizationContextProvider getContextProvider()

Returns:

application-owned request context provider

getFailurePolicy

public @NonNull McpLocalizationFailurePolicy getFailurePolicy()

Returns the whole-response framework-catalog failure policy. It does not authorize a synthetic context when application context creation fails.

Returns:

framework-catalog localization failure policy

getMaximumLocalizableTextCountPerResponse

public @NonNull Integer getMaximumLocalizableTextCountPerResponse()

Returns the maximum number of provider text lookups permitted while rendering one framework response.

Returns:

positive bounded response-local lookup limit