Package com.unboundid.ldap.sdk
Class JSONLDAPConnectionLoggerProperties
- java.lang.Object
-
- com.unboundid.ldap.sdk.JSONLDAPConnectionLoggerProperties
-
- All Implemented Interfaces:
java.io.Serializable
@Mutable @ThreadSafety(level=NOT_THREADSAFE) public final class JSONLDAPConnectionLoggerProperties extends java.lang.Object implements java.io.Serializable
This class provides a data structure that can be used to define the properties to use when creating aJSONLDAPConnectionLogger.- See Also:
- Serialized Form
-
-
Constructor Summary
Constructors Constructor Description JSONLDAPConnectionLoggerProperties()Creates a new set of JSON LDAP connection logger properties with the default settings.JSONLDAPConnectionLoggerProperties(JSONLDAPConnectionLogger logger)Creates a new set of JSON LDAP connection logger properties using the configuration for the provided logger.JSONLDAPConnectionLoggerProperties(JSONLDAPConnectionLoggerProperties properties)Creates a new set of JSON LDAP connection logger properties that is a clone of the provided set of properties.
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description booleanflushAfterConnectMessages()Indicates whether the log handler should be flushed after logging each successful or failed connection attempt.booleanflushAfterDisconnectMessages()Indicates whether the log handler should be flushed after logging each disconnect.booleanflushAfterFinalResultMessages()Indicates whether the log handler should be flushed after logging the final result for each operation.booleanflushAfterNonFinalResultMessages()Indicates whether the log handler should be flushed after logging each non-final result (including search result entries, search result references, and intermediate response messages).booleanflushAfterRequestMessages()Indicates whether the log handler should be flushed after logging each request.java.util.Set<java.lang.String>getAttributesToRedact()Retrieves a set containing the names or OIDs of the attributes whose values should be redacted from log messages.java.util.Set<OperationType>getOperationTypes()Retrieves the set of operation types for which to log requests and results.SchemagetSchema()Retrieves the schema that will be used to identify alternate names and OIDs for attributes whose values should be redacted.booleanincludeAddAttributeNames()Indicates whether log messages about add requests should include the names of the attributes provided in the request.booleanincludeAddAttributeValues()Indicates whether log messages about add requests should include the values of the attributes provided in the request.booleanincludeControlOIDs()Indicates whether request and result log messages should include the OIDs of any controls included in that request or result.booleanincludeModifyAttributeNames()Indicates whether log messages about modify requests should include the names of the attributes modified in the request.booleanincludeModifyAttributeValues()Indicates whether log messages about modify requests should include the values of the attributes modified in the request.booleanincludeSearchEntryAttributeNames()Indicates whether log messages about search result entries should include the names of the attributes in the returned entry.booleanincludeSearchEntryAttributeValues()Indicates whether log messages about search result entries should include the values of the attributes in the returned entry.booleanlogConnects()Indicates whether to log successful and failed connection attempts.booleanlogDisconnects()Indicates whether to log disconnects.booleanlogFinalResults()Indicates whether to log messages about the final results for operations included in the set of operation types returned by thegetOperationTypes()method.booleanlogIntermediateResponses()Indicates whether to log messages about each intermediate response returned in the course of processing an operation.booleanlogRequests()Indicates whether to log messages about requests for operations included in the set of operation types returned by thegetOperationTypes()method.booleanlogSearchEntries()Indicates whether to log messages about each search result entry returned for search operations.booleanlogSearchReferences()Indicates whether to log messages about each search result reference returned for search operations.voidsetAttributesToRedact(java.lang.String... attributesToRedact)Specifies the names or OIDs of the attributes whose values should be redacted from log messages.voidsetAttributesToRedact(java.util.Collection<java.lang.String> attributesToRedact)Specifies the names or OIDs of the attributes whose values should be redacted from log messages.voidsetFlushAfterConnectMessages(boolean flushAfterConnectMessages)Specifies whether the log handler should be flushed after logging each successful or failed connection attempt.voidsetFlushAfterDisconnectMessages(boolean flushAfterDisconnectMessages)Specifies whether the log handler should be flushed after logging each disconnect.voidsetFlushAfterFinalResultMessages(boolean flushAfterFinalResultMessages)Specifies whether the log handler should be flushed after logging the final result for each operation.voidsetFlushAfterNonFinalResultMessages(boolean flushAfterNonFinalResultMessages)Specifies whether the log handler should be flushed after logging each non-final result (including search result entries, search result references, and intermediate result messages).voidsetFlushAfterRequestMessages(boolean flushAfterRequestMessages)Specifies whether the log handler should be flushed after logging each request.voidsetIncludeAddAttributeNames(boolean includeAddAttributeNames)Specifies whether log messages about add requests should include the names of the attributes provided in the request.voidsetIncludeAddAttributeValues(boolean includeAddAttributeValues)Specifies whether log messages about add requests should include the values of the attributes provided in the request.voidsetIncludeControlOIDs(boolean includeControlOIDs)Specifies whether request and result log messages should include the OIDs of any controls included in that request or result.voidsetIncludeModifyAttributeNames(boolean includeModifyAttributeNames)Specifies whether log messages about modify requests should include the names of the attributes modified in the request.voidsetIncludeModifyAttributeValues(boolean includeModifyAttributeValues)Specifies whether log messages about modify requests should include the values of the attributes modified in the request.voidsetIncludeSearchEntryAttributeNames(boolean includeSearchEntryAttributeNames)Specifies whether log messages about search result entries should include the names of the attributes in the returned entry.voidsetIncludeSearchEntryAttributeValues(boolean includeSearchEntryAttributeValues)Specifies whether log messages about search result entries should include the values of the attributes in the returned entry.voidsetLogConnects(boolean logConnects)Specifies whether to log successful and failed connection attempts.voidsetLogDisconnects(boolean logDisconnects)Specifies whether to log disconnects.voidsetLogFinalResults(boolean logFinalResults)Specifies whether to log messages about the final results for operations included in the set of operation types returned by thegetOperationTypes()method.voidsetLogIntermediateResponses(boolean logIntermediateResponses)Specifies whether to log messages about each intermediate response returned in the course of processing an operation.voidsetLogRequests(boolean logRequests)Specifies whether to log messages about requests for operations included in the set of operation types returned by thegetOperationTypes()method.voidsetLogSearchEntries(boolean logSearchEntries)Specifies whether to log messages about each search result entry returned for search operations.voidsetLogSearchReferences(boolean logSearchReferences)Specifies whether to log messages about each search result reference returned for search operations.voidsetOperationTypes(OperationType... operationTypes)Specifies the set of operation types for which to log requests and results.voidsetOperationTypes(java.util.Collection<OperationType> operationTypes)Specifies the set of operation types for which to log requests and results.voidsetSchema(Schema schema)Specifies the schema that will be used to identify alternate names and OIDs for attributes whose values should be redacted.java.lang.StringtoString()Retrieves a string representation of thisJSONLDAPConnectionLoggerPropertiesobject.voidtoString(java.lang.StringBuilder buffer)Appends a string representation of thisJSONLDAPConnectionLoggerPropertiesobject to the provided buffer.
-
-
-
Constructor Detail
-
JSONLDAPConnectionLoggerProperties
public JSONLDAPConnectionLoggerProperties()
Creates a new set of JSON LDAP connection logger properties with the default settings.
-
JSONLDAPConnectionLoggerProperties
public JSONLDAPConnectionLoggerProperties(@NotNull JSONLDAPConnectionLoggerProperties properties)
Creates a new set of JSON LDAP connection logger properties that is a clone of the provided set of properties.- Parameters:
properties- The set of properties to copy. It must not benull.
-
JSONLDAPConnectionLoggerProperties
public JSONLDAPConnectionLoggerProperties(@NotNull JSONLDAPConnectionLogger logger)
Creates a new set of JSON LDAP connection logger properties using the configuration for the provided logger.- Parameters:
logger- The JSON LDAP connection logger whose configuration should be used to create the set of properties.
-
-
Method Detail
-
logConnects
public boolean logConnects()
Indicates whether to log successful and failed connection attempts. Connection attempts will be logged by default.- Returns:
trueif connection attempts should be logged, orfalseif not.
-
setLogConnects
public void setLogConnects(boolean logConnects)
Specifies whether to log successful and failed connection attempts.- Parameters:
logConnects- Indicates whether to log successful and failed connection attempts.
-
logDisconnects
public boolean logDisconnects()
Indicates whether to log disconnects. Disconnects will be logged by default.- Returns:
trueif disconnects should be logged, orfalseif not.
-
setLogDisconnects
public void setLogDisconnects(boolean logDisconnects)
Specifies whether to log disconnects. Disconnects will be logged by default.- Parameters:
logDisconnects- Indicates whether to log disconnects.
-
logRequests
public boolean logRequests()
Indicates whether to log messages about requests for operations included in the set of operation types returned by thegetOperationTypes()method. Operation requests will be logged by default.- Returns:
trueif operation requests should be logged for appropriate operation types, orfalseif not.
-
setLogRequests
public void setLogRequests(boolean logRequests)
Specifies whether to log messages about requests for operations included in the set of operation types returned by thegetOperationTypes()method.- Parameters:
logRequests- Indicates whether to log messages about operation requests.
-
logFinalResults
public boolean logFinalResults()
Indicates whether to log messages about the final results for operations included in the set of operation types returned by thegetOperationTypes()method. Final operation results will be logged by default.- Returns:
trueif operation requests should be logged for appropriate operation types, orfalseif not.
-
setLogFinalResults
public void setLogFinalResults(boolean logFinalResults)
Specifies whether to log messages about the final results for operations included in the set of operation types returned by thegetOperationTypes()method.- Parameters:
logFinalResults- Indicates whether to log messages about final operation results.
-
logSearchEntries
public boolean logSearchEntries()
Indicates whether to log messages about each search result entry returned for search operations. This property will only be used if the set returned by thegetOperationTypes()method includesOperationType.SEARCH. Search result entries will not be logged by default.- Returns:
trueif search result entries should be logged, orfalseif not.
-
setLogSearchEntries
public void setLogSearchEntries(boolean logSearchEntries)
Specifies whether to log messages about each search result entry returned for search operations. This property will only be used if the set returned by thegetOperationTypes()method includesOperationType.SEARCH.- Parameters:
logSearchEntries- Indicates whether to log search result entry messages.
-
logSearchReferences
public boolean logSearchReferences()
Indicates whether to log messages about each search result reference returned for search operations. This property will only be used if the set returned by thegetOperationTypes()method includesOperationType.SEARCH. Search result references will not be logged by default.- Returns:
trueif search result references should be logged, orfalseif not.
-
setLogSearchReferences
public void setLogSearchReferences(boolean logSearchReferences)
Specifies whether to log messages about each search result reference returned for search operations. This property will only be used if the set returned by thegetOperationTypes()method includesOperationType.SEARCH.- Parameters:
logSearchReferences- Indicates whether to log search result reference messages.
-
logIntermediateResponses
public boolean logIntermediateResponses()
Indicates whether to log messages about each intermediate response returned in the course of processing an operation. Intermediate response messages will be logged by default.- Returns:
trueif intermediate response messages should be logged, orfalseif not.
-
setLogIntermediateResponses
public void setLogIntermediateResponses(boolean logIntermediateResponses)
Specifies whether to log messages about each intermediate response returned in the course of processing an operation.- Parameters:
logIntermediateResponses- Indicates whether to log intermediate response messages.
-
getOperationTypes
@NotNull public java.util.Set<OperationType> getOperationTypes()
Retrieves the set of operation types for which to log requests and results. All operation types will be logged by default.- Returns:
- The set of operation types for which to log requests and results.
-
setOperationTypes
public void setOperationTypes(@Nullable OperationType... operationTypes)
Specifies the set of operation types for which to log requests and results.- Parameters:
operationTypes- The set of operation types for which to log requests and results. It may benullor empty if no operation types should be logged.
-
setOperationTypes
public void setOperationTypes(@Nullable java.util.Collection<OperationType> operationTypes)
Specifies the set of operation types for which to log requests and results.- Parameters:
operationTypes- The set of operation types for which to log requests and results. It may benullor empty if no operation types should be logged.
-
includeAddAttributeNames
public boolean includeAddAttributeNames()
Indicates whether log messages about add requests should include the names of the attributes provided in the request. Add attribute names (but not values) will be logged by default.- Returns:
trueif add attribute names should be logged, orfalseif not.
-
setIncludeAddAttributeNames
public void setIncludeAddAttributeNames(boolean includeAddAttributeNames)
Specifies whether log messages about add requests should include the names of the attributes provided in the request.- Parameters:
includeAddAttributeNames- Indicates whether to include attribute names in add request log messages.
-
includeAddAttributeValues
public boolean includeAddAttributeValues()
Indicates whether log messages about add requests should include the values of the attributes provided in the request. This property will only be used ifincludeAddAttributeNamesreturnstrue. Values for attributes named in the set returned by thegetAttributesToRedact()method will be replaced with a value of "[REDACTED]". Add attribute names (but not values) will be logged by default.- Returns:
trueif add attribute values should be logged, orfalseif not.
-
setIncludeAddAttributeValues
public void setIncludeAddAttributeValues(boolean includeAddAttributeValues)
Specifies whether log messages about add requests should include the values of the attributes provided in the request. This property will only be used ifincludeAddAttributeNamesreturnstrue. Values for attributes named in the set returned by thegetAttributesToRedact()method will be replaced with a value of "[REDACTED]".- Parameters:
includeAddAttributeValues- Indicates whether to include attribute values in add request log messages.
-
includeModifyAttributeNames
public boolean includeModifyAttributeNames()
Indicates whether log messages about modify requests should include the names of the attributes modified in the request. Modified attribute names (but not values) will be logged by default.- Returns:
trueif modify attribute names should be logged, orfalseif not.
-
setIncludeModifyAttributeNames
public void setIncludeModifyAttributeNames(boolean includeModifyAttributeNames)
Specifies whether log messages about modify requests should include the names of the attributes modified in the request.- Parameters:
includeModifyAttributeNames- Indicates whether to include attribute names in modify request log messages.
-
includeModifyAttributeValues
public boolean includeModifyAttributeValues()
Indicates whether log messages about modify requests should include the values of the attributes modified in the request. This property will only be used ifincludeModifyAttributeNamesreturnstrue. Values for attributes named in the set returned by thegetAttributesToRedact()method will be replaced with a value of "[REDACTED]". Modify attribute names (but not values) will be logged by default.- Returns:
trueif modify attribute values should be logged, orfalseif not.
-
setIncludeModifyAttributeValues
public void setIncludeModifyAttributeValues(boolean includeModifyAttributeValues)
Specifies whether log messages about modify requests should include the values of the attributes modified in the request. This property will only be used ifincludeModifyAttributeNamesreturnstrue. Values for attributes named in the set returned by thegetAttributesToRedact()method will be replaced with a value of "[REDACTED]".- Parameters:
includeModifyAttributeValues- Indicates whether to include attribute values in modify request log messages.
-
includeSearchEntryAttributeNames
public boolean includeSearchEntryAttributeNames()
Indicates whether log messages about search result entries should include the names of the attributes in the returned entry. Entry attribute names (but not values) will be logged by default.- Returns:
trueif search result entry attribute names should be logged, orfalseif not.
-
setIncludeSearchEntryAttributeNames
public void setIncludeSearchEntryAttributeNames(boolean includeSearchEntryAttributeNames)
Specifies whether log messages about search result entries should include the names of the attributes in the returned entry.- Parameters:
includeSearchEntryAttributeNames- Indicates whether to include attribute names in search result entry log messages.
-
includeSearchEntryAttributeValues
public boolean includeSearchEntryAttributeValues()
Indicates whether log messages about search result entries should include the values of the attributes in the returned entry. This property will only be used ifincludeSearchEntryAttributeNamesreturnstrue. Values for attributes named in the set returned by thegetAttributesToRedact()method will be replaced with a value of "[REDACTED]". Entry attribute names (but not values) will be logged by default.- Returns:
trueif search result entry attribute values should be logged, orfalseif not.
-
setIncludeSearchEntryAttributeValues
public void setIncludeSearchEntryAttributeValues(boolean includeSearchEntryAttributeValues)
Specifies whether log messages about search result entries should include the values of the attributes in the returned entry. This property will only be used ifincludeSearchEntryAttributeNamesreturnstrue. Values for attributes named in the set returned by thegetAttributesToRedact()method will be replaced with a value of "[REDACTED]".- Parameters:
includeSearchEntryAttributeValues- Indicates whether to include attribute values in search result entry log messages.
-
getAttributesToRedact
@NotNull public java.util.Set<java.lang.String> getAttributesToRedact()
Retrieves a set containing the names or OIDs of the attributes whose values should be redacted from log messages. Values of the userPassword, authPassword, and unicodePWD attributes will be redacted by default.- Returns:
- A set containing the names or OIDs of the attributes whose values should be redacted from log messages, or an empty set if no attribute values should be redacted.
-
setAttributesToRedact
public void setAttributesToRedact(@Nullable java.lang.String... attributesToRedact)
Specifies the names or OIDs of the attributes whose values should be redacted from log messages.- Parameters:
attributesToRedact- The names or OIDs of the attributes whose values should be redacted. It may benullor empty if no attribute values should be redacted.
-
setAttributesToRedact
public void setAttributesToRedact(@Nullable java.util.Collection<java.lang.String> attributesToRedact)
Specifies the names or OIDs of the attributes whose values should be redacted from log messages.- Parameters:
attributesToRedact- The names or OIDs of the attributes whose values should be redacted. It may benullor empty if no attribute values should be redacted.
-
includeControlOIDs
public boolean includeControlOIDs()
Indicates whether request and result log messages should include the OIDs of any controls included in that request or result. Control OIDs will be logged by default.- Returns:
trueif request control OIDs should be logged, orfalseif not.
-
setIncludeControlOIDs
public void setIncludeControlOIDs(boolean includeControlOIDs)
Specifies whether request and result log messages should include the OIDs of any controls included in that request or result.- Parameters:
includeControlOIDs- Indicates whether to include control OIDs in request and result log messages.
-
flushAfterConnectMessages
public boolean flushAfterConnectMessages()
Indicates whether the log handler should be flushed after logging each successful or failed connection attempt. By default, the handler will be flushed after logging each connection attempt.- Returns:
trueif the log handler should be flushed after logging each connection attempt, orfalseif not.
-
setFlushAfterConnectMessages
public void setFlushAfterConnectMessages(boolean flushAfterConnectMessages)
Specifies whether the log handler should be flushed after logging each successful or failed connection attempt.- Parameters:
flushAfterConnectMessages- Indicates whether the log handler should be flushed after logging each connection attempt.
-
flushAfterDisconnectMessages
public boolean flushAfterDisconnectMessages()
Indicates whether the log handler should be flushed after logging each disconnect. By default, the handler will be flushed after logging each disconnect.- Returns:
trueif the log handler should be flushed after logging each disconnect, orfalseif not.
-
setFlushAfterDisconnectMessages
public void setFlushAfterDisconnectMessages(boolean flushAfterDisconnectMessages)
Specifies whether the log handler should be flushed after logging each disconnect.- Parameters:
flushAfterDisconnectMessages- Indicates whether the log handler should be flushed after logging each disconnect.
-
flushAfterRequestMessages
public boolean flushAfterRequestMessages()
Indicates whether the log handler should be flushed after logging each request. By default, the handler will be flushed after logging each final result, but not after logging requests or non-final results.- Returns:
trueif the log handler should be flushed after logging each request, orfalseif not.
-
setFlushAfterRequestMessages
public void setFlushAfterRequestMessages(boolean flushAfterRequestMessages)
Specifies whether the log handler should be flushed after logging each request.- Parameters:
flushAfterRequestMessages- Indicates whether the log handler should be flushed after logging each request.
-
flushAfterNonFinalResultMessages
public boolean flushAfterNonFinalResultMessages()
Indicates whether the log handler should be flushed after logging each non-final result (including search result entries, search result references, and intermediate response messages). By default, the handler will be flushed after logging each final result, but not after logging requests or non-final results.- Returns:
trueif the log handler should be flushed after logging each non-final result, orfalseif not.
-
setFlushAfterNonFinalResultMessages
public void setFlushAfterNonFinalResultMessages(boolean flushAfterNonFinalResultMessages)
Specifies whether the log handler should be flushed after logging each non-final result (including search result entries, search result references, and intermediate result messages).- Parameters:
flushAfterNonFinalResultMessages- Indicates whether the log handler should be flushed after logging each non-final result.
-
flushAfterFinalResultMessages
public boolean flushAfterFinalResultMessages()
Indicates whether the log handler should be flushed after logging the final result for each operation. By default, the handler will be flushed after logging each final result, but not after logging requests or non-final results.- Returns:
trueif the log handler should be flushed after logging each final result, orfalseif not.
-
setFlushAfterFinalResultMessages
public void setFlushAfterFinalResultMessages(boolean flushAfterFinalResultMessages)
Specifies whether the log handler should be flushed after logging the final result for each operation.- Parameters:
flushAfterFinalResultMessages- Indicates whether the log handler should be flushed after logging each final result.
-
getSchema
@Nullable public Schema getSchema()
Retrieves the schema that will be used to identify alternate names and OIDs for attributes whose values should be redacted. The LDAP SDK's default standard schema will be used by default.- Returns:
- The schema that will be used to identify alternate names and OIDs
for attributes whose values should be redacted, or
nullif no schema should be used.
-
setSchema
public void setSchema(@Nullable Schema schema)
Specifies the schema that will be used to identify alternate names and OIDs for attributes whose values should be redacted.- Parameters:
schema- The schema that will be used to identify alternate names and OIDs for attributes whose values should be redacted. It may benullif no schema should be used.
-
toString
@NotNull public java.lang.String toString()
Retrieves a string representation of thisJSONLDAPConnectionLoggerPropertiesobject.- Overrides:
toStringin classjava.lang.Object- Returns:
- A string representation of this
JSONLDAPConnectionLoggerPropertiesobject.
-
-