java.lang.Object
- javax.naming.directory.SearchControls

All Implemented Interfaces:

Serializable
```
public class SearchControls
extends Object
implements Serializable
```
This class encapsulates factors that determine scope of search and what gets returned as a result of the search.
A SearchControls instance is not synchronized against concurrent multithreaded access. Multiple threads trying to access and modify a single SearchControls instance should lock the object.

Since:

1.3

See Also:
Serialized Form

Field Summary

Fields
Modifier and Type	Field and Description
`static int`	`OBJECT_SCOPE` Search the named object.
`static int`	`ONELEVEL_SCOPE` Search one level of the named context.
`static int`	`SUBTREE_SCOPE` Search the entire subtree rooted at the named object.

Eerste pagina van API Java Inhoudsopgave Haut

Constructor Summary

Constructors
Constructor and Description
`SearchControls()` Constructs a search constraints using defaults.
`SearchControls(int scope, long countlim, int timelim, String[] attrs, boolean retobj, boolean deref)` Constructs a search constraints using arguments.

Eerste pagina van API Java Inhoudsopgave Haut

Method Summary

Methods
Modifier and Type	Method and Description
`long`	`getCountLimit()` Retrieves the maximum number of entries that will be returned as a result of the search.
`boolean`	`getDerefLinkFlag()` Determines whether links will be dereferenced during the search.
`String[]`	`getReturningAttributes()` Retrieves the attributes that will be returned as part of the search.
`boolean`	`getReturningObjFlag()` Determines whether objects will be returned as part of the result.
`int`	`getSearchScope()` Retrieves the search scope of these SearchControls.
`int`	`getTimeLimit()` Retrieves the time limit of these SearchControls in milliseconds.
`void`	`setCountLimit(long limit)` Sets the maximum number of entries to be returned as a result of the search.
`void`	`setDerefLinkFlag(boolean on)` Enables/disables link dereferencing during the search.
`void`	`setReturningAttributes(String[] attrs)` Specifies the attributes that will be returned as part of the search.
`void`	`setReturningObjFlag(boolean on)` Enables/disables returning objects returned as part of the result.
`void`	`setSearchScope(int scope)` Sets the search scope to one of: OBJECT_SCOPE, ONELEVEL_SCOPE, SUBTREE_SCOPE.
`void`	`setTimeLimit(int ms)` Sets the time limit of these SearchControls in milliseconds.

Eerste pagina van API Java Inhoudsopgave Haut

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - OBJECT_SCOPE
```
public static final int OBJECT_SCOPE
```
    Search the named object.
    The NamingEnumeration that results from search() using OBJECT_SCOPE will contain one or zero element. The enumeration contains one element if the named object satisfies the search filter specified in search(). The element will have as its name the empty string because the names of elements in the NamingEnumeration are relative to the target context--in this case, the target context is the named object. It contains zero element if the named object does not satisfy the search filter specified in search().
    The value of this constant is 0.
    
    See Also:
    Constant Field Values
  - ONELEVEL_SCOPE
```
public static final int ONELEVEL_SCOPE
```
    Search one level of the named context.
    The NamingEnumeration that results from search() using ONELEVEL_SCOPE contains elements with objects in the named context that satisfy the search filter specified in search(). The names of elements in the NamingEnumeration are atomic names relative to the named context.
    The value of this constant is 1.
    
    See Also:
    Constant Field Values
  - SUBTREE_SCOPE
```
public static final int SUBTREE_SCOPE
```
    Search the entire subtree rooted at the named object.
    If the named object is not a DirContext, search only the object. If the named object is a DirContext, search the subtree rooted at the named object, including the named object itself.
    The search will not cross naming system boundaries.
    The NamingEnumeration that results from search() using SUBTREE_SCOPE contains elements of objects from the subtree (including the named context) that satisfy the search filter specified in search(). The names of elements in the NamingEnumeration are either relative to the named context or is a URL string. If the named context satisfies the search filter, it is included in the enumeration with the empty string as its name.
    The value of this constant is 2.
    
    See Also:
    Constant Field Values
- Constructor Detail
  - SearchControls
```
public SearchControls()
```
    Constructs a search constraints using defaults.
    The defaults are:
    - search one level
    - no maximum return limit for search results
    - no time limit for search
    - return all attributes associated with objects that satisfy the search filter.
    - do not return named object (return only name and class)
    - do not dereference links during search
  - SearchControls
```
public SearchControls(int scope,
              long countlim,
              int timelim,
              String[] attrs,
              boolean retobj,
              boolean deref)
```
    Constructs a search constraints using arguments.
    
    Parameters:
    scope - The search scope. One of: OBJECT_SCOPE, ONELEVEL_SCOPE, SUBTREE_SCOPE.
    timelim - The number of milliseconds to wait before returning. If 0, wait indefinitely.
    deref - If true, dereference links during search.
    countlim - The maximum number of entries to return. If 0, return all entries that satisfy filter.
    retobj - If true, return the object bound to the name of the entry; if false, do not return object.
    attrs - The identifiers of the attributes to return along with the entry. If null, return all attributes. If empty return no attributes.
- Method Detail
  - getSearchScope
```
public int getSearchScope()
```
    Retrieves the search scope of these SearchControls.
    One of OBJECT_SCOPE, ONELEVEL_SCOPE, SUBTREE_SCOPE.
    
    Returns:
    The search scope of this SearchControls.
    See Also:
    setSearchScope(int)
  - getTimeLimit
```
public int getTimeLimit()
```
    Retrieves the time limit of these SearchControls in milliseconds.
    If the value is 0, this means to wait indefinitely.
    
    Returns:
    The time limit of these SearchControls in milliseconds.
    See Also:
    setTimeLimit(int)
  - getDerefLinkFlag
```
public boolean getDerefLinkFlag()
```
    Determines whether links will be dereferenced during the search.
    
    Returns:
    true if links will be dereferenced; false otherwise.
    See Also:
    setDerefLinkFlag(boolean)
  - getReturningObjFlag
```
public boolean getReturningObjFlag()
```
    Determines whether objects will be returned as part of the result.
    
    Returns:
    true if objects will be returned; false otherwise.
    See Also:
    setReturningObjFlag(boolean)
  - getCountLimit
```
public long getCountLimit()
```
    Retrieves the maximum number of entries that will be returned as a result of the search.
    0 indicates that all entries will be returned.
    
    Returns:
    The maximum number of entries that will be returned.
    See Also:
    setCountLimit(long)
  - getReturningAttributes
```
public String[] getReturningAttributes()
```
    Retrieves the attributes that will be returned as part of the search.
    A value of null indicates that all attributes will be returned. An empty array indicates that no attributes are to be returned.
    
    Returns:
    An array of attribute ids identifying the attributes that will be returned. Can be null.
    See Also:
    setReturningAttributes(java.lang.String[])
  - setSearchScope
```
public void setSearchScope(int scope)
```
    Sets the search scope to one of: OBJECT_SCOPE, ONELEVEL_SCOPE, SUBTREE_SCOPE.
    
    Parameters:
    scope - The search scope of this SearchControls.
    See Also:
    getSearchScope()
  - setTimeLimit
```
public void setTimeLimit(int ms)
```
    Sets the time limit of these SearchControls in milliseconds.
    If the value is 0, this means to wait indefinitely.
    
    Parameters:
    ms - The time limit of these SearchControls in milliseconds.
    See Also:
    getTimeLimit()
  - setDerefLinkFlag
```
public void setDerefLinkFlag(boolean on)
```
    Enables/disables link dereferencing during the search.
    
    Parameters:
    on - if true links will be dereferenced; if false, not followed.
    See Also:
    getDerefLinkFlag()
  - setReturningObjFlag
```
public void setReturningObjFlag(boolean on)
```
    Enables/disables returning objects returned as part of the result.
    If disabled, only the name and class of the object is returned. If enabled, the object will be returned.
    
    Parameters:
    on - if true, objects will be returned; if false, objects will not be returned.
    See Also:
    getReturningObjFlag()
  - setCountLimit
```
public void setCountLimit(long limit)
```
    Sets the maximum number of entries to be returned as a result of the search.
    0 indicates no limit: all entries will be returned.
    
    Parameters:
    limit - The maximum number of entries that will be returned.
    See Also:
    getCountLimit()
  - setReturningAttributes
```
public void setReturningAttributes(String[] attrs)
```
    Specifies the attributes that will be returned as part of the search.
    null indicates that all attributes will be returned. An empty array indicates no attributes are returned.
    
    Parameters:
    attrs - An array of attribute ids identifying the attributes that will be returned. Can be null.
    See Also:
    getReturningAttributes()

Nederlandse vertaling

U hebt gevraagd om deze site in het Nederlands te bezoeken. Voor nu wordt alleen de interface vertaald, maar nog niet alle inhoud.

Als je me wilt helpen met vertalingen, is je bijdrage welkom. Het enige dat u hoeft te doen, is u op de site registreren en mij een bericht sturen waarin u wordt gevraagd om u toe te voegen aan de groep vertalers, zodat u de gewenste pagina's kunt vertalen. Een link onderaan elke vertaalde pagina geeft aan dat u de vertaler bent en heeft een link naar uw profiel.

Bij voorbaat dank.

Document heeft de 11/06/2005 gemaakt, de laatste keer de 04/03/2020 gewijzigd
Bron van het afgedrukte document:https://www.gaudry.be/nl/java-api-rf-javax/naming/directory/searchcontrols.html

De infobrol is een persoonlijke site waarvan de inhoud uitsluitend mijn verantwoordelijkheid is. De tekst is beschikbaar onder CreativeCommons-licentie (BY-NC-SA). Meer info op de gebruiksvoorwaarden en de auteur.

Referenties

Manuel PHP : https://docs.oracle.com

Deze verwijzingen en links verwijzen naar documenten die geraadpleegd zijn tijdens het schrijven van deze pagina, of die aanvullende informatie kunnen geven, maar de auteurs van deze bronnen kunnen niet verantwoordelijk worden gehouden voor de inhoud van deze pagina.
De auteur Deze site is als enige verantwoordelijk voor de manier waarop de verschillende concepten, en de vrijheden die met de referentiewerken worden genomen, hier worden gepresenteerd. Vergeet niet dat u meerdere broninformatie moet doorgeven om het risico op fouten te verkleinen.

Inhoudsopgave Haut

Class SearchControls

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

OBJECT_SCOPE

ONELEVEL_SCOPE

SUBTREE_SCOPE

Constructor Detail

SearchControls

SearchControls

Method Detail

getSearchScope

getTimeLimit

getDerefLinkFlag

getReturningObjFlag

getCountLimit

getReturningAttributes

setSearchScope

setTimeLimit

setDerefLinkFlag

setReturningObjFlag

setCountLimit

setReturningAttributes

Referenties