com.atlassian.jira.auditing

Interface AuditingService

All Known Implementing Classes:

DefaultAuditingService

@ExperimentalApi
public interface AuditingService

Service for managing auditing records

Since:

v6.3

Method Summary

Methods

Modifier and Type	Method and Description
ServiceOutcome<Records>	getRecords(Integer offset, Integer maxResults, AuditingFilter filter)
Long	getTotalNumberOfRecords() Returns total number of audit records
ErrorCollection	storeRecord(String category, String summary, AssociatedItem objectItem, Iterable<ChangedValue> values, Iterable<AssociatedItem> associatedItems) Store record in Auditing Log
ErrorCollection	storeRecord(String category, String summary, String eventSourceKey, AssociatedItem objectItem, Iterable<ChangedValue> values, Iterable<AssociatedItem> associatedItems) /** Store record in Auditing Log along with plugin name created the event

Method Detail

getRecords

@Nonnull
ServiceOutcome<Records> getRecords(@Nullable
                                         Integer offset,
                                         @Nullable
                                         Integer maxResults,
                                         @Nullable
                                         AuditingFilter filter)

Parameters:

offset - the offset from which search starts

maxResults - maximum number of returned results

filter - defines how records should be filtered out before being returned, if null records will not be filtered

Returns:

Records instance wrapped in ServiceOutcome

storeRecord

@Nonnull
ErrorCollection storeRecord(@Nullable
                                  String category,
                                  @Nullable
                                  String summary,
                                  @Nullable
                                  AssociatedItem objectItem,
                                  @Nullable
                                  Iterable<ChangedValue> values,
                                  @Nullable
                                  Iterable<AssociatedItem> associatedItems)

Store record in Auditing Log

Parameters:

category - - category of the log record

summary - - description of the change

objectItem - - changed object

values - - changed values of the object item

associatedItems - - other objects that were affected by this change

associatedItems - @return

storeRecord

@Nonnull
ErrorCollection storeRecord(@Nonnull
                                  String category,
                                  @Nonnull
                                  String summary,
                                  @Nonnull
                                  String eventSourceKey,
                                  @Nullable
                                  AssociatedItem objectItem,
                                  @Nullable
                                  Iterable<ChangedValue> values,
                                  @Nullable
                                  Iterable<AssociatedItem> associatedItems)

/** Store record in Auditing Log along with plugin name created the event

Parameters:

category - - category of the log record

summary - - description of the change

eventSourceKey - - key of plugin which creates the record

objectItem - - changed object

values - - changed values of the object item

associatedItems - - other objects that were affected by this change

associatedItems - @return

getTotalNumberOfRecords

@Nonnull
Long getTotalNumberOfRecords()

Returns total number of audit records

Returns:

total number of records