net.sf.javaprinciples.resource
Interface ResourcePutService<T>

Type Parameters:

T - Type of content in the Resource.

public interface ResourcePutService<T>

Service interface for PUT and POST operations for Resources.

Author:

rvllewln

Method Summary

ResourceIdentifier

putResource(ResourceIdentifier identifier, Resource<T> resource) Put/Post a Resource.

Method Detail

putResource

ResourceIdentifier putResource(ResourceIdentifier identifier,
                               Resource<T> resource)
                               throws ResourceException

Put/Post a Resource.

Parameters:

identifier - The Resource's identifier (if known - typically null for a POST).

resource - The Resource representation to be stored/used.

Returns:

The ResourceIdentifier, which will be the same as that provided (for a PUT) or will be a new Identifier generated by the server for the Resource in the case of a POST.

Throws:

ResourceException - If there are any problems in putting the Resource.