com.compomics.util.db

Class ObjectsDB

java.lang.Object

com.compomics.util.db.ObjectsDB

All Implemented Interfaces:

java.io.Serializable

public class ObjectsDB
extends java.lang.Object
implements java.io.Serializable

A database which can easily be used to store objects.

Author:

Marc Vaudel

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	LONG_KEY_PREFIX Suffix used for long keys.
static int	TABLE_NAME_MAX_LENGTH The maximal length of a table name.
static int	VARCHAR_MAX_LENGTH The maximal length of a varchar.

Constructor Summary

Constructors

Constructor and Description
ObjectsDB(java.lang.String folder, java.lang.String dbName, boolean deleteOldDatabase, ObjectsCache objectsCache) Constructor.

Method Summary

Methods

Modifier and Type	Method and Description
void	addTable(java.lang.String tableName) Adds the desired table in the database.
void	close() Closes the db connection.
java.lang.String	correctKey(java.lang.String tableName, java.lang.String key) Indexes the long keys by a number.
java.lang.String	correctTableName(java.lang.String tableName) Surrounds the table name with quotation marks such that spaces etc are allowed.
void	deleteObject(java.lang.String tableName, java.lang.String objectKey) Deletes an object from the desired table.
void	establishConnection(java.lang.String aDbFolder, boolean deleteOldDatabase, ObjectsCache objectsCache) Establishes connection to the database.
java.lang.String	getName() Returns the database name.
ObjectsCache	getObjectsCache() Returns the cache used by this database.
java.lang.String	getOriginalKey(java.lang.String tableName, java.lang.String correctedKey) Returns the original key of the corrected long key.
boolean	inDB(java.lang.String tableName, java.lang.String objectKey, boolean cache) Indicates whether an object is loaded in the given table.
void	insertObject(java.lang.String tableName, java.lang.String objectKey, java.lang.Object object, boolean inCache) Stores an object in the desired table.
void	insertObjects(java.lang.String tableName, java.util.HashMap<java.lang.String,java.lang.Object> objects, WaitingHandler waitingHandler) Inserts a set of objects in the given table.
void	insertObjects(java.lang.String tableName, java.util.HashMap<java.lang.String,java.lang.Object> objects, WaitingHandler waitingHandler, boolean allNewObjects) Inserts a set of objects in the given table.
void	loadObjects(java.lang.String tableName, java.util.ArrayList<java.lang.String> keys, WaitingHandler waitingHandler) Loads some objects from a table in the cache.
void	loadObjects(java.lang.String tableName, WaitingHandler waitingHandler) Loads all objects from a table in the cache.
java.lang.Object	retrieveObject(java.lang.String tableName, java.lang.String objectKey, boolean useDB) Retrieves an object from the desired table.
java.lang.Object	retrieveObject(java.lang.String tableName, java.lang.String objectKey, boolean useDB, boolean useCache) Retrieves an object from the desired table.
void	setObjectCache(ObjectsCache objectCache) Sets the object cache to be used by this database.
java.util.ArrayList<java.lang.String>	tableContent(java.lang.String tableName) Returns an arraylist with the content in the given table.
java.util.HashSet<java.lang.String>	tableContentAsSet(java.lang.String tableName) Returns a hashset with the content in the given table.
void	updateObject(java.lang.String tableName, java.lang.String objectKey, java.lang.Object object) Updates an object in the cache or in the tables if not in cache.
void	updateObject(java.lang.String tableName, java.lang.String objectKey, java.lang.Object object, boolean cache) Updates an object in the cache or in the tables if not in cache or if cache is wrong.

Methods inherited from class java.lang.Object

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

Field Detail

TABLE_NAME_MAX_LENGTH

public static final int TABLE_NAME_MAX_LENGTH

The maximal length of a table name.

See Also:

Constant Field Values

VARCHAR_MAX_LENGTH

public static final int VARCHAR_MAX_LENGTH

The maximal length of a varchar. Note: 32672 is the max length for a varchar.

See Also:

Constant Field Values

LONG_KEY_PREFIX

public static final java.lang.String LONG_KEY_PREFIX

Suffix used for long keys.

See Also:

Constant Field Values

Constructor Detail

ObjectsDB

public ObjectsDB(java.lang.String folder,
         java.lang.String dbName,
         boolean deleteOldDatabase,
         ObjectsCache objectsCache)
          throws java.sql.SQLException

Constructor.

Parameters:

folder - absolute path of the folder where to establish the database

dbName - name of the database

deleteOldDatabase - if true, tries to delete the old database

objectsCache -

Throws:

java.sql.SQLException

Method Detail

getName

public java.lang.String getName()

Returns the database name.

Returns:

the database name

getObjectsCache

public ObjectsCache getObjectsCache()

Returns the cache used by this database.

Returns:

the cache used by this database

setObjectCache

public void setObjectCache(ObjectsCache objectCache)

Sets the object cache to be used by this database.

Parameters:

objectCache - the object cache to be used by this database

addTable

public void addTable(java.lang.String tableName)
              throws java.sql.SQLException

Adds the desired table in the database.

Parameters:

tableName - the name of the table

Throws:

java.sql.SQLException - exception thrown whenever a problem occurred while working with the database

insertObject

public void insertObject(java.lang.String tableName,
                java.lang.String objectKey,
                java.lang.Object object,
                boolean inCache)
                  throws java.sql.SQLException,
                         java.io.IOException,
                         java.lang.InterruptedException

Stores an object in the desired table. When multiple objects are to be inserted, use insertObjects instead.

Parameters:

tableName - the name of the table

objectKey - the key of the object

object - the object to store

inCache - boolean indicating whether the method shall try to put the object in cache or not

Throws:

java.sql.SQLException - exception thrown whenever an error occurred while storing the object

java.io.IOException - exception thrown whenever an error occurred while writing in the database

java.lang.InterruptedException

insertObjects

public void insertObjects(java.lang.String tableName,
                 java.util.HashMap<java.lang.String,java.lang.Object> objects,
                 WaitingHandler waitingHandler)
                   throws java.sql.SQLException,
                          java.io.IOException

Inserts a set of objects in the given table.

Parameters:

tableName - the name of the table

objects - map of the objects (object key -> object)

waitingHandler - a waiting handler displaying the progress (can be null). The progress will be displayed on the secondary progress bar.

Throws:

java.sql.SQLException

java.io.IOException

insertObjects

public void insertObjects(java.lang.String tableName,
                 java.util.HashMap<java.lang.String,java.lang.Object> objects,
                 WaitingHandler waitingHandler,
                 boolean allNewObjects)
                   throws java.sql.SQLException,
                          java.io.IOException

Inserts a set of objects in the given table.

Parameters:

tableName - the name of the table

objects - map of the objects (object key -> object)

waitingHandler - a waiting handler displaying the progress (can be null). The progress will be displayed on the secondary progress bar.

allNewObjects - boolean indicating whether all objects are new

Throws:

java.sql.SQLException

java.io.IOException

loadObjects

public void loadObjects(java.lang.String tableName,
               WaitingHandler waitingHandler)
                 throws java.sql.SQLException,
                        java.io.IOException,
                        java.lang.ClassNotFoundException,
                        java.lang.InterruptedException

Loads all objects from a table in the cache.

Parameters:

tableName - the table name

waitingHandler - the waiting handler

Throws:

java.sql.SQLException - exception thrown whenever an error occurred while interrogating the database

java.io.IOException - exception thrown whenever an error occurred while reading the database

java.lang.ClassNotFoundException - exception thrown whenever the class of the object is not found when deserializing it.

java.lang.InterruptedException

loadObjects

public void loadObjects(java.lang.String tableName,
               java.util.ArrayList<java.lang.String> keys,
               WaitingHandler waitingHandler)
                 throws java.sql.SQLException,
                        java.io.IOException,
                        java.lang.ClassNotFoundException,
                        java.lang.InterruptedException

Loads some objects from a table in the cache.

Parameters:

tableName - the table name

keys - the keys of the objects to load

waitingHandler - the waiting handler, will only be increased

Throws:

java.sql.SQLException - exception thrown whenever an error occurred while interrogating the database

java.io.IOException - exception thrown whenever an error occurred while reading the database

java.lang.ClassNotFoundException - exception thrown whenever the class of the object is not found when deserializing it.

java.lang.InterruptedException

retrieveObject

public java.lang.Object retrieveObject(java.lang.String tableName,
                              java.lang.String objectKey,
                              boolean useDB)
                                throws java.sql.SQLException,
                                       java.io.IOException,
                                       java.lang.ClassNotFoundException,
                                       java.lang.InterruptedException

Retrieves an object from the desired table. The key should be unique otherwise the first object will be returned. Returns null if the key is not found. The retrieved object is saved in cache.

Parameters:

tableName - the name of the table

objectKey - the object key

useDB - if useDB is false, null will be returned if the object is not in the cache

Returns:

the object stored in the table.

Throws:

java.sql.SQLException - exception thrown whenever an error occurred while interrogating the database

java.io.IOException - exception thrown whenever an error occurred while reading the database

java.lang.ClassNotFoundException - exception thrown whenever the class of the object is not found when deserializing it.

java.lang.InterruptedException

retrieveObject

public java.lang.Object retrieveObject(java.lang.String tableName,
                              java.lang.String objectKey,
                              boolean useDB,
                              boolean useCache)
                                throws java.sql.SQLException,
                                       java.io.IOException,
                                       java.lang.ClassNotFoundException,
                                       java.lang.InterruptedException

Retrieves an object from the desired table. The key should be unique otherwise the first object will be returned. Returns null if the key is not found.

Parameters:

tableName - the name of the table

objectKey - the object key

useDB - if useDB is false, null will be returned if the object is not in the cache

useCache - if true the retrieved object will be saved in cache

Returns:

the object stored in the table.

Throws:

java.sql.SQLException - exception thrown whenever an error occurred while interrogating the database

java.io.IOException - exception thrown whenever an error occurred while reading the database

java.lang.ClassNotFoundException - exception thrown whenever the class of the object is not found when deserializing it.

java.lang.InterruptedException

inDB

public boolean inDB(java.lang.String tableName,
           java.lang.String objectKey,
           boolean cache)
             throws java.sql.SQLException

Indicates whether an object is loaded in the given table.

Parameters:

tableName - the table name

objectKey - the object key

cache - a boolean indicating whether the cache should be searched as well

Returns:

a boolean indicating whether an object is loaded in the given table

Throws:

java.sql.SQLException - exception thrown whenever an exception occurred while interrogating the database

tableContent

public java.util.ArrayList<java.lang.String> tableContent(java.lang.String tableName)
                                                   throws java.sql.SQLException

Returns an arraylist with the content in the given table.

Parameters:

tableName - the table to get the content for

Returns:

an arraylist with the content in the given table

Throws:

java.sql.SQLException

tableContentAsSet

public java.util.HashSet<java.lang.String> tableContentAsSet(java.lang.String tableName)
                                                      throws java.sql.SQLException

Returns a hashset with the content in the given table.

Parameters:

tableName - the table to get the content for

Returns:

a hashset with the content in the given table

Throws:

java.sql.SQLException

deleteObject

public void deleteObject(java.lang.String tableName,
                java.lang.String objectKey)
                  throws java.sql.SQLException,
                         java.io.IOException

Deletes an object from the desired table.

Parameters:

tableName - the name of the table

objectKey - the object key

Throws:

java.sql.SQLException - exception thrown whenever an error occurred while interrogating the database

java.io.IOException - exception thrown whenever an error occurred while interrogating the database

updateObject

public void updateObject(java.lang.String tableName,
                java.lang.String objectKey,
                java.lang.Object object)
                  throws java.sql.SQLException,
                         java.io.IOException

Updates an object in the cache or in the tables if not in cache.

Parameters:

tableName - the name of the table

objectKey - the key of the object

object - the object to store

Throws:

java.sql.SQLException - exception thrown whenever an error occurred while storing the object

java.io.IOException - exception thrown whenever an error occurred while writing in the database

updateObject

public void updateObject(java.lang.String tableName,
                java.lang.String objectKey,
                java.lang.Object object,
                boolean cache)
                  throws java.sql.SQLException,
                         java.io.IOException

Updates an object in the cache or in the tables if not in cache or if cache is wrong.

Parameters:

tableName - the name of the table

objectKey - the key of the object

object - the object to store

cache - a boolean indicating whether the method should look in the cache

Throws:

java.sql.SQLException - exception thrown whenever an error occurred while storing the object

java.io.IOException - exception thrown whenever an error occurred while writing in the database

close

public void close()
           throws java.sql.SQLException

Closes the db connection.

Throws:

java.sql.SQLException - exception thrown whenever an error occurred while closing the database connection

establishConnection

public void establishConnection(java.lang.String aDbFolder,
                       boolean deleteOldDatabase,
                       ObjectsCache objectsCache)
                         throws java.sql.SQLException

Establishes connection to the database.

Parameters:

aDbFolder - the folder where the database is located

deleteOldDatabase - if true, tries to delete the old database

objectsCache -

Throws:

java.sql.SQLException - exception thrown whenever an error occurred while establishing the connection

correctTableName

public java.lang.String correctTableName(java.lang.String tableName)

Surrounds the table name with quotation marks such that spaces etc are allowed.

Parameters:

tableName - the table name

Returns:

the corrected table name

correctKey

public java.lang.String correctKey(java.lang.String tableName,
                          java.lang.String key)

Indexes the long keys by a number.

Parameters:

tableName - the table name

key - the key of the object to be stored

Returns:

the corrected table name

getOriginalKey

public java.lang.String getOriginalKey(java.lang.String tableName,
                              java.lang.String correctedKey)

Returns the original key of the corrected long key.

Parameters:

tableName - the table

correctedKey - the corrected key, should be prefix + number

Returns:

the original long key