ReplaceableMergeStack
Implemented by a merge stack (ConfigDelayedMerge, ConfigDelayedMergeObject)
that replaces itself during substitution resolution in order to implement
"look backwards only" semantics.
that replaces itself during substitution resolution in order to implement
"look backwards only" semantics.
Value members
Methods
Inherited methods
Returns a ConfigValue based on this one, but with the given
origin. This is useful when you are parsing a new format of file or setting
comments for a single ConfigValue.
origin. This is useful when you are parsing a new format of file or setting
comments for a single ConfigValue.
- Value Params
- origin
-
the origin set on the returned value
- Returns
-
the new ConfigValue with the given origin
- Since
-
1.3.0
- Inhertied from
- ConfigValue
The origin of the value (file, line number, etc.), for debugging and
error messages.
error messages.
- Returns
-
where the value came from
- Inhertied from
- ConfigValue
Places the value inside a
[[Config]]
at the given key. See also[[ConfigValue#atPath]]
.- Value Params
- key
-
key to store this value at.
- Returns
-
a Config instance containing this value at the given key.
- Inhertied from
- ConfigValue
The
[[ConfigValueType]]
of the value; matches the JSON type schema.- Returns
-
value's type
- Inhertied from
- ConfigValue
Replace a child of this value. CAUTION if replacement is null, delete the
child, which may also delete the parent, or make the parent into a
non-container.
child, which may also delete the parent, or make the parent into a
non-container.
- Inhertied from
- Container
Places the value inside a
[[Config]]
at the given path. See also[[ConfigValue#atKey]]
.- Value Params
- path
-
path to store this value at.
- Returns
-
a Config instance containing this value at the given
path. - Inhertied from
- ConfigValue
Super-expensive full traversal to see if descendant is anywhere
underneath this container.
underneath this container.
- Inhertied from
- Container
Renders the config value to a string, using the provided options.
If the config value has not been resolved
(see [Config.resolve()),
it's possible that it can't be rendered as valid HOCON. In that case the
rendering should still be useful for debugging but you might not be able
to parse it. If the value has been resolved, it will always be parseable.
(see [Config.resolve()),
it's possible that it can't be rendered as valid HOCON. In that case the
rendering should still be useful for debugging but you might not be able
to parse it. If the value has been resolved, it will always be parseable.
If the config value has been resolved and the options disable all
HOCON-specific features (such as comments), the rendering will be valid
JSON. If you enable HOCON-only features such as comments, the rendering
will not be valid JSON.
HOCON-specific features (such as comments), the rendering will be valid
JSON. If you enable HOCON-only features such as comments, the rendering
will not be valid JSON.
- Value Params
- options
-
the rendering options
- Returns
-
the rendered value
- Inhertied from
- ConfigValue
Renders the config value as a HOCON string. This method is primarily
intended for debugging, so it tries to add helpful comments and
whitespace.
intended for debugging, so it tries to add helpful comments and
whitespace.
If the config value has not been resolved
(see Config.resolve()),
it's possible that it can't be rendered as valid HOCON. In that case the
rendering should still be useful for debugging but you might not be able
to parse it. If the value has been resolved, it will always be parseable.
(see Config.resolve()),
it's possible that it can't be rendered as valid HOCON. In that case the
rendering should still be useful for debugging but you might not be able
to parse it. If the value has been resolved, it will always be parseable.
This method is equivalent to
render(ConfigRenderOptions.defaults()).
render(ConfigRenderOptions.defaults()).
- Returns
-
the rendered value
- Inhertied from
- ConfigValue
Returns the value as a plain Java boxed value, that is, a String,
Number, Boolean, Map<String,Object>,
List, or null, matching the
of this ConfigValue. If the value is a
Number, Boolean, Map<String,Object>,
List, or null, matching the
[[#valueType]]
of this ConfigValue. If the value is a
[[ConfigObject]]
or[[ConfigList]]
, it is recursively unwrapped.- Returns
-
a plain Java value corresponding to this ConfigValue
- Inhertied from
- ConfigValue