Index
All Classes and Interfaces|All Packages|Constant Field Values|Serialized Form
A
- add(Variables) - Method in class io.jstach.kiwi.kvs.Variables.Builder
-
Adds a
Variables
supplier to this builder. - add(KeyValuesResource) - Method in class io.jstach.kiwi.kvs.KeyValuesLoader.Builder
-
Adds a
KeyValuesResource
as a source to the loader. - add(Variables) - Method in class io.jstach.kiwi.kvs.KeyValuesLoader.Builder
-
Adds
Variables
for interpolation when loading key-values. - add(String) - Method in class io.jstach.kiwi.kvs.KeyValuesLoader.Builder
-
Adds a URI specified as a string as a source to the loader.
- add(String, KeyValues) - Method in class io.jstach.kiwi.kvs.KeyValuesLoader.Builder
-
Adds a named
KeyValues
source to the loader. - add(String, String) - Method in class io.jstach.kiwi.kvs.KeyValues.Builder
-
Adds a key-value pair to the builder.
- add(String, String) - Method in class io.jstach.kiwi.kvs.Variables.Builder
-
Adds a key-value mapping to this builder.
- add(String, Consumer<KeyValuesResource.Builder>) - Method in class io.jstach.kiwi.kvs.KeyValuesLoader.Builder
-
Add resource using callback on builder.
- add(URI) - Method in class io.jstach.kiwi.kvs.KeyValuesLoader.Builder
-
Adds a
URI
as a source by wrapping it in aKeyValuesResource
. - add(Collection<Map.Entry<String, String>>) - Method in class io.jstach.kiwi.kvs.KeyValues.Builder
-
Adds a collection of entries to the builder.
- add(Map.Entry<String, String>) - Method in class io.jstach.kiwi.kvs.KeyValues.Builder
-
Adds a key-value pair to the builder from a map entry.
- add(Map<String, String>) - Method in class io.jstach.kiwi.kvs.Variables.Builder
-
Adds a map of key-value mappings as a
Variables
supplier. - add(Properties) - Method in class io.jstach.kiwi.kvs.Variables.Builder
-
Adds a set of properties as a
Variables
supplier. - add(SequencedCollection<Map.Entry<String, String>>) - Method in class io.jstach.kiwi.kvs.KeyValues.Builder
-
Adds a collection of entries to the builder.
- addFlags(String) - Method in class io.jstach.kiwi.kvs.KeyValuesResource.Builder
-
Parses a comma-separated string of resource flags and adds or removes the flags from this builder.
- addFlags(Collection<KeyValue.Flag>) - Method in record class io.jstach.kiwi.kvs.KeyValue
-
Adds additional flags to this
KeyValue
and returns a new instance. - Adding Kiwi to Your Project - Search tag in Overview
- Section
- apply(String) - Method in interface io.jstach.kiwi.kvs.Variables
- Architecture - Search tag in Overview
- Section
B
- Basic Usage - Search tag in module io.jstach.kiwi.kvs
- Section
- build() - Method in class io.jstach.kiwi.kvs.KeyValues.Builder
-
Builds and returns a
KeyValues
instance containing all the key-value pairs added to this builder. - build() - Method in class io.jstach.kiwi.kvs.KeyValuesLoader.Builder
-
Builds and returns a new
KeyValuesLoader
based on the current state of the builder. - build() - Method in class io.jstach.kiwi.kvs.KeyValuesResource.Builder
-
Builds and returns a
KeyValuesResource
based on the current builder state. - build() - Method in class io.jstach.kiwi.kvs.KeyValuesSystem.Builder
-
Builds and returns a new
KeyValuesSystem
instance configured with the provided settings. - build() - Method in class io.jstach.kiwi.kvs.Variables.Builder
-
Builds a
Variables
instance from the current state of this builder, combining all added sources into a chain. - build(String, String) - Method in class io.jstach.kiwi.kvs.KeyValues.Builder
-
Constructs a
KeyValue
with the given key and value, including flags and source information. - builder() - Static method in interface io.jstach.kiwi.kvs.KeyValues
-
Creates a new
KeyValues.Builder
with a default, empty source. - builder() - Static method in interface io.jstach.kiwi.kvs.KeyValuesSystem
-
Creates and returns a new
KeyValuesSystem.Builder
for constructing customizedKeyValuesSystem
instances. - builder() - Static method in interface io.jstach.kiwi.kvs.Variables
-
Creates a new
Variables
builder for constructing a compositeVariables
instance. - builder(KeyValuesResource) - Static method in interface io.jstach.kiwi.kvs.KeyValues
-
Creates a new
KeyValues.Builder
for constructing aKeyValues
instance. - builder(String) - Static method in interface io.jstach.kiwi.kvs.KeyValuesResource
-
Creates a builder for a
KeyValuesResource
from the given URI string. - builder(URI) - Static method in interface io.jstach.kiwi.kvs.KeyValuesResource
-
Creates a builder for a
KeyValuesResource
from the given URI. - Builtin Filters - Search tag in interface io.jstach.kiwi.kvs.KeyValuesServiceProvider.KeyValuesFilter
- Section
C
- clearParameters() - Method in class io.jstach.kiwi.kvs.KeyValuesResource.Builder
-
Clears all parameters associated with the resource.
- close() - Method in interface io.jstach.kiwi.kvs.KeyValuesSystem
-
This signals to the logger that this key value system will not be used anymore but there is guarantee of this.
- closed(KeyValuesSystem) - Method in interface io.jstach.kiwi.kvs.KeyValuesEnvironment.Logger
-
This signals that key values system will no longer be used to load resources and that some other system can now take over perhaps the logging system.
- collector() - Static method in interface io.jstach.kiwi.kvs.KeyValues
-
Collects a stream of
KeyValue
into aKeyValues
instance. - collector(KeyValues.Builder) - Static method in interface io.jstach.kiwi.kvs.KeyValues
-
Collects a stream of
Map.Entry
into aKeyValues
using the provided builder. - Components: - Search tag in interface io.jstach.kiwi.kvs.KeyValue.Meta
- Section
- Contents - Search tag in Overview
- Section
- copyOf(SequencedCollection<? extends Variables>) - Static method in interface io.jstach.kiwi.kvs.Variables
-
Creates a
Variables
instance that chains together multipleVariables
sources but copies and filters the collection. - copyOf(SequencedCollection<KeyValue>) - Static method in interface io.jstach.kiwi.kvs.KeyValues
-
Creates a
KeyValues
instance by copying the given collection. - create() - Static method in interface io.jstach.kiwi.boot.KiwiConfig
-
Creates a stable config based on the opinionated loading.
- create(Properties) - Static method in interface io.jstach.kiwi.kvs.Variables
-
Creates a
Variables
instance from the provided properties. - create(SequencedCollection<? extends Variables>) - Static method in interface io.jstach.kiwi.kvs.Variables
-
Creates a
Variables
instance that chains together multipleVariables
sources.
D
- debug(String) - Method in interface io.jstach.kiwi.kvs.KeyValuesEnvironment.Logger
-
Logs a debug-level message.
- defaultResource() - Method in interface io.jstach.kiwi.kvs.KeyValuesEnvironment
-
If the loader builder is not passed any resources this resource will be used.
- defaults() - Static method in interface io.jstach.kiwi.kvs.KeyValuesSystem
-
Returns a default implementation of
KeyValuesSystem
configured with standard settings and a ServiceLoader based onKeyValuesServiceProvider
and its classloader. - describe(String) - Method in interface io.jstach.kiwi.boot.KiwiConfig.StableConfig
-
Describes the key like what resource it came from.
- description() - Method in interface io.jstach.kiwi.kvs.KeyValuesResource
-
Pretty toString of resource.
- Description - Search tag in Overview
- Section
E
- empty() - Static method in interface io.jstach.kiwi.kvs.KeyValues
-
Returns an empty
KeyValues
instance. - empty() - Static method in interface io.jstach.kiwi.kvs.Variables
-
Returns an empty
Parameters
instance. - EMPTY - Static variable in record class io.jstach.kiwi.kvs.KeyValue.Source
-
A default, empty source instance used when no specific source information is available.
- environment() - Method in record class io.jstach.kiwi.kvs.KeyValuesServiceProvider.KeyValuesFilter.FilterContext
-
Returns the value of the
environment
record component. - environment() - Method in interface io.jstach.kiwi.kvs.KeyValuesServiceProvider.KeyValuesLoaderFinder.LoaderContext
-
Retrieves the
KeyValuesEnvironment
for accessing system-level resources and properties. - environment() - Method in interface io.jstach.kiwi.kvs.KeyValuesSystem
-
Returns the
KeyValuesEnvironment
instance used for system-level interactions. - environment(KeyValuesEnvironment) - Method in class io.jstach.kiwi.kvs.KeyValuesSystem.Builder
-
Sets the
KeyValuesEnvironment
to be used by theKeyValuesSystem
. - equals(Object) - Method in record class io.jstach.kiwi.kvs.KeyValue
-
Indicates whether some other object is "equal to" this one.
- equals(Object) - Method in record class io.jstach.kiwi.kvs.KeyValue.Source
-
Indicates whether some other object is "equal to" this one.
- equals(Object) - Method in record class io.jstach.kiwi.kvs.KeyValuesServiceProvider.KeyValuesFilter.Filter
-
Indicates whether some other object is "equal to" this one.
- equals(Object) - Method in record class io.jstach.kiwi.kvs.KeyValuesServiceProvider.KeyValuesFilter.FilterContext
-
Indicates whether some other object is "equal to" this one.
- Example Properties Files - Search tag in module io.jstach.kiwi.kvs
- Section
- Example Usage - Search tag in Overview
- Section
- Example Usage - Search tag in interface io.jstach.kiwi.boot.KiwiConfig
- Section
- Example Usage - Search tag in record class io.jstach.kiwi.kvs.KeyValue
- Section
- expand(Variables) - Method in interface io.jstach.kiwi.kvs.KeyValues
-
Expands the key-values using variable interpolation.
- expanded() - Method in record class io.jstach.kiwi.kvs.KeyValue
-
Returns the value of the
expanded
record component. - expression() - Method in record class io.jstach.kiwi.kvs.KeyValuesServiceProvider.KeyValuesFilter.Filter
-
Returns the value of the
expression
record component. - Extensibility - Search tag in interface io.jstach.kiwi.kvs.KeyValuesServiceProvider.KeyValuesFilter
- Section
- Extensibility - Search tag in module io.jstach.kiwi.kvs
- Section
F
- fatal(Exception) - Method in interface io.jstach.kiwi.kvs.KeyValuesEnvironment.Logger
-
This is to signal failure that the KeyValueSystem cannot recover from while attempting to load.
- Features - Search tag in module io.jstach.kiwi.kvs
- Section
- Fields: - Search tag in record class io.jstach.kiwi.kvs.KeyValue.Source
- Section
- filter() - Method in record class io.jstach.kiwi.kvs.KeyValuesServiceProvider.KeyValuesFilter.Filter
-
Returns the value of the
filter
record component. - filter() - Method in interface io.jstach.kiwi.kvs.KeyValuesSystem
-
Returns a composite
KeyValuesServiceProvider.KeyValuesFilter
that aggregates all the filters added to theKeyValuesSystem.Builder
or found via theServiceLoader
, if configured. - filter(KeyValuesServiceProvider.KeyValuesFilter) - Method in class io.jstach.kiwi.kvs.KeyValuesSystem.Builder
-
Adds a filter to the filter chain.
- filter(KeyValuesServiceProvider.KeyValuesFilter.FilterContext, KeyValues, KeyValuesServiceProvider.KeyValuesFilter.Filter) - Method in interface io.jstach.kiwi.kvs.KeyValuesServiceProvider.KeyValuesFilter
-
Applies a filter to the given key-value pairs.
- filter(Predicate<KeyValue>) - Method in interface io.jstach.kiwi.kvs.KeyValues
-
Filters the key-value pairs based on a predicate.
- Filter(String, String, String) - Constructor for record class io.jstach.kiwi.kvs.KeyValuesServiceProvider.KeyValuesFilter.Filter
-
Creates an instance of a
Filter
record class. - FilterContext(KeyValuesEnvironment, Variables.Parameters) - Constructor for record class io.jstach.kiwi.kvs.KeyValuesServiceProvider.KeyValuesFilter.FilterContext
-
Creates an instance of a
FilterContext
record class. - findByExt(String) - Method in interface io.jstach.kiwi.kvs.KeyValuesMedia
- findByExt(String) - Method in interface io.jstach.kiwi.kvs.KeyValuesServiceProvider.KeyValuesMediaFinder
-
Finds a
KeyValuesMedia
based on a file extension. - findByMediaType(String) - Method in interface io.jstach.kiwi.kvs.KeyValuesMedia
- findByMediaType(String) - Method in interface io.jstach.kiwi.kvs.KeyValuesServiceProvider.KeyValuesMediaFinder
-
Finds a
KeyValuesMedia
based on a media type string. - findByResource(KeyValuesResource) - Method in interface io.jstach.kiwi.kvs.KeyValuesServiceProvider.KeyValuesMediaFinder
-
Finds a
KeyValuesMedia
based on the attributes of a givenKeyValuesResource
. - findByUri(URI) - Method in interface io.jstach.kiwi.kvs.KeyValuesMedia
- findByUri(URI) - Method in interface io.jstach.kiwi.kvs.KeyValuesServiceProvider.KeyValuesMediaFinder
-
Finds a
KeyValuesMedia
based on aURI
. - findEntry(String...) - Method in interface io.jstach.kiwi.kvs.Variables
-
Find a variable key-value tuple based on vararg keys.
- findLoader(KeyValuesServiceProvider.KeyValuesLoaderFinder.LoaderContext, KeyValuesResource) - Method in interface io.jstach.kiwi.kvs.KeyValuesServiceProvider.KeyValuesLoaderFinder
-
Finds a
KeyValuesLoader
capable of loading the specifiedKeyValuesResource
using the providedKeyValuesServiceProvider.KeyValuesLoaderFinder.LoaderContext
. - flag(KeyValue.Flag) - Method in class io.jstach.kiwi.kvs.KeyValues.Builder
-
Adds a flag that will be applied to all key-value pairs added by this builder.
- FLAG_INHERIT - Static variable in interface io.jstach.kiwi.kvs.KeyValuesResource
-
Indicates that the resource's properties should inherit from parent or default configurations.
- FLAG_LOCK - Static variable in interface io.jstach.kiwi.kvs.KeyValuesResource
-
Specifies that the resource is locked and its properties should not be overridden.
- FLAG_NO_ADD - Static variable in interface io.jstach.kiwi.kvs.KeyValuesResource
-
Indicates that the key-value pairs from the resource should only be added to variables and not to the final resolved key-value set.
- FLAG_NO_ADD_VARIABLES - Static variable in interface io.jstach.kiwi.kvs.KeyValuesResource
-
Indicates that key-value pairs added to variables should not be used for interpolation purposes.
- FLAG_NO_EMPTY - Static variable in interface io.jstach.kiwi.kvs.KeyValuesResource
-
Indicates that the resource should not be empty.
- FLAG_NO_INTERPOLATE - Static variable in interface io.jstach.kiwi.kvs.KeyValuesResource
-
Disables interpolation entirely for key-value pairs loaded from this resource.
- FLAG_NO_LOAD_CHILDREN - Static variable in interface io.jstach.kiwi.kvs.KeyValuesResource
-
Prevents the resource from invoking `_load` calls to load additional child resources.
- FLAG_NO_RELOAD - Static variable in interface io.jstach.kiwi.kvs.KeyValuesResource
-
Specifies that the resource should not be reloaded once it has been loaded.
- FLAG_NO_REPLACE - Static variable in interface io.jstach.kiwi.kvs.KeyValuesResource
-
Ensures that the resource can only add new key-value pairs and cannot replace existing ones.
- FLAG_NO_REQUIRE - Static variable in interface io.jstach.kiwi.kvs.KeyValuesResource
-
Indicates that the resource is optional and no error should occur if it is not found.
- FLAG_NOT_REQUIRED - Static variable in interface io.jstach.kiwi.kvs.KeyValuesResource
-
A synonym for
KeyValuesResource.FLAG_NO_REQUIRE
. - FLAG_OPTIONAL - Static variable in interface io.jstach.kiwi.kvs.KeyValuesResource
-
A synonym for
KeyValuesResource.FLAG_NO_REQUIRE
. - FLAG_SENSITIVE - Static variable in interface io.jstach.kiwi.kvs.KeyValuesResource
-
Marks the resource as containing sensitive key-value pairs, which should not be displayed or included in output such as `toString`.
- flags() - Method in interface io.jstach.kiwi.kvs.KeyValue.Meta
-
Retrieves any flags associated with the key-value.
- Flags: - Search tag in enum class io.jstach.kiwi.kvs.KeyValue.Flag
- Section
- flatMap(Function<KeyValue, KeyValues>) - Method in interface io.jstach.kiwi.kvs.KeyValues
-
Flattens the key-values by applying a mapping function that returns another
KeyValues
. - foo.properties - Search tag in module io.jstach.kiwi.kvs
- Section
- forKeyValues(BiConsumer<String, String>) - Method in interface io.jstach.kiwi.kvs.Variables.Parameters
-
Iterates over all key-value pairs in this
Parameters
instance and applies them to a provided consumer. - format(KeyValues) - Method in interface io.jstach.kiwi.kvs.KeyValuesMedia.Formatter
-
Formats key-value pairs and returns them as a string.
- format(Appendable, KeyValues) - Method in interface io.jstach.kiwi.kvs.KeyValuesMedia.Formatter
-
Formats key-value pairs into the provided
Appendable
. - format(StringBuilder, KeyValues) - Method in interface io.jstach.kiwi.kvs.KeyValuesMedia.Formatter
-
Formats key-value pairs into a
StringBuilder
. - formatLevel(System.Logger.Level) - Static method in interface io.jstach.kiwi.kvs.KeyValuesEnvironment.Logger
-
Turns a Level into a SLF4J like level String that is all upper case and same length with right padding.
- formatParameterKey(KeyValuesResource, String) - Method in interface io.jstach.kiwi.kvs.KeyValuesServiceProvider.KeyValuesLoaderFinder.LoaderContext
-
Formats a resource parameter key how it is represented as key in the parsed resource.
- formatResource(KeyValuesResource, BiConsumer<String, String>) - Method in interface io.jstach.kiwi.kvs.KeyValuesServiceProvider.KeyValuesLoaderFinder.LoaderContext
-
Formats a
KeyValuesResource
into its key-value representation and applies it to a given consumer. - formatter() - Method in interface io.jstach.kiwi.kvs.KeyValuesMedia
-
Returns a
KeyValuesMedia.Formatter
for formatting key-value pairs to an appendable target.
G
- getClassLoader() - Method in interface io.jstach.kiwi.kvs.KeyValuesEnvironment
-
Retrieves the system class loader.
- getFileExt() - Method in interface io.jstach.kiwi.kvs.KeyValuesMedia
-
Returns the file extension associated with the media type, if any.
- getLogger() - Method in interface io.jstach.kiwi.kvs.KeyValuesEnvironment
-
Retrieves the logger instance used for logging messages.
- getMainArgs() - Method in interface io.jstach.kiwi.kvs.KeyValuesEnvironment
-
Retrieves the main method arguments.
- getMediaType() - Method in interface io.jstach.kiwi.kvs.KeyValuesMedia
-
Returns the media type as a string.
- getProperty(String) - Method in interface io.jstach.kiwi.boot.KiwiConfig
-
Analogous to
System.getProperty(String)
. - getRandom() - Method in interface io.jstach.kiwi.kvs.KeyValuesEnvironment
-
Retrieves a random number generator.
- getResourceAsStream(String) - Method in interface io.jstach.kiwi.kvs.KeyValuesEnvironment.ResourceStreamLoader
-
Retrieves an input stream for the specified resource path.
- getResourceStreamLoader() - Method in interface io.jstach.kiwi.kvs.KeyValuesEnvironment
-
Retrieves the
KeyValuesEnvironment.ResourceStreamLoader
used for loading resources as streams. - getStandardInput() - Method in interface io.jstach.kiwi.kvs.KeyValuesEnvironment
-
Retrieves the standard input stream.
- getSystemEnv() - Method in interface io.jstach.kiwi.kvs.KeyValuesEnvironment
-
Retrieves the current environment variables.
- getSystemProperties() - Method in interface io.jstach.kiwi.kvs.KeyValuesEnvironment
-
Retrieves the current system properties.
- getValue(String) - Method in interface io.jstach.kiwi.kvs.Variables
-
Retrieves the value mapped to the specified key.
- Gradle - Search tag in Overview
- Section
- grep - Search tag in interface io.jstach.kiwi.kvs.KeyValuesServiceProvider.KeyValuesFilter
- Section
H
- hasFileExt(String) - Method in interface io.jstach.kiwi.kvs.KeyValuesMedia
-
Checks if a given filename has the file extension associated with this media type.
- hasFileExt(URI) - Method in interface io.jstach.kiwi.kvs.KeyValuesMedia
-
Checks if the URI's path has the file extension associated with this media type.
- hashCode() - Method in record class io.jstach.kiwi.kvs.KeyValue
-
Returns a hash code value for this object.
- hashCode() - Method in record class io.jstach.kiwi.kvs.KeyValue.Source
-
Returns a hash code value for this object.
- hashCode() - Method in record class io.jstach.kiwi.kvs.KeyValuesServiceProvider.KeyValuesFilter.Filter
-
Returns a hash code value for this object.
- hashCode() - Method in record class io.jstach.kiwi.kvs.KeyValuesServiceProvider.KeyValuesFilter.FilterContext
-
Returns a hash code value for this object.
I
- Immutability: - Search tag in interface io.jstach.kiwi.kvs.KeyValue.Meta
- Section
- index() - Method in record class io.jstach.kiwi.kvs.KeyValue.Source
-
Returns the value of the
index
record component. - info(String) - Method in interface io.jstach.kiwi.kvs.KeyValuesEnvironment.Logger
-
Logs an info-level message.
- init(KeyValuesSystem) - Method in interface io.jstach.kiwi.kvs.KeyValuesEnvironment.Logger
-
When Key Values System is loaded.
- inputStreamToString(InputStream) - Static method in interface io.jstach.kiwi.kvs.KeyValuesMedia
-
Reads an
InputStream
and converts it to a UTF-8 encoded string. - interpolate(Variables) - Method in interface io.jstach.kiwi.kvs.KeyValues
-
Interpolates the values using the provided
Variables
map. - Interpolation - Search tag in Overview
- Section
- io.jstach.kiwi.boot - module io.jstach.kiwi.boot
-
Kiwi Boot is tiny opinionated configuration framework modeled after Spring Boot that uses Kiwi KVS system to load key values into Map.
- io.jstach.kiwi.boot - package io.jstach.kiwi.boot
-
A Opinionated loading of configuration using Kiwi KVS based on Spring Boot loading style.
- io.jstach.kiwi.kvs - module io.jstach.kiwi.kvs
-
The
io.jstach.kiwi.kvs
module provides the core library for Kiwi, a non-opinionated Java configuration system that supports recursive chain loading of configuration from key-value pairs. - io.jstach.kiwi.kvs - package io.jstach.kiwi.kvs
-
Kiwi Key Value loading system that allows loading of key values from URI-based resources.
- isFlag(KeyValue.Flag) - Method in record class io.jstach.kiwi.kvs.KeyValue
-
Checks if a specific flag is set on this
KeyValue
. - isNoInterpolation() - Method in record class io.jstach.kiwi.kvs.KeyValue
-
Checks if the
KeyValue.Flag.NO_INTERPOLATION
flag is set on thisKeyValue
. - isSensitive() - Method in record class io.jstach.kiwi.kvs.KeyValue
-
Checks if the
KeyValue.Flag.SENSITIVE
flag is set on thisKeyValue
. - isSet(KeyValue) - Method in enum class io.jstach.kiwi.kvs.KeyValue.Flag
-
Checks if this flag is set for the given
KeyValue
. - iterator() - Method in interface io.jstach.kiwi.kvs.KeyValues
K
- key() - Method in record class io.jstach.kiwi.kvs.KeyValue
-
Returns the value of the
key
record component. - KEY_FILT - Static variable in interface io.jstach.kiwi.kvs.KeyValuesResource
-
A synonym for
KeyValuesResource.KEY_FILTER
. - KEY_FILTER - Static variable in interface io.jstach.kiwi.kvs.KeyValuesResource
-
Represents the key for specifying filters to apply to the resource.
- KEY_FLAG - Static variable in interface io.jstach.kiwi.kvs.KeyValuesResource
-
A synonym for
KeyValuesResource.KEY_FLAGS
. - KEY_FLAGS - Static variable in interface io.jstach.kiwi.kvs.KeyValuesResource
-
Represents the key for specifying flags associated with a resource.
- KEY_LOAD - Static variable in interface io.jstach.kiwi.kvs.KeyValuesResource
-
Represents the key for specifying resources to load.
- KEY_MEDIA_TYPE - Static variable in interface io.jstach.kiwi.kvs.KeyValuesResource
-
Represents the key for specifying the media type of a resource.
- KEY_MIME - Static variable in interface io.jstach.kiwi.kvs.KeyValuesResource
-
A synonym for
KeyValuesResource.KEY_MEDIA_TYPE
. - KEY_PARAM - Static variable in interface io.jstach.kiwi.kvs.KeyValuesResource
-
Represents the key for specifying parameters associated with a resource.
- KEY_PARM - Static variable in interface io.jstach.kiwi.kvs.KeyValuesResource
-
A synonym for
KeyValuesResource.KEY_PARAM
. - Key Features: - Search tag in interface io.jstach.kiwi.kvs.KeyValues
- Section
- Key Interfaces and Classes - Search tag in package io.jstach.kiwi.kvs
- Section
- keys() - Method in interface io.jstach.kiwi.kvs.Variables.Parameters
-
Returns an iterable over all keys that this
Parameters
instance knows about. - KeyValue - Search tag in Overview
- Section
- KeyValue - Record Class in io.jstach.kiwi.kvs
-
Represents a key-value pair in the Kiwi configuration system.
- KeyValue(String, String) - Constructor for record class io.jstach.kiwi.kvs.KeyValue
-
Constructs a new
KeyValue
with a raw value, using the provided key and raw value. - KeyValue(String, String, KeyValue.Meta) - Constructor for record class io.jstach.kiwi.kvs.KeyValue
-
Constructs a new
KeyValue
with the given key, expanded value, and associated metadata. - KeyValue.Flag - Enum Class in io.jstach.kiwi.kvs
-
Enumeration representing flags that can modify the behavior of a
KeyValue
. - KeyValue.Meta - Interface in io.jstach.kiwi.kvs
-
Metadata associated with a
KeyValue
. - KeyValue.Source - Record Class in io.jstach.kiwi.kvs
-
Represents the source information for a
KeyValue
. - KeyValues - Interface in io.jstach.kiwi.kvs
-
Represents a collection of
KeyValue
entries with various utility methods for manipulation, transformation, and expansion. - KeyValues.Builder - Class in io.jstach.kiwi.kvs
-
A builder for constructing
KeyValues
instances from key-value pairs. - KeyValuesEnvironment - Search tag in Overview
- Section
- KeyValuesEnvironment - Interface in io.jstach.kiwi.kvs
-
A facade over various system-level singletons used for loading key-value resources.
- KeyValuesEnvironment.Logger - Interface in io.jstach.kiwi.kvs
-
Key Values Resource focused logging facade and event capture.
- KeyValuesEnvironment.ResourceStreamLoader - Interface in io.jstach.kiwi.kvs
-
Interface for loading resources as input streams.
- KeyValuesLoader - Interface in io.jstach.kiwi.kvs
-
Represents a loader responsible for loading
KeyValues
from configured sources. - KeyValuesLoader.Builder - Class in io.jstach.kiwi.kvs
-
A builder class for constructing instances of
KeyValuesLoader
. - KeyValuesMedia - Search tag in Overview
- Section
- KeyValuesMedia - Interface in io.jstach.kiwi.kvs
-
Represents a media type for parsing and formatting key-value pairs.
- KeyValuesMedia.Formatter - Interface in io.jstach.kiwi.kvs
-
A formatter for writing key-value pairs to an output.
- KeyValuesMedia.Parser - Interface in io.jstach.kiwi.kvs
-
A parser for reading key-value pairs from an input source.
- KeyValuesMediaException - Exception Class in io.jstach.kiwi.kvs
-
An exception thrown when an error related to media type handling occurs in the context of key-value parsing or formatting.
- KeyValuesMediaException(String) - Constructor for exception class io.jstach.kiwi.kvs.KeyValuesMediaException
-
Constructs a new
KeyValuesMediaException
with the specified detail message. - KeyValuesMediaException(String, Throwable) - Constructor for exception class io.jstach.kiwi.kvs.KeyValuesMediaException
-
Constructs a new
KeyValuesMediaException
with the specified detail message and cause. - KeyValuesResource - Search tag in Overview
- Section
- KeyValuesResource - Interface in io.jstach.kiwi.kvs
-
Represents a resource that contains key-value pairs to be loaded and processed.
- KeyValuesResource.Builder - Class in io.jstach.kiwi.kvs
-
Builder class for creating instances of
KeyValuesResource
. - KeyValuesServiceProvider - Interface in io.jstach.kiwi.kvs
-
A service provider interface (SPI) for extending Kiwi's capabilities to support additional media types and URI patterns.
- KeyValuesServiceProvider.KeyValuesFilter - Interface in io.jstach.kiwi.kvs
-
A service provider interface (SPI) for filtering key values after a resource is loaded.
- KeyValuesServiceProvider.KeyValuesFilter.Filter - Record Class in io.jstach.kiwi.kvs
-
A filter description with filter identifier and expression which is the DSL code that the filter will parse use to do filtering.
- KeyValuesServiceProvider.KeyValuesFilter.FilterContext - Record Class in io.jstach.kiwi.kvs
-
Provides contextual information to a filter, including the environment and any parameters specified for the filtering operation.
- KeyValuesServiceProvider.KeyValuesLoaderFinder - Interface in io.jstach.kiwi.kvs
-
A service provider interface for finding
KeyValuesLoader
implementations that can handle specificKeyValuesResource
instances. - KeyValuesServiceProvider.KeyValuesLoaderFinder.LoaderContext - Interface in io.jstach.kiwi.kvs
-
A context provided to
KeyValuesServiceProvider.KeyValuesLoaderFinder
implementations to supply necessary dependencies and services for creating aKeyValuesLoader
. - KeyValuesServiceProvider.KeyValuesMediaFinder - Interface in io.jstach.kiwi.kvs
-
A service provider interface for finding
KeyValuesMedia
implementations based on various attributes such as file extensions, media types, and URIs. - KeyValuesSystem - Search tag in Overview
- Section
- KeyValuesSystem - Interface in io.jstach.kiwi.kvs
-
The main entry point into the Kiwi configuration library.
- KeyValuesSystem.Builder - Class in io.jstach.kiwi.kvs
-
A builder class for constructing instances of
KeyValuesSystem
with customizable components such as environment, loaders, and media finders. - KiwiConfig - Interface in io.jstach.kiwi.boot
-
Kiwi Config is tiny opinionated configuration framework modeled after Spring Boot that uses Kiwi KVS system to load key values into a Map.
- KiwiConfig.ReloadableConfig - Interface in io.jstach.kiwi.boot
-
A reloadable config allows reloading but does not guarantee that repeated calls of
KiwiConfig.getProperty(String)
and similar will return the same results. - KiwiConfig.StableConfig - Interface in io.jstach.kiwi.boot
-
A stable config guarantees that repeated calls of
KiwiConfig.getProperty(String)
and similar will return the same result.
L
- last() - Method in interface io.jstach.kiwi.kvs.KeyValues
-
This method gets the last element of the key values stream.
- load() - Method in class io.jstach.kiwi.kvs.KeyValuesLoader.Builder
-
Loads key-values using the current builder configuration.
- load() - Method in interface io.jstach.kiwi.kvs.KeyValuesLoader
-
Loads key-values from configured sources.
- load(KeyValuesResource) - Method in interface io.jstach.kiwi.kvs.KeyValuesEnvironment.Logger
-
Logs a debug message indicating that a resource is being loaded.
- loaded(KeyValuesResource) - Method in interface io.jstach.kiwi.kvs.KeyValuesEnvironment.Logger
-
Logs an info message indicating that a resource has been successfully loaded.
- loader() - Method in interface io.jstach.kiwi.kvs.KeyValuesSystem
-
Creates and returns a
KeyValuesLoader.Builder
for constructing loaders that can load key-value pairs from various resources. - loaderFinder() - Method in interface io.jstach.kiwi.kvs.KeyValuesSystem
-
Returns a composite
KeyValuesServiceProvider.KeyValuesLoaderFinder
that aggregates all loader finders added to theKeyValuesSystem.Builder
or found via theServiceLoader
, if configured. - loadFinder(KeyValuesServiceProvider.KeyValuesLoaderFinder) - Method in class io.jstach.kiwi.kvs.KeyValuesSystem.Builder
-
Adds a
KeyValuesServiceProvider.KeyValuesLoaderFinder
to the list of loader finders.
M
- map(UnaryOperator<KeyValue>) - Method in interface io.jstach.kiwi.kvs.KeyValues
-
Applies a transformation function to each key-value pair in the collection.
- Maven - Search tag in Overview
- Section
- Maven Coordinates - Search tag in module io.jstach.kiwi.kvs
- Section
- mediaFinder() - Method in interface io.jstach.kiwi.kvs.KeyValuesServiceProvider.KeyValuesLoaderFinder.LoaderContext
-
Retrieves the
KeyValuesServiceProvider.KeyValuesMediaFinder
for finding media types. - mediaFinder() - Method in interface io.jstach.kiwi.kvs.KeyValuesSystem
-
Returns a composite
KeyValuesServiceProvider.KeyValuesMediaFinder
that aggregates all media finders added to theKeyValuesSystem.Builder
or found via theServiceLoader
, if configured. - mediaFinder(KeyValuesServiceProvider.KeyValuesMediaFinder) - Method in class io.jstach.kiwi.kvs.KeyValuesSystem.Builder
-
Adds a
KeyValuesServiceProvider.KeyValuesMediaFinder
to the list of media finders. - mediaType() - Method in interface io.jstach.kiwi.kvs.KeyValuesResource
-
Returns the media type of the resource, if specified.
- mediaType(String) - Method in class io.jstach.kiwi.kvs.KeyValuesResource.Builder
-
Sets the media type for the resource.
- memoize() - Method in interface io.jstach.kiwi.kvs.KeyValues
-
Returns a memoized version of this
KeyValues
which means repeated calls to iteratore or stream over the KeyValues will always generate the same result. - meta() - Method in record class io.jstach.kiwi.kvs.KeyValue
-
Returns the value of the
meta
record component. - Method Details - Search tag in interface io.jstach.kiwi.kvs.KeyValuesServiceProvider.KeyValuesFilter
- Section
- missing(KeyValuesResource, FileNotFoundException) - Method in interface io.jstach.kiwi.kvs.KeyValuesEnvironment.Logger
-
Logs a debug message indicating that a resource is missing.
N
- name() - Method in interface io.jstach.kiwi.kvs.KeyValuesResource
-
Returns the name of the resource.
- name() - Method in record class io.jstach.kiwi.kvs.KeyValuesServiceProvider.KeyValuesFilter.Filter
-
Returns the value of the
name
record component. - name(String) - Method in class io.jstach.kiwi.kvs.KeyValuesResource.Builder
-
Sets the name for the resource.
- NO_INTERPOLATION - Enum constant in enum class io.jstach.kiwi.kvs.KeyValue.Flag
-
Indicates that the key-value pair should not undergo any interpolation or variable substitution.
- noAddKeyValues(boolean) - Method in class io.jstach.kiwi.kvs.KeyValuesResource.Builder
-
Sets or clears the
LoadFlag.NO_ADD
flag. - noInterpolation(boolean) - Method in class io.jstach.kiwi.kvs.KeyValuesResource.Builder
-
Sets or clears the
LoadFlag.NO_INTERPOLATE
flag. - noRequire(boolean) - Method in class io.jstach.kiwi.kvs.KeyValuesResource.Builder
-
Marks the resource as not required.
- NULL_URI - Static variable in record class io.jstach.kiwi.kvs.KeyValue.Source
-
A constant representing a "null" URI for cases where the source is not specified.
O
- of() - Static method in interface io.jstach.kiwi.boot.KiwiConfig
-
Gets the global config singleton.
- of() - Static method in interface io.jstach.kiwi.kvs.KeyValuesEnvironment.Logger
-
By default Kiwi does no logging because logging usually needs configuration loaded first (kiwi in this case).
- of(KeyValue) - Static method in interface io.jstach.kiwi.kvs.KeyValues
-
Creates a single key values instance.
- of(String, String, KeyValue.Source, Set<KeyValue.Flag>) - Static method in interface io.jstach.kiwi.kvs.KeyValue.Meta
-
Factory method to create a new
Meta
instance with the specified raw value, source, and flags. - of(System.Logger) - Static method in interface io.jstach.kiwi.kvs.KeyValuesEnvironment.Logger
-
Returns a logger that uses the supplied
System.Logger
. - of(Map<String, String>) - Static method in interface io.jstach.kiwi.kvs.Variables.Parameters
-
Creates a
Parameters
instance from a provided map. - ofProperties() - Static method in interface io.jstach.kiwi.kvs.KeyValuesMedia
-
Returns a
KeyValuesMedia
instance for theProperties
format however unlike normalProperties
order of the properties key values is maintained based on the order parsed. - ofSystemEnv(KeyValuesEnvironment) - Static method in interface io.jstach.kiwi.kvs.Variables
-
Creates variables from system environment variables.
- ofSystemProperties(KeyValuesEnvironment) - Static method in interface io.jstach.kiwi.kvs.Variables
-
Creates variables from system properties.
- ofUrlEncoded() - Static method in interface io.jstach.kiwi.kvs.KeyValuesMedia
-
Returns a
KeyValuesMedia
instance for the URL-encoded format. - openStream(String) - Method in interface io.jstach.kiwi.kvs.KeyValuesEnvironment.ResourceStreamLoader
-
Opens an input stream for the specified resource path.
- originalKey() - Method in interface io.jstach.kiwi.kvs.KeyValue.Meta
-
The original key that was collected on the source.
P
- parameter(String, String) - Method in class io.jstach.kiwi.kvs.KeyValuesResource.Builder
-
Adds a parameter key-value pair to the resource.
- parameters() - Method in interface io.jstach.kiwi.kvs.KeyValuesResource
-
Returns the parameters associated with the resource.
- parameters() - Method in record class io.jstach.kiwi.kvs.KeyValuesServiceProvider.KeyValuesFilter.FilterContext
-
Returns the value of the
parameters
record component. - parse(KeyValuesResource, InputStream) - Method in interface io.jstach.kiwi.kvs.KeyValuesMedia.Parser
-
Parses key-value pairs from an input stream and associates them with a given resource.
- parse(InputStream, BiConsumer<String, String>) - Method in interface io.jstach.kiwi.kvs.KeyValuesMedia.Parser
-
Parses key-value pairs from an input stream and applies them to a consumer.
- parse(String) - Method in interface io.jstach.kiwi.kvs.KeyValuesMedia.Parser
-
Parses key-value pairs from a string and returns a
KeyValues
instance. - parse(String, BiConsumer<String, String>) - Method in interface io.jstach.kiwi.kvs.KeyValuesMedia.Parser
-
Parses key-value pairs from a string and applies them to a consumer.
- parser() - Method in interface io.jstach.kiwi.kvs.KeyValuesMedia
-
Returns a
KeyValuesMedia.Parser
for parsing key-value pairs from an input stream. - Project Information - Search tag in Overview
- Section
R
- raw() - Method in interface io.jstach.kiwi.kvs.KeyValue.Meta
-
Retrieves the raw, unexpanded value associated with the
KeyValue
. - raw() - Method in record class io.jstach.kiwi.kvs.KeyValue
-
Gets the original raw value before any interpolation.
- redact() - Method in record class io.jstach.kiwi.kvs.KeyValue
-
Redacts the sensitive value in this key-value pair by replacing it with a default message.
- redact() - Method in interface io.jstach.kiwi.kvs.KeyValues
-
Redacts sensitive key-value entries by replacing their values.
- redact(String) - Method in record class io.jstach.kiwi.kvs.KeyValue
-
Redacts the sensitive value in this key-value pair by replacing it with a custom message.
- REDACTED_MESSAGE - Static variable in record class io.jstach.kiwi.kvs.KeyValue
- reference() - Method in record class io.jstach.kiwi.kvs.KeyValue.Source
-
Returns the value of the
reference
record component. - reference() - Method in interface io.jstach.kiwi.kvs.KeyValuesResource
-
Returns the
KeyValue
that references this resource, if any. - reload() - Method in interface io.jstach.kiwi.boot.KiwiConfig.ReloadableConfig
-
Will reload the config and return the previous config.
- renameKey(Function<String, String>) - Method in interface io.jstach.kiwi.kvs.Variables
-
Applies functional composition to rename key while retrieving value this variables.
- Requirements - Search tag in Overview
- Section
- requireParser(KeyValuesResource) - Method in interface io.jstach.kiwi.kvs.KeyValuesServiceProvider.KeyValuesLoaderFinder.LoaderContext
-
Finds and returns a required parser for the specified
KeyValuesResource
. - Resource Configuration in Resource - Search tag in Overview
- Section
- Resource Configuration in URI - Search tag in Overview
- Section
- Resource Filters - Search tag in Overview
- Section
- Resource Flags - Search tag in Overview
- Section
- Resource Key Value Configuration - Search tag in Overview
- Section
- Resource Loading - Search tag in Overview
- Section
- Resource Media Type - Search tag in Overview
- Section
S
- sed - Search tag in interface io.jstach.kiwi.kvs.KeyValuesServiceProvider.KeyValuesFilter
- Section
- sensitive(boolean) - Method in class io.jstach.kiwi.kvs.KeyValuesResource.Builder
-
Marks the resource as sensitive, meaning its values should not be printed.
- SENSITIVE - Enum constant in enum class io.jstach.kiwi.kvs.KeyValue.Flag
-
Marks the key-value as containing sensitive information.
- serviceLoader(ServiceLoader<KeyValuesServiceProvider>) - Method in class io.jstach.kiwi.kvs.KeyValuesSystem.Builder
-
Sets the
ServiceLoader
for loadingKeyValuesServiceProvider
implementations. - setDefaultProperties(Map<String, String>) - Static method in interface io.jstach.kiwi.boot.KiwiConfig
-
Set default properties which will be used in addition to those in the found on loading.
- source() - Method in interface io.jstach.kiwi.kvs.KeyValue.Meta
-
Returns the source from which the key-value pair was loaded.
- Source() - Constructor for record class io.jstach.kiwi.kvs.KeyValue.Source
-
Creates an empty source.
- Source(URI, KeyValue, int) - Constructor for record class io.jstach.kiwi.kvs.KeyValue.Source
-
Creates an instance of a
Source
record class. - stableConfig() - Method in interface io.jstach.kiwi.boot.KiwiConfig.ReloadableConfig
-
The current backing stable config (might be generated).
- start.properties - Search tag in module io.jstach.kiwi.kvs
- Section
- stream() - Method in interface io.jstach.kiwi.kvs.KeyValues
-
Returns a stream of the contained
KeyValue
entries.
T
- Technical Details - Search tag in module io.jstach.kiwi.kvs
- Section
- Technical Details - Search tag in package io.jstach.kiwi.kvs
- Section
- toBuilder() - Method in interface io.jstach.kiwi.kvs.KeyValuesResource
-
Creates a builder based on the current state of this
KeyValuesResource
. - toMap() - Method in interface io.jstach.kiwi.boot.KiwiConfig.StableConfig
-
Generates a map from the config.
- toMap() - Method in interface io.jstach.kiwi.kvs.KeyValues
-
Converts the key-values to a map where each key maps to its expanded value.
- toString() - Method in record class io.jstach.kiwi.kvs.KeyValue.Source
-
Returns a string representation of this record class.
- toString() - Method in record class io.jstach.kiwi.kvs.KeyValue
-
Returns a string representation of this record class.
- toString() - Method in class io.jstach.kiwi.kvs.KeyValuesResource.Builder
- toString() - Method in record class io.jstach.kiwi.kvs.KeyValuesServiceProvider.KeyValuesFilter.Filter
-
Returns a string representation of this record class.
- toString() - Method in record class io.jstach.kiwi.kvs.KeyValuesServiceProvider.KeyValuesFilter.FilterContext
-
Returns a string representation of this record class.
U
- uri() - Method in record class io.jstach.kiwi.kvs.KeyValue.Source
-
Returns the value of the
uri
record component. - uri() - Method in interface io.jstach.kiwi.kvs.KeyValuesResource
-
Returns the URI of the resource.
- uri(URI) - Method in class io.jstach.kiwi.kvs.KeyValuesResource.Builder
-
Sets the URI for the resource.
- URI schema: env, system, cmd - Search tag in Overview
- Section
- URI schema: profile. - Search tag in Overview
- Section
- URI schema: stdin - Search tag in Overview
- Section
- Usage - Search tag in interface io.jstach.kiwi.kvs.KeyValuesServiceProvider.KeyValuesFilter
- Section
- Usage Example: - Search tag in class io.jstach.kiwi.kvs.KeyValues.Builder
- Section
- Usage Example: - Search tag in interface io.jstach.kiwi.kvs.KeyValues
- Section
- Usage Example: - Search tag in record class io.jstach.kiwi.kvs.KeyValue.Source
- Section
- user.properties - Search tag in module io.jstach.kiwi.kvs
- Section
- User Guide - Search tag in Overview
- Section
- useServiceLoader() - Method in class io.jstach.kiwi.kvs.KeyValuesSystem.Builder
-
Uses the default service loader to load extensions.
V
- value() - Method in record class io.jstach.kiwi.kvs.KeyValue
-
Gets the expanded value after interpolation.
- valueOf(String) - Static method in enum class io.jstach.kiwi.kvs.KeyValue.Flag
-
Returns the enum constant of this class with the specified name.
- values() - Static method in enum class io.jstach.kiwi.kvs.KeyValue.Flag
-
Returns an array containing the constants of this enum class, in the order they are declared.
- variables() - Method in interface io.jstach.kiwi.kvs.KeyValuesServiceProvider.KeyValuesLoaderFinder.LoaderContext
-
Retrieves the
Variables
used for interpolation. - variables(Function<KeyValuesEnvironment, Variables>) - Method in class io.jstach.kiwi.kvs.KeyValuesLoader.Builder
-
Adds variables that will be resolved based on the environment.
- Variables - Interface in io.jstach.kiwi.kvs
-
Represents a mapping function that associates a key to a value, typically used for variable resolution during interpolation.
- Variables.Builder - Class in io.jstach.kiwi.kvs
-
A builder class for creating composite
Variables
instances by combining multiple sources of key-to-value mappings. - Variables.Parameters - Interface in io.jstach.kiwi.kvs
-
Represents a specialized
Variables
interface that can list all keys it knows about.
W
- warn(String) - Method in interface io.jstach.kiwi.kvs.KeyValuesEnvironment.Logger
-
Logs an warn-level message.
- Why and Use Case - Search tag in Overview
- Section
- withExpanded(String) - Method in record class io.jstach.kiwi.kvs.KeyValue
-
Creates a new
KeyValue
with an updated expanded value. - withExpanded(Function<String, String>) - Method in record class io.jstach.kiwi.kvs.KeyValue
-
Returns a new
KeyValue
instance with its value expanded using the provided function. - withFlags(Collection<KeyValue.Flag>) - Method in interface io.jstach.kiwi.kvs.KeyValue.Meta
-
Creates a new
Meta
instance with the specified flags. - withKey(String) - Method in record class io.jstach.kiwi.kvs.KeyValue
-
Creates a new KeyValue with an updated key.
- withSource(KeyValue.Source) - Method in interface io.jstach.kiwi.kvs.KeyValue.Meta
-
Creates a new
Meta
instance with the specified source.
All Classes and Interfaces|All Packages|Constant Field Values|Serialized Form