com.google.gerrit.server

Class ApprovalsUtil

java.lang.Object

com.google.gerrit.server.ApprovalsUtil

public class ApprovalsUtil
extends Object

Utility functions to manipulate patchset approvals.

Approvals are overloaded, they represent both approvals and reviewers which should be CCed on a change. To ensure that reviewers are not lost there must always be an approval on each patchset for each reviewer, even if the reviewer hasn't actually given a score to the change. To mark the "no score" case, a dummy approval, which may live in any of the available categories, with a score of 0 is used.

The methods in this class only modify the gwtorm database.

Constructor Summary

Constructors

Constructor and Description
ApprovalsUtil(ApprovalCopier copier, PermissionBackend permissionBackend, ProjectCache projectCache)

Method Summary

Modifier and Type	Method and Description
Iterable<PatchSetApproval>	addApprovalsForNewPatchSet(ChangeUpdate update, LabelTypes labelTypes, PatchSet ps, CurrentUser user, Map<String,Short> approvals) Adds approvals to ChangeUpdate for a new patch set, and writes to NoteDb.
Collection<Account.Id>	addCcs(ChangeNotes notes, ChangeUpdate update, Collection<Account.Id> wantCCs) Adds accounts to a change as reviewers in the CC state.
List<PatchSetApproval>	addReviewers(ChangeNotes notes, ChangeUpdate update, LabelTypes labelTypes, Change change, Iterable<Account.Id> wantReviewers)
List<PatchSetApproval>	addReviewers(ChangeUpdate update, LabelTypes labelTypes, Change change, PatchSet ps, PatchSetInfo info, Iterable<Account.Id> wantReviewers, Collection<Account.Id> existingReviewers)
com.google.common.collect.ListMultimap<PatchSet.Id,PatchSetApproval>	byChange(ChangeNotes notes)
Iterable<PatchSetApproval>	byPatchSet(ChangeNotes notes, PatchSet.Id psId, org.eclipse.jgit.revwalk.RevWalk rw, org.eclipse.jgit.lib.Config repoConfig)
Iterable<PatchSetApproval>	byPatchSetUser(ChangeNotes notes, PatchSet.Id psId, Account.Id accountId, org.eclipse.jgit.revwalk.RevWalk rw, org.eclipse.jgit.lib.Config repoConfig)
static void	checkLabel(LabelTypes labelTypes, String name, Short value)
ReviewerSet	getReviewers(ChangeNotes notes) Get all reviewers for a change.
ReviewerSet	getReviewers(ChangeNotes notes, Iterable<PatchSetApproval> allApprovals) Get all reviewers and CCed accounts for a change.
List<ReviewerStatusUpdate>	getReviewerUpdates(ChangeNotes notes) Get updates to reviewer set.
PatchSetApproval	getSubmitter(ChangeNotes notes, PatchSet.Id c)
static PatchSetApproval	getSubmitter(PatchSet.Id c, Iterable<PatchSetApproval> approvals)
static PatchSetApproval	newApproval(PatchSet.Id psId, CurrentUser user, LabelId labelId, int value, Date when)
static String	renderMessageWithApprovals(int patchSetId, Map<String,Short> n, Map<String,PatchSetApproval> c)

Methods inherited from class java.lang.Object

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

Constructor Detail

ApprovalsUtil

@Inject
public ApprovalsUtil(ApprovalCopier copier,
                             PermissionBackend permissionBackend,
                             ProjectCache projectCache)

Method Detail

newApproval

public static PatchSetApproval newApproval(PatchSet.Id psId,
                                           CurrentUser user,
                                           LabelId labelId,
                                           int value,
                                           Date when)

getReviewers

public ReviewerSet getReviewers(ChangeNotes notes)

Get all reviewers for a change.

Parameters:

notes - change notes.

Returns:

reviewers for the change.

getReviewers

public ReviewerSet getReviewers(ChangeNotes notes,
                                Iterable<PatchSetApproval> allApprovals)

Get all reviewers and CCed accounts for a change.

Parameters:

allApprovals - all approvals to consider; must all belong to the same change.

Returns:

reviewers for the change.

getReviewerUpdates

public List<ReviewerStatusUpdate> getReviewerUpdates(ChangeNotes notes)

Get updates to reviewer set.

Parameters:

notes - change notes.

Returns:

reviewer updates for the change.

addReviewers

public List<PatchSetApproval> addReviewers(ChangeUpdate update,
                                           LabelTypes labelTypes,
                                           Change change,
                                           PatchSet ps,
                                           PatchSetInfo info,
                                           Iterable<Account.Id> wantReviewers,
                                           Collection<Account.Id> existingReviewers)

addReviewers

public List<PatchSetApproval> addReviewers(ChangeNotes notes,
                                           ChangeUpdate update,
                                           LabelTypes labelTypes,
                                           Change change,
                                           Iterable<Account.Id> wantReviewers)

addCcs

public Collection<Account.Id> addCcs(ChangeNotes notes,
                                     ChangeUpdate update,
                                     Collection<Account.Id> wantCCs)

Adds accounts to a change as reviewers in the CC state.

Parameters:

notes - change notes.

update - change update.

wantCCs - accounts to CC.

Returns:

whether a change was made.

addApprovalsForNewPatchSet

public Iterable<PatchSetApproval> addApprovalsForNewPatchSet(ChangeUpdate update,
                                                             LabelTypes labelTypes,
                                                             PatchSet ps,
                                                             CurrentUser user,
                                                             Map<String,Short> approvals)
                                                      throws RestApiException,
                                                             PermissionBackendException

Adds approvals to ChangeUpdate for a new patch set, and writes to NoteDb.

Parameters:

update - change update.

labelTypes - label types for the containing project.

ps - patch set being approved.

user - user adding approvals.

approvals - approvals to add.

Throws:

RestApiException

PermissionBackendException

checkLabel

public static void checkLabel(LabelTypes labelTypes,
                              String name,
                              Short value)
                       throws BadRequestException

Throws:

BadRequestException

byChange

public com.google.common.collect.ListMultimap<PatchSet.Id,PatchSetApproval> byChange(ChangeNotes notes)

byPatchSet

public Iterable<PatchSetApproval> byPatchSet(ChangeNotes notes,
                                             PatchSet.Id psId,
                                             org.eclipse.jgit.revwalk.RevWalk rw,
                                             org.eclipse.jgit.lib.Config repoConfig)

byPatchSetUser

public Iterable<PatchSetApproval> byPatchSetUser(ChangeNotes notes,
                                                 PatchSet.Id psId,
                                                 Account.Id accountId,
                                                 org.eclipse.jgit.revwalk.RevWalk rw,
                                                 org.eclipse.jgit.lib.Config repoConfig)

getSubmitter

public PatchSetApproval getSubmitter(ChangeNotes notes,
                                     PatchSet.Id c)

getSubmitter

public static PatchSetApproval getSubmitter(PatchSet.Id c,
                                            Iterable<PatchSetApproval> approvals)

renderMessageWithApprovals

public static String renderMessageWithApprovals(int patchSetId,
                                                Map<String,Short> n,
                                                Map<String,PatchSetApproval> c)