com.netscape.jndi.ldap.controls
Class LdapSortControl
LDAPSortControl
com.netscape.jndi.ldap.controls.LdapSortControl
- Control
public class LdapSortControl
extends LDAPSortControl
implements Control
Represents an LDAP v3 server control that specifies that you want
the server to return sorted search results. (The OID for this
control is 1.2.840.113556.1.4.473.)
When constructing an
LDAPSortControl
object, you can
specify the order in which you want the results sorted.
You can also specify whether or not this control is critical
to the search operation.
To specify the sort order, you construct an
LdapSortKey
object and pass it to the
LdapSortControl
constructor.
The
LdapSortKey
object represents a list of the attribute
types used for sorting (a "sort key list").
The LDAP server sends back a sort response control to indicate
the result of the sorting operation. (The OID for this control
is 1.2.840.113556.1.4.474.)
LdapSortControl(String[] keys, boolean critical) - Constructs an
LDAPSortControl object with an array of
sorting keys.
|
LdapSortControl(LdapSortKey key, boolean critical) - Constructs an
LDAPSortControl object with a single
sorting key.
|
LdapSortControl(LdapSortKey[] keys, boolean critical) - Constructs an
LDAPSortControl object with an array of
sorting keys.
|
byte[] | getEncodedValue() - Retrieves the ASN.1 BER encoded value of the LDAP control.
|
LdapSortControl
public LdapSortControl(String[] keys,
boolean critical)
Constructs an LDAPSortControl
object with an array of
sorting keys.
keys
- The attributes to sort by.critical
- true
if the LDAP operation should be
discarded when the server does not support this control (in other
words, this control is critical to the LDAP operation).
LdapSortControl
public LdapSortControl(LdapSortKey key,
boolean critical)
Constructs an LDAPSortControl
object with a single
sorting key.
key
- A single attribute to sort by.critical
- true
if the LDAP operation should be
discarded when the server does not support this control (in other
words, this control is critical to the LDAP operation).
LdapSortControl
public LdapSortControl(LdapSortKey[] keys,
boolean critical)
Constructs an LDAPSortControl
object with an array of
sorting keys.
keys
- The attributes to sort by.critical
- true
if the LDAP operation should be
discarded when the server does not support this control (in other
words, this control is critical to the LDAP operation).
getEncodedValue
public byte[] getEncodedValue()
Retrieves the ASN.1 BER encoded value of the LDAP control.
Null is returned if the value is absent.
- A possibly null byte array representing the ASN.1 BER
encoded value of the LDAP control.