au.com.cybersearch2.classydb

Class DatabaseAdminImpl

java.lang.Object

au.com.cybersearch2.classydb.DatabaseAdminImpl

All Implemented Interfaces:

DatabaseAdmin

public class DatabaseAdminImpl
extends Object
implements DatabaseAdmin

DatabaseAdminImpl Handler of database create and upgrade events

Author:

Andrew Bowley 29/07/2014

Field Summary

Fields inherited from interface au.com.cybersearch2.classydb.DatabaseAdmin

DATA_FILENAME, DATABASE_NAME, DATABASE_VERSION, DROP_SCHEMA_FILENAME, SCHEMA_FILENAME, UPGRADE_FILENAME_FORMAT

Constructor Summary

Constructors

Constructor and Description
DatabaseAdminImpl(String puName, PersistenceAdmin persistenceAdmin, ResourceEnvironment resourceEnvironment, OpenHelperCallbacks openHelperCallbacks) Construct a DatabaseAdminImpl object

Method Summary

Methods

Modifier and Type	Method and Description
OpenHelperCallbacks	getCustomOpenHelperCallbacks()
void	initializeDatabase(PersistenceConfig persistenceConfig, DatabaseSupport databaseSupport) Open database and handle create/upgrade events
void	onCreate(com.j256.ormlite.support.ConnectionSource connectionSource) Database create handler.
void	onUpgrade(com.j256.ormlite.support.ConnectionSource connectionSource, int oldVersion, int newVersion) Database upgrade handler.

Methods inherited from class java.lang.Object

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

Constructor Detail

DatabaseAdminImpl

public DatabaseAdminImpl(String puName,
                 PersistenceAdmin persistenceAdmin,
                 ResourceEnvironment resourceEnvironment,
                 OpenHelperCallbacks openHelperCallbacks)

Construct a DatabaseAdminImpl object

Parameters:

puName - The persistence unit name

persistenceAdmin - The persistence unit connectionSource and properties provider

Method Detail

getCustomOpenHelperCallbacks

public OpenHelperCallbacks getCustomOpenHelperCallbacks()

Specified by:

getCustomOpenHelperCallbacks in interface DatabaseAdmin

onCreate

public void onCreate(com.j256.ormlite.support.ConnectionSource connectionSource)

Database create handler. Optionaly runs native scripts to drop and create schema and populate the database with data. Note that because ORMLite uses a ThreadLocal variable for a special connection, this executes in a single thread.

Specified by:

onCreate in interface DatabaseAdmin

Parameters:

connectionSource - An open ConnectionSource to be employed for all database activities.

onUpgrade

public void onUpgrade(com.j256.ormlite.support.ConnectionSource connectionSource,
             int oldVersion,
             int newVersion)

Database upgrade handler.

The SQLite ALTER TABLE documentation can be found here. If you add new columns you can use ALTER TABLE to insert them into a live table. If you rename or remove columns you can use ALTER TABLE to rename the old table, then create the new table and then populate the new table with the contents of the old table.

Specified by:

onUpgrade in interface DatabaseAdmin

Parameters:

connectionSource - An open ConnectionSource to be employed for all database activities.

oldVersion - The old database version.

newVersion - The new database version.

initializeDatabase

public void initializeDatabase(PersistenceConfig persistenceConfig,
                      DatabaseSupport databaseSupport)

Open database and handle create/upgrade events

Parameters:

persistenceConfig - PersistenceUnitAdmin Unit Configuration

databaseSupport - Database Support for specific database type