LabelNormalizer (Gerrit Review Plugin API Documentation)

java.lang.Object
- com.google.gerrit.server.change.LabelNormalizer

```
public class LabelNormalizer
extends Object
```
Normalizes votes on labels according to project config.
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. The label definition 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.
Normalizing a vote means making it compliant with the current label definition:
- If the voting value is greater than the max allowed value according to the label definition, the voting value is changed to the max allowed value.
- If the voting value is lower than the min allowed value according to the label definition, the voting value is changed to the min allowed value.
- If the label definition for a vote is missing, the vote is deleted.

Nested Class Summary

Nested Classes
Modifier and Type Class Description

static class LabelNormalizer.Result

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method	Description
`Optional<PatchSetApproval>`	`normalize(ChangeNotes notes, PatchSetApproval approval)`	Returns a copy of the given approval normalized to the defined ranges for the label type.
`LabelNormalizer.Result`	`normalize(ChangeNotes notes, Collection<PatchSetApproval> approvals)`	Returns copies of approvals normalized to the defined ranges for the label type.

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(ChangeNotes notes,
                                        Collection<PatchSetApproval> approvals)
```
    Returns copies of approvals normalized to the defined ranges for the label type. Approvals for unknown labels are not included in the output
    
    Parameters:
    
    notes - change notes containing the given approvals.
    
    approvals - list of approvals.
  - normalize
```
public Optional<PatchSetApproval> normalize(ChangeNotes notes,
                                            PatchSetApproval approval)
```
    Returns a copy of the given approval normalized to the defined ranges for the label type. If the approval is for an unknown label Optional.empty() is returned
    
    Parameters:
    
    notes - change notes containing the given approval
    
    approval - approval that should be normalized