Package com.google.gerrit.server.notedb

Class ChangeNotes

java.lang.Object

com.google.gerrit.server.notedb.AbstractChangeNotes<ChangeNotes>

com.google.gerrit.server.notedb.ChangeNotes

public class ChangeNotes
extends AbstractChangeNotes<ChangeNotes>

View of a single Change based on the log of its notes branch.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	ChangeNotes.Factory

Nested classes/interfaces inherited from class com.google.gerrit.server.notedb.AbstractChangeNotes

AbstractChangeNotes.Args, AbstractChangeNotes.LoadHandle

Field Summary

Fields

Modifier and Type	Field	Description
static com.google.common.collect.Ordering<ChangeMessage>	MESSAGE_BY_TIME

Fields inherited from class com.google.gerrit.server.notedb.AbstractChangeNotes

args

Constructor Summary

Constructors

Constructor	Description
ChangeNotes(AbstractChangeNotes.Args args, Change change, boolean shouldExist, RefCache refs)

Method Summary

Modifier and Type	Method	Description
boolean	containsComment(Comment c)
boolean	containsCommentPublished(Comment c)
com.google.common.collect.ImmutableList<Account.Id>	getAllPastReviewers()
com.google.common.collect.ImmutableListMultimap<PatchSet.Id,PatchSetApproval>	getApprovals()
com.google.common.collect.ImmutableList<AssigneeStatusUpdate>	getAssigneeUpdates()
com.google.common.collect.ImmutableSet<AttentionSetUpdate>	getAttentionSet()	Returns the most recent update (i.e.
Change	getChange()
com.google.common.collect.ImmutableList<ChangeMessage>	getChangeMessages()
com.google.common.collect.ImmutableSet<Comment.Key>	getCommentKeys()
com.google.common.collect.ImmutableListMultimap<org.eclipse.jgit.lib.ObjectId,Comment>	getComments()
PatchSet	getCurrentPatchSet()
com.google.common.collect.ImmutableListMultimap<org.eclipse.jgit.lib.ObjectId,Comment>	getDraftComments(Account.Id author)
com.google.common.collect.ImmutableListMultimap<org.eclipse.jgit.lib.ObjectId,Comment>	getDraftComments(Account.Id author, org.eclipse.jgit.lib.Ref ref)
com.google.common.collect.ImmutableSet<String>	getHashtags()
org.eclipse.jgit.lib.ObjectId	getMetaId()
com.google.common.collect.ImmutableSet<Account.Id>	getPastAssignees()
com.google.common.collect.ImmutableSortedMap<PatchSet.Id,PatchSet>	getPatchSets()
ReviewerSet	getPendingReviewers()
ReviewerByEmailSet	getPendingReviewersByEmail()
Project.NameKey	getProjectName()
String	getRefName()
ReviewerSet	getReviewers()
ReviewerByEmailSet	getReviewersByEmail()
com.google.common.collect.ImmutableList<ReviewerStatusUpdate>	getReviewerUpdates()
RobotCommentNotes	getRobotCommentNotes()
com.google.common.collect.ImmutableListMultimap<org.eclipse.jgit.lib.ObjectId,RobotComment>	getRobotComments()
com.google.common.collect.ImmutableList<SubmitRecord>	getSubmitRecords()
int	getUpdateCount()
protected void	loadDefaults()	Load default values for any instance variables when NoteDb is disabled.
protected void	onLoad(AbstractChangeNotes.LoadHandle handle)	Set up the metadata, parsing any state from the loaded revision.
static org.eclipse.jgit.errors.ConfigInvalidException	parseException(Change.Id changeId, String fmt, Object... args)
protected org.eclipse.jgit.lib.ObjectId	readRef(org.eclipse.jgit.lib.Repository repo)

Methods inherited from class com.google.gerrit.server.notedb.AbstractChangeNotes

getChangeId, getRevision, load, loadRevision, openHandle, openHandle, reload, self

Methods inherited from class java.lang.Object

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

Field Detail

MESSAGE_BY_TIME

public static final com.google.common.collect.Ordering<ChangeMessage> MESSAGE_BY_TIME

Constructor Detail

ChangeNotes

public ChangeNotes(AbstractChangeNotes.Args args,
                   Change change,
                   boolean shouldExist,
                   RefCache refs)

Method Detail

parseException

public static org.eclipse.jgit.errors.ConfigInvalidException parseException(Change.Id changeId,
                                                                            String fmt,
                                                                            Object... args)

getChange

public Change getChange()

getMetaId

public org.eclipse.jgit.lib.ObjectId getMetaId()

getPatchSets

public com.google.common.collect.ImmutableSortedMap<PatchSet.Id,PatchSet> getPatchSets()

getApprovals

public com.google.common.collect.ImmutableListMultimap<PatchSet.Id,PatchSetApproval> getApprovals()

getReviewers

public ReviewerSet getReviewers()

getReviewersByEmail

public ReviewerByEmailSet getReviewersByEmail()

Returns:

reviewers that do not currently have a Gerrit account and were added by email.

getPendingReviewers

public ReviewerSet getPendingReviewers()

Returns:

reviewers that were modified during this change's current WIP phase.

getPendingReviewersByEmail

public ReviewerByEmailSet getPendingReviewersByEmail()

Returns:

reviewers by email that were modified during this change's current WIP phase.

getReviewerUpdates

public com.google.common.collect.ImmutableList<ReviewerStatusUpdate> getReviewerUpdates()

getAttentionSet

public com.google.common.collect.ImmutableSet<AttentionSetUpdate> getAttentionSet()

Returns the most recent update (i.e. status) per user.

getPastAssignees

public com.google.common.collect.ImmutableSet<Account.Id> getPastAssignees()

Returns:

an ImmutableSet of Account.Ids of all users that have been assigned to this change. The order of the set is the order in which they were assigned.

getAssigneeUpdates

public com.google.common.collect.ImmutableList<AssigneeStatusUpdate> getAssigneeUpdates()

Returns:

an ImmutableList of AssigneeStatusUpdate of all the updates to the assignee field to this change. The order of the list is from most recent updates to least recent.

getHashtags

public com.google.common.collect.ImmutableSet<String> getHashtags()

Returns:

a ImmutableSet of all hashtags for this change sorted in alphabetical order.

getAllPastReviewers

public com.google.common.collect.ImmutableList<Account.Id> getAllPastReviewers()

Returns:

a list of all users who have ever been a reviewer on this change.

getSubmitRecords

public com.google.common.collect.ImmutableList<SubmitRecord> getSubmitRecords()

Returns:

submit records stored during the most recent submit; only for changes that were actually submitted.

getChangeMessages

public com.google.common.collect.ImmutableList<ChangeMessage> getChangeMessages()

Returns:

all change messages, in chronological order, oldest first.

getComments

public com.google.common.collect.ImmutableListMultimap<org.eclipse.jgit.lib.ObjectId,Comment> getComments()

Returns:

inline comments on each revision.

getCommentKeys

public com.google.common.collect.ImmutableSet<Comment.Key> getCommentKeys()

getUpdateCount

public int getUpdateCount()

getDraftComments

public com.google.common.collect.ImmutableListMultimap<org.eclipse.jgit.lib.ObjectId,Comment> getDraftComments(Account.Id author)

getDraftComments

public com.google.common.collect.ImmutableListMultimap<org.eclipse.jgit.lib.ObjectId,Comment> getDraftComments(Account.Id author,
                                                                                                                     org.eclipse.jgit.lib.Ref ref)

getRobotComments

public com.google.common.collect.ImmutableListMultimap<org.eclipse.jgit.lib.ObjectId,RobotComment> getRobotComments()

getRobotCommentNotes

public RobotCommentNotes getRobotCommentNotes()

containsComment

public boolean containsComment(Comment c)

containsCommentPublished

public boolean containsCommentPublished(Comment c)

getRefName

public String getRefName()

Specified by:

getRefName in class AbstractChangeNotes<ChangeNotes>

Returns:

name of the reference storing this configuration.

getCurrentPatchSet

public PatchSet getCurrentPatchSet()

onLoad

protected void onLoad(AbstractChangeNotes.LoadHandle handle)
               throws NoSuchChangeException,
                      IOException

Description copied from class: AbstractChangeNotes

Set up the metadata, parsing any state from the loaded revision.

Specified by:

onLoad in class AbstractChangeNotes<ChangeNotes>

Throws:

NoSuchChangeException

IOException

loadDefaults

protected void loadDefaults()

Description copied from class: AbstractChangeNotes

Load default values for any instance variables when NoteDb is disabled.

Specified by:

loadDefaults in class AbstractChangeNotes<ChangeNotes>

getProjectName

public Project.NameKey getProjectName()

Specified by:

getProjectName in class AbstractChangeNotes<ChangeNotes>

Returns:

the NameKey for the project where the notes should be stored, which is not necessarily the same as the change's project.

readRef

protected org.eclipse.jgit.lib.ObjectId readRef(org.eclipse.jgit.lib.Repository repo)
                                         throws IOException

Overrides:

readRef in class AbstractChangeNotes<ChangeNotes>

Throws:

IOException