Download the JDK
Search the Tutorials
Hide the TOC
Trail: Java Naming and Directory Interface(TM).
Lesson: Naming and Directory Operations
Section: Search
Naming and Directory Operations
Naming Exceptions
Lookup an Object
List the Context
Add, Replace or Remove a Binding
Rename
Create and Destroy Subcontexts
Attribute Names
Read Attributes
Modify Attributes
Add, Replace Bindings with Attributes
Search
Basic Search
Filters
Scope
Result Count
Time Limit
Trouble Shooting Tips
Home Page > Java Naming and Directory Interface(TM). > Naming and Directory Operations
« Previous • Trail • Next »
Result Count

> Sometimes, a query might produce too many answers and you want to limit the number of answers returned. You can do this by using the count limit search control. By default, a search does not have a count limit--it will return all answers that it finds. To set the count limit of a search, pass the number to `SearchControls.setCountLimit()`.

> The following example sets the count limit to 1.

> >     // Set the search controls to limit the count to 1
> >     SearchControls ctls = new SearchControls();
> >     ctls.setCountLimit(1);

> If the program attempts to get more than the count limit number of results, then a `SizeLimitExceededException` will be thrown. So if a program has set a count limit, then it should either differentiate this exception from other `NamingException`s or keep track of the count limit and not request more than that number of results.

> Specifying a count limit for a search is one way of controlling the resources (such as memory and network bandwidth) that your application consumes. Other ways to control the resources consumed are to narrow your search filter (be more specific about what you seek), start your search in the appropriate context, and use the appropriate scope.

« Previous • Trail • Next »
Previous page: Scope
Next page: Time Limit