de.minee.jpa

Class AbstractDAO

java.lang.Object

de.minee.jpa.AbstractDAO

public abstract class AbstractDAO
extends Object

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
protected static interface	AbstractDAO.UpdateData

Constructor Summary

Constructors

Constructor and Description
AbstractDAO()

Method Summary

Modifier and Type	Method and Description
protected void	createTable(Class<?> cls)
<T> void	delete(T objectToDelete) Directly deletes a Object and recursively its children.
<T> void	deleteShallow(T objectToDelete) Deletes a Object.
protected void	dropTable(Class<?> cls)
protected void	dropTable(String table)
int	executeNative(String sql, Object... args)
protected Connection	getConnection()
protected String	getConnectionString()
protected String	getPassword()
protected String	getUserName()
<T> UUID	insert(T objectToInsert) Deep insert of the Object and recursively their children.
<T> UUID	insertShallow(T objectToInsert)
<T> UUID	merge(T objectToMerge)
<T> UUID	mergeShallow(T objectToMerge)
<T> InitialQueryConnection<T,AbstractStatement<T>>	select(Class<T> clazz) Creates a Query for selecting Objects of type clazz.
<T> int	update(T objectToUpdate)
protected void	updateData(AbstractDAO.UpdateData updateData) This method is supposed to allow Data changes during the updateDatabaseSchema process.
protected abstract int	updateDatabaseSchema(int oldDbSchemaVersion) If the database is newly created oldDbSchemaVersion will initially be 0.
<T> int	updateShallow(T objectToUpdate)
protected void	updateTable(Class<?> cls)
protected void	updateTable(Class<?> cls, boolean allowDeletion)

Methods inherited from class java.lang.Object

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

Constructor Detail

AbstractDAO

public AbstractDAO()

Method Detail

getConnectionString

protected String getConnectionString()

getUserName

protected String getUserName()

getPassword

protected String getPassword()

updateDatabaseSchema

protected abstract int updateDatabaseSchema(int oldDbSchemaVersion)

If the database is newly created oldDbSchemaVersion will initially be 0. It is not allowed to change the data through the fluent api directly during the updateDatabaseSchema process. However if you need to modify data use updateData() within this method. Data changes will be executed synchronously.

Parameters:

oldDbSchemaVersion - schema version of the existing database or 0

Returns:

new Schema Version that will be passed next time the database connection will be opened @

getConnection

protected Connection getConnection()

dropTable

protected void dropTable(Class<?> cls)

dropTable

protected void dropTable(String table)

createTable

protected void createTable(Class<?> cls)

updateData

protected void updateData(AbstractDAO.UpdateData updateData)

This method is supposed to allow Data changes during the updateDatabaseSchema process.

Parameters:

updateData -

updateTable

protected void updateTable(Class<?> cls)

updateTable

protected void updateTable(Class<?> cls,
                           boolean allowDeletion)

select

public <T> InitialQueryConnection<T,AbstractStatement<T>> select(Class<T> clazz)

Creates a Query for selecting Objects of type clazz.

Parameters:

clazz - Class corresponding to a DB Table

Returns:

Fluent style based query builder @ SQLException in case of an error

insertShallow

public <T> UUID insertShallow(T objectToInsert)

insert

public <T> UUID insert(T objectToInsert)

Deep insert of the Object and recursively their children.

Parameters:

objectToInsert - object that should be persisted

Returns:

id of the inserted object @ SQLException in case of an error

update

public <T> int update(T objectToUpdate)

updateShallow

public <T> int updateShallow(T objectToUpdate)

merge

public <T> UUID merge(T objectToMerge)

mergeShallow

public <T> UUID mergeShallow(T objectToMerge)

delete

public <T> void delete(T objectToDelete)

Directly deletes a Object and recursively its children.

Parameters:

objectToDelete - Object that shall be deleted from Database @ SQLException in case of an error

deleteShallow

public <T> void deleteShallow(T objectToDelete)

Deletes a Object. Referenced Objects will not be deleted.

Parameters:

objectToDelete - Object that shall be deleted from Database @ SQLException in case of an error

executeNative

public int executeNative(String sql,
                         Object... args)