com.google.gerrit.extensions.restapi

Interface AcceptsPost<P extends RestResource>

All Known Implementing Classes:

CachesCollection, ChangeEdits, ChangesCollection, PublishChangeEdit, RebaseChangeEdit

public interface AcceptsPost<P extends RestResource>

Optional interface for RestCollection.

Collections that implement this interface can accept a POST directly on the collection itself when no id was given in the path. This interface is intended to be used with TopLevelResource collections. Nested collections often bind POST on the parent collection to the view implementation handling the insertion of a new member.

Method Summary

Modifier and Type	Method and Description
RestModifyView<P,?>	post(P parent) Handle creation of a child resource by POST on the collection.

Method Detail

post

RestModifyView<P,?> post(P parent)
                  throws RestApiException

Handle creation of a child resource by POST on the collection.

Parameters:

parent - parent collection handle.

Returns:

a view to perform the creation. The id of the newly created resource should be determined from the input body.

Throws:

RestApiException - the view cannot be constructed.