QueryResourceHandler (OpenAM Server Only 7.3.1 Documentation)

All Known Implementing Classes:

IdentifierQueryResourceHandler
```
public interface QueryResourceHandler
```
A completion handler for consuming the results of a query request.
A query result completion handler may be specified when performing query requests using a Connection object. The handleResource(org.forgerock.json.resource.ResourceResponse) method is invoked for each resource which matches the query criteria, followed by returning a QueryResponse or a ResourceException indicating that no more JSON resources will be returned.
Implementations of these methods should complete in a timely manner so as to avoid keeping the invoking thread from dispatching to other completion handlers.
Synchronization note: each invocation of handleResource for a resource happens-before the invocation of handleResource for the next resource. Invocation of handleResource for the final resource happens-before returning a QueryResponse or a ResourceException are invoked with the final query status. In other words, query resource handler method invocations will occur sequentially and one at a time.

Method Summary

All Methods Instance Methods Abstract Methods
Modifier and Type	Method	Description
`boolean`	`handleResource(ResourceResponse resource)`	Invoked each time a matching JSON resource is returned from a query request.

- Method Detail
  - handleResource
```
boolean handleResource(ResourceResponse resource)
```
    Invoked each time a matching JSON resource is returned from a query request. More specifically, if a query request matches 10 resources, then this method will be invoked 10 times, once for each matching resource.
    Refer to RequestHandler.handleQuery(org.forgerock.services.context.Context, QueryRequest, QueryResourceHandler) for information regarding the concurrency and the order in which events are processed.
    
    Parameters:
    
    resource - The matching JSON resource.
    
    Returns:
    
    true if this handler should continue to be notified of any remaining matching JSON resources, or false if the remaining JSON resources should be skipped for some reason (e.g. a client side size limit has been reached).