Package org.forgerock.json.resource

Class MemoryBackend

java.lang.Object

org.forgerock.json.resource.MemoryBackend

All Implemented Interfaces:

CollectionResourceProvider

public final class MemoryBackend
extends Object
implements CollectionResourceProvider

A simple in-memory collection resource provider which uses a Map to store resources. This resource provider is intended for testing purposes only and there are no performance guarantees.

Constructor Summary

Constructors

Constructor	Description
MemoryBackend()	Creates a new in-memory collection containing no resources.

Method Summary

Modifier and Type	Method	Description
Promise<ActionResponse,ResourceException>	actionCollection(Context context, ActionRequest request)	Performs the provided action against the resource collection.
Promise<ActionResponse,ResourceException>	actionInstance(Context context, String id, ActionRequest request)	Performs the provided action against a resource within the collection.
Promise<ResourceResponse,ResourceException>	createInstance(Context context, CreateRequest request)	Adds a new resource instance to the collection.
Promise<ResourceResponse,ResourceException>	deleteInstance(Context context, String id, DeleteRequest request)	Removes a resource instance from the collection.
Promise<ResourceResponse,ResourceException>	patchInstance(Context context, String id, PatchRequest request)	Patches an existing resource within the collection.
Promise<QueryResponse,ResourceException>	queryCollection(Context context, QueryRequest request, QueryResourceHandler handler)	Searches the collection for all resources which match the query request criteria.
Promise<ResourceResponse,ResourceException>	readInstance(Context context, String id, ReadRequest request)	Reads an existing resource within the collection.
Promise<ResourceResponse,ResourceException>	updateInstance(Context context, String id, UpdateRequest request)	Updates an existing resource within the collection.

Methods inherited from class java.lang.Object

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

Constructor Detail

MemoryBackend

public MemoryBackend()

Creates a new in-memory collection containing no resources.

Method Detail

actionCollection

public Promise<ActionResponse,ResourceException> actionCollection(Context context,
                                                                        ActionRequest request)

Performs the provided action against the resource collection.

Specified by:

actionCollection in interface CollectionResourceProvider

Parameters:

context - The request server context.

request - The action request.

Returns:

A Promise containing the result of the operation.

See Also:

RequestHandler.handleAction(Context, ActionRequest)

actionInstance

public Promise<ActionResponse,ResourceException> actionInstance(Context context,
                                                                      String id,
                                                                      ActionRequest request)

Performs the provided action against a resource within the collection.

Specified by:

actionInstance in interface CollectionResourceProvider

Parameters:

context - The request server context.

id - The ID of the targeted resource within the collection.

request - The action request.

Returns:

A Promise containing the result of the operation.

See Also:

RequestHandler.handleAction(Context, ActionRequest)

createInstance

public Promise<ResourceResponse,ResourceException> createInstance(Context context,
                                                                        CreateRequest request)

Adds a new resource instance to the collection.

Create requests are targeted at the collection itself and may include a user-provided resource ID for the new resource as part of the request itself. The user-provider resource ID may be accessed using the method CreateRequest.getNewResourceId().

Specified by:

createInstance in interface CollectionResourceProvider

Parameters:

context - The request server context.

request - The create request.

Returns:

A Promise containing the result of the operation.

See Also:

RequestHandler.handleCreate(Context, CreateRequest), CreateRequest.getNewResourceId()

deleteInstance

public Promise<ResourceResponse,ResourceException> deleteInstance(Context context,
                                                                        String id,
                                                                        DeleteRequest request)

Removes a resource instance from the collection.

Specified by:

deleteInstance in interface CollectionResourceProvider

Parameters:

context - The request server context.

id - The ID of the targeted resource within the collection.

request - The delete request.

Returns:

A Promise containing the result of the operation.

See Also:

RequestHandler.handleDelete(Context, DeleteRequest)

patchInstance

public Promise<ResourceResponse,ResourceException> patchInstance(Context context,
                                                                       String id,
                                                                       PatchRequest request)

Patches an existing resource within the collection.

Specified by:

patchInstance in interface CollectionResourceProvider

Parameters:

context - The request server context.

id - The ID of the targeted resource within the collection.

request - The patch request.

Returns:

A Promise containing the result of the operation.

See Also:

RequestHandler.handlePatch(Context, PatchRequest)

queryCollection

public Promise<QueryResponse,ResourceException> queryCollection(Context context,
                                                                      QueryRequest request,
                                                                      QueryResourceHandler handler)

Searches the collection for all resources which match the query request criteria.

Implementations must invoke QueryResourceHandler.handleResource(ResourceResponse) for each resource which matches the query criteria. Once all matching resources have been returned implementations are required to return either a QueryResponse if the query has completed successfully, or ResourceException if the query did not complete successfully (even if some matching resources were returned).

Specified by:

queryCollection in interface CollectionResourceProvider

Parameters:

context - The request server context.

request - The query request.

handler - The query resource handler to be notified for each matching resource.

Returns:

A Promise containing the result of the operation.

See Also:

RequestHandler.handleQuery(Context, QueryRequest, QueryResourceHandler)

readInstance

public Promise<ResourceResponse,ResourceException> readInstance(Context context,
                                                                      String id,
                                                                      ReadRequest request)

Reads an existing resource within the collection.

Specified by:

readInstance in interface CollectionResourceProvider

Parameters:

context - The request server context.

id - The ID of the targeted resource within the collection.

request - The read request.

Returns:

A Promise containing the result of the operation.

See Also:

RequestHandler.handleRead(Context, ReadRequest)

updateInstance

public Promise<ResourceResponse,ResourceException> updateInstance(Context context,
                                                                        String id,
                                                                        UpdateRequest request)

Updates an existing resource within the collection.

Specified by:

updateInstance in interface CollectionResourceProvider

Parameters:

context - The request server context.

id - The ID of the targeted resource within the collection.

request - The update request.

Returns:

A Promise containing the result of the operation.

See Also:

RequestHandler.handleUpdate(Context, UpdateRequest)