Previous | Next | Trail Map | The Basics | Directory Operations

Time Limit

When you set a time limit on a search, that 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, a TimeLimitExceededException(in the API reference documentation) is thrown.

To set the time limit of a search, pass the number of milliseconds to the method SearchControls.setTimeLimit()(in the API reference documentation).

This example sets the count limit to 1 second:

// Set search controls to limit 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 a slow server, or a server that has lots of entries, or use other tactics to make the search take longer than 1 second.

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


Previous | Next | Trail Map | The Basics | Directory Operations