net.java.sip.communicator.impl.configuration
Class DatabaseConfigurationStore

java.lang.Object
  net.java.sip.communicator.impl.configuration.HashtableConfigurationStore<Hashtable>
      net.java.sip.communicator.impl.configuration.DatabaseConfigurationStore

All Implemented Interfaces:

ConfigurationStore

public abstract class DatabaseConfigurationStore
extends HashtableConfigurationStore<Hashtable>

Author:

Lyubomir Marinov

Field Summary

Fields inherited from class net.java.sip.communicator.impl.configuration.HashtableConfigurationStore

properties

Constructor Summary

protected	DatabaseConfigurationStore() Initializes a new DatabaseConfigurationStore instance.
protected	DatabaseConfigurationStore(Hashtable properties) Initializes a new DatabaseConfigurationStore instance with a specific runtime Hashtable storage.

Method Summary

protected abstract void	reloadConfiguration() Removes all property name-value associations currently present in this ConfigurationStore instance and deserializes new property name-value associations from its underlying database (storage).
void	reloadConfiguration(File file) Removes all property name-value associations currently present in this ConfigurationStore and deserializes new property name-value associations from a specific File which presumably is in the format represented by this instance.
protected void	storeConfiguration() Stores/serializes the property name-value associations currently present in this ConfigurationStore instance into its underlying database (storage).
void	storeConfiguration(OutputStream out) Stores/serializes the property name-value associations currently present in this ConfigurationStore into a specific OutputStream in the format represented by this instance.

Methods inherited from class net.java.sip.communicator.impl.configuration.HashtableConfigurationStore

getProperty, getPropertyNames, isSystemProperty, removeProperty, setNonSystemProperty, setSystemProperty

Methods inherited from class java.lang.Object

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

Constructor Detail

DatabaseConfigurationStore

protected DatabaseConfigurationStore()

Initializes a new DatabaseConfigurationStore instance.

DatabaseConfigurationStore

protected DatabaseConfigurationStore(Hashtable properties)

Initializes a new DatabaseConfigurationStore instance with a specific runtime Hashtable storage.

Parameters:

properties - the Hashtable which is to become the runtime storage of the new instance

Method Detail

reloadConfiguration

protected abstract void reloadConfiguration()
                                     throws IOException

Removes all property name-value associations currently present in this ConfigurationStore instance and deserializes new property name-value associations from its underlying database (storage).

Throws:

IOException - if there is an input error while reading from the underlying database (storage)

reloadConfiguration

public void reloadConfiguration(File file)
                         throws IOException,
                                XMLException

Removes all property name-value associations currently present in this ConfigurationStore and deserializes new property name-value associations from a specific File which presumably is in the format represented by this instance.

Parameters:

file - the File to be read and to deserialize new property name-value associations from into this instance

Throws:

IOException - if there is an input error while reading from the specified file

XMLException - if parsing the contents of the specified file fails

See Also:

ConfigurationStore.reloadConfiguration(File)

storeConfiguration

protected void storeConfiguration()
                           throws IOException

Stores/serializes the property name-value associations currently present in this ConfigurationStore instance into its underlying database (storage).

Throws:

IOException - if there is an output error while storing the properties managed by this ConfigurationStore instance into its underlying database (storage)

storeConfiguration

public void storeConfiguration(OutputStream out)
                        throws IOException

Stores/serializes the property name-value associations currently present in this ConfigurationStore into a specific OutputStream in the format represented by this instance.

Parameters:

out - the OutputStream to receive the serialized form of the property name-value associations currently present in this ConfigurationStore

Throws:

IOException - if there is an output error while storing the properties managed by this ConfigurationStore into the specified file

See Also:

ConfigurationStore.storeConfiguration(OutputStream)