Package xal.tools.database

Class ConnectionDictionary

java.lang.Object

java.util.Dictionary<K,V>

java.util.Hashtable<Object,Object>

java.util.Properties

xal.tools.database.ConnectionDictionary

All Implemented Interfaces:

Serializable, Cloneable, Map<Object,Object>

public class ConnectionDictionary
extends Properties

ConnectionDictionary contains properties that can be used to establish a database connection. It should contain at least the database URL, user name and password. A default connection dictionary can be fetched from a file specified in the user's preferences.

Author:

tap

See Also:

• Serialized Form

Field Summary

Fields

Modifier and Type	Field	Description
static final String	DATABASE_ADAPTOR_KEY
static final String	PASSWORD_KEY
static final String	URL_KEY
static final String	USER_KEY

Fields inherited from class java.util.Properties

defaults

Constructor Summary

Constructors

Constructor	Description
ConnectionDictionary()	Constructor

Method Summary

Modifier and Type	Method	Description
static ConnectionDictionary	defaultDictionary()	Get the connection dictionary from the file specified in the user's preferences.
DatabaseAdaptor	getDatabaseAdaptor()	Get the database adaptor to use
static ConnectionDictionary	getInstance()	Get the connection dictionary from the URL specified in the user's preferences.
static ConnectionDictionary	getInstance(String accountName)	Get the connection dictionary from the URL specified in the user's preferences and for the specified account.
static ConnectionDictionary	getInstance(String accountName, String serverName)	Get the connection dictionary from the URL specified in the user's preferences and for the specified account and server.
String	getPassword()	Get the user password for connecting
static ConnectionDictionary	getPreferredInstance(String... accountNames)	Get the available connection dictionary which is the most preferred
String	getURLSpec()	Get the connection URL
String	getUser()	Get the user name for connecting
boolean	hasRequiredInfo()	Determine if the dictionary is sufficiently complete regardless whether the data is right or wrong.
void	setDatabaseAdaptorClass(Class<?> databaseAdaptorClass)	Set the database adaptor class
void	setDatabaseAdaptorClass(String className)	Set the database adaptor class
void	setPassword(String password)	Set the password
void	setURLSpec(String urlSpec)	Set the URL spec
void	setUser(String userID)	Set the user ID

Methods inherited from class java.util.Properties

clear, clone, compute, computeIfAbsent, computeIfPresent, contains, containsKey, containsValue, elements, entrySet, equals, forEach, get, getOrDefault, getProperty, getProperty, hashCode, isEmpty, keys, keySet, list, list, load, load, loadFromXML, merge, propertyNames, put, putAll, putIfAbsent, rehash, remove, remove, replace, replace, replaceAll, save, setProperty, size, store, store, storeToXML, storeToXML, storeToXML, stringPropertyNames, toString, values

Methods inherited from class java.lang.Object

finalize, getClass, notify, notifyAll, wait, wait, wait

Field Details

USER_KEY

public static final String USER_KEY

See Also:

• Constant Field Values

PASSWORD_KEY

public static final String PASSWORD_KEY

See Also:

• Constant Field Values

URL_KEY

public static final String URL_KEY

See Also:

• Constant Field Values

DATABASE_ADAPTOR_KEY

public static final String DATABASE_ADAPTOR_KEY

See Also:

• Constant Field Values

Constructor Details

ConnectionDictionary

public ConnectionDictionary()

Constructor

Method Details

defaultDictionary

public static ConnectionDictionary defaultDictionary()

Get the connection dictionary from the file specified in the user's preferences.

Returns:

the user's default connection dictionary

getInstance

public static ConnectionDictionary getInstance()

Get the connection dictionary from the URL specified in the user's preferences.

Returns:

the user's default connection dictionary

getInstance

public static ConnectionDictionary getInstance(String accountName)

Get the connection dictionary from the URL specified in the user's preferences and for the specified account.

Parameters:

accountName - name of the account for which to initialize the connection dictionary (or null to use the default account if any)

Returns:

the user's default connection dictionary

getPreferredInstance

public static ConnectionDictionary getPreferredInstance(String... accountNames)

Get the available connection dictionary which is the most preferred

Parameters:

accountNames - ordered (most preferred is first) accounts to search among

getInstance

public static ConnectionDictionary getInstance(String accountName,
 String serverName)

Get the connection dictionary from the URL specified in the user's preferences and for the specified account and server.

Parameters:

accountName - name of the account for which to initialize the connection dictionary (or null to use the default account if any)

serverName - name of the database server for which to initialize the connection dictionary (or null to use the default server if any)

Returns:

the user's default connection dictionary

hasRequiredInfo

public boolean hasRequiredInfo()

Determine if the dictionary is sufficiently complete regardless whether the data is right or wrong.

Returns:

true if the dictionary contains the user name, password and database URL (database adaptor is optional)

getUser

public String getUser()

Get the user name for connecting

Returns:

the user name

setUser

public void setUser(String userID)

Set the user ID

Parameters:

userID - The user ID

getPassword

public String getPassword()

Get the user password for connecting

Returns:

the user password

setPassword

public void setPassword(String password)

Set the password

Parameters:

password - the password

getURLSpec

public String getURLSpec()

Get the connection URL

Returns:

the connection URL

setURLSpec

public void setURLSpec(String urlSpec)

Set the URL spec

Parameters:

urlSpec - The URL spec

getDatabaseAdaptor

public DatabaseAdaptor getDatabaseAdaptor()

Get the database adaptor to use

Returns:

the database adaptor

setDatabaseAdaptorClass

public void setDatabaseAdaptorClass(Class<?> databaseAdaptorClass)

Set the database adaptor class

Parameters:

databaseAdaptorClass - the database adaptor class to use

setDatabaseAdaptorClass

public void setDatabaseAdaptorClass(String className)

Set the database adaptor class

Parameters:

className - the database adaptor class name to use