Package com.google.gerrit.server.restapi.project

Class CommitsCollection

java.lang.Object

com.google.gerrit.server.restapi.project.CommitsCollection

All Implemented Interfaces:

ChildCollection<ProjectResource,CommitResource>, RestCollection<ProjectResource,CommitResource>, RestView<ProjectResource>

public class CommitsCollection
extends Object
implements ChildCollection<ProjectResource,CommitResource>

Constructor Summary

Constructors

Constructor	Description
CommitsCollection(DynamicMap<RestView<CommitResource>> views, GitRepositoryManager repoManager, ChangeIndexCollection indexes, com.google.inject.Provider<InternalChangeQuery> queryProvider, Reachable reachable)

Method Summary

Modifier and Type	Method	Description
boolean	canRead(ProjectState state, org.eclipse.jgit.lib.Repository repo, org.eclipse.jgit.revwalk.RevCommit commit)
RestView<ProjectResource>	list()	Create a view to list the contents of the collection.
CommitResource	parse(ProjectResource parent, IdString id)	Parse a path component into a resource handle.
DynamicMap<RestView<CommitResource>>	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

Constructor Detail

CommitsCollection

@Inject
public CommitsCollection(DynamicMap<RestView<CommitResource>> views,
                         GitRepositoryManager repoManager,
                         ChangeIndexCollection indexes,
                         com.google.inject.Provider<InternalChangeQuery> queryProvider,
                         Reachable reachable)

Method Detail

list

public RestView<ProjectResource> list()
                               throws ResourceNotFoundException

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<ProjectResource,CommitResource>

Returns:

view to list the collection.

Throws:

ResourceNotFoundException - if the collection doesn't support listing.

parse

public CommitResource parse(ProjectResource parent,
                            IdString id)
                     throws RestApiException,
                            IOException

Description copied from interface: RestCollection

Parse a path component into a resource handle.

Specified by:

parse in interface RestCollection<ProjectResource,CommitResource>

Parameters:

parent - 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.

RestApiException

IOException

views

public DynamicMap<RestView<CommitResource>> 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<ProjectResource,CommitResource>

Returns:

map of views.

canRead

public boolean canRead(ProjectState state,
                       org.eclipse.jgit.lib.Repository repo,
                       org.eclipse.jgit.revwalk.RevCommit commit)
                throws IOException

Returns:

true if commit is visible to the caller.

Throws:

IOException