io.flamingock.internal.common.core.util

Class ConfigValueParser

java.lang.Object

io.flamingock.internal.common.core.util.ConfigValueParser

public final class ConfigValueParser
extends java.lang.Object

Generic configuration value parser for Flamingock configuration values.

Supported placeholder syntax:

• ${name}
• ${name:defaultValue}

Notes:

• The placeholder name may include separators such as ., - and _.
• The first : (if present) separates the name from the default value.
• Whitespace around the name is allowed and ignored.
• Nested placeholders (e.g. ${a:${b}}) are intentionally not supported.
• If a value starts with ${ but is not a valid placeholder, this class throws an exception. It must not be treated as a literal.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	ConfigValueParser.ConfigValue Result of parsing an input configuration value.
static class	ConfigValueParser.Placeholder Immutable representation of a parsed placeholder.
static class	ConfigValueParser.ValueType

Field Summary

Fields

Modifier and Type	Field and Description
static java.util.function.Predicate<java.lang.String>	BOOLEAN_VALUE_VALIDATOR Validator suitable for boolean-like values: allowed values: "", "true", "false" (case-insensitive).

Method Summary

Modifier and Type	Method and Description
static boolean	isValidPlaceholder(java.lang.String raw) Returns true if the supplied value is syntactically a valid placeholder.
static ConfigValueParser.ConfigValue	parse(java.lang.String valueName, java.lang.String raw) Parses the provided value and classifies it as EMPTY, PLACEHOLDER, or LITERAL.
static ConfigValueParser.ConfigValue	parse(java.lang.String valueName, java.lang.String raw, java.util.function.Predicate<java.lang.String> valueValidator) Parses the provided value and classifies it as EMPTY, PLACEHOLDER, or LITERAL, while also validating: Placeholder syntax (always, when value starts with ${) Placeholder default value (only when present, using valueValidator if provided) Literal value (using valueValidator if provided)
static java.util.Optional<ConfigValueParser.Placeholder>	parsePlaceholder(java.lang.String valueName, java.lang.String raw) Parses a placeholder if (and only if) the entire value is a placeholder.

Methods inherited from class java.lang.Object

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

Field Detail

BOOLEAN_VALUE_VALIDATOR

public static final java.util.function.Predicate<java.lang.String> BOOLEAN_VALUE_VALIDATOR

Validator suitable for boolean-like values: allowed values: "", "true", "false" (case-insensitive).

Method Detail

parse

public static ConfigValueParser.ConfigValue parse(java.lang.String valueName,
                                                  java.lang.String raw)

Parses the provided value and classifies it as EMPTY, PLACEHOLDER, or LITERAL.

This overload performs only placeholder syntax validation. Literals and placeholder defaults are accepted as-is.

Parameters:

valueName - logical name used in exception messages (e.g. "origin", "emptyOriginAllowed")

raw - raw input value

Returns:

parsed configuration value (never invalid; invalid inputs throw)

parse

public static ConfigValueParser.ConfigValue parse(java.lang.String valueName,
                                                  java.lang.String raw,
                                                  java.util.function.Predicate<java.lang.String> valueValidator)

Parses the provided value and classifies it as EMPTY, PLACEHOLDER, or LITERAL, while also validating:

• Placeholder syntax (always, when value starts with ${)
• Placeholder default value (only when present, using valueValidator if provided)
• Literal value (using valueValidator if provided)

Fail-fast rule: if the value starts with ${} but is not a valid placeholder, this method throws IllegalArgumentException.

Parameters:

valueName - logical name used in exception messages (e.g. "origin", "emptyOriginAllowed")

raw - raw input value

valueValidator - validator applied to literal values and placeholder default values (may be null)

Returns:

parsed configuration value (never invalid; invalid inputs throw)

parsePlaceholder

public static java.util.Optional<ConfigValueParser.Placeholder> parsePlaceholder(java.lang.String valueName,
                                                                                 java.lang.String raw)

Parses a placeholder if (and only if) the entire value is a placeholder.

Returns Optional.empty() if the input is null, blank, or not a placeholder.

Important: if the value starts with ${} but is not a valid placeholder, this method throws IllegalArgumentException.

isValidPlaceholder

public static boolean isValidPlaceholder(java.lang.String raw)

Returns true if the supplied value is syntactically a valid placeholder.

This method never throws. If you need fail-fast behaviour for values starting with ${, use parse(String, String).