Class AssuredReplicationResponseControl
- java.lang.Object
-
- com.unboundid.ldap.sdk.Control
-
- com.unboundid.ldap.sdk.unboundidds.controls.AssuredReplicationResponseControl
-
- All Implemented Interfaces:
DecodeableControl
,java.io.Serializable
@NotMutable @ThreadSafety(level=COMPLETELY_THREADSAFE) public final class AssuredReplicationResponseControl extends Control implements DecodeableControl
This class provides an implementation of an LDAP control that can be included in add, bind, modify, modify DN, and certain extended responses to provide information about the result of replication assurance processing for that operation.
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.
The OID for this control is 1.3.6.1.4.1.30221.2.5.29. It will have a criticality of FALSE, and will have a value with the following encoding:AssuredReplicationResponse ::= SEQUENCE { localLevel [0] LocalLevel OPTIONAL, localAssuranceSatisfied [1] BOOLEAN, localAssuranceMessage [2] OCTET STRING OPTIONAL, remoteLevel [3] RemoteLevel OPTIONAL, remoteAssuranceSatisfied [4] BOOLEAN, remoteAssuranceMessage [5] OCTET STRING OPTIONAL, csn [6] OCTET STRING OPTIONAL, serverResults [7] SEQUENCE OF ServerResult OPTIONAL, ... } ServerResult ::= SEQUENCE { resultCode [0] ENUMERATED { complete (0), timeout (1), conflict (2), serverShutdown (3), unavailable (4), duplicate (5), ... }, replicationServerID [1] INTEGER OPTIONAL, replicaID [2] INTEGER OPTIONAL, ... }
- See Also:
AssuredReplicationRequestControl
, Serialized Form
-
-
Field Summary
Fields Modifier and Type Field Description static java.lang.String
ASSURED_REPLICATION_RESPONSE_OID
The OID (1.3.6.1.4.1.30221.2.5.29) for the assured replication response control.
-
Constructor Summary
Constructors Constructor Description AssuredReplicationResponseControl(AssuredReplicationLocalLevel localLevel, boolean localAssuranceSatisfied, java.lang.String localAssuranceMessage, AssuredReplicationRemoteLevel remoteLevel, boolean remoteAssuranceSatisfied, java.lang.String remoteAssuranceMessage, java.lang.String csn, java.util.Collection<AssuredReplicationServerResult> serverResults)
Creates a new assured replication response control with the provided information.AssuredReplicationResponseControl(java.lang.String oid, boolean isCritical, ASN1OctetString value)
Creates a new assured replication response control with the provided information.
-
Method Summary
All Methods Static Methods Instance Methods Concrete Methods Modifier and Type Method Description AssuredReplicationResponseControl
decodeControl(java.lang.String oid, boolean isCritical, ASN1OctetString value)
Creates a new instance of this decodeable control from the provided information.static AssuredReplicationResponseControl
get(LDAPResult result)
Extracts an assured replication response control from the provided LDAP result.static java.util.List<AssuredReplicationResponseControl>
getAll(LDAPResult result)
Extracts all assured replication response controls from the provided LDAP result.java.lang.String
getControlName()
Retrieves the user-friendly name for this control, if available.java.lang.String
getCSN()
Retrieves the replication change sequence number (CSN) assigned to the associated operation, if available.java.lang.String
getLocalAssuranceMessage()
Retrieves a message with additional information about local assurance processing, if available.AssuredReplicationLocalLevel
getLocalLevel()
Retrieves the local assurance level selected by the server for the associated operation, if available.java.lang.String
getRemoteAssuranceMessage()
Retrieves a message with additional information about remote assurance processing, if available.AssuredReplicationRemoteLevel
getRemoteLevel()
Retrieves the remote assurance level selected by the server for the associated operation, if available.java.util.List<AssuredReplicationServerResult>
getServerResults()
Retrieves a list of the results from individual replication servers and/or directory servers used in assurance processing.boolean
localAssuranceSatisfied()
Indicates whether the desired local level of assurance is known to have been satisfied.boolean
remoteAssuranceSatisfied()
Indicates whether the desired remote level of assurance is known to have been satisfied.void
toString(java.lang.StringBuilder buffer)
Appends a string representation of this LDAP control to the provided buffer.-
Methods inherited from class com.unboundid.ldap.sdk.Control
decode, decode, decodeControls, deregisterDecodeableControl, encode, encodeControls, equals, getOID, getValue, hashCode, hasValue, isCritical, readFrom, registerDecodeableControl, toString, writeTo
-
-
-
-
Field Detail
-
ASSURED_REPLICATION_RESPONSE_OID
public static final java.lang.String ASSURED_REPLICATION_RESPONSE_OID
The OID (1.3.6.1.4.1.30221.2.5.29) for the assured replication response control.- See Also:
- Constant Field Values
-
-
Constructor Detail
-
AssuredReplicationResponseControl
public AssuredReplicationResponseControl(AssuredReplicationLocalLevel localLevel, boolean localAssuranceSatisfied, java.lang.String localAssuranceMessage, AssuredReplicationRemoteLevel remoteLevel, boolean remoteAssuranceSatisfied, java.lang.String remoteAssuranceMessage, java.lang.String csn, java.util.Collection<AssuredReplicationServerResult> serverResults)
Creates a new assured replication response control with the provided information.- Parameters:
localLevel
- The local assurance level selected by the server for the associated operation. It may benull
if this is not available.localAssuranceSatisfied
- Indicates whether the desired local level of assurance is known to have been satisfied.localAssuranceMessage
- An optional message providing additional information about local assurance processing. This may benull
if no additional message is needed.remoteLevel
- The remote assurance level selected by the server for the associated operation. It may benull
if this is not available.remoteAssuranceSatisfied
- Indicates whether the desired remote level of assurance is known to have been satisfied.remoteAssuranceMessage
- An optional message providing additional information about remote assurance processing. This may benull
if no additional message is needed.csn
- The change sequence number (CSN) that has been assigned to the associated operation. It may benull
if no CSN is available.serverResults
- The set of individual results from the local and/or remote replication servers and/or directory servers used in assurance processing. This may benull
or empty if no server results are available.
-
AssuredReplicationResponseControl
public AssuredReplicationResponseControl(java.lang.String oid, boolean isCritical, ASN1OctetString value) throws LDAPException
Creates a new assured replication response control with the provided information.- Parameters:
oid
- The OID for the control.isCritical
- Indicates whether the control should be marked critical.value
- The encoded value for the control. This may benull
if no value was provided.- Throws:
LDAPException
- If the provided control cannot be decoded as an assured replication response control.
-
-
Method Detail
-
decodeControl
public AssuredReplicationResponseControl decodeControl(java.lang.String oid, boolean isCritical, ASN1OctetString value) throws LDAPException
Creates a new instance of this decodeable control from the provided information.- Specified by:
decodeControl
in interfaceDecodeableControl
- Parameters:
oid
- The OID for the control.isCritical
- Indicates whether the control should be marked critical.value
- The encoded value for the control. This may benull
if no value was provided.- Returns:
- The decoded representation of this control.
- Throws:
LDAPException
- If the provided information cannot be decoded as a valid instance of this decodeable control.
-
get
public static AssuredReplicationResponseControl get(LDAPResult result) throws LDAPException
Extracts an assured replication response control from the provided LDAP result. If there are multiple assured replication response controls included in the result, then only the first will be returned.- Parameters:
result
- The LDAP result from which to retrieve the assured replication response control.- Returns:
- The assured replication response control contained in the provided
LDAP result, or
null
if the result did not contain an assured replication response control. - Throws:
LDAPException
- If a problem is encountered while attempting to decode the assured replication response control contained in the provided result.
-
getAll
public static java.util.List<AssuredReplicationResponseControl> getAll(LDAPResult result) throws LDAPException
Extracts all assured replication response controls from the provided LDAP result.- Parameters:
result
- The LDAP result from which to retrieve the assured replication response controls.- Returns:
- A list containing the assured replication response controls contained in the provided LDAP result, or an empty list if the result did not contain any assured replication response control.
- Throws:
LDAPException
- If a problem is encountered while attempting to decode any assured replication response control contained in the provided result.
-
getLocalLevel
public AssuredReplicationLocalLevel getLocalLevel()
Retrieves the local assurance level selected by the server for the associated operation, if available.- Returns:
- The local assurance level selected by the server for the
associated operation, or
null
if this is not available.
-
localAssuranceSatisfied
public boolean localAssuranceSatisfied()
Indicates whether the desired local level of assurance is known to have been satisfied.- Returns:
true
if the desired local level of assurance is known to have been satisfied, orfalse
if not.
-
getLocalAssuranceMessage
public java.lang.String getLocalAssuranceMessage()
Retrieves a message with additional information about local assurance processing, if available.- Returns:
- A message with additional information about local assurance
processing, or
null
if none is available.
-
getRemoteLevel
public AssuredReplicationRemoteLevel getRemoteLevel()
Retrieves the remote assurance level selected by the server for the associated operation, if available.- Returns:
- The remote assurance level selected by the server for the
associated operation, or
null
if the remote assurance level is not available.
-
remoteAssuranceSatisfied
public boolean remoteAssuranceSatisfied()
Indicates whether the desired remote level of assurance is known to have been satisfied.- Returns:
true
if the desired remote level of assurance is known to have been satisfied, orfalse
if not.
-
getRemoteAssuranceMessage
public java.lang.String getRemoteAssuranceMessage()
Retrieves a message with additional information about remote assurance processing, if available.- Returns:
- A message with additional information about remote assurance
processing, or
null
if none is available.
-
getCSN
public java.lang.String getCSN()
Retrieves the replication change sequence number (CSN) assigned to the associated operation, if available.- Returns:
- The replication CSN assigned to the associated operation, or
null
if the CSN is not available.
-
getServerResults
public java.util.List<AssuredReplicationServerResult> getServerResults()
Retrieves a list of the results from individual replication servers and/or directory servers used in assurance processing. It may be empty if no server results are available.- Returns:
- A list of the results from individual replication servers and/or directory servers used in assurance processing.
-
getControlName
public java.lang.String getControlName()
Retrieves the user-friendly name for this control, if available. If no user-friendly name has been defined, then the OID will be returned.- Overrides:
getControlName
in classControl
- Returns:
- The user-friendly name for this control, or the OID if no user-friendly name is available.
-
-