com.google.gerrit.server.git

Class LabelNormalizer

java.lang.Object

com.google.gerrit.server.git.LabelNormalizer

public class LabelNormalizer
extends java.lang.Object

Normalizes votes on labels according to project config and permissions.

Votes are recorded in the database for a user based on the state of the project at that time: what labels are defined for the project, and what the user is allowed to vote on. Both of those can change between the time a vote is originally made and a later point, for example when a change is submitted. This class normalizes old votes against current project configuration.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	LabelNormalizer.Result

Method Summary

Modifier and Type	Method and Description
boolean	canVote(ChangeControl ctl, LabelType lt, Account.Id id)
LabelNormalizer.Result	normalize(Change change, java.util.Collection<PatchSetApproval> approvals)
LabelNormalizer.Result	normalize(ChangeControl ctl, java.util.Collection<PatchSetApproval> approvals)

Methods inherited from class java.lang.Object

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

Method Detail

normalize

public LabelNormalizer.Result normalize(Change change,
                                        java.util.Collection<PatchSetApproval> approvals)
                                 throws com.google.gwtorm.server.OrmException

Parameters:

change - change containing the given approvals.

approvals - list of approvals.

Returns:

copies of approvals normalized to the defined ranges for the label type and permissions for the user. Approvals for unknown labels are not included in the output, nor are approvals where the user has no permissions for that label.

Throws:

com.google.gwtorm.server.OrmException

normalize

public LabelNormalizer.Result normalize(ChangeControl ctl,
                                        java.util.Collection<PatchSetApproval> approvals)

Parameters:

ctl - change control containing the given approvals.

approvals - list of approvals.

Returns:

copies of approvals normalized to the defined ranges for the label type and permissions for the user. Approvals for unknown labels are not included in the output, nor are approvals where the user has no permissions for that label.

canVote

public boolean canVote(ChangeControl ctl,
                       LabelType lt,
                       Account.Id id)

Parameters:

ctl - change control (for any user).

lt - label type.

id - account ID.

Returns:

whether the given account ID has any permissions to vote on this label for this change.