Package org.craftercms.studio.api.v2.service.audit.internal

Interface AuditServiceInternal

All Known Implementing Classes:
AuditServiceInternalImpl
public interface AuditServiceInternal

  • Method Details

    • getAuditLog

      List<AuditLog> getAuditLog(String siteId, int offset, int limit, String user, List<String> operations, boolean includeParameters, ZonedDateTime dateFrom, ZonedDateTime dateTo, String target, String origin, String clusterNodeId, String sort, String order)
      Get audit log filtered by parameters
      Parameters:
      siteId - site identifier
      offset - offset of first record in result set
      limit - number of records to return as result set
      user - filter by user
      operations - filter by list of operations
      includeParameters - include audit log parameters in result set
      dateFrom - filter results by lower border for date
      dateTo - filter results by upper border for date
      target - filter results by target
      origin - filter results by origin
      clusterNodeId - filter results by cluster node
      sort - sort strategy
      order - order strategy
      Returns:
      List of audit log entries

    • getAuditLogTotal

      int getAuditLogTotal(String siteId, String user, List<String> operations, boolean includeParameters, ZonedDateTime dateFrom, ZonedDateTime dateTo, String target, String origin, String clusterNodeId)
      Get the audit log entry count given the provided filter parameters
      Parameters:
      siteId - site ID
      user - filter by user
      operations - filter by list of operations
      includeParameters - include audit log parameters in result set
      dateFrom - filter results by lower border for date
      dateTo - filter results by upper border for date
      target - filter results by target
      origin - filter results by origin
      clusterNodeId - filter results by cluster node
      Returns:
      total number of records matching the filter

    • getAuditLogEntry

      AuditLog getAuditLogEntry(String siteId, long auditLogId)
      Get audit log entry by id
      Parameters:
      siteId - the site ID. When null or empty, it will retrieve entries for all sites and include admin activities.
      auditLogId - id of audit log entry to get
      Returns:
      Audit log entry

    • insertAuditLog

      boolean insertAuditLog(AuditLog auditLog)
      Insert log audit entry
      Parameters:
      auditLog - Audit log to insert
      Returns:
      true if successful, otherwise false

    • createAuditLogEntry

      AuditLog createAuditLogEntry()
      Create Audit log entry and populate common properties
      Returns:
      Audit log entry

    • selectUserFeedEntries

      List<AuditLog> selectUserFeedEntries(String user, String siteId, int offset, int limit, String contentType, boolean hideLiveItems)

    • deleteAuditLogForSite

      void deleteAuditLogForSite(long siteId)
      Delete audit log for site
      Parameters:
      siteId - site id

    • getCommitAuthors

      List<CommitAuthor> getCommitAuthors(long siteId, List<String> commitIds, String path)
      Get commit authors from a list of commit ids This will look in the audit data and retrieve a CommitAuthor when:
      • There is an audit entry for the given commit id
      • AND the audit entry origin is API
      • AND the audit entry primary_target_value correspond to the given path
      Parameters:
      siteId - site id
      commitIds - commit ids
      path - path of the file
      Returns:
      list CommitAuthor of the commit

    • isAudited

      boolean isAudited(long siteId, String commitId)
      Check if a commit has been audited.
      Parameters:
      siteId - site id
      commitId - commit id
      Returns:
      true if there is an audit entry for the given commit id, otherwise false