org.identityconnectors.framework.common.objects

Class SearchResult

java.lang.Object

org.identityconnectors.framework.common.objects.SearchResult

public final class SearchResult
extends Object

The final result of a query request returned after all connector objects matching the request have been returned. In addition to indicating that no more objects are to be returned by the search, the search result will contain page results state information if result paging has been enabled for the search.

Since:

1.4

Constructor Summary

Constructors

Constructor and Description
SearchResult() Creates a new search result with a null paged results cookie and no estimate of the total number of remaining results.
SearchResult(String pagedResultsCookie, int remainingPagedResults) Creates a new search result with the provided paged results cookie and estimate of the total number of remaining results.

Method Summary

Methods

Modifier and Type	Method and Description
String	getPagedResultsCookie() Returns the opaque cookie which should be used with the next paged results search request.
int	getRemainingPagedResults() Returns an estimate of the total number of remaining results to be returned in subsequent paged results search requests.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

SearchResult

public SearchResult()

Creates a new search result with a null paged results cookie and no estimate of the total number of remaining results.

SearchResult

public SearchResult(String pagedResultsCookie,
            int remainingPagedResults)

Creates a new search result with the provided paged results cookie and estimate of the total number of remaining results.

Parameters:

pagedResultsCookie - The opaque cookie which should be used with the next paged results search request, or null if paged results were not requested, or if there are not more pages to be returned.

remainingPagedResults - An estimate of the total number of remaining results to be returned in subsequent paged results search requests, or -1 if paged results were not requested, or if the total number of remaining results is unknown.

Method Detail

getPagedResultsCookie

public String getPagedResultsCookie()

Returns the opaque cookie which should be used with the next paged results search request.

Returns:

The opaque cookie which should be used with the next paged results search request, or null if paged results were not requested, or if there are not more pages to be returned.

getRemainingPagedResults

public int getRemainingPagedResults()

Returns an estimate of the total number of remaining results to be returned in subsequent paged results search requests.

Returns:

An estimate of the total number of remaining results to be returned in subsequent paged results search requests, or -1 if paged results were not requested, or if the total number of remaining results is unknown.