org.forgerock.authz.basic.crest

Class SimpleResource

java.lang.Object

org.forgerock.authz.basic.crest.SimpleResource

All Implemented Interfaces:

CollectionResourceProvider

public class SimpleResource
extends Object
implements CollectionResourceProvider

Simple CollectionResourceProvider that just echos back the operation performed.

Since:

1.5.0

Constructor Summary

Constructors

Constructor and Description
SimpleResource()

Method Summary

Modifier and Type	Method and Description
Promise<ActionResponse,ResourceException>	actionCollection(Context context, ActionRequest request) Performs the provided action against the resource collection.
Promise<ActionResponse,ResourceException>	actionInstance(Context context, String resourceId, 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 resourceId, DeleteRequest request) Removes a resource instance from the collection.
Promise<ResourceResponse,ResourceException>	patchInstance(Context context, String resourceId, 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 resourceId, ReadRequest request) Reads an existing resource within the collection.
Promise<ResourceResponse,ResourceException>	updateInstance(Context context, String resourceId, 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

SimpleResource

public SimpleResource()

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 resourceId,
                                                                ActionRequest request)

Performs the provided action against a resource within the collection.

Specified by:

actionInstance in interface CollectionResourceProvider

Parameters:

context - The request server context.

resourceId - 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 resourceId,
                                                                  DeleteRequest request)

Removes a resource instance from the collection.

Specified by:

deleteInstance in interface CollectionResourceProvider

Parameters:

context - The request server context.

resourceId - 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 resourceId,
                                                                 PatchRequest request)

Patches an existing resource within the collection.

Specified by:

patchInstance in interface CollectionResourceProvider

Parameters:

context - The request server context.

resourceId - 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 resourceId,
                                                                ReadRequest request)

Reads an existing resource within the collection.

Specified by:

readInstance in interface CollectionResourceProvider

Parameters:

context - The request server context.

resourceId - 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 resourceId,
                                                                  UpdateRequest request)

Updates an existing resource within the collection.

Specified by:

updateInstance in interface CollectionResourceProvider

Parameters:

context - The request server context.

resourceId - 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)