Class AccessLogPublisher<T extends AccessLogPublisherCfg>
- java.lang.Object
-
- org.opends.server.loggers.AccessLogPublisher<T>
-
- Type Parameters:
T
- The type of access log publisher configuration handled by this log publisher implementation.
- All Implemented Interfaces:
Closeable
,AutoCloseable
,LogPublisher<T>
- Direct Known Subclasses:
TextAccessLogPublisher
,TextAuditLogPublisher
@PublicAPI(stability=VOLATILE, mayExtend=true) public abstract class AccessLogPublisher<T extends AccessLogPublisherCfg> extends Object implements LogPublisher<T>
This class defines the set of methods and structures that must be implemented for a Directory Server access log publisher.
-
-
Constructor Summary
Constructors Constructor Description AccessLogPublisher()
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description boolean
isConfigurationAcceptable(T configuration, List<LocalizableMessage> unacceptableReasons)
Indicates whether the provided configuration is acceptable for this log publisher.void
logAbandonRequest(RequestContext context, AbandonRequest request)
Writes a message to the access logger with information about the provided abandon request.void
logAbandonResult(RequestContext context, AbandonRequest request, Result result)
Writes a message to the access logger with information about the provided result.void
logAddRequest(RequestContext context, AddRequest request)
Writes a message to the access logger with information about the add request.void
logAddResult(RequestContext context, AddRequest request, Result result)
Writes a message to the access logger with information about the add result.void
logBindRequest(RequestContext context, BindRequest request)
Writes a message to the access logger with information about the bind request.void
logBindResult(RequestContext context, BindRequest request, Result result)
Writes a message to the access logger with information about the bind result.void
logCompareRequest(RequestContext context, CompareRequest request)
Writes a message to the access logger with information about the compare request.void
logCompareResult(RequestContext context, CompareRequest request, Result result)
Writes a message to the access logger with information about the compare result.void
logConnect(ClientConnection clientConnection)
Writes a message to the access logger with information about a new client connection that has been established, regardless of whether it will be immediately terminated.void
logDeleteRequest(RequestContext context, DeleteRequest request)
Writes a message to the access logger with information about the delete request.void
logDeleteResult(RequestContext context, DeleteRequest request, Result result)
Writes a message to the access logger with information about the delete result.void
logDisconnect(ClientConnection clientConnection, DisconnectReason disconnectReason, LocalizableMessage message)
Writes a message to the access logger with information about the termination of an existing client connection.void
logExtendedRequest(RequestContext context, ExtendedRequest<?> request)
Writes a message to the access logger with information about the extended request.void
logExtendedResult(RequestContext context, ExtendedRequest<?> request, Result result)
Writes a message to the access logger with information about the extended result.void
logInvalidRequest(RequestContext context, InvalidRequest request)
Writes a message to the access logger with information about an invalid request.void
logInvalidResult(RequestContext context, InvalidRequest request, Result result)
Writes a message to the access logger with information about the result.void
logModifyDnRequest(RequestContext context, ModifyDnRequest request)
Writes a message to the access logger with information about the modifyDN request.void
logModifyDnResult(RequestContext context, ModifyDnRequest request, Result result)
Writes a message to the access logger with information about the modifyDN result.void
logModifyRequest(RequestContext context, ModifyRequest request)
Writes a message to the access logger with information about the modify request.void
logModifyResult(RequestContext context, ModifyRequest request, Result result)
Writes a message to the access logger with information about the modify result.void
logSearchRequest(RequestContext context, SearchRequest request)
Writes a message to the access logger with information about the search request.void
logSearchResult(RequestContext context, SearchRequest request, Result result)
Writes a message to the access logger with information about the search result.void
logTlsHandshake(ConnectionContext connectionContext)
Writes a message to the access logger with information about the TLS handshake.void
logUnbind(RequestContext context, UnbindRequest request)
Writes a message to the access logger with information about the provided unbind request.-
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
-
Methods inherited from interface org.opends.server.loggers.LogPublisher
close, getDN, initializeLogPublisher
-
-
-
-
Method Detail
-
isConfigurationAcceptable
public boolean isConfigurationAcceptable(T configuration, List<LocalizableMessage> unacceptableReasons)
Description copied from interface:LogPublisher
Indicates 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.- Specified by:
isConfigurationAcceptable
in interfaceLogPublisher<T extends AccessLogPublisherCfg>
- 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:
true
if the provided configuration is acceptable for this log publisher, orfalse
if not.
-
logConnect
public void logConnect(ClientConnection clientConnection)
Writes a message to the access logger with information about a new client connection that has been established, regardless of whether it will be immediately terminated.The default implementation is to not log anything.
- Parameters:
clientConnection
- The client connection that has been established.
-
logDisconnect
public void logDisconnect(ClientConnection clientConnection, DisconnectReason disconnectReason, LocalizableMessage message)
Writes a message to the access logger with information about the termination of an existing client connection.The default implementation is to not log anything.
- Parameters:
clientConnection
- The client connection that has been terminated.disconnectReason
- A generic disconnect reason for the connection termination.message
- A human-readable message that can provide additional information about the disconnect.
-
logAbandonRequest
public void logAbandonRequest(RequestContext context, AbandonRequest request)
Writes a message to the access logger with information about the provided abandon request.The default implementation is to not log anything.
- Parameters:
context
- the logging context for the requestrequest
- the abandon request to log
-
logAbandonResult
public void logAbandonResult(RequestContext context, AbandonRequest request, Result result)
Writes a message to the access logger with information about the provided result. Note there is no LDAP result sent back to client, it is for logging purposes only.- Parameters:
context
- the context for the requestrequest
- the original abandon requestresult
- theResult
to the abandon request
-
logAddRequest
public void logAddRequest(RequestContext context, AddRequest request)
Writes a message to the access logger with information about the add request.The default implementation is to not log anything.
- Parameters:
context
- the logging context for the requestrequest
- the add request to log
-
logAddResult
public void logAddResult(RequestContext context, AddRequest request, Result result)
Writes a message to the access logger with information about the add result.The default implementation is to not log anything.
- Parameters:
context
- the logging context for the requestrequest
- the original add requestresult
- the result to log
-
logBindRequest
public void logBindRequest(RequestContext context, BindRequest request)
Writes a message to the access logger with information about the bind request.The default implementation is to not log anything.
- Parameters:
context
- the logging context for the requestrequest
- the bind request to log
-
logBindResult
public void logBindResult(RequestContext context, BindRequest request, Result result)
Writes a message to the access logger with information about the bind result.The default implementation is to not log anything.
- Parameters:
context
- the logging context for the requestrequest
- the original bind requestresult
- the result to log
-
logCompareRequest
public void logCompareRequest(RequestContext context, CompareRequest request)
Writes a message to the access logger with information about the compare request.The default implementation is to not log anything.
- Parameters:
context
- the logging context for the requestrequest
- the compare request to log
-
logCompareResult
public void logCompareResult(RequestContext context, CompareRequest request, Result result)
Writes a message to the access logger with information about the compare result.The default implementation is to not log anything.
- Parameters:
context
- the logging context for the requestrequest
- the original compare requestresult
- the result to log
-
logDeleteRequest
public void logDeleteRequest(RequestContext context, DeleteRequest request)
Writes a message to the access logger with information about the delete request.The default implementation is to not log anything.
- Parameters:
context
- the logging context for the requestrequest
- the original delete request
-
logDeleteResult
public void logDeleteResult(RequestContext context, DeleteRequest request, Result result)
Writes a message to the access logger with information about the delete result.The default implementation is to not log anything.
- Parameters:
context
- the logging context for the requestrequest
- the original delete requestresult
- the result to log
-
logExtendedRequest
public void logExtendedRequest(RequestContext context, ExtendedRequest<?> request)
Writes a message to the access logger with information about the extended request.The default implementation is to not log anything.
- Parameters:
context
- the logging context for the requestrequest
- the original extended request
-
logExtendedResult
public void logExtendedResult(RequestContext context, ExtendedRequest<?> request, Result result)
Writes a message to the access logger with information about the extended result.The default implementation is to not log anything.
- Parameters:
context
- the logging context for the requestrequest
- the original extended requestresult
- the result to log
-
logInvalidRequest
public void logInvalidRequest(RequestContext context, InvalidRequest request)
Writes a message to the access logger with information about an invalid request.- Parameters:
context
- the context for this requestrequest
- the description of the invalid request to log
-
logInvalidResult
public void logInvalidResult(RequestContext context, InvalidRequest request, Result result)
Writes a message to the access logger with information about the result.The default implementation is to not log anything.
- Parameters:
context
- the logging context for the requestrequest
- the original description of the invalid requestresult
- the result to log
-
logModifyRequest
public void logModifyRequest(RequestContext context, ModifyRequest request)
Writes a message to the access logger with information about the modify request.The default implementation is to not log anything.
- Parameters:
context
- the logging context for the requestrequest
- the original modify request
-
logModifyResult
public void logModifyResult(RequestContext context, ModifyRequest request, Result result)
Writes a message to the access logger with information about the modify result.The default implementation is to not log anything.
- Parameters:
context
- the logging context for the requestrequest
- the original modify requestresult
- the result to log
-
logModifyDnRequest
public void logModifyDnRequest(RequestContext context, ModifyDnRequest request)
Writes a message to the access logger with information about the modifyDN request.The default implementation is to not log anything.
- Parameters:
context
- the logging context for the requestrequest
- the original modifyDN request
-
logModifyDnResult
public void logModifyDnResult(RequestContext context, ModifyDnRequest request, Result result)
Writes a message to the access logger with information about the modifyDN result.The default implementation is to not log anything.
- Parameters:
context
- the logging context for the requestrequest
- the original modifyDN requestresult
- the result to log
-
logSearchRequest
public void logSearchRequest(RequestContext context, SearchRequest request)
Writes a message to the access logger with information about the search request.The default implementation is to not log anything.
- Parameters:
context
- the logging context for the requestrequest
- the original search request
-
logSearchResult
public void logSearchResult(RequestContext context, SearchRequest request, Result result)
Writes a message to the access logger with information about the search result.The default implementation is to not log anything.
- Parameters:
context
- the logging context for the requestrequest
- the original search requestresult
- the result to log
-
logTlsHandshake
public void logTlsHandshake(ConnectionContext connectionContext)
Writes a message to the access logger with information about the TLS handshake.The default implementation is to not log anything.
- Parameters:
connectionContext
- the logging context for the connection
-
logUnbind
public void logUnbind(RequestContext context, UnbindRequest request)
Writes a message to the access logger with information about the provided unbind request.The default implementation is to not log anything.
- Parameters:
context
- the logging context for the requestrequest
- the unbind request to log
-
-