com.helger.photon.basic.app.dao.impl

Class AbstractDAO

java.lang.Object

com.helger.photon.basic.app.dao.impl.AbstractDAO

All Implemented Interfaces:

IAutoSaveAware, IChangeable, IDAO

Direct Known Subclasses:

AbstractSimpleDAO, AbstractWALDAO

@ThreadSafe
public abstract class AbstractDAO
extends Object
implements IDAO

Base implementation of IDAO

Author:

Philip Helger

Nested Class Summary

Nested classes/interfaces inherited from interface com.helger.photon.basic.app.dao.IDAO

IDAO.EMode

Field Summary

Fields

Modifier and Type	Field and Description
static boolean	DEFAULT_AUTO_SAVE_ENABLED By default auto-save is enabled
protected ReadWriteLock	m_aRWLock

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	AbstractDAO()

Method Summary

Methods

Modifier and Type	Method and Description
void	beginWithoutAutoSave() Start doing something without auto save.
void	endWithoutAutoSave() End doing something without auto save.
static com.helger.commons.callback.CallbackList<IDAOReadExceptionCallback>	getExceptionHandlersRead()
static com.helger.commons.callback.CallbackList<IDAOWriteExceptionCallback>	getExceptionHandlersWrite()
boolean	hasPendingChanges()
boolean	internalHasPendingChanges()
protected boolean	internalIsAutoSaveEnabled()
void	internalSetPendingChanges(boolean bPendingChanges)
boolean	isAutoSaveEnabled()
<RETURNTYPE> RETURNTYPE	performWithoutAutoSave(com.helger.commons.callback.INonThrowingCallable<RETURNTYPE> aCallable) Execute a callback with autosave being disabled.
void	performWithoutAutoSave(com.helger.commons.callback.INonThrowingRunnable aRunnable) Execute a callback with autosave being disabled.
<RETURNTYPE> RETURNTYPE	performWithoutAutoSave(com.helger.commons.callback.IThrowingCallable<RETURNTYPE> aCallable) Execute a callback with autosave being disabled.
void	performWithoutAutoSave(com.helger.commons.callback.IThrowingRunnable aRunnable) Execute a callback with autosave being disabled.
String	toString()

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.helger.photon.basic.app.dao.IDAO

getInitCount, getLastInitDateTime, getLastReadDateTime, getLastWriteDateTime, getReadCount, getWriteCount, writeToFileOnPendingChanges

Field Detail

DEFAULT_AUTO_SAVE_ENABLED

public static final boolean DEFAULT_AUTO_SAVE_ENABLED

By default auto-save is enabled

See Also:

Constant Field Values

m_aRWLock

protected final ReadWriteLock m_aRWLock

Constructor Detail

AbstractDAO

protected AbstractDAO()

Method Detail

getExceptionHandlersRead

@Nonnull
@ReturnsMutableObject(reason="design")
public static final com.helger.commons.callback.CallbackList<IDAOReadExceptionCallback> getExceptionHandlersRead()

getExceptionHandlersWrite

@Nonnull
@ReturnsMutableObject(reason="design")
public static final com.helger.commons.callback.CallbackList<IDAOWriteExceptionCallback> getExceptionHandlersWrite()

internalIsAutoSaveEnabled

@MustBeLocked(value=READ)
protected final boolean internalIsAutoSaveEnabled()

Returns:

true if auto save is enabled, false otherwise.

isAutoSaveEnabled

public final boolean isAutoSaveEnabled()

Specified by:

isAutoSaveEnabled in interface IAutoSaveAware

Returns:

true if auto save is enabled, false otherwise.

internalSetPendingChanges

@MustBeLocked(value=WRITE)
public final void internalSetPendingChanges(boolean bPendingChanges)

internalHasPendingChanges

@MustBeLocked(value=READ)
public final boolean internalHasPendingChanges()

Returns:

true if unsaved changes are present

hasPendingChanges

public final boolean hasPendingChanges()

Specified by:

hasPendingChanges in interface IChangeable

Returns:

true if unsaved changes are present

beginWithoutAutoSave

public final void beginWithoutAutoSave()

Description copied from interface: IAutoSaveAware

Start doing something without auto save.

Specified by:

beginWithoutAutoSave in interface IAutoSaveAware

endWithoutAutoSave

public final void endWithoutAutoSave()

Description copied from interface: IAutoSaveAware

End doing something without auto save. It must be ensure that each call to IAutoSaveAware.beginWithoutAutoSave() is always correctly ended with a call to this method.

Specified by:

endWithoutAutoSave in interface IAutoSaveAware

performWithoutAutoSave

public final void performWithoutAutoSave(@Nonnull
                          com.helger.commons.callback.INonThrowingRunnable aRunnable)

Execute a callback with autosave being disabled. Must be called outside a writeLock, as this method locks itself!

Specified by:

performWithoutAutoSave in interface IAutoSaveAware

Parameters:

aRunnable - The callback to be executed

performWithoutAutoSave

@Nullable
public final <RETURNTYPE> RETURNTYPE performWithoutAutoSave(@Nonnull
                                                      com.helger.commons.callback.INonThrowingCallable<RETURNTYPE> aCallable)

Execute a callback with autosave being disabled. Must be called outside a writeLock, as this method locks itself!

Specified by:

performWithoutAutoSave in interface IAutoSaveAware

Parameters:

aCallable - The callback to be executed

Returns:

The result of the callback. May be null.

performWithoutAutoSave

public final void performWithoutAutoSave(@Nonnull
                          com.helger.commons.callback.IThrowingRunnable aRunnable)
                                  throws Exception

Execute a callback with autosave being disabled. Must be called outside a writeLock, as this method locks itself!

Parameters:

aRunnable - The callback to be executed

Throws:

Exception - In case of an error

performWithoutAutoSave

@Nullable
public final <RETURNTYPE> RETURNTYPE performWithoutAutoSave(@Nonnull
                                                      com.helger.commons.callback.IThrowingCallable<RETURNTYPE> aCallable)
                                        throws Exception

Execute a callback with autosave being disabled. Must be called outside a writeLock, as this method locks itself!

Parameters:

aCallable - The callback to be executed

Returns:

The result of the callback. May be null.

Throws:

Exception - In case of an error

toString

public String toString()

Overrides:

toString in class Object