org.nuxeo.ecm.platform.audit.service

Class AbstractAuditBackend

java.lang.Object

org.nuxeo.ecm.platform.audit.service.AbstractAuditBackend

All Implemented Interfaces:

AuditAdmin, AuditLogger, AuditReader, Logs, AuditBackend

Direct Known Subclasses:

DefaultAuditBackend, ESAuditBackend

public abstract class AbstractAuditBackend
extends Object
implements AuditBackend

Abstract class to share code between AuditBackend implementations

Author:

tiry

Constructor Summary

Constructors

Constructor and Description
AbstractAuditBackend()

Method Summary

Methods

Modifier and Type	Method and Description
void	activate(NXAuditEventsService component)
Set<String>	getAuditableEventNames() Returns the list of auditable event names.
List<LogEntry>	getLogEntriesFor(String uuid) Returns the logs given a doc uuid.
void	logEvent(Event event) Logs an Event.
void	logEvents(EventBundle eventBundle) Logs a bundle of events
List<?>	nativeQuery(String query, int pageNb, int pageSize) Returns a batched list of entries.
List<LogEntry>	nativeQueryLogs(String whereClause, int pageNb, int pageSize) Returns a batched list of log entries.
ExtendedInfo	newExtendedInfo(Serializable value) Create a new ExtendedInfo instance
LogEntry	newLogEntry() Create a new LogEntry instance.
List<LogEntry>	queryLogs(String[] eventIds, String dateRange) Returns the list of log entries.
List<LogEntry>	queryLogsByPage(String[] eventIds, Date limit, String category, String path, int pageNb, int pageSize) Returns the batched list of log entries.
List<LogEntry>	queryLogsByPage(String[] eventIds, String dateRange, String category, String path, int pageNb, int pageSize) Returns the batched list of log entries.

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.nuxeo.ecm.platform.audit.service.AuditBackend

deactivate

Methods inherited from interface org.nuxeo.ecm.platform.audit.api.AuditReader

getLogEntriesFor, getLogEntryByID, nativeQuery, queryLogsByPage, queryLogsByPage

Methods inherited from interface org.nuxeo.ecm.platform.audit.api.AuditLogger

addLogEntries

Methods inherited from interface org.nuxeo.ecm.platform.audit.api.AuditAdmin

getEventsCount, syncLogCreationEntries

Constructor Detail

AbstractAuditBackend

public AbstractAuditBackend()

Method Detail

activate

public void activate(NXAuditEventsService component)

Specified by:

activate in interface AuditBackend

getAuditableEventNames

public Set<String> getAuditableEventNames()

Description copied from interface: AuditLogger

Returns the list of auditable event names.

Specified by:

getAuditableEventNames in interface AuditLogger

Returns:

list of String representing event names.

queryLogsByPage

public List<LogEntry> queryLogsByPage(String[] eventIds,
                             String dateRange,
                             String category,
                             String path,
                             int pageNb,
                             int pageSize)

Description copied from interface: AuditReader

Returns the batched list of log entries.

Note we will use NXQL in the future when the search engine will index history.

Specified by:

queryLogsByPage in interface AuditReader

Parameters:

eventIds - the event ids.

dateRange - a preset date range.

category - add filter on events category

path - add filter on document path

pageNb - page number (ignore if <=1)

pageSize - number of results per page

Returns:

a list of log entries.

See Also:

DateRangeQueryConstants

queryLogsByPage

public List<LogEntry> queryLogsByPage(String[] eventIds,
                             Date limit,
                             String category,
                             String path,
                             int pageNb,
                             int pageSize)

Description copied from interface: AuditReader

Returns the batched list of log entries.

Note we will use NXQL in the future when the search engine will index history.

Specified by:

queryLogsByPage in interface AuditReader

Parameters:

eventIds - the event ids.

limit - filter events by date from limit to now

category - add filter on events category

path - add filter on document path

pageNb - page number (ignore if <=1)

pageSize - number of results per page

Returns:

a list of log entries.

See Also:

DateRangeQueryConstants

newLogEntry

public LogEntry newLogEntry()

Description copied from interface: AuditLogger

Create a new LogEntry instance.

Specified by:

newLogEntry in interface AuditLogger

Returns:

newExtendedInfo

public ExtendedInfo newExtendedInfo(Serializable value)

Description copied from interface: AuditLogger

Create a new ExtendedInfo instance

Specified by:

newExtendedInfo in interface AuditLogger

Returns:

logEvents

public void logEvents(EventBundle eventBundle)

Description copied from interface: AuditLogger

Logs a bundle of events

Specified by:

logEvents in interface AuditLogger

logEvent

public void logEvent(Event event)

Description copied from interface: AuditLogger

Logs an Event.

Specified by:

logEvent in interface AuditLogger

getLogEntriesFor

public List<LogEntry> getLogEntriesFor(String uuid)

Description copied from interface: AuditReader

Returns the logs given a doc uuid.

Specified by:

getLogEntriesFor in interface AuditReader

Parameters:

uuid - the document uuid

Returns:

a list of log entries

nativeQuery

public List<?> nativeQuery(String query,
                  int pageNb,
                  int pageSize)

Description copied from interface: AuditReader

Returns a batched list of entries. query string is a native query clause for the backend : here EJBQL 3.0 can be used

Specified by:

nativeQuery in interface AuditReader

queryLogs

public List<LogEntry> queryLogs(String[] eventIds,
                       String dateRange)

Description copied from interface: AuditReader

Returns the list of log entries.

Note we will use NXQL in the future when the search engine will index history.

Specified by:

queryLogs in interface AuditReader

Parameters:

eventIds - the event ids.

dateRange - a preset date range.

Returns:

a list of log entries.

See Also:

DateRangeQueryConstants

nativeQueryLogs

public List<LogEntry> nativeQueryLogs(String whereClause,
                             int pageNb,
                             int pageSize)

Description copied from interface: AuditReader

Returns a batched list of log entries. WhereClause is a native where clause for the backend: here EJBQL 3.0 can be used.

Specified by:

nativeQueryLogs in interface AuditReader