Package org.apache.juneau.config.store

Class ConfigStore

java.lang.Object

org.apache.juneau.Context

org.apache.juneau.config.store.ConfigStore

All Implemented Interfaces:

Closeable, AutoCloseable, AnnotationProvider

Direct Known Subclasses:

ClasspathStore, FileStore, MemoryStore, SqlStore

public abstract class ConfigStore
extends Context
implements Closeable

Represents a storage location for configuration files.

Content stores require two methods to be implemented:

• read(String) - Retrieve a config file.
• write(String,String,String) - ConfigStore a config file.

Notes:

• This class is thread safe and reusable.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	ConfigStore.Builder	Builder class.

Field Summary

Fields inherited from class org.apache.juneau.Context

CONTEXT_APPLY_FILTER

Fields inherited from interface org.apache.juneau.AnnotationProvider

DEFAULT, DISABLE_ANNOTATION_CACHING

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	ConfigStore(ConfigStore.Builder builder)	Constructor.

Method Summary

Modifier and Type	Method	Description
abstract boolean	exists(String name)	Checks whether the configuration with the specified name exists in this store.
ConfigMap	getMap(String name)	Returns a map file containing the parsed contents of a configuration.
abstract String	read(String name)	Returns the contents of the configuration file.
ConfigStore	register(String name, ConfigStoreListener l)	Registers a new listener on this store.
protected String	resolveName(String name)	Subclasses can override this method to convert config names to internal forms.
ConfigStore	unregister(String name, ConfigStoreListener l)	Unregisters a listener from this store.
ConfigStore	update(String name, String contents)	Called when the physical contents of a config file have changed.
ConfigStore	update(String name, String... contentLines)	Convenience method for updating the contents of a file with lines.
abstract String	write(String name, String expectedContents, String newContents)	Saves the contents of the configuration file if the underlying storage hasn't been modified.

Methods inherited from class org.apache.juneau.Context

copy, createBuilder, createSession, firstAnnotation, firstAnnotation, firstAnnotation, firstAnnotation, firstDeclaredAnnotation, forEachAnnotation, forEachAnnotation, forEachAnnotation, forEachAnnotation, forEachDeclaredAnnotation, getSession, hasAnnotation, hasAnnotation, hasAnnotation, hasAnnotation, init, isDebug, lastAnnotation, lastAnnotation, lastAnnotation, lastAnnotation, lastDeclaredAnnotation, properties, toString

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.io.Closeable

close

Constructor Details

ConfigStore

protected ConfigStore(ConfigStore.Builder builder)

Constructor.

Parameters:

builder - The builder for this object.

Method Details

read

public abstract String read(String name)
                     throws IOException

Returns the contents of the configuration file.

Parameters:

name - The config file name.

Returns:

The contents of the configuration file.
A blank string if the config does not exist.
Never null.

Throws:

IOException - Thrown by underlying stream.

write

public abstract String write(String name,
 String expectedContents,
 String newContents)
                      throws IOException

Saves the contents of the configuration file if the underlying storage hasn't been modified.

Parameters:

name - The config file name.

expectedContents - The expected contents of the file.

newContents - The new contents.

Returns:

If null, then we successfully stored the contents of the file.
Otherwise the contents of the file have changed and we return the new contents of the file.

Throws:

IOException - Thrown by underlying stream.

exists

public abstract boolean exists(String name)

Checks whether the configuration with the specified name exists in this store.

Parameters:

name - The config name.

Returns:

true if the configuration with the specified name exists in this store.

register

public ConfigStore register(String name,
 ConfigStoreListener l)

Registers a new listener on this store.

Parameters:

name - The configuration name to listen for.

l - The new listener.

Returns:

This object.

unregister

public ConfigStore unregister(String name,
 ConfigStoreListener l)

Unregisters a listener from this store.

Parameters:

name - The configuration name to listen for.

l - The listener to unregister.

Returns:

This object.

getMap

public ConfigMap getMap(String name)
                 throws IOException

Returns a map file containing the parsed contents of a configuration.

Parameters:

name - The configuration name.

Returns:

The parsed configuration.
Never null.

Throws:

IOException - Thrown by underlying stream.

update

public ConfigStore update(String name,
 String contents)

Called when the physical contents of a config file have changed.

Triggers calls to ConfigStoreListener.onChange(String) on all registered listeners.

Parameters:

name - The config name (e.g. the filename without the extension).

contents - The new contents.

Returns:

This object.

update

public ConfigStore update(String name,
 String... contentLines)

Convenience method for updating the contents of a file with lines.

Parameters:

name - The config name (e.g. the filename without the extension).

contentLines - The new contents.

Returns:

This object.

resolveName

protected String resolveName(String name)

Subclasses can override this method to convert config names to internal forms.

For example, the FileStore class can take in both "MyConfig" and "MyConfig.cfg" as names that both resolve to "MyConfig.cfg".

Parameters:

name - The name to resolve.

Returns:

The resolved name.