com.google.gerrit.server.change

Class ChangeEdits

java.lang.Object

com.google.gerrit.server.change.ChangeEdits

All Implemented Interfaces:

AcceptsCreate<ChangeResource>, AcceptsDelete<ChangeResource>, AcceptsPost<ChangeResource>, ChildCollection<ChangeResource,ChangeEditResource>, RestCollection<ChangeResource,ChangeEditResource>, RestView<ChangeResource>

public class ChangeEdits
extends java.lang.Object
implements ChildCollection<ChangeResource,ChangeEditResource>, AcceptsCreate<ChangeResource>, AcceptsPost<ChangeResource>, AcceptsDelete<ChangeResource>

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	ChangeEdits.Create
static class	ChangeEdits.DeleteContent Handler to delete a file.
static class	ChangeEdits.DeleteFile
static class	ChangeEdits.Detail
static class	ChangeEdits.EditMessage
static class	ChangeEdits.Get
static class	ChangeEdits.GetMessage
static class	ChangeEdits.GetMeta
static class	ChangeEdits.Post Post to edit collection resource.
static class	ChangeEdits.Put Put handler that is activated when PUT request is called on collection element.

Method Summary

Modifier and Type	Method and Description
ChangeEdits.Create	create(ChangeResource parent, IdString id) Handle creation of a child resource.
ChangeEdits.DeleteFile	delete(ChangeResource parent, IdString id) Create handler that is activated when collection element is accessed but doesn't exist, e.
RestView<ChangeResource>	list() Create a view to list the contents of the collection.
ChangeEditResource	parse(ChangeResource rsrc, IdString id) Parse a path component into a resource handle.
ChangeEdits.Post	post(ChangeResource parent) Handle creation of a child resource by POST on the collection.
DynamicMap<RestView<ChangeEditResource>>	views() Get the views that support this collection.

Methods inherited from class java.lang.Object

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

Method Detail

views

public DynamicMap<RestView<ChangeEditResource>> views()

Description copied from interface: RestCollection

Get the views that support this collection.

Within a resource the views are accessed as RESOURCE/plugin~view.

Specified by:

views in interface RestCollection<ChangeResource,ChangeEditResource>

Returns:

map of views.

list

public RestView<ChangeResource> list()

Description copied from interface: RestCollection

Create a view to list the contents of the collection.

The returned view should accept the parent type to scope the search, and may want to take a "q" parameter option to narrow the results.

Specified by:

list in interface RestCollection<ChangeResource,ChangeEditResource>

Returns:

view to list the collection.

parse

public ChangeEditResource parse(ChangeResource rsrc,
                                IdString id)
                         throws ResourceNotFoundException,
                                AuthException,
                                java.io.IOException,
                                com.google.gwtorm.server.OrmException

Description copied from interface: RestCollection

Parse a path component into a resource handle.

Specified by:

parse in interface RestCollection<ChangeResource,ChangeEditResource>

Parameters:

rsrc - the handle to the collection.

id - string identifier supplied by the client. In a URL such as /changes/1234/abandon this string is "1234".

Returns:

a resource handle for the identified object.

Throws:

ResourceNotFoundException - the object does not exist, or the caller is not permitted to know if the resource exists.

AuthException

java.io.IOException

com.google.gwtorm.server.OrmException

create

public ChangeEdits.Create create(ChangeResource parent,
                                 IdString id)
                          throws RestApiException

Description copied from interface: AcceptsCreate

Handle creation of a child resource.

Specified by:

create in interface AcceptsCreate<ChangeResource>

Parameters:

parent - parent collection handle.

id - id of the resource being created.

Returns:

a view to perform the creation. The create method must embed the id into the newly returned view object, as it will not be passed.

Throws:

RestApiException - the view cannot be constructed.

post

public ChangeEdits.Post post(ChangeResource parent)
                      throws RestApiException

Description copied from interface: AcceptsPost

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

Specified by:

post in interface AcceptsPost<ChangeResource>

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.

delete

public ChangeEdits.DeleteFile delete(ChangeResource parent,
                                     IdString id)
                              throws RestApiException

Create handler that is activated when collection element is accessed but doesn't exist, e. g. PUT request with a path was called but change edit wasn't created yet. Change edit is created and PUT handler is called.

Specified by:

delete in interface AcceptsDelete<ChangeResource>

Parameters:

parent - parent collection handle.

id - id of the resource being created (optional).

Returns:

a view to perform the deletion.

Throws:

RestApiException - the view cannot be constructed.