Package org.odpi.openmetadata.repositoryservices.connectors.stores.auditlogstore

Class OMRSAuditLogStoreConnectorBase

java.lang.Object

org.odpi.openmetadata.frameworks.connectors.Connector

org.odpi.openmetadata.frameworks.connectors.ConnectorBase

org.odpi.openmetadata.repositoryservices.connectors.stores.auditlogstore.OMRSAuditLogStoreConnectorBase

All Implemented Interfaces:

org.odpi.openmetadata.frameworks.connectors.SecureConnectorExtension, org.odpi.openmetadata.frameworks.connectors.VirtualConnectorExtension, OMRSAuditLogStore

public abstract class OMRSAuditLogStoreConnectorBase
extends org.odpi.openmetadata.frameworks.connectors.ConnectorBase
implements OMRSAuditLogStore

OMRSAuditLogStoreConnectorBase is the base class for connectors that support the OMRSAuditLog. It has implementations of the query methods that throw "function not supported". This means that log destinations that do not support queries can ignore these methods. It also supports the start and stop method for the connector which only need to be overridden if the connector has work to do at these times

Method Summary

Modifier and Type	Method	Description
OMRSAuditLogRecord	getAuditLogRecord(String logRecordId)	Retrieve a specific audit log record.
List<OMRSAuditLogRecord>	getAuditLogRecordsByComponent(String component, Date startDate, Date endDate, int offset, int maximumRecords)	Retrieve a list of log records written by a specific component.
List<OMRSAuditLogRecord>	getAuditLogRecordsBySeverity(String severity, Date startDate, Date endDate, int offset, int maximumRecords)	Retrieve a list of log records that have specific severity.
List<OMRSAuditLogRecord>	getAuditLogRecordsByTimeStamp(Date startDate, Date endDate, int offset, int maximumRecords)	Retrieve a list of log records written in a specified time period.
String	getDestinationName()	Return the name of this audit log destination.
List<String>	getSupportedSeverities()	Return the list of supported severities that this destination is configured to support.
void	initialize(String connectorInstanceId, org.odpi.openmetadata.frameworks.connectors.properties.ConnectionDetails connectionDetails)	Call made by the ConnectorProvider to initialize the Connector with the base services.
String	storeLogRecord(org.odpi.openmetadata.frameworks.auditlog.AuditLogRecord logRecord)	Store the audit log record in the audit log store.
abstract String	storeLogRecord(OMRSAuditLogRecord logRecord)	Store the audit log record in the audit log store.

Methods inherited from class org.odpi.openmetadata.frameworks.connectors.ConnectorBase

disconnect, equals, getConnectedAssetProperties, getConnection, getConnectorInstanceId, hashCode, initializeConnectedAssetProperties, initializeEmbeddedConnectors, initializeSecretsStoreConnector, isActive, start, toString

Methods inherited from class org.odpi.openmetadata.frameworks.connectors.Connector

clearStatisticProperty, clearStatisticTimestamp, getConnectorStatistics, getStatisticCounter, getStatisticProperty, getStatisticTimestamp, incrementStatisticCounter, initializeStatisticCounter, setStatisticProperty, setStatisticTimestamp

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Method Details

getDestinationName

public String getDestinationName()

Return the name of this audit log destination.

Specified by:

getDestinationName in interface OMRSAuditLogStore

Returns:

string display name suitable for messages.

getSupportedSeverities

public List<String> getSupportedSeverities()

Return the list of supported severities that this destination is configured to support.

Specified by:

getSupportedSeverities in interface OMRSAuditLogStore

Returns:

list of severity names (see OMRSAuditLogRecordSeverity)

storeLogRecord

public abstract String storeLogRecord(OMRSAuditLogRecord logRecord)
                               throws InvalidParameterException,
RepositoryErrorException

Store the audit log record in the audit log store.

Specified by:

storeLogRecord in interface OMRSAuditLogStore

Parameters:

logRecord - log record to store

Returns:

unique identifier assigned to the log record

Throws:

InvalidParameterException - indicates that the logRecord parameter is invalid.

RepositoryErrorException - indicates that the audit log store is not available or has an error.

storeLogRecord

public String storeLogRecord(org.odpi.openmetadata.frameworks.auditlog.AuditLogRecord logRecord)
                      throws InvalidParameterException,
RepositoryErrorException

Store the audit log record in the audit log store.

Parameters:

logRecord - log record to store

Returns:

unique identifier assigned to the log record

Throws:

InvalidParameterException - indicates that the logRecord parameter is invalid.

RepositoryErrorException - indicates that the audit log store is not available or has an error.

getAuditLogRecord

public OMRSAuditLogRecord getAuditLogRecord(String logRecordId)
                                     throws InvalidParameterException,
FunctionNotSupportedException,
RepositoryErrorException

Retrieve a specific audit log record.

Specified by:

getAuditLogRecord in interface OMRSAuditLogStore

Parameters:

logRecordId - unique identifier for the log record

Returns:

requested audit log record

Throws:

InvalidParameterException - indicates that the logRecordId parameter is invalid.

FunctionNotSupportedException - indicates that the audit log store does not support queries.

RepositoryErrorException - indicates that the audit log store is not available or has an error.

getAuditLogRecordsByTimeStamp

public List<OMRSAuditLogRecord> getAuditLogRecordsByTimeStamp(Date startDate,
 Date endDate,
 int offset,
 int maximumRecords)
                                                       throws InvalidParameterException,
PagingErrorException,
FunctionNotSupportedException,
RepositoryErrorException

Retrieve a list of log records written in a specified time period. The offset and maximumRecords parameters support a paging

Specified by:

getAuditLogRecordsByTimeStamp in interface OMRSAuditLogStore

Parameters:

startDate - start of time period

endDate - end of time period

offset - offset of full collection to begin the return results

maximumRecords - maximum number of log records to return

Returns:

list of log records from the specified time period

Throws:

InvalidParameterException - indicates that the start and/or end date parameters are invalid.

PagingErrorException - indicates that the offset or the maximumRecords parameters are invalid.

FunctionNotSupportedException - indicates that the audit log store does not support queries.

RepositoryErrorException - indicates that the audit log store is not available or has an error.

getAuditLogRecordsBySeverity

public List<OMRSAuditLogRecord> getAuditLogRecordsBySeverity(String severity,
 Date startDate,
 Date endDate,
 int offset,
 int maximumRecords)
                                                      throws InvalidParameterException,
PagingErrorException,
FunctionNotSupportedException,
RepositoryErrorException

Retrieve a list of log records that have specific severity. The offset and maximumRecords parameters support a paging model.

Specified by:

getAuditLogRecordsBySeverity in interface OMRSAuditLogStore

Parameters:

severity - the severity value of messages to return

startDate - start of time period

endDate - end of time period

offset - offset of full collection to begin the return results

maximumRecords - maximum number of log records to return

Returns:

list of log records from the specified time period

Throws:

InvalidParameterException - indicates that the severity, start and/or end date parameters are invalid.

PagingErrorException - indicates that the offset or the maximumRecords parameters are invalid.

FunctionNotSupportedException - indicates that the audit log store does not support queries.

RepositoryErrorException - indicates that the audit log store is not available or has an error.

getAuditLogRecordsByComponent

public List<OMRSAuditLogRecord> getAuditLogRecordsByComponent(String component,
 Date startDate,
 Date endDate,
 int offset,
 int maximumRecords)
                                                       throws InvalidParameterException,
PagingErrorException,
FunctionNotSupportedException,
RepositoryErrorException

Retrieve a list of log records written by a specific component. The offset and maximumRecords parameters support a paging model.

Specified by:

getAuditLogRecordsByComponent in interface OMRSAuditLogStore

Parameters:

component - name of the component to retrieve events from

startDate - start of time period

endDate - end of time period

offset - offset of full collection to begin the return results

maximumRecords - maximum number of log records to return

Returns:

list of log records from the specified time period

Throws:

InvalidParameterException - indicates that the component, start and/or end date parameters are invalid.

PagingErrorException - indicates that the offset or the maximumRecords parameters are invalid.

FunctionNotSupportedException - indicates that the audit log store does not support queries.

RepositoryErrorException - indicates that the audit log store is not available or has an error.

initialize

public void initialize(String connectorInstanceId,
 org.odpi.openmetadata.frameworks.connectors.properties.ConnectionDetails connectionDetails)

Call made by the ConnectorProvider to initialize the Connector with the base services.

Overrides:

initialize in class org.odpi.openmetadata.frameworks.connectors.ConnectorBase

Parameters:

connectorInstanceId - unique id for the connector instance useful for messages etc

connectionDetails - POJO for the configuration used to create the connector.