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
Time Limit

> A time limit on a search places an upper bound on the amount of time that the search operation will block waiting for the answers. This is useful when you don't want to wait too long for an answer. If the time limit specified is exceeded before the search operation can be completed, then a `TimeLimitExceededException` will be thrown.

> To set the time limit of a search, pass the number of milliseconds to `SearchControls.setTimeLimit()`. The following example sets the time limit to 1 second.

> >     // Set the search controls to limit the time to 1 second (1000 ms)
> >     SearchControls ctls = new SearchControls();
> >     ctls.setTimeLimit(1000);

> To get this particular example to exceed its time limit, you need to reconfigure it to use either a slow server, or a server that has lots of entries. Alternatively, you can use other tactics to make the search take longer than 1 second.

> A time limit of zero means that no time limit has been set and that calls to the directory will wait indefinitely for an answer.

Previous page: Result Count
Next page: Trouble Shooting Tips