Package org.nuxeo.ecm.platform.audit.api
Interface AuditReader
- All Known Subinterfaces:
AuditBackend
,Logs
,LogsRemote
- All Known Implementing Classes:
AbstractAuditBackend
,DefaultAuditBackend
,ESAuditBackend
,MongoDBAuditBackend
public interface AuditReader
Interface for reading data from the Audit service.
- Author:
- tiry
-
Method Summary
Modifier and TypeMethodDescriptionlong
getLatestLogId
(String repositoryId, String... eventIds) Returns the latest log id matching events and repository or 0 when no match found.getLogEntriesAfter
(long logIdOffset, int limit, String repositoryId, String... eventIds) Returns up to limit log entries matching events and repository with log id greater or equal to logIdOffset.getLogEntriesFor
(String uuid, String repositoryId) Returns the logs given a doc uuid and a repository id.getLogEntryByID
(long id) Returns a given log entry given its id.default List<?>
nativeQuery
(String query, int pageNb, int pageSize) Returns a batched list of entries. query string is a native query clause for the backend : here EJBQL 3.0 must be used if implementation of audit backend is JPA (< 7.3 or audit.elasticsearch.enabled=false) and JSON if implementation is Elasticsearch.List<?>
nativeQuery
(String query, Map<String, Object> params, int pageNb, int pageSize) Returns a batched list of entries.nativeQueryLogs
(String whereClause, int pageNb, int pageSize) Returns a batched list of log entries.Returns the list of log entries.queryLogs
(QueryBuilder builder) Returns the logs given a collection of predicates and a default sort.queryLogsByPage
(String[] eventIds, String dateRange, String[] categories, String path, int pageNb, int pageSize) queryLogsByPage
(String[] eventIds, String dateRange, String category, String path, int pageNb, int pageSize) Returns the batched list of log entries.queryLogsByPage
(String[] eventIds, Date limit, String[] categories, String path, int pageNb, int pageSize) queryLogsByPage
(String[] eventIds, Date limit, String category, String path, int pageNb, int pageSize) Returns the batched list of log entries.
-
Method Details
-
getLogEntriesFor
Returns the logs given a doc uuid and a repository id.- Parameters:
uuid
- the document uuidrepositoryId
- the repository id- Returns:
- a list of log entries
- Since:
- 8.4
-
getLogEntryByID
Returns a given log entry given its id.- Parameters:
id
- the log entry identifier- Returns:
- a LogEntry instance
-
queryLogs
Returns the logs given a collection of predicates and a default sort.- Parameters:
builder
- the query builder to fetch log entries- Returns:
- a list of log entries
- Since:
- 9.3
-
queryLogs
Returns the list of log entries.Note we will use NXQL in the future when the search engine will index history.
- Parameters:
eventIds
- the event ids.dateRange
- a preset date range.- Returns:
- a list of log entries.
- See Also:
-
queryLogsByPage
default List<LogEntry> queryLogsByPage(String[] eventIds, String dateRange, String category, String path, int pageNb, int pageSize) Returns the batched list of log entries.Note we will use NXQL in the future when the search engine will index history.
- Parameters:
eventIds
- the event ids.dateRange
- a preset date range.category
- add filter on events categorypath
- add filter on document pathpageNb
- page number (ignore if <=1)pageSize
- number of results per page- Returns:
- a list of log entries.
- See Also:
-
queryLogsByPage
-
queryLogsByPage
default List<LogEntry> queryLogsByPage(String[] eventIds, Date limit, String category, String path, int pageNb, int pageSize) Returns the batched list of log entries.Note we will use NXQL in the future when the search engine will index history.
- Parameters:
eventIds
- the event ids.limit
- filter events by date from limit to nowcategory
- add filter on events categorypath
- add filter on document pathpageNb
- page number (ignore if <=1)pageSize
- number of results per page- Returns:
- a list of log entries.
- See Also:
-
queryLogsByPage
-
nativeQueryLogs
Returns a batched list of log entries. WhereClause is a native where clause for the backend: here EJBQL 3.0 must be used if implementation of audit backend is JPA (< 7.3 or audit.elasticsearch.enabled=false) and JSON if implementation is Elasticsearch. -
nativeQuery
Returns a batched list of entries. query string is a native query clause for the backend : here EJBQL 3.0 must be used if implementation of audit backend is JPA (< 7.3 or audit.elasticsearch.enabled=false) and JSON if implementation is Elasticsearch. -
nativeQuery
Returns a batched list of entries.- Parameters:
query
- a JPA query language query if implementation of audit backend is JPA (< 7.3 or audit.elasticsearch.enabled=false) and JSON if implementation is Elasticsearchparams
- parameters for the querypageNb
- the page number (starts at 1)pageSize
- the number of results per page
-
getLatestLogId
Returns the latest log id matching events and repository or 0 when no match found.- Since:
- 9.3
-
getLogEntriesAfter
List<LogEntry> getLogEntriesAfter(long logIdOffset, int limit, String repositoryId, String... eventIds) Returns up to limit log entries matching events and repository with log id greater or equal to logIdOffset.- Since:
- 9.3
-