org.ekrich.config.impl
Type members
Classlikes
- Companion
- object
Trying very hard to avoid a parent reference in config values; when you have a tree like this, the availability of parent() tends to result in a lot of improperly-factored and non-modular code. Please don't add parent().
Trying very hard to avoid a parent reference in config values; when you have a tree like this, the availability of parent() tends to result in a lot of improperly-factored and non-modular code. Please don't add parent().
- Companion
- class
A terrible Map that isn't as expensive as HashMap to copy and add one item to. Please write something real if you see this and get cranky.
A terrible Map that isn't as expensive as HashMap to copy and add one item to. Please write something real if you see this and get cranky.
- Companion
- class
To workaround missing implementation in Scala.js
To workaround missing implementation in Scala.js
A ConfigConcatenation represents a list of values to be concatenated (see the spec). It only has to exist if at least one value is an unresolved substitution, otherwise we could go ahead and collapse the list into a single value.
A ConfigConcatenation represents a list of values to be concatenated (see the spec). It only has to exist if at least one value is an unresolved substitution, otherwise we could go ahead and collapse the list into a single value.
Right now this is always a list of strings and ${} references, but in the future should support a list of ConfigList. We may also support concatenations of objects, but ConfigDelayedMerge should be used for that since a concat of objects really will merge, not concatenate.
- Companion
- class
- Companion
- object
The issue here is that we want to first merge our stack of config files, and then we want to evaluate substitutions. But if two substitutions both expand to an object, we might need to merge those two objects. Thus, we can't ever "override" a substitution when we do a merge; instead we have to save the stack of values that should be merged, and resolve the merge when we evaluate substitutions.
The issue here is that we want to first merge our stack of config files, and then we want to evaluate substitutions. But if two substitutions both expand to an object, we might need to merge those two objects. Thus, we can't ever "override" a substitution when we do a merge; instead we have to save the stack of values that should be merged, and resolve the merge when we evaluate substitutions.
- Companion
- class
- Companion
- object
- Companion
- object
Internal implementation detail, not ABI stable, do not touch.
For use only by the [[org.ekrich.config]]
package.
Internal implementation detail, not ABI stable, do not touch.
For use only by the [[org.ekrich.config]]
package.
Internal implementation detail, not ABI stable, do not touch.
For use only by the [[org.ekrich.config]]
package.
Internal implementation detail, not ABI stable, do not touch.
For use only by the [[org.ekrich.config]]
package.
This exists because sometimes null is not the same as missing. Specifically, if a value is set to null we can give a better error message (indicating where it was set to null) in case someone asks for the value. Also, null overrides values set "earlier" in the search path, while missing values do not.
This exists because sometimes null is not the same as missing. Specifically, if a value is set to null we can give a better error message (indicating where it was set to null) in case someone asks for the value. Also, null overrides values set "earlier" in the search path, while missing values do not.
- Companion
- object
ConfigReference replaces ConfigReference (the older class kept for back compat) and represents the ${} substitution syntax. It can resolve to any kind of value.
ConfigReference replaces ConfigReference (the older class kept for back compat) and represents the ${} substitution syntax. It can resolve to any kind of value.
- Companion
- object
An AbstractConfigValue which contains other values. Java has no way to express "this has to be an AbstractConfigValue also" other than making AbstractConfigValue an interface which would be aggravating. But we can say we are a ConfigValue.
An AbstractConfigValue which contains other values. Java has no way to express "this has to be an AbstractConfigValue also" other than making AbstractConfigValue an interface which would be aggravating. But we can say we are a ConfigValue.
Default automatic type transformations.
Default automatic type transformations.
The key used to memoize already-traversed nodes when resolving substitutions
The key used to memoize already-traversed nodes when resolving substitutions
Internal implementation detail, not ABI stable, do not touch.
For use only by the [[org.ekrich.config]]
package.
The point of this class is to avoid "propagating" each
overload on "thing which can be parsed" through multiple
interfaces. Most interfaces can have just one overload that
takes a Parseable. Also it's used as an abstract "resource
handle" in the ConfigIncluder interface.
Internal implementation detail, not ABI stable, do not touch.
For use only by the [[org.ekrich.config]]
package.
The point of this class is to avoid "propagating" each
overload on "thing which can be parsed" through multiple
interfaces. Most interfaces can have just one overload that
takes a Parseable. Also it's used as an abstract "resource
handle" in the ConfigIncluder interface.
- Companion
- class
Implemented by a merge stack (ConfigDelayedMerge, ConfigDelayedMergeObject) that replaces itself during substitution resolution in order to implement "look backwards only" semantics.
Implemented by a merge stack (ConfigDelayedMerge, ConfigDelayedMergeObject) that replaces itself during substitution resolution in order to implement "look backwards only" semantics.
This exists because we have to memoize resolved substitutions as we go through the config tree; otherwise we could end up creating multiple copies of values or whole trees of values as we follow chains of substitutions.
This exists because we have to memoize resolved substitutions as we go through the config tree; otherwise we could end up creating multiple copies of values or whole trees of values as we follow chains of substitutions.
This class is the source for values for a substitution like ${foo}
.
This class is the source for values for a substitution like ${foo}
.
- Companion
- class
Deliberately shoving all the serialization code into this class instead of doing it OO-style with each subclass. Seems better to have it all in one place. This class implements a lame serialization format that supports skipping unknown fields, so it's moderately more extensible than the default Java serialization format.
Deliberately shoving all the serialization code into this class instead of doing it OO-style with each subclass. Seems better to have it all in one place. This class implements a lame serialization format that supports skipping unknown fields, so it's moderately more extensible than the default Java serialization format.
- Companion
- class
One thing to keep in mind in the future: as Collection-like APIs are added here, including iterators or size() or anything, they should be consistent with a one-level java.util.Map from paths to non-null values. Null values are not "in" the map.
One thing to keep in mind in the future: as Collection-like APIs are added here, including iterators or size() or anything, they should be consistent with a one-level java.util.Map from paths to non-null values. Null values are not "in" the map.
- Companion
- class
- Companion
- object
- Companion
- object
To workaround missing implementation in Scala.js
To workaround missing implementation in Scala.js
Interface that tags a ConfigValue that is not mergeable until after
substitutions are resolved. Basically these are special ConfigValue that
never appear in a resolved tree, like ConfigSubstitution
and
[[ConfigDelayedMerge]]
.
Interface that tags a ConfigValue that is not mergeable until after
substitutions are resolved. Basically these are special ConfigValue that
never appear in a resolved tree, like ConfigSubstitution
and
[[ConfigDelayedMerge]]
.
To workaround missing implementation in Scala.js
To workaround missing implementation in Scala.js