-
- All Superinterfaces:
- Serializable
- All Known Implementing Classes:
- BasicControl, ManageReferralControl, PagedResultsControl, PagedResultsResponseControl, SortControl, SortResponseControl
public interface Control extends Serializable
This interface represents an LDAPv3 control as defined in RFC 2251.The LDAPv3 protocol uses controls to send and receive additional data to affect the behavior of predefined operations. Controls can be sent along with any LDAP operation to the server. These are referred to as request controls. For example, a "sort" control can be sent with an LDAP search operation to request that the results be returned in a particular order. Solicited and unsolicited controls can also be returned with responses from the server. Such controls are referred to as response controls. For example, an LDAP server might define a special control to return change notifications.
This interface is used to represent both request and response controls.
- Since:
- 1.3
- See Also:
ControlFactory
-
-
Field Summary
Fields Modifier and Type Field and Description static boolean
CRITICAL
Indicates a critical control.static boolean
NONCRITICAL
Indicates a non-critical control.
-
Method Summary
Methods Modifier and Type Method and Description byte[]
getEncodedValue()
Retrieves the ASN.1 BER encoded value of the LDAP control.String
getID()
Retrieves the object identifier assigned for the LDAP control.boolean
isCritical()
Determines the criticality of the LDAP control.
-
-
-
Field Detail
-
CRITICAL
static final boolean CRITICAL
Indicates a critical control. The value of this constant is true.- See Also:
- Constant Field Values
-
NONCRITICAL
static final boolean NONCRITICAL
Indicates a non-critical control. The value of this constant is false.- See Also:
- Constant Field Values
-
-
Method Detail
-
getID
String getID()
Retrieves the object identifier assigned for the LDAP control.- Returns:
- The non-null object identifier string.
-
isCritical
boolean isCritical()
Determines the criticality of the LDAP control. A critical control must not be ignored by the server. In other words, if the server receives a critical control that it does not support, regardless of whether the control makes sense for the operation, the operation will not be performed and an OperationNotSupportedException will be thrown.- Returns:
- true if this control is critical; false otherwise.
-
getEncodedValue
byte[] getEncodedValue()
Retrieves the ASN.1 BER encoded value of the LDAP control. The result is the raw BER bytes including the tag and length of the control's value. It does not include the controls OID or criticality. Null is returned if the value is absent.- Returns:
- A possibly null byte array representing the ASN.1 BER encoded value of the LDAP control.
-
-
Traduction non disponible
Les API Java ne sont pas encore traduites en français sur l'infobrol. Seule la version anglaise est disponible pour l'instant.
Version en cache
21/11/2024 21:37:54 Cette version de la page est en cache (à la date du 21/11/2024 21:37:54) afin d'accélérer le traitement. Vous pouvez activer le mode utilisateur dans le menu en haut pour afficher la dernère version de la page.Document créé le 30/08/2006, dernière modification le 04/03/2020
Source du document imprimé : https://www.gaudry.be/java-api-rf-javax/naming/ldap/control.html
L'infobrol est un site personnel dont le contenu n'engage que moi. Le texte est mis à disposition sous licence CreativeCommons(BY-NC-SA). Plus d'info sur les conditions d'utilisation et sur l'auteur.
Références
Ces références et liens indiquent des documents consultés lors de la rédaction de cette page, ou qui peuvent apporter un complément d'information, mais les auteurs de ces sources ne peuvent être tenus responsables du contenu de cette page.
L'auteur de ce site est seul responsable de la manière dont sont présentés ici les différents concepts, et des libertés qui sont prises avec les ouvrages de référence. N'oubliez pas que vous devez croiser les informations de sources multiples afin de diminuer les risques d'erreurs.