com.neeve.ods
Class StorePersisterDescriptor

java.lang.Object
  com.neeve.root.RootObject
      com.neeve.ods.OdsObject
          com.neeve.ods.StorePersisterDescriptor

public final class StorePersisterDescriptor
extends OdsObject

Describes a store persister.

This class contains information used to describe a store persister. It is intended for use by a user when creating store persisters.

Threading:

This class is not thread safe.

Method Summary

static StorePersisterDescriptor	create(String name, String className) Create a default persister descriptor.
void	delete() Delete a persister descriptor from the default configuration repository.
void	delete(IConfigRepository repo) Delete a persister descriptor from the configuration repository.
static boolean	exists(IConfigRepository repo, String name) Checks if a persister is configured in a configuration repository
static boolean	exists(String name) Checks if a persister is configured in the default configuration repository
String	getClassName() Get the name of the main class of the persister that this descriptor describes.
String	getName() Get the name of the persister that this descriptor describes.
Properties	getProperties() Get the app properties
String	getProperty(String name) Get a persister property.
static StorePersisterDescriptor	load(IConfigRepository repo, String name) Create a persister descriptor from a configuration respository.
static StorePersisterDescriptor	load(String name) Create a persister descriptor from the default configuration respository.
static Set<StorePersisterDescriptor>	loadAll() Create persister descriptors for all persisters configured in the default configuration repository.
static Set<StorePersisterDescriptor>	loadAll(IConfigRepository repo) Create persister descriptors for all persisters in a configuration repository.
void	save() Save a persister descriptor to the default configuration repository.
void	save(IConfigRepository repo) Save a persister descriptor to a configuration repository.
Properties	save(Properties props) Save a persister descriptor to a property table.
StorePersisterDescriptor	setProperties(Properties props) Set a set of persister properties.
StorePersisterDescriptor	setProperty(String name, String val) Set a persister property.
String	toString() Returns a string representation of this object

Methods inherited from class com.neeve.root.RootObject

getChecked, getThreaded, getTracer, setChecked, setTracer

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Method Detail

getName

public final String getName()

Get the name of the persister that this descriptor describes.

getClassName

public final String getClassName()

Get the name of the main class of the persister that this descriptor describes.

setProperty

public final StorePersisterDescriptor setProperty(String name,
                                                  String val)

Set a persister property.

Returns:

Returns this object for invocation chaining.

Threading:

This method is safe for concurrent access by multiple threads.

getProperty

public final String getProperty(String name)

Get a persister property.

Threading:

This method is safe for concurrent access by multiple threads.

setProperties

public final StorePersisterDescriptor setProperties(Properties props)

Set a set of persister properties.

Returns:

Returns this object for invocation chaining.

Threading:

This method is safe for concurrent access by multiple threads.

getProperties

public final Properties getProperties()

Get the app properties

Threading:

This method is safe for concurrent access by multiple threads.

save

public final Properties save(Properties props)

Save a persister descriptor to a property table.

Parameters:

props - The property table.

Throws:

IllegalArgumentException - If the properties are null

Threading:

This method is notsafe for concurrent access by multiple threads.

save

public final void save(IConfigRepository repo)
                throws OdsException

Save a persister descriptor to a configuration repository.

Parameters:

repo - The root directory of the configuration respository.

Throws:

OdsException - Thrown in case an error in encountered during the saving of the descriptor.

Threading:

This method is notsafe for concurrent access by multiple threads.

This method saves a persister descriptor to a configuration repository. The descriptor is saved in a format suitable for loading subsequently using any of the load methods offered by this class.

save

public final void save()
                throws OdsException

Save a persister descriptor to the default configuration repository.

Throws:

OdsException

Threading:

This method is notsafe for concurrent access by multiple threads.

This method saves a persister descriptor to the default confiiguration respository. The descriptor is saved in a format suitable for loading subsequently using any of the load methods offered in this class.

delete

public final void delete(IConfigRepository repo)
                  throws OdsException

Delete a persister descriptor from the configuration repository.

Parameters:

repo - The configuration respository to delete the descriptor from.

Throws:

OdsException - Thrown in case an error in encountered during the deletion of the descriptor.

Threading:

This method is notsafe for concurrent access by multiple threads.

This method deletes a persister descriptor from a configuration repository.

delete

public final void delete()
                  throws OdsException

Delete a persister descriptor from the default configuration repository.

Throws:

OdsException - Thrown in case an error in encountered during the deletion of the descriptor.

Threading:

This method is notsafe for concurrent access by multiple threads.

This method permanently deletes a persister descriptor from the default configuration repository.

create

public static StorePersisterDescriptor create(String name,
                                              String className)

Create a default persister descriptor.

Parameters:

name - The name of the persister whose descriptor is to be prepared.

className - The name of the persister's main class

Threading:

This method is safe for concurrent access by multiple threads.

exists

public static boolean exists(IConfigRepository repo,
                             String name)

Checks if a persister is configured in a configuration repository

Parameters:

repo - The configuration respository to check in.

name - The name of the persister to check for.

Threading:

This method is safe for concurrent access by multiple threads.

exists

public static boolean exists(String name)

Checks if a persister is configured in the default configuration repository

Parameters:

name - The name of the persister to check for.

Threading:

This method is safe for concurrent access by multiple threads.

load

public static StorePersisterDescriptor load(IConfigRepository repo,
                                            String name)
                                     throws OdsException

Create a persister descriptor from a configuration respository.

Parameters:

repo - The configuration repository from where to load the descriptor.

name - The name of the persister whose descriptor is to be prepared.

Throws:

OdsException

Threading:

This method is safe for concurrent access by multiple threads.

load

public static StorePersisterDescriptor load(String name)
                                     throws OdsException

Create a persister descriptor from the default configuration respository.

Parameters:

name - The name of the persister whose descriptor is to be prepared.

Throws:

OdsException

Threading:

This method is safe for concurrent access by multiple threads.

loadAll

public static Set<StorePersisterDescriptor> loadAll(IConfigRepository repo)
                                             throws OdsException

Create persister descriptors for all persisters in a configuration repository.

Parameters:

repo - The configuration respository from where to create the persisters.

Returns:

Returns the set of persister descriptors.

This method creates and initializes persister descriptors for each of the persisters configured in a configuration repository.

Throws:

OdsException

Threading:

This method is safe for concurrent access by multiple threads.

loadAll

public static Set<StorePersisterDescriptor> loadAll()
                                             throws OdsException

Create persister descriptors for all persisters configured in the default configuration repository.

Returns:

Returns the set of persister descriptors.

This method creates and initializes persisters descriptors for all the persisters configured in the default configuration repository.

Throws:

OdsException

Threading:

This method is safe for concurrent access by multiple threads.

toString

public final String toString()

Returns a string representation of this object

Overrides:

toString in class Object