Package org.opends.server.loggers
Class TextAuditLogPublisher
- java.lang.Object
-
- org.opends.server.loggers.AccessLogPublisher<T>
-
- org.opends.server.loggers.TextAuditLogPublisher
-
- All Implemented Interfaces:
Closeable,AutoCloseable,ConfigurationChangeListener<FileBasedAuditLogPublisherCfg>,LogPublisher<FileBasedAuditLogPublisherCfg>
public final class TextAuditLogPublisher extends AccessLogPublisher<T> implements ConfigurationChangeListener<FileBasedAuditLogPublisherCfg>
This class provides the implementation of the audit logger used by the directory server.
-
-
Constructor Summary
Constructors Constructor Description TextAuditLogPublisher()
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description ConfigChangeResultapplyConfigurationChange(FileBasedAuditLogPublisherCfg config)Applies the configuration changes to this change listener.protected voidbuildFilters(boolean suppressInternal)For startup access logger.voidclose()Close this publisher.protected voidclose0()Release any resources owned by the sub-implementation.DNgetDN()Gets the DN of the configuration entry for this log publisher.protected voidinitializeFilters(T config)Initializes the filter configuration.voidinitializeLogPublisher(FileBasedAuditLogPublisherCfg cfg, ServerContext serverContext)Initializes this publisher provider based on the information in the provided debug publisher configuration.booleanisConfigurationAcceptable(FileBasedAuditLogPublisherCfg configuration, List<org.forgerock.i18n.LocalizableMessage> unacceptableReasons)Indicates whether the provided configuration is acceptable for this log publisher.booleanisConfigurationChangeAcceptable(FileBasedAuditLogPublisherCfg config, List<org.forgerock.i18n.LocalizableMessage> unacceptableReasons)Indicates whether the proposed change to the configuration is acceptable to this change listener.protected booleanisConnectLoggable(ClientConnection c)Returnstrueif the provided client connect should be logged.protected booleanisDisconnectLoggable(ClientConnection c)Returnstrueif the provided client disconnect should be logged.protected booleanisFilterConfigurationAcceptable(T config, List<org.forgerock.i18n.LocalizableMessage> unacceptableReasons)Perform any initialization required by the sub-implementation.protected booleanisRequestLoggable(Operation o)Returnstrueif the provided request should be logged.protected booleanisResponseLoggable(Operation o)Returnstrueif the provided response should be logged.voidlogAddResponse(AddOperation addOperation)Writes a message to the access logger with information about the add response associated with the provided add operation.voidlogDeleteResponse(DeleteOperation deleteOperation)Writes a message to the access logger with information about the delete response associated with the provided delete operation.voidlogModifyDNResponse(ModifyDNOperation modifyDNOperation)Writes a message to the access logger with information about the modify DN response associated with the provided modify DN operation.voidlogModifyResponse(ModifyOperation modifyOperation)Writes a message to the access logger with information about the modify response associated with the provided modify operation.-
Methods inherited from class org.opends.server.loggers.AccessLogPublisher
logAbandonRequest, logAbandonResult, logAddRequest, logBindRequest, logBindResponse, logCompareRequest, logCompareResponse, logConnect, logDeleteRequest, logDisconnect, logExtendedRequest, logExtendedResponse, logModifyDNRequest, logModifyRequest, logSearchRequest, logSearchResultDone, logUnbind
-
-
-
-
Method Detail
-
applyConfigurationChange
public ConfigChangeResult applyConfigurationChange(FileBasedAuditLogPublisherCfg config)
Description copied from interface:ConfigurationChangeListenerApplies the configuration changes to this change listener.- Specified by:
applyConfigurationChangein interfaceConfigurationChangeListener<FileBasedAuditLogPublisherCfg>- Parameters:
config- The new configuration containing the changes.- Returns:
- Returns information about the result of changing the configuration.
-
close0
protected void close0()
Release any resources owned by the sub-implementation.
-
initializeLogPublisher
public void initializeLogPublisher(FileBasedAuditLogPublisherCfg cfg, ServerContext serverContext) throws ConfigException, InitializationException
Description copied from interface:LogPublisherInitializes this publisher provider based on the information in the provided debug publisher configuration.- Specified by:
initializeLogPublisherin interfaceLogPublisher<FileBasedAuditLogPublisherCfg>- Parameters:
cfg- The publisher configuration that contains the information to use to initialize this publisher.serverContext- The server context.- Throws:
ConfigException- If an unrecoverable problem arises in the process of performing the initialization as a result of the server configuration.InitializationException- If a problem occurs during initialization that is not related to the server configuration.
-
isConfigurationAcceptable
public boolean isConfigurationAcceptable(FileBasedAuditLogPublisherCfg configuration, List<org.forgerock.i18n.LocalizableMessage> unacceptableReasons)
Description copied from interface:LogPublisherIndicates whether the provided configuration is acceptable for this log publisher. It should be possible to call this method on an uninitialized log publisher instance in order to determine whether the log publisher would be able to use the provided configuration.
Note that implementations which use a subclass of the provided configuration class will likely need to cast the configuration to the appropriate subclass type.- Specified by:
isConfigurationAcceptablein interfaceLogPublisher<FileBasedAuditLogPublisherCfg>- Overrides:
isConfigurationAcceptablein classAccessLogPublisher<FileBasedAuditLogPublisherCfg>- Parameters:
configuration- The log publisher configuration for which to make the determination.unacceptableReasons- A list that may be used to hold the reasons that the provided configuration is not acceptable.- Returns:
trueif the provided configuration is acceptable for this log publisher, orfalseif not.
-
isConfigurationChangeAcceptable
public boolean isConfigurationChangeAcceptable(FileBasedAuditLogPublisherCfg config, List<org.forgerock.i18n.LocalizableMessage> unacceptableReasons)
Description copied from interface:ConfigurationChangeListenerIndicates whether the proposed change to the configuration is acceptable to this change listener.- Specified by:
isConfigurationChangeAcceptablein interfaceConfigurationChangeListener<FileBasedAuditLogPublisherCfg>- Parameters:
config- The new configuration containing the changes.unacceptableReasons- A list that can be used to hold messages about why the provided configuration is not acceptable.- Returns:
- Returns
trueif the proposed change is acceptable, orfalseif it is not.
-
logAddResponse
public void logAddResponse(AddOperation addOperation)
Description copied from class:AccessLogPublisherWrites a message to the access logger with information about the add response associated with the provided add operation.The default implementation is to not log anything.
- Overrides:
logAddResponsein classAccessLogPublisher<FileBasedAuditLogPublisherCfg>- Parameters:
addOperation- The add operation containing the information to use to log the add response.
-
logDeleteResponse
public void logDeleteResponse(DeleteOperation deleteOperation)
Description copied from class:AccessLogPublisherWrites a message to the access logger with information about the delete response associated with the provided delete operation.The default implementation is to not log anything.
- Overrides:
logDeleteResponsein classAccessLogPublisher<FileBasedAuditLogPublisherCfg>- Parameters:
deleteOperation- The delete operation containing the information to use to log the delete response.
-
logModifyDNResponse
public void logModifyDNResponse(ModifyDNOperation modifyDNOperation)
Description copied from class:AccessLogPublisherWrites a message to the access logger with information about the modify DN response associated with the provided modify DN operation.The default implementation is to not log anything.
- Overrides:
logModifyDNResponsein classAccessLogPublisher<FileBasedAuditLogPublisherCfg>- Parameters:
modifyDNOperation- The modify DN operation containing the information to use to log the modify DN response.
-
logModifyResponse
public void logModifyResponse(ModifyOperation modifyOperation)
Description copied from class:AccessLogPublisherWrites a message to the access logger with information about the modify response associated with the provided modify operation.The default implementation is to not log anything.
- Overrides:
logModifyResponsein classAccessLogPublisher<FileBasedAuditLogPublisherCfg>- Parameters:
modifyOperation- The modify operation containing the information to use to log the modify response.
-
close
public final void close()
Description copied from interface:LogPublisherClose this publisher.
-
getDN
public final DN getDN()
Description copied from interface:LogPublisherGets the DN of the configuration entry for this log publisher.- Returns:
- The configuration entry DN.
-
buildFilters
protected void buildFilters(boolean suppressInternal)
For startup access logger.- Parameters:
suppressInternal-trueif internal operations should be suppressed.
-
initializeFilters
protected final void initializeFilters(T config) throws ConfigException, InitializationExceptionInitializes the filter configuration. This method must be called by sub-classes during initialization.- Parameters:
config- The access publisher configuration that contains the information to use to initialize this access publisher.- Throws:
ConfigException- If an unrecoverable problem arises in the process of performing the initialization as a result of the server configuration.InitializationException- If a problem occurs during initialization that is not related to the server configuration.
-
isConnectLoggable
protected final boolean isConnectLoggable(ClientConnection c)
Returnstrueif the provided client connect should be logged.- Parameters:
c- The client connection.- Returns:
trueif the provided client connect should be logged.
-
isDisconnectLoggable
protected final boolean isDisconnectLoggable(ClientConnection c)
Returnstrueif the provided client disconnect should be logged.- Parameters:
c- The client connection.- Returns:
trueif the provided client disconnect should be logged.
-
isFilterConfigurationAcceptable
protected final boolean isFilterConfigurationAcceptable(T config, List<org.forgerock.i18n.LocalizableMessage> unacceptableReasons)Perform any initialization required by the sub-implementation.- Parameters:
config- The access publisher configuration that contains the information to use to initialize this access publisher.unacceptableReasons- A list that may be used to hold the reasons that the provided configuration is not acceptable.- Returns:
trueif the provided configuration is acceptable for this access log publisher, orfalseif not.
-
isRequestLoggable
protected final boolean isRequestLoggable(Operation o)
Returnstrueif the provided request should be logged.- Parameters:
o- The request.- Returns:
trueif the provided request should be logged.
-
isResponseLoggable
protected final boolean isResponseLoggable(Operation o)
Returnstrueif the provided response should be logged.- Parameters:
o- The response.- Returns:
trueif the provided response should be logged.
-
-