globals.parameter

Class AbstractDatabaseParameter

java.lang.Object

util.PropertyContainer

util.PropertyResources

globals.parameter.AbstractParameter

globals.parameter.AbstractDatabaseParameter

All Implemented Interfaces:

Parameter, Cloneable, ExitCleaning, Initializable, PropertySupplying, ResourceSupplying

Direct Known Subclasses:

AbstractDatabaseValue

public abstract class AbstractDatabaseParameter
extends AbstractParameter

An abstract implementation of a parameter that connects to a database. It composes with a GenericSql object, which connects on init. Each query to the parameter via the get() and set(java.lang.Object) method first checks if the connections is open, if it was closed unexpectedely and the KEY_ALLOWREOPEN property points to true, its is opened again. If successful, the abstract methods getFromOpenDatabase(mysql.SqlAccess) or setIntoOpenDatabase(mysql.SqlAccess, java.lang.Object) methods are called.

Nested Class Summary

Nested classes/interfaces inherited from class util.PropertyResources

PropertyResources.Load, PropertyResources.URLResource

Field Summary

Fields

Modifier and Type	Field and Description
private SqlAccess	db My SQL instance.
private static boolean	DEFALLOWREOPEN The key to the unique trigger name.
static String	KEY_ALLOWREOPEN The key to the unique trigger name.

Fields inherited from class globals.parameter.AbstractParameter

KEY_FORMAT, KEY_NAME, KEY_PRESERVE, UNKNOWN

Fields inherited from class util.PropertyResources

KEY_NOINITONCREATE, POSTFIX_ALPHABET, POSTFIX_BYTES, POSTFIX_DIR, POSTFIX_EXT, POSTFIX_FILE, POSTFIX_LIST, POSTFIX_MODTIME, POSTFIX_URL

Fields inherited from class util.PropertyContainer

KEY_LISTSEPARATOR, KEY_MAPKEYVALUECHAR, KEY_MAPSEPARATOR

Fields inherited from interface util.PropertySupplying

CONFIG, KEY_CLASS

Fields inherited from interface util.ResourceSupplying

KEY_URLRESOURCES, KEY_URLUSECONFIG, KEY_URLUSECURRENT, KEY_URLUSEHOME

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	AbstractDatabaseParameter(Map<String,String> prop) Constructs a new database parameter.

Method Summary

Modifier and Type	Method and Description
void	exit() On exit, we close the database, if we are open.
Object	get() Gets the parameter from the database.
protected abstract Object	getFromOpenDatabase(SqlAccess db) This method is called if the database is ready for data retrieval.
void	init() Initializes the database and tries to open it.
Object	set(Object to) Sets the parameter from the database.
protected abstract Object	setIntoOpenDatabase(SqlAccess db, Object to) This method is calles if the database is ready to insert a new value.

Methods inherited from class globals.parameter.AbstractParameter

createParameter, delivers, getFormatted, getFormatted, getName, getPreserveFile, getString, getString, overrideDefaultName, register, rescanned, setName, toString

Methods inherited from class util.PropertyResources

clone, createFrom, createFrom, createFrom, createInstance, getApplet, getAsResources, getLocate, getPropertiesToKey, getPropertiesToKey, getResource, getResourceAsStream, getResourceFromKey, getResources, hasLocalURLs, initProperties, keyCreate, keyCreate, reload, setApplet

Methods inherited from class util.PropertyContainer

augment, augment, augment, augment, augment, defaultBoolean, defaultChar, defaultDouble, defaultFloat, defaultInt, defaultLong, defaultObject, defaultObject, defaultProperties, defaultProperty, getAsBoolean, getAsChar, getAsDouble, getAsEnums, getAsFloat, getAsInt, getAsList, getAsLong, getAsMap, getAsMap, getAsObject, getAsObject, getProperties, getProperty, has, isNew, parseObject, parseObject, reload, removeProperty, requires, setObject, setProperties, setProperty, stringProperties

Methods inherited from class java.lang.Object

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

Methods inherited from interface util.PropertySupplying

defaultBoolean, defaultChar, defaultDouble, defaultFloat, defaultInt, defaultLong, defaultObject, defaultObject, defaultProperties, defaultProperty, getAsBoolean, getAsChar, getAsDouble, getAsFloat, getAsInt, getAsList, getAsLong, getAsMap, getAsObject, getAsObject, getProperties, getProperty, has, parseObject, removeProperty, setObject, setProperty, stringProperties

Field Detail

KEY_ALLOWREOPEN

public static final String KEY_ALLOWREOPEN

The key to the unique trigger name.

See Also:

Constant Field Values

DEFALLOWREOPEN

private static final boolean DEFALLOWREOPEN

The key to the unique trigger name.

See Also:

Constant Field Values

db

private SqlAccess db

My SQL instance.

Constructor Detail

AbstractDatabaseParameter

protected AbstractDatabaseParameter(Map<String,String> prop)

Constructs a new database parameter. The database is opened on init().

Method Detail

init

public void init()
          throws InitException

Initializes the database and tries to open it.

Specified by:

init in interface Initializable

Overrides:

init in class AbstractParameter

Throws:

InitException

exit

public void exit()

On exit, we close the database, if we are open.

Specified by:

exit in interface ExitCleaning

Overrides:

exit in class AbstractParameter

get

public Object get()

Gets the parameter from the database. We check, if the database is open and if it is ready. If not, and the KEY_ALLOWREOPEN property points to true, we reopen.

set

public Object set(Object to)

Sets the parameter from the database. We check, if the database is open and if it is ready. If not, and the KEY_ALLOWREOPEN property points to true, we reopen.

Returns:

The previous value of this parameter.

getFromOpenDatabase

protected abstract Object getFromOpenDatabase(SqlAccess db)
                                       throws SQLException

This method is called if the database is ready for data retrieval.

Throws:

SQLException

setIntoOpenDatabase

protected abstract Object setIntoOpenDatabase(SqlAccess db,
                                              Object to)
                                       throws SQLException

This method is calles if the database is ready to insert a new value.

Throws:

SQLException