Package org.apache.juneau.config.store

Class MemoryStore

java.lang.Object

org.apache.juneau.Context

org.apache.juneau.config.store.ConfigStore

org.apache.juneau.config.store.MemoryStore

All Implemented Interfaces:

Closeable, AutoCloseable

public class MemoryStore
extends ConfigStore

Filesystem-based storage location for configuration files.

Points to a file system directory containing configuration files.

Notes:

• This class is thread safe and reusable.

Nested Class Summary

Nested Classes

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

Field Summary

Fields

Modifier and Type	Field	Description
static final MemoryStore	DEFAULT	Default memory store, all default values.

Fields inherited from class org.apache.juneau.Context

CONTEXT_APPLY_FILTER

Constructor Summary

Constructors

Constructor	Description
MemoryStore(MemoryStore.Builder builder)	Constructor.

Method Summary

Modifier and Type	Method	Description
void	close()	No-op.
MemoryStore.Builder	copy()	Creates a builder from this context object.
static MemoryStore.Builder	create()	Creates a new builder for this object.
boolean	exists(String name)	Checks whether the configuration with the specified name exists in this store.
String	read(String name)	Returns the contents of the configuration file.
MemoryStore	update(String name, String newContents)	Called when the physical contents of a config file have changed.
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.config.store.ConfigStore

getMap, properties, register, resolveName, unregister, update

Methods inherited from class org.apache.juneau.Context

createBuilder, createSession, getAnnotationProvider, getSession, init, isDebug, toString

Methods inherited from class java.lang.Object

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

Field Details

DEFAULT

public static final MemoryStore DEFAULT

Default memory store, all default values.

Constructor Details

MemoryStore

public MemoryStore(MemoryStore.Builder builder)

Constructor.

Parameters:

builder - The builder for this object.

Method Details

create

public static MemoryStore.Builder create()

Creates a new builder for this object.

Returns:

A new builder.

close

public void close()
           throws IOException

No-op.

Throws:

IOException

copy

public MemoryStore.Builder copy()

Description copied from class: Context

Creates a builder from this context object.

Builders are used to define new contexts (e.g. serializers, parsers) based on existing configurations.

Overrides:

copy in class Context

Returns:

A new Builder object.

exists

public boolean exists(String name)

Description copied from class: ConfigStore

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

Specified by:

exists in class ConfigStore

Parameters:

name - The config name.

Returns:

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

read

public String read(String name)

Description copied from class: ConfigStore

Returns the contents of the configuration file.

Specified by:

read in class ConfigStore

Parameters:

name - The config file name.

Returns:

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

update

public MemoryStore update(String name,
 String newContents)

Description copied from class: ConfigStore

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

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

Overrides:

update in class ConfigStore

Parameters:

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

newContents - The new contents.

Returns:

This object.

write

public String write(String name,
 String expectedContents,
 String newContents)

Description copied from class: ConfigStore

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

Specified by:

write in class ConfigStore

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.