@NotMutable @ThreadSafety(level=COMPLETELY_THREADSAFE) public final class GeneratePasswordResponseControl extends Control implements DecodeableControl
GeneratePasswordRequestControl
.
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.
GeneratePasswordResponse ::= SEQUENCE { generatedPassword OCTET STRING, mustChangePassword BOOLEAN, secondsUntilExpiration [0] INTEGER OPTIONAL, ... }
GeneratePasswordRequestControl
,
Serialized FormModifier and Type | Field and Description |
---|---|
static java.lang.String |
GENERATE_PASSWORD_RESPONSE_OID
The OID (1.3.6.1.4.1.30221.2.5.59) for the generate password response
control.
|
Constructor and Description |
---|
GeneratePasswordResponseControl(byte[] generatedPassword,
boolean mustChangePassword,
java.lang.Long secondsUntilExpiration)
Creates a new generate password response control with the provided
information.
|
GeneratePasswordResponseControl(java.lang.String oid,
boolean isCritical,
ASN1OctetString value)
Creates a new generate password response control with the provided
information.
|
GeneratePasswordResponseControl(java.lang.String generatedPassword,
boolean mustChangePassword,
java.lang.Long secondsUntilExpiration)
Creates a new generate password response control with the provided
information.
|
Modifier and Type | Method and Description |
---|---|
GeneratePasswordResponseControl |
decodeControl(java.lang.String oid,
boolean isCritical,
ASN1OctetString value)
Creates a new instance of this decodeable control from the provided
information.
|
static GeneratePasswordResponseControl |
get(LDAPResult result)
Extracts a generate password response control from the provided result.
|
java.lang.String |
getControlName()
Retrieves the user-friendly name for this control, if available.
|
ASN1OctetString |
getGeneratedPassword()
Retrieves the password that was generated by the server.
|
byte[] |
getGeneratedPasswordBytes()
Retrieves the bytes that comprise the password that was generated by the
server.
|
java.lang.String |
getGeneratedPasswordString()
Retrieves a string representation of the password that was generated by the
server.
|
java.lang.Long |
getSecondsUntilExpiration()
Retrieves the length of time, in seconds, until the generated password will
expire.
|
boolean |
mustChangePassword()
Indicates whether the user will be required to change their password the
first time they authenticate.
|
void |
toString(java.lang.StringBuilder buffer)
Appends a string representation of this LDAP control to the provided
buffer.
|
decode, decode, decodeControls, deregisterDecodeableControl, encode, encodeControls, equals, getOID, getValue, hashCode, hasValue, isCritical, readFrom, registerDecodeableControl, toString, writeTo
public static final java.lang.String GENERATE_PASSWORD_RESPONSE_OID
public GeneratePasswordResponseControl(java.lang.String generatedPassword, boolean mustChangePassword, java.lang.Long secondsUntilExpiration)
generatedPassword
- The password generated by the server. It
must not be null
.mustChangePassword
- Indicates whether the user will be required
to choose a new password the first time
they authenticate.secondsUntilExpiration
- The number of seconds until the new
password will expire. It may be
null
if the new password will not
expire.public GeneratePasswordResponseControl(byte[] generatedPassword, boolean mustChangePassword, java.lang.Long secondsUntilExpiration)
generatedPassword
- The password generated by the server. It
must not be null
.mustChangePassword
- Indicates whether the user will be required
to choose a new password the first time
they authenticate.secondsUntilExpiration
- The number of seconds until the new
password will expire. It may be
null
if the new password will not
expire.public GeneratePasswordResponseControl(java.lang.String oid, boolean isCritical, ASN1OctetString value) throws LDAPException
oid
- The OID for the control.isCritical
- Indicates whether the control should be marked
critical.value
- The encoded value for the control. This may be
null
if no value was provided.LDAPException
- If the provided control cannot be decoded as a
generate password response control.public GeneratePasswordResponseControl decodeControl(java.lang.String oid, boolean isCritical, ASN1OctetString value) throws LDAPException
decodeControl
in interface DecodeableControl
oid
- The OID for the control.isCritical
- Indicates whether the control should be marked
critical.value
- The encoded value for the control. This may be
null
if no value was provided.LDAPException
- If the provided information cannot be decoded as a
valid instance of this decodeable control.public static GeneratePasswordResponseControl get(LDAPResult result) throws LDAPException
result
- The result from which to retrieve the generate password
response control.null
if the result did not contain a generate
password response control.LDAPException
- If a problem is encountered while attempting to
decode the generate password response control
contained in the provided result.public ASN1OctetString getGeneratedPassword()
public java.lang.String getGeneratedPasswordString()
public byte[] getGeneratedPasswordBytes()
public boolean mustChangePassword()
true
if the user will be required to change their password
the first time they authenticate, or false
if not.public java.lang.Long getSecondsUntilExpiration()
null
if this is not available (e.g., because
the generated password will not expire).public java.lang.String getControlName()
getControlName
in class Control