Package one.microstream.configuration.types

Interface ConfigurationLoader

All Known Implementing Classes:

ConfigurationLoader.FileLoader, ConfigurationLoader.InputStreamLoader, ConfigurationLoader.PathLoader, ConfigurationLoader.UrlLoader

Functional Interface:

This is a functional interface and can therefore be used as the assignment target for a lambda expression or method reference.

@FunctionalInterface
public interface ConfigurationLoader

Loader for external configuration resources.

Supported resource types:

• Path
• File
• URL
• InputStream

See Also:

Configuration.Builder.load(ConfigurationLoader, ConfigurationParser)

Nested Class Summary

Nested Classes

Modifier and Type	Interface	Description
static interface	ConfigurationLoader.Defaults
static class	ConfigurationLoader.FileLoader
static class	ConfigurationLoader.InputStreamLoader
static class	ConfigurationLoader.PathLoader
static class	ConfigurationLoader.UrlLoader

Method Summary

Modifier and Type	Method	Description
String	loadConfiguration()	Loads the configuration from the given resource.
static ConfigurationLoader	New(File file)	Tries to load the configuration from file.
static ConfigurationLoader	New(File file, Charset charset)	Tries to load the configuration from file.
static ConfigurationLoader	New(InputStream inputStream)	Tries to load the configuration from the InputStream inputStream.
static ConfigurationLoader	New(InputStream inputStream, Charset charset)	Tries to load the configuration from the InputStream inputStream.
static ConfigurationLoader	New(String path)	Loads the configuration from the given resource.
static ConfigurationLoader	New(String path, Charset charset)	Loads the configuration from the given resource.
static ConfigurationLoader	New(URL url)	Tries to load the configuration from the URL url.
static ConfigurationLoader	New(URL url, Charset charset)	Tries to load the configuration from the URL url.
static ConfigurationLoader	New(Path path)	Tries to load the configuration from path.
static ConfigurationLoader	New(Path path, Charset charset)	Tries to load the configuration from path.

Method Details

loadConfiguration

String loadConfiguration()

Loads the configuration from the given resource.

Returns:

the configuration resource's content.

Throws:

ConfigurationException - if an error occurs while loading the resource

New

static ConfigurationLoader New(String path)

Loads the configuration from the given resource.

The load order is as follows:

• The classpath
• As an URL
• As a file

Parameters:

path - a classpath resource, a file path or an URL

Returns:

the configuration resource's content.

Throws:

ConfigurationExceptionNoConfigurationFound - if no configuration can be found at the given path

New

static ConfigurationLoader New(String path, Charset charset)

Loads the configuration from the given resource.

The load order is as follows:

• The classpath
• As an URL
• As a file

Parameters:

path - a classpath resource, a file path or an URL

charset - the charset used to load the configuration

Returns:

the configuration resource's content.

Throws:

ConfigurationExceptionNoConfigurationFound - if no configuration can be found at the given path

New

static ConfigurationLoader New(Path path)

Tries to load the configuration from path.

Parameters:

path - file system path

Returns:

the configuration

Throws:

ConfigurationException - if the configuration couldn't be loaded

New

static ConfigurationLoader New(Path path, Charset charset)

Tries to load the configuration from path.

Parameters:

path - file system path

charset - the charset used to load the configuration

Returns:

the configuration

Throws:

ConfigurationException - if the configuration couldn't be loaded

New

static ConfigurationLoader New(File file)

Tries to load the configuration from file.

Parameters:

file - file path

Returns:

the configuration

Throws:

ConfigurationException - if the configuration couldn't be loaded

New

static ConfigurationLoader New(File file, Charset charset)

Tries to load the configuration from file.

Parameters:

file - file path

charset - the charset used to load the configuration

Returns:

the configuration

Throws:

ConfigurationException - if the configuration couldn't be loaded

New

static ConfigurationLoader New(URL url)

Tries to load the configuration from the URL url.

Parameters:

url - URL path

Returns:

the configuration

Throws:

ConfigurationException - if the configuration couldn't be loaded

New

static ConfigurationLoader New(URL url, Charset charset)

Tries to load the configuration from the URL url.

Parameters:

url - URL path

charset - the charset used to load the configuration

Returns:

the configuration

Throws:

ConfigurationException - if the configuration couldn't be loaded

New

static ConfigurationLoader New(InputStream inputStream)

Tries to load the configuration from the InputStream inputStream.

Parameters:

inputStream - the stream to read from

Returns:

the configuration

Throws:

ConfigurationException - if the configuration couldn't be loaded

New

static ConfigurationLoader New(InputStream inputStream, Charset charset)

Tries to load the configuration from the InputStream inputStream.

Parameters:

inputStream - the stream to read from

charset - the charset used to load the configuration

Returns:

the configuration

Throws:

ConfigurationException - if the configuration couldn't be loaded