Uses of Class
org.forgerock.json.resource.ResourceException

Packages that use ResourceException

Package	Description
org.forgerock.json.resource

Uses of ResourceException in org.forgerock.json.resource

Subclasses of ResourceException in org.forgerock.json.resource

Modifier and Type	Class and Description
class	BadRequestException An exception that is thrown during a operation on a resource when the requested operation is malformed.
class	ConflictException An exception that is thrown during a operation on a resource when such an operation would result in a conflict.
class	ForbiddenException An exception that is thrown when access to a resource is forbidden during an operation on an resource.
class	InternalServerErrorException An exception that is thrown during an operation on a resource when the server encountered an unexpected condition which prevented it from fulfilling the request.
class	NotFoundException An exception that is thrown when a specified resource cannot be found.
class	NotSupportedException An exception that is thrown during an operation on a resource when the resource does not implement/support the feature to fulfill the request.
class	PermanentException An exception that indicates that a failure is permanent, i.e. that re-trying alone without addressing the cause is not expected to succeed.
class	PreconditionFailedException An exception that is thrown to indicate that a resource's current version does not match the version provided.
class	PreconditionRequiredException An exception that is thrown to indicate that a resource requires a version, but no version was supplied in the request.
class	RetryableException An exception that indicates that a failure may be temporary, and that retrying the same request may be able to succeed in the future.
class	ServiceUnavailableException An exception that is thrown during an operation on a resource when the server is temporarily unable to handle the request.
class	UncategorizedException An exception that indicates that a failure is not directly known to the system, and hence requires out-of-band knowledge or enhancements to determine if a failure should be categorized as temporary or permanent.

Methods in org.forgerock.json.resource that return ResourceException

Modifier and Type	Method and Description
static ResourceException	ResourceException.getException(int code) Deprecated. in favor of newResourceException(int)
static ResourceException	ResourceException.getException(int code, String message) Deprecated. in favor of newResourceException(int, String)
static ResourceException	ResourceException.getException(int code, String message, Throwable cause) Deprecated. in favor of newResourceException(int, String, Throwable)
ResourceException	ResourceException.includeCauseInJsonValue() Returns this ResourceException with the includeCause flag set to true so that toJsonValue() method will include the cause if there is one supplied.
static ResourceException	ResourceException.newResourceException(int code) Returns an exception with the specified HTTP error code, but no detail message or cause, and a default reason phrase.
static ResourceException	ResourceException.newResourceException(int code, String message) Returns an exception with the specified HTTP error code and detail message, but no cause, and a default reason phrase.
static ResourceException	ResourceException.newResourceException(int code, String message, Throwable cause) Returns an exception with the specified HTTP error code, detail message, and cause, and a default reason phrase.
ResourceException	ResourceException.setDetail(org.forgerock.json.JsonValue detail) Sets the additional detail which can be evaluated by applications.
ResourceException	ResourceException.setReason(String reason) Sets/overrides the short reason phrase of the exception.

Methods in org.forgerock.json.resource that return types with arguments of type ResourceException

Modifier and Type	Method and Description
org.forgerock.util.promise.Promise<ActionResponse,ResourceException>	Connection.actionAsync(org.forgerock.services.context.Context context, ActionRequest request) Asynchronously performs an action against a specific resource, or set of resources.
org.forgerock.util.promise.Promise<ActionResponse,ResourceException>	AbstractConnectionWrapper.actionAsync(org.forgerock.services.context.Context context, ActionRequest request) Asynchronously performs an action against a specific resource, or set of resources.
org.forgerock.util.promise.Promise<ActionResponse,ResourceException>	MemoryBackend.actionCollection(org.forgerock.services.context.Context context, ActionRequest request) Performs the provided action against the resource collection.
org.forgerock.util.promise.Promise<ActionResponse,ResourceException>	CollectionResourceProvider.actionCollection(org.forgerock.services.context.Context context, ActionRequest request) Performs the provided action against the resource collection.
org.forgerock.util.promise.Promise<ActionResponse,ResourceException>	SingletonResourceProvider.actionInstance(org.forgerock.services.context.Context context, ActionRequest request) Performs the provided action against the single resource instance.
org.forgerock.util.promise.Promise<ActionResponse,ResourceException>	MemoryBackend.actionInstance(org.forgerock.services.context.Context context, String id, ActionRequest request) Performs the provided action against a resource within the collection.
org.forgerock.util.promise.Promise<ActionResponse,ResourceException>	CollectionResourceProvider.actionInstance(org.forgerock.services.context.Context context, String resourceId, ActionRequest request) Performs the provided action against a resource within the collection.
org.forgerock.util.promise.Promise<ActionResponse,ResourceException>	ActionResponse.asPromise() Return this response as a result Promise.
org.forgerock.util.promise.Promise<QueryResponse,ResourceException>	QueryResponse.asPromise() Return this response as a result Promise.
org.forgerock.util.promise.Promise<ResourceResponse,ResourceException>	ResourceResponse.asPromise() Return this response as a result Promise.
<V> org.forgerock.util.promise.Promise<V,ResourceException>	ResourceException.asPromise() Return this ResourceException as a Promise.
org.forgerock.util.promise.Promise<ResourceResponse,ResourceException>	Connection.createAsync(org.forgerock.services.context.Context context, CreateRequest request) Asynchronously adds a new JSON resource.
org.forgerock.util.promise.Promise<ResourceResponse,ResourceException>	AbstractConnectionWrapper.createAsync(org.forgerock.services.context.Context context, CreateRequest request) Asynchronously adds a new JSON resource.
org.forgerock.util.promise.Promise<ResourceResponse,ResourceException>	MemoryBackend.createInstance(org.forgerock.services.context.Context context, CreateRequest request) Adds a new resource instance to the collection.
org.forgerock.util.promise.Promise<ResourceResponse,ResourceException>	CollectionResourceProvider.createInstance(org.forgerock.services.context.Context context, CreateRequest request) Adds a new resource instance to the collection.
org.forgerock.util.promise.Promise<ResourceResponse,ResourceException>	Connection.deleteAsync(org.forgerock.services.context.Context context, DeleteRequest request) Asynchronously deletes a JSON resource.
org.forgerock.util.promise.Promise<ResourceResponse,ResourceException>	AbstractConnectionWrapper.deleteAsync(org.forgerock.services.context.Context context, DeleteRequest request) Asynchronously deletes a JSON resource.
org.forgerock.util.promise.Promise<ResourceResponse,ResourceException>	MemoryBackend.deleteInstance(org.forgerock.services.context.Context context, String id, DeleteRequest request) Removes a resource instance from the collection.
org.forgerock.util.promise.Promise<ResourceResponse,ResourceException>	CollectionResourceProvider.deleteInstance(org.forgerock.services.context.Context context, String resourceId, DeleteRequest request) Removes a resource instance from the collection.
org.forgerock.util.promise.Promise<ActionResponse,ResourceException>	Filter.filterAction(org.forgerock.services.context.Context context, ActionRequest request, RequestHandler next) Filters an action request.
org.forgerock.util.promise.Promise<ActionResponse,ResourceException>	ResourceApiVersionRoutingFilter.filterAction(org.forgerock.services.context.Context context, ActionRequest request, RequestHandler next)
org.forgerock.util.promise.Promise<ResourceResponse,ResourceException>	Filter.filterCreate(org.forgerock.services.context.Context context, CreateRequest request, RequestHandler next) Filters a create request.
org.forgerock.util.promise.Promise<ResourceResponse,ResourceException>	ResourceApiVersionRoutingFilter.filterCreate(org.forgerock.services.context.Context context, CreateRequest request, RequestHandler next)
org.forgerock.util.promise.Promise<ResourceResponse,ResourceException>	Filter.filterDelete(org.forgerock.services.context.Context context, DeleteRequest request, RequestHandler next) Filters a delete request.
org.forgerock.util.promise.Promise<ResourceResponse,ResourceException>	ResourceApiVersionRoutingFilter.filterDelete(org.forgerock.services.context.Context context, DeleteRequest request, RequestHandler next)
org.forgerock.util.promise.Promise<ResourceResponse,ResourceException>	Filter.filterPatch(org.forgerock.services.context.Context context, PatchRequest request, RequestHandler next) Filters a patch request.
org.forgerock.util.promise.Promise<ResourceResponse,ResourceException>	ResourceApiVersionRoutingFilter.filterPatch(org.forgerock.services.context.Context context, PatchRequest request, RequestHandler next)
org.forgerock.util.promise.Promise<QueryResponse,ResourceException>	Filter.filterQuery(org.forgerock.services.context.Context context, QueryRequest request, QueryResourceHandler handler, RequestHandler next) Filters a query request.
org.forgerock.util.promise.Promise<QueryResponse,ResourceException>	ResourceApiVersionRoutingFilter.filterQuery(org.forgerock.services.context.Context context, QueryRequest request, QueryResourceHandler handler, RequestHandler next)
org.forgerock.util.promise.Promise<ResourceResponse,ResourceException>	Filter.filterRead(org.forgerock.services.context.Context context, ReadRequest request, RequestHandler next) Filters a read request.
org.forgerock.util.promise.Promise<ResourceResponse,ResourceException>	ResourceApiVersionRoutingFilter.filterRead(org.forgerock.services.context.Context context, ReadRequest request, RequestHandler next)
org.forgerock.util.promise.Promise<ResourceResponse,ResourceException>	Filter.filterUpdate(org.forgerock.services.context.Context context, UpdateRequest request, RequestHandler next) Filters an update request.
org.forgerock.util.promise.Promise<ResourceResponse,ResourceException>	ResourceApiVersionRoutingFilter.filterUpdate(org.forgerock.services.context.Context context, UpdateRequest request, RequestHandler next)
org.forgerock.util.promise.Promise<Connection,ResourceException>	ConnectionFactory.getConnectionAsync() Asynchronously obtains a connection to the JSON resource provider associated with this connection factory.
org.forgerock.util.promise.Promise<ActionResponse,ResourceException>	AbstractRequestHandler.handleAction(org.forgerock.services.context.Context context, ActionRequest request) Handles performing an action on a resource, and optionally returns an associated result.
org.forgerock.util.promise.Promise<ActionResponse,ResourceException>	FilterChain.handleAction(org.forgerock.services.context.Context context, ActionRequest request)
org.forgerock.util.promise.Promise<ActionResponse,ResourceException>	RequestHandler.handleAction(org.forgerock.services.context.Context context, ActionRequest request) Handles performing an action on a resource, and optionally returns an associated result.
org.forgerock.util.promise.Promise<ActionResponse,ResourceException>	Router.handleAction(org.forgerock.services.context.Context context, ActionRequest request)
org.forgerock.util.promise.Promise<ResourceResponse,ResourceException>	AbstractRequestHandler.handleCreate(org.forgerock.services.context.Context context, CreateRequest request) Adds a new JSON resource, returning a Promise that will be completed when the resource has been added.
org.forgerock.util.promise.Promise<ResourceResponse,ResourceException>	FilterChain.handleCreate(org.forgerock.services.context.Context context, CreateRequest request)
org.forgerock.util.promise.Promise<ResourceResponse,ResourceException>	RequestHandler.handleCreate(org.forgerock.services.context.Context context, CreateRequest request) Adds a new JSON resource, returning a Promise that will be completed when the resource has been added.
org.forgerock.util.promise.Promise<ResourceResponse,ResourceException>	Router.handleCreate(org.forgerock.services.context.Context context, CreateRequest request)
org.forgerock.util.promise.Promise<ResourceResponse,ResourceException>	AbstractRequestHandler.handleDelete(org.forgerock.services.context.Context context, DeleteRequest request) Deletes a JSON resource, returning a Promise that will be completed when the resource has been deleted.
org.forgerock.util.promise.Promise<ResourceResponse,ResourceException>	FilterChain.handleDelete(org.forgerock.services.context.Context context, DeleteRequest request)
org.forgerock.util.promise.Promise<ResourceResponse,ResourceException>	RequestHandler.handleDelete(org.forgerock.services.context.Context context, DeleteRequest request) Deletes a JSON resource, returning a Promise that will be completed when the resource has been deleted.
org.forgerock.util.promise.Promise<ResourceResponse,ResourceException>	Router.handleDelete(org.forgerock.services.context.Context context, DeleteRequest request)
org.forgerock.util.promise.Promise<ResourceResponse,ResourceException>	AbstractRequestHandler.handlePatch(org.forgerock.services.context.Context context, PatchRequest request) Updates a JSON resource by applying a set of changes to its existing content, returning a Promise that will be completed when the resource has been updated.
org.forgerock.util.promise.Promise<ResourceResponse,ResourceException>	FilterChain.handlePatch(org.forgerock.services.context.Context context, PatchRequest request)
org.forgerock.util.promise.Promise<ResourceResponse,ResourceException>	RequestHandler.handlePatch(org.forgerock.services.context.Context context, PatchRequest request) Updates a JSON resource by applying a set of changes to its existing content, returning a Promise that will be completed when the resource has been updated.
org.forgerock.util.promise.Promise<ResourceResponse,ResourceException>	Router.handlePatch(org.forgerock.services.context.Context context, PatchRequest request)
org.forgerock.util.promise.Promise<QueryResponse,ResourceException>	AbstractRequestHandler.handleQuery(org.forgerock.services.context.Context context, QueryRequest request, QueryResourceHandler handler) Searches for all JSON resources matching a user specified set of criteria, returning a Promise that will be completed when the search has completed.
org.forgerock.util.promise.Promise<QueryResponse,ResourceException>	FilterChain.handleQuery(org.forgerock.services.context.Context context, QueryRequest request, QueryResourceHandler handler)
org.forgerock.util.promise.Promise<QueryResponse,ResourceException>	RequestHandler.handleQuery(org.forgerock.services.context.Context context, QueryRequest request, QueryResourceHandler handler) Searches for all JSON resources matching a user specified set of criteria, returning a Promise that will be completed when the search has completed.
org.forgerock.util.promise.Promise<QueryResponse,ResourceException>	Router.handleQuery(org.forgerock.services.context.Context context, QueryRequest request, QueryResourceHandler handler)
org.forgerock.util.promise.Promise<ResourceResponse,ResourceException>	AbstractRequestHandler.handleRead(org.forgerock.services.context.Context context, ReadRequest request) Reads a JSON resource, returning a Promise that will be completed when the resource has been read.
org.forgerock.util.promise.Promise<ResourceResponse,ResourceException>	FilterChain.handleRead(org.forgerock.services.context.Context context, ReadRequest request)
org.forgerock.util.promise.Promise<ResourceResponse,ResourceException>	RequestHandler.handleRead(org.forgerock.services.context.Context context, ReadRequest request) Reads a JSON resource, returning a Promise that will be completed when the resource has been read.
org.forgerock.util.promise.Promise<ResourceResponse,ResourceException>	Router.handleRead(org.forgerock.services.context.Context context, ReadRequest request)
org.forgerock.util.promise.Promise<ResourceResponse,ResourceException>	AbstractRequestHandler.handleUpdate(org.forgerock.services.context.Context context, UpdateRequest request) Updates a JSON resource by replacing its existing content with new content, returning a Promise that will be completed when the resource has been updated.
org.forgerock.util.promise.Promise<ResourceResponse,ResourceException>	FilterChain.handleUpdate(org.forgerock.services.context.Context context, UpdateRequest request)
org.forgerock.util.promise.Promise<ResourceResponse,ResourceException>	RequestHandler.handleUpdate(org.forgerock.services.context.Context context, UpdateRequest request) Updates a JSON resource by replacing its existing content with new content, returning a Promise that will be completed when the resource has been updated.
org.forgerock.util.promise.Promise<ResourceResponse,ResourceException>	Router.handleUpdate(org.forgerock.services.context.Context context, UpdateRequest request)
org.forgerock.util.promise.Promise<ResourceResponse,ResourceException>	Connection.patchAsync(org.forgerock.services.context.Context context, PatchRequest request) Asynchronously updates a JSON resource by applying a set of changes to its existing content.
org.forgerock.util.promise.Promise<ResourceResponse,ResourceException>	AbstractConnectionWrapper.patchAsync(org.forgerock.services.context.Context context, PatchRequest request) Asynchronously updates a JSON resource by applying a set of changes to its existing content.
org.forgerock.util.promise.Promise<ResourceResponse,ResourceException>	SingletonResourceProvider.patchInstance(org.forgerock.services.context.Context context, PatchRequest request) Patches the single resource instance.
org.forgerock.util.promise.Promise<ResourceResponse,ResourceException>	MemoryBackend.patchInstance(org.forgerock.services.context.Context context, String id, PatchRequest request) Patches an existing resource within the collection.
org.forgerock.util.promise.Promise<ResourceResponse,ResourceException>	CollectionResourceProvider.patchInstance(org.forgerock.services.context.Context context, String resourceId, PatchRequest request) Patches an existing resource within the collection.
org.forgerock.util.promise.Promise<QueryResponse,ResourceException>	Connection.queryAsync(org.forgerock.services.context.Context context, QueryRequest request, QueryResourceHandler handler) Asynchronously searches for all JSON resources matching a user specified set of criteria, and returns a Promise that will be completed with the results of the search.
org.forgerock.util.promise.Promise<QueryResponse,ResourceException>	AbstractConnectionWrapper.queryAsync(org.forgerock.services.context.Context context, QueryRequest request, QueryResourceHandler handler) Asynchronously searches for all JSON resources matching a user specified set of criteria, and returns a Promise that will be completed with the results of the search.
org.forgerock.util.promise.Promise<QueryResponse,ResourceException>	MemoryBackend.queryCollection(org.forgerock.services.context.Context context, QueryRequest request, QueryResourceHandler handler) Searches the collection for all resources which match the query request criteria.
org.forgerock.util.promise.Promise<QueryResponse,ResourceException>	CollectionResourceProvider.queryCollection(org.forgerock.services.context.Context context, QueryRequest request, QueryResourceHandler handler) Searches the collection for all resources which match the query request criteria.
org.forgerock.util.promise.Promise<ResourceResponse,ResourceException>	Connection.readAsync(org.forgerock.services.context.Context context, ReadRequest request) Asynchronously reads a JSON resource.
org.forgerock.util.promise.Promise<ResourceResponse,ResourceException>	AbstractConnectionWrapper.readAsync(org.forgerock.services.context.Context context, ReadRequest request) Asynchronously reads a JSON resource.
org.forgerock.util.promise.Promise<ResourceResponse,ResourceException>	SingletonResourceProvider.readInstance(org.forgerock.services.context.Context context, ReadRequest request) Reads the single resource instance.
org.forgerock.util.promise.Promise<ResourceResponse,ResourceException>	MemoryBackend.readInstance(org.forgerock.services.context.Context context, String id, ReadRequest request) Reads an existing resource within the collection.
org.forgerock.util.promise.Promise<ResourceResponse,ResourceException>	CollectionResourceProvider.readInstance(org.forgerock.services.context.Context context, String resourceId, ReadRequest request) Reads an existing resource within the collection.
org.forgerock.util.promise.Promise<ResourceResponse,ResourceException>	Connection.updateAsync(org.forgerock.services.context.Context context, UpdateRequest request) Asynchronously updates a JSON resource by replacing its existing content with new content.
org.forgerock.util.promise.Promise<ResourceResponse,ResourceException>	AbstractConnectionWrapper.updateAsync(org.forgerock.services.context.Context context, UpdateRequest request) Asynchronously updates a JSON resource by replacing its existing content with new content.
org.forgerock.util.promise.Promise<ResourceResponse,ResourceException>	MemoryBackend.updateInstance(org.forgerock.services.context.Context context, String id, UpdateRequest request) Updates an existing resource within the collection.
org.forgerock.util.promise.Promise<ResourceResponse,ResourceException>	CollectionResourceProvider.updateInstance(org.forgerock.services.context.Context context, String resourceId, UpdateRequest request) Updates an existing resource within the collection.
org.forgerock.util.promise.Promise<ResourceResponse,ResourceException>	SingletonResourceProvider.updateInstance(org.forgerock.services.context.Context context, UpdateRequest request) Updates the single resource instance.

Methods in org.forgerock.json.resource that throw ResourceException

Modifier and Type	Method and Description
ActionResponse	Connection.action(org.forgerock.services.context.Context context, ActionRequest request) Performs an action against a specific resource, or set of resources.
ActionResponse	AbstractAsynchronousConnection.action(org.forgerock.services.context.Context context, ActionRequest request)
ActionResponse	AbstractConnectionWrapper.action(org.forgerock.services.context.Context context, ActionRequest request) Performs an action against a specific resource, or set of resources.
ResourceResponse	Connection.create(org.forgerock.services.context.Context context, CreateRequest request) Adds a new JSON resource.
ResourceResponse	AbstractAsynchronousConnection.create(org.forgerock.services.context.Context context, CreateRequest request)
ResourceResponse	AbstractConnectionWrapper.create(org.forgerock.services.context.Context context, CreateRequest request) Adds a new JSON resource.
ResourceResponse	Connection.delete(org.forgerock.services.context.Context context, DeleteRequest request) Deletes a JSON resource.
ResourceResponse	AbstractAsynchronousConnection.delete(org.forgerock.services.context.Context context, DeleteRequest request)
ResourceResponse	AbstractConnectionWrapper.delete(org.forgerock.services.context.Context context, DeleteRequest request) Deletes a JSON resource.
Connection	ConnectionFactory.getConnection() Returns a connection to the JSON resource provider associated with this connection factory.
ActionResponse	SynchronousRequestHandler.handleAction(org.forgerock.services.context.Context context, ActionRequest request) Handles performing an action on a resource, and optionally returns an associated result.
ResourceResponse	SynchronousRequestHandler.handleCreate(org.forgerock.services.context.Context context, CreateRequest request) Adds a new JSON resource.
ResourceResponse	SynchronousRequestHandler.handleDelete(org.forgerock.services.context.Context context, DeleteRequest request) Deletes a JSON resource.
ResourceResponse	SynchronousRequestHandler.handlePatch(org.forgerock.services.context.Context context, PatchRequest request) Updates a JSON resource by applying a set of changes to its existing content.
QueryResponse	SynchronousRequestHandler.handleQuery(org.forgerock.services.context.Context context, QueryRequest request, Collection<ResourceResponse> resources) Searches for all JSON resources matching a user specified set of criteria.
ResourceResponse	SynchronousRequestHandler.handleRead(org.forgerock.services.context.Context context, ReadRequest request) Reads a JSON resource.
ResourceResponse	SynchronousRequestHandler.handleUpdate(org.forgerock.services.context.Context context, UpdateRequest request) Updates a JSON resource by replacing its existing content with new content.
ResourceResponse	Connection.patch(org.forgerock.services.context.Context context, PatchRequest request) Updates a JSON resource by applying a set of changes to its existing content.
ResourceResponse	AbstractAsynchronousConnection.patch(org.forgerock.services.context.Context context, PatchRequest request)
ResourceResponse	AbstractConnectionWrapper.patch(org.forgerock.services.context.Context context, PatchRequest request) Updates a JSON resource by applying a set of changes to its existing content.
QueryResponse	Connection.query(org.forgerock.services.context.Context context, QueryRequest request, Collection<? super ResourceResponse> results) Searches for all JSON resources matching a user specified set of criteria, and places the results in the provided collection.
QueryResponse	AbstractAsynchronousConnection.query(org.forgerock.services.context.Context context, QueryRequest request, Collection<? super ResourceResponse> results)
QueryResponse	AbstractConnectionWrapper.query(org.forgerock.services.context.Context context, QueryRequest request, Collection<? super ResourceResponse> results) Searches for all JSON resources matching a user specified set of criteria, and places the results in the provided collection.
QueryResponse	Connection.query(org.forgerock.services.context.Context context, QueryRequest request, QueryResourceHandler handler) Searches for all JSON resources matching a user specified set of criteria, and returns a Promise that will be completed with the results of the search.
QueryResponse	AbstractAsynchronousConnection.query(org.forgerock.services.context.Context context, QueryRequest request, QueryResourceHandler handler)
QueryResponse	AbstractConnectionWrapper.query(org.forgerock.services.context.Context context, QueryRequest request, QueryResourceHandler handler) Searches for all JSON resources matching a user specified set of criteria, and returns a Promise that will be completed with the results of the search.
ResourceResponse	Connection.read(org.forgerock.services.context.Context context, ReadRequest request) Reads a JSON resource.
ResourceResponse	AbstractAsynchronousConnection.read(org.forgerock.services.context.Context context, ReadRequest request)
ResourceResponse	AbstractConnectionWrapper.read(org.forgerock.services.context.Context context, ReadRequest request) Reads a JSON resource.
ResourceResponse	Connection.update(org.forgerock.services.context.Context context, UpdateRequest request) Updates a JSON resource by replacing its existing content with new content.
ResourceResponse	AbstractAsynchronousConnection.update(org.forgerock.services.context.Context context, UpdateRequest request)
ResourceResponse	AbstractConnectionWrapper.update(org.forgerock.services.context.Context context, UpdateRequest request) Updates a JSON resource by replacing its existing content with new content.