Package com.unboundid.ldap.sdk.unboundidds.logs

Class AddResultAccessLogMessage

java.lang.Object
com.unboundid.ldap.sdk.unboundidds.logs.LogMessage
com.unboundid.ldap.sdk.unboundidds.logs.AccessLogMessage
com.unboundid.ldap.sdk.unboundidds.logs.OperationAccessLogMessage
com.unboundid.ldap.sdk.unboundidds.logs.OperationRequestAccessLogMessage
com.unboundid.ldap.sdk.unboundidds.logs.AddRequestAccessLogMessage
com.unboundid.ldap.sdk.unboundidds.logs.AddResultAccessLogMessage
All Implemented Interfaces:
MinimalOperationResultAccessLogMessage, OperationResultAccessLogMessage, Serializable
Direct Known Subclasses:
AddAssuranceCompletedAccessLogMessage
@NotExtensible @NotMutable @ThreadSafety(level=COMPLETELY_THREADSAFE) public class AddResultAccessLogMessage extends AddRequestAccessLogMessage implements OperationResultAccessLogMessage
This class provides a data structure that holds information about a log message that may appear in the Directory Server access log about the result of an add operation processed by the Directory Server.
NOTE: This class, and other classes within the com.unboundid.ldap.sdk.unboundidds package structure, are only supported for use against Ping Identity, UnboundID, and Nokia/Alcatel-Lucent 8661 server products. These classes provide support for proprietary functionality or for external specifications that are not considered stable or mature enough to be guaranteed to work in an interoperable way with other types of LDAP servers.
See Also:

  • Constructor Details

    • AddResultAccessLogMessage

      public AddResultAccessLogMessage(@NotNull String s) throws LogException
      Creates a new add result access log message from the provided message string.
      Parameters:
      s - The string to be parsed as an add result access log message.
      Throws:
      LogException - If the provided string cannot be parsed as a valid log message.

    • AddResultAccessLogMessage

      public AddResultAccessLogMessage(@NotNull LogMessage m)
      Creates a new add result access log message from the provided message string.
      Parameters:
      m - The log message to be parsed as an add result access log message.

  • Method Details

    • getResultCode

      @Nullable public ResultCode getResultCode()
      Retrieves the result code for the operation.
      Specified by:
      getResultCode in interface MinimalOperationResultAccessLogMessage
      Returns:
      The result code for the operation, or null if it is not included in the log message.

    • getDiagnosticMessage

      @Nullable public String getDiagnosticMessage()
      Retrieves the diagnostic message for the operation.
      Specified by:
      getDiagnosticMessage in interface MinimalOperationResultAccessLogMessage
      Returns:
      The diagnostic message for the operation, or null if it is not included in the log message.

    • getAdditionalInformation

      @Nullable public String getAdditionalInformation()
      Retrieves a message with additional information about the result of the operation.
      Specified by:
      getAdditionalInformation in interface MinimalOperationResultAccessLogMessage
      Returns:
      A message with additional information about the result of the operation, or null if it is not included in the log message.

    • getMatchedDN

      @Nullable public String getMatchedDN()
      Retrieves the matched DN for the operation.
      Specified by:
      getMatchedDN in interface MinimalOperationResultAccessLogMessage
      Returns:
      The matched DN for the operation, or null if it is not included in the log message.

    • getReferralURLs

      @NotNull public List<String> getReferralURLs()
      Retrieves the list of referral URLs for the operation.
      Specified by:
      getReferralURLs in interface MinimalOperationResultAccessLogMessage
      Returns:
      The list of referral URLs for the operation, or an empty list if it is not included in the log message.

    • getIntermediateResponsesReturned

      @Nullable public Long getIntermediateResponsesReturned()
      Retrieves the number of intermediate response messages returned in the course of processing the operation.
      Specified by:
      getIntermediateResponsesReturned in interface OperationResultAccessLogMessage
      Returns:
      The number of intermediate response messages returned to the client in the course of processing the operation, or null if it is not included in the log message.

    • getProcessingTimeMillis

      @Nullable public Double getProcessingTimeMillis()
      Retrieves the length of time in milliseconds required to process the operation.
      Specified by:
      getProcessingTimeMillis in interface MinimalOperationResultAccessLogMessage
      Returns:
      The length of time in milliseconds required to process the operation, or null if it is not included in the log message.

    • getQueueTimeMillis

      @Nullable public Double getQueueTimeMillis()
      Retrieves the length of time in milliseconds the operation was required to wait on the work queue.
      Specified by:
      getQueueTimeMillis in interface MinimalOperationResultAccessLogMessage
      Returns:
      The length of time in milliseconds the operation was required to wait on the work queue, or null if it is not included in the log message.

    • getResponseControlOIDs

      @NotNull public List<String> getResponseControlOIDs()
      Retrieves the OIDs of any response controls contained in the log message.
      Specified by:
      getResponseControlOIDs in interface OperationResultAccessLogMessage
      Returns:
      The OIDs of any response controls contained in the log message, or an empty list if it is not included in the log message.

    • getServersAccessed

      @NotNull public List<String> getServersAccessed()
      Retrieves a list of the additional servers that were accessed in the course of processing the operation. For example, if the access log message is from a Directory Proxy Server instance, then this may contain a list of the backend servers used to process the operation.
      Specified by:
      getServersAccessed in interface OperationResultAccessLogMessage
      Returns:
      A list of the additional servers that were accessed in the course of processing the operation, or an empty list if it is not included in the log message.

    • getUncachedDataAccessed

      @Nullable public Boolean getUncachedDataAccessed()
      Indicates whether the server accessed any uncached data in the course of processing the operation.
      Returns:
      true if the server was known to access uncached data in the course of processing the operation, false if the server was known not to access uncached data, or null if it is not included in the log message (and the server likely did not access uncached data).

    • getIntermediateClientResult

      @Nullable public String getIntermediateClientResult()
      Retrieves the content of the intermediate client result for the operation.
      Specified by:
      getIntermediateClientResult in interface OperationResultAccessLogMessage
      Returns:
      The content of the intermediate client result for the operation, or null if it is not included in the log message.

    • getAlternateAuthorizationDN

      @Nullable public String getAlternateAuthorizationDN()
      Retrieves the alternate authorization DN for the operation.
      Returns:
      The alternate authorization DN for the operation, or null if it is not included in the log message.

    • getReplicationChangeID

      @Nullable public String getReplicationChangeID()
      Retrieves the replication change ID for the operation, if available.
      Returns:
      The replication change ID for the operation, or null if it is not included in the log message.

    • getTargetHost

      @Nullable public String getTargetHost()
      Retrieves the address of the backend server to which the request has been forwarded.
      Returns:
      The address of the backend server to which the request has been forwarded, or null if it is not included in the log message.

    • getTargetPort

      @Nullable public Integer getTargetPort()
      Retrieves the port of the backend server to which the request has been forwarded.
      Returns:
      The port of the backend server to which the request has been forwarded, or null if it is not included in the log message.

    • getTargetProtocol

      @Nullable public String getTargetProtocol()
      Retrieves the protocol used to forward the request to the backend server.
      Returns:
      The protocol used to forward the request to the backend server, or null if it is not included in the log message.

    • getUndeleteFromDN

      @Nullable public String getUndeleteFromDN()
      Retrieves the DN of the soft-deleted entry from which the contents of the added entry were obtained, if it was an undelete rather than a normal add.
      Returns:
      The DN of the soft-deleted entry from which the contents of the added entry were obtained, or null if it is not included in the log message (e.g., because the operation was a normal add rather than an undelete).

    • getAssuredReplicationLocalLevel

      @Nullable public AssuredReplicationLocalLevel getAssuredReplicationLocalLevel()
      Retrieves the local level that will be used for assured replication processing, if available.
      Returns:
      The local level that will be used for assured replication processing, or null if this is not included in the log message (e.g., because assured replication will not be performed for the operation).

    • getAssuredReplicationRemoteLevel

      @Nullable public AssuredReplicationRemoteLevel getAssuredReplicationRemoteLevel()
      Retrieves the remote level that will be used for assured replication processing, if available.
      Returns:
      The remote level that will be used for assured replication processing, or null if this is not included in the log message (e.g., because assured replication will not be performed for the operation).

    • getAssuredReplicationTimeoutMillis

      @Nullable public Long getAssuredReplicationTimeoutMillis()
      Retrieves the maximum length of time in milliseconds that the server will delay the response to the client while waiting for the replication assurance requirement to be satisfied.
      Returns:
      The maximum length of time in milliseconds that the server will delay the response to the client while waiting for the replication assurance requirement to be satisfied, or null if this is not included in the log message (e.g., because assured replication will not be performed for the operation).

    • getResponseDelayedByAssurance

      @Nullable public Boolean getResponseDelayedByAssurance()
      Indicates whether the operation response to the client will be delayed until replication assurance has been satisfied or the timeout has occurred.
      Returns:
      true if the operation response to the client will be delayed until replication assurance has been satisfied, false if the response will not be delayed by assurance processing, or null if this was not included in the log message (e.g., because assured replication will not be performed for the operation)

    • getUsedPrivileges

      @NotNull public List<String> getUsedPrivileges()
      Retrieves the names of any privileges used during the course of processing the operation.
      Returns:
      The names of any privileges used during the course of processing the operation, or an empty list if no privileges were used or this is not included in the log message.

    • getPreAuthorizationUsedPrivileges

      @NotNull public List<String> getPreAuthorizationUsedPrivileges()
      Retrieves the names of any privileges used during the course of processing the operation before an alternate authorization identity was assigned.
      Returns:
      The names of any privileges used during the course of processing the operation before an alternate authorization identity was assigned, or an empty list if no privileges were used or this is not included in the log message.

    • getMissingPrivileges

      @NotNull public List<String> getMissingPrivileges()
      Retrieves the names of any privileges that would have been required for processing the operation but that the requester did not have.
      Returns:
      The names of any privileges that would have been required for processing the operation but that the requester did not have, or an empty list if there were no missing privileges or this is not included in the log message.

    • getIndexesWithKeysAccessedNearEntryLimit

      @NotNull public List<String> getIndexesWithKeysAccessedNearEntryLimit()
      Retrieves the names of any indexes for which one or more keys near (typically, within 80% of) the index entry limit were accessed while processing the operation.
      Returns:
      The names of any indexes for which one or more keys near the index entry limit were accessed while processing the operation, or an empty list if no such index keys were accessed, or if this is not included in the log message.

    • getIndexesWithKeysAccessedOverEntryLimit

      @NotNull public List<String> getIndexesWithKeysAccessedOverEntryLimit()
      Retrieves the names of any indexes for which one or more keys over the index entry limit were accessed while processing the operation.
      Returns:
      The names of any indexes for which one or more keys over the index entry limit were accessed while processing the operation, or an empty list if no such index keys were accessed, or if this is not included in the log message.

    • getMessageType

      @NotNull public AccessLogMessageType getMessageType()
      Retrieves the message type for this access log message.
      Overrides:
      getMessageType in class OperationRequestAccessLogMessage
      Returns:
      The message type for this access log message.