com.helger.photon.basic.security.audit

Class AuditManager

java.lang.Object

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

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

com.helger.photon.basic.security.audit.AuditManager

All Implemented Interfaces:

IAutoSaveAware, IChangeable, IDAO, IAuditManager

@ThreadSafe
public final class AuditManager
extends AbstractSimpleDAO
implements IAuditManager

The class handles all audit items

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 String	ATTR_DT_STRING
static String	ATTR_SUCCESS
static String	ATTR_TYPE
static String	ATTR_USER
static String	ELEMENT_ITEM
static String	ELEMENT_ITEMS

Fields inherited from class com.helger.photon.basic.app.dao.impl.AbstractDAO

DEFAULT_AUTO_SAVE_ENABLED, m_aRWLock

Constructor Summary

Constructors

Constructor and Description
AuditManager(String sBaseDir, ICurrentUserIDProvider aUserIDProvider) Constructor

Method Summary

Methods

Modifier and Type	Method and Description
protected com.helger.commons.microdom.IMicroDocument	createWriteData() Create the XML document that should be saved to the file.
boolean	equals(Object o)
List<IAuditItem>	getAllAuditItemsOfDate(org.joda.time.LocalDate aDate)
int	getAuditItemCount()
AsynchronousAuditor	getAuditor()
List<IAuditItem>	getLastAuditItems(int nMaxItems)
static String	getRelativeAuditFilename(org.joda.time.LocalDate aDate)
int	hashCode()
protected void	onFilenameChange(String sPreviousFilename, String sNewFilename) Called after a successful write of the file, if the filename is different from the previous filename.
protected com.helger.commons.state.EChange	onRead(com.helger.commons.microdom.IMicroDocument aDoc) Fill the internal structures with from the passed XML document.
static void	readFromXML(com.helger.commons.microdom.IMicroDocument aDoc, com.helger.photon.basic.security.audit.AuditManager.IReadHandler aHandler)
void	stop() Stop taking new audits.
String	toString()

Methods inherited from class com.helger.photon.basic.app.dao.impl.AbstractSimpleDAO

beforeWriteToFile, getDAOIO, getFilenameProvider, getInitCount, getLastFilename, getLastInitDateTime, getLastReadDateTime, getLastWriteDateTime, getReadCount, getSafeFile, getWriteCount, getXMLWriterSettings, initialRead, markAsChanged, modifyWriteData, onInit, triggerExceptionHandlersRead, triggerExceptionHandlersWrite, writeToFileOnPendingChanges

Methods inherited from class com.helger.photon.basic.app.dao.impl.AbstractDAO

beginWithoutAutoSave, endWithoutAutoSave, getExceptionHandlersRead, getExceptionHandlersWrite, hasPendingChanges, internalHasPendingChanges, internalIsAutoSaveEnabled, internalSetPendingChanges, isAutoSaveEnabled, performWithoutAutoSave, performWithoutAutoSave, performWithoutAutoSave, performWithoutAutoSave

Methods inherited from class java.lang.Object

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

Field Detail

ELEMENT_ITEMS

public static final String ELEMENT_ITEMS

See Also:

Constant Field Values

ELEMENT_ITEM

public static final String ELEMENT_ITEM

See Also:

Constant Field Values

ATTR_DT_STRING

public static final String ATTR_DT_STRING

See Also:

Constant Field Values

ATTR_USER

public static final String ATTR_USER

See Also:

Constant Field Values

ATTR_TYPE

public static final String ATTR_TYPE

See Also:

Constant Field Values

ATTR_SUCCESS

public static final String ATTR_SUCCESS

See Also:

Constant Field Values

Constructor Detail

AuditManager

public AuditManager(@Nullable
            String sBaseDir,
            @Nonnull
            ICurrentUserIDProvider aUserIDProvider)
             throws DAOException

Constructor

Parameters:

sBaseDir - The base directory, relative to the default IO base directory. May be null to indicate an in-memory auditor only.

aUserIDProvider - The current user ID provider. May not be null.

Throws:

DAOException - In case reading failed

Method Detail

getRelativeAuditFilename

@Nonnull
@Nonempty
public static String getRelativeAuditFilename(@Nonnull
                                               org.joda.time.LocalDate aDate)

getAuditor

@Nonnull
public AsynchronousAuditor getAuditor()

Specified by:

getAuditor in interface IAuditManager

Returns:

The underlying auditor. Never null.

readFromXML

public static void readFromXML(@Nonnull
               com.helger.commons.microdom.IMicroDocument aDoc,
               @Nonnull
               com.helger.photon.basic.security.audit.AuditManager.IReadHandler aHandler)

onRead

@Nonnull
protected com.helger.commons.state.EChange onRead(@Nonnull
                                              com.helger.commons.microdom.IMicroDocument aDoc)

Description copied from class: AbstractSimpleDAO

Fill the internal structures with from the passed XML document. This method is only called within a write lock!

Specified by:

onRead in class AbstractSimpleDAO

Parameters:

aDoc - The XML document to read from. Never null.

Returns:

EChange.CHANGED if reading the data changed something in the internal structures that requires a writing.

createWriteData

protected com.helger.commons.microdom.IMicroDocument createWriteData()

Description copied from class: AbstractSimpleDAO

Create the XML document that should be saved to the file. This method is only called within a write lock!

Specified by:

createWriteData in class AbstractSimpleDAO

Returns:

The non-null document to write to the file.

onFilenameChange

protected void onFilenameChange(@Nullable
                    String sPreviousFilename,
                    @Nonnull
                    String sNewFilename)

Description copied from class: AbstractSimpleDAO

Called after a successful write of the file, if the filename is different from the previous filename. This can e.g. be used to clear old data.

Overrides:

onFilenameChange in class AbstractSimpleDAO

Parameters:

sPreviousFilename - The previous filename. May be null.

sNewFilename - The new filename. Never null.

getAuditItemCount

@Nonnegative
public int getAuditItemCount()

getLastAuditItems

@Nonnull
@ReturnsMutableCopy
public List<IAuditItem> getLastAuditItems(@Nonnegative
                                                            int nMaxItems)

Specified by:

getLastAuditItems in interface IAuditManager

Parameters:

nMaxItems - The maximum number of items. Must be > 0.

Returns:

The n latest audit items. Never null.

stop

public void stop()

Description copied from interface: IAuditManager

Stop taking new audits. Call this upon shutdown for correct cleanup! Consecutive calls to this method have no further effect.

Specified by:

stop in interface IAuditManager

getAllAuditItemsOfDate

@Nullable
@ReturnsMutableCopy
public List<IAuditItem> getAllAuditItemsOfDate(@Nonnull
                                                                  org.joda.time.LocalDate aDate)

equals

public boolean equals(Object o)

Overrides:

equals in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object

toString

public String toString()

Overrides:

toString in class AbstractSimpleDAO