Class AuditEventServiceImpl

java.lang.Object

ubic.gemma.persistence.service.common.auditAndSecurity.AuditEventServiceImpl

All Implemented Interfaces:

AuditEventService

@Service("auditEventService")
public class AuditEventServiceImpl
extends Object
implements AuditEventService

Author:

pavlidis

See Also:

• AuditEventService

Constructor Summary

Constructors

Constructor	Description
AuditEventServiceImpl(AuditEventDao auditEventDao)

Method Summary

Modifier and Type	Method	Description
<T extends Auditable> Map<T, AuditEvent>	getCreateEvents(Collection<T> auditables)
List<AuditEvent>	getEvents(Auditable auditable)
CursorPage<AuditEvent>	getEventsByCursor(Auditable auditable, Cursor cursor, int limit)	Keyset-pagination counterpart to AuditEventService.getEvents(Auditable) for the GET /datasets/{dataset}/auditEvents endpoint — see CURSOR_PAGINATION_STEP1_PLAN.md step 1q.
List<AuditEvent>	getEventsWithType(Auditable auditable)	Retrieve all events with an event type.
<T extends Auditable> Set<Long>	getIdsHavingEvent(Class<T> auditableClass, Collection<Class<? extends AuditEventType>> types)	Obtain the ids of every auditable of a class whose trail carries at least one event of any of the given types.
AuditEvent	getLastEvent(Auditable auditable)
AuditEvent	getLastEvent(Auditable auditable, Class<? extends AuditEventType> type)
AuditEvent	getLastEvent(Auditable auditable, Class<? extends AuditEventType> type, Collection<Class<? extends AuditEventType>> excludedTypes)
<T extends Auditable> Map<T, AuditEvent>	getLastEvents(Class<T> auditableClass, Class<? extends AuditEventType> type)
<T extends Auditable> Map<T, AuditEvent>	getLastEvents(Collection<T> auditables)	Obtain the latest typed event for each of the given auditables, whatever its type.
<T extends Auditable> Map<Class<? extends AuditEventType>, Map<T, AuditEvent>>	getLastEvents(Collection<T> auditables, Collection<Class<? extends AuditEventType>> types)	Fast method to retrieve auditEventTypes of multiple classes.
<T extends Auditable> Collection<T>	getNewSinceDate(Class<T> auditableClass, Date date)
<T extends Auditable> Collection<T>	getUpdatedSinceDate(Class<T> auditableClass, Date date)
boolean	hasEvent(Auditable a, Class<? extends AuditEventType> type)
void	retainHavingEvent(Collection<? extends Auditable> a, Class<? extends AuditEventType> type)
void	retainLackingEvent(Collection<? extends Auditable> a, Class<? extends AuditEventType> type)

Methods inherited from class Object

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

Constructor Details

AuditEventServiceImpl

@Autowired
public AuditEventServiceImpl(AuditEventDao auditEventDao)

Method Details

getEvents

@Transactional(readOnly=true)
public List<AuditEvent> getEvents(Auditable auditable)

Specified by:

getEvents in interface AuditEventService

getEventsWithType

@Transactional(readOnly=true)
public List<AuditEvent> getEventsWithType(Auditable auditable)

Description copied from interface: AuditEventService

Retrieve all events with an event type.

Specified by:

getEventsWithType in interface AuditEventService

getEventsByCursor

@Transactional(readOnly=true)
public CursorPage<AuditEvent> getEventsByCursor(Auditable auditable,
 @Nullable
 Cursor cursor,
 int limit)

Description copied from interface: AuditEventService

Keyset-pagination counterpart to AuditEventService.getEvents(Auditable) for the GET /datasets/{dataset}/auditEvents endpoint — see CURSOR_PAGINATION_STEP1_PLAN.md step 1q. Mirrors the AuditEventDao.getEventsByCursor(Auditable, Cursor, int) contract (id-asc keyset, limit+1 probe for hasMore, totalElements null by default). The auditable-trail scope and ACL check is preserved.

Specified by:

getEventsByCursor in interface AuditEventService

getCreateEvents

@Transactional(readOnly=true)
public <T extends Auditable> Map<T, AuditEvent> getCreateEvents(Collection<T> auditables)

Specified by:

getCreateEvents in interface AuditEventService

getLastEvent

@Transactional(readOnly=true)
public AuditEvent getLastEvent(Auditable auditable)

Specified by:

getLastEvent in interface AuditEventService

getLastEvent

@Transactional(readOnly=true)
public AuditEvent getLastEvent(Auditable auditable,
 Class<? extends AuditEventType> type)

Specified by:

getLastEvent in interface AuditEventService

getLastEvent

@Transactional(readOnly=true)
public AuditEvent getLastEvent(Auditable auditable,
 Class<? extends AuditEventType> type,
 Collection<Class<? extends AuditEventType>> excludedTypes)

Specified by:

getLastEvent in interface AuditEventService

getLastEvents

@Transactional(readOnly=true)
public <T extends Auditable> Map<T, AuditEvent> getLastEvents(Class<T> auditableClass,
 Class<? extends AuditEventType> type)

Specified by:

getLastEvents in interface AuditEventService

getIdsHavingEvent

@Transactional(readOnly=true)
public <T extends Auditable> Set<Long> getIdsHavingEvent(Class<T> auditableClass,
 Collection<Class<? extends AuditEventType>> types)

Description copied from interface: AuditEventService

Obtain the ids of every auditable of a class whose trail carries at least one event of any of the given types. One query, whatever the number of types.

🛑 Bare ids, so there is no securable object to hang an ACL check on and none is applied — the @PostFilter the sibling above uses has nothing to filter here. Treat the result as a narrowing step and intersect it with an ACL-filtered load (e.g. ExpressionExperimentService.load(Filters, Sort), whose ACL clause is in-query) before any of these ids reaches a caller.

Specified by:

getIdsHavingEvent in interface AuditEventService

See Also:

• AuditEventDao.getIdsHavingEvent(Class, Collection)

getLastEvents

@Transactional(readOnly=true)
public <T extends Auditable> Map<T, AuditEvent> getLastEvents(Collection<T> auditables)

Description copied from interface: AuditEventService

Obtain the latest typed event for each of the given auditables, whatever its type.

One query for the whole collection. Auditables whose trail carries no typed event at all are absent from the map rather than mapped to null; AuditEventService.getCreateEvents(Collection) is the batched fallback for those.

Specified by:

getLastEvents in interface AuditEventService

See Also:

• AuditEventDao.getLastEvents(Collection)

getLastEvents

@Transactional(readOnly=true)
public <T extends Auditable>
Map<Class<? extends AuditEventType>, Map<T, AuditEvent>> getLastEvents(Collection<T> auditables,
 Collection<Class<? extends AuditEventType>> types)

Description copied from interface: AuditEventService

Fast method to retrieve auditEventTypes of multiple classes.

Specified by:

getLastEvents in interface AuditEventService

Parameters:

auditables - auditables

types - types

Returns:

map of AuditEventType to a Map of Auditable to the AuditEvent matching that type. Note: cannot secure this very easily since map key is a Class.

getNewSinceDate

@Transactional(readOnly=true)
public <T extends Auditable> Collection<T> getNewSinceDate(Class<T> auditableClass,
 Date date)

Specified by:

getNewSinceDate in interface AuditEventService

getUpdatedSinceDate

@Transactional(readOnly=true)
public <T extends Auditable> Collection<T> getUpdatedSinceDate(Class<T> auditableClass,
 Date date)

Specified by:

getUpdatedSinceDate in interface AuditEventService

Parameters:

date - date

Returns:

a collection of Auditable objects that received at least one typed AuditEvent (i.e. eventType IS NOT NULL) since the date entered. Generic auto-UPDATE rows (action='U', eventType=null) are NOT counted — see AUDIT_SYSTEM_AUDIT.md Section 5, risk #1. Note that this security setting works even though auditables aren't necessarily securable; non-securable auditables will be returned. See AclEntryAfterInvocationCollectionFilteringProvider and applicationContext-security.xml

hasEvent

@Transactional(readOnly=true)
public boolean hasEvent(Auditable a,
 Class<? extends AuditEventType> type)

Specified by:

hasEvent in interface AuditEventService

retainHavingEvent

@Transactional(readOnly=true)
public void retainHavingEvent(Collection<? extends Auditable> a,
 Class<? extends AuditEventType> type)

Specified by:

retainHavingEvent in interface AuditEventService

retainLackingEvent

@Transactional(readOnly=true)
public void retainLackingEvent(Collection<? extends Auditable> a,
 Class<? extends AuditEventType> type)

Specified by:

retainLackingEvent in interface AuditEventService