Package com.google.gerrit.server.notedb

Class NoteDbUpdateManager

java.lang.Object

com.google.gerrit.server.notedb.NoteDbUpdateManager

All Implemented Interfaces:

AutoCloseable

public class NoteDbUpdateManager
extends Object
implements AutoCloseable

Object to manage a single sequence of updates to NoteDb.

Instances are one-time-use. Handles updating both the change repo and the All-Users repo for any affected changes, with proper ordering.

To see the state that would be applied prior to executing the full sequence of updates, use stage().

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static interface	NoteDbUpdateManager.Factory

Method Summary

Modifier and Type	Method	Description
void	add(ChangeDraftUpdate draftUpdate)
void	add(ChangeUpdate update)	Add an update to the list of updates to execute.
com.google.common.collect.ImmutableListMultimap<ProjectChangeKey,AttentionSetUpdate>	attentionSetUpdates()
void	close()
void	deleteChange(Change.Id id)
com.google.common.collect.ImmutableMultimap<Project.NameKey,org.eclipse.jgit.lib.BatchRefUpdate>	execute()
com.google.common.collect.ImmutableMultimap<Project.NameKey,org.eclipse.jgit.lib.BatchRefUpdate>	execute(boolean dryrun)
boolean	isExecuted()
NoteDbUpdateManager	setBatchUpdateListeners(com.google.common.collect.ImmutableList<BatchUpdateListener> batchUpdateListeners)
NoteDbUpdateManager	setChangeRepo(org.eclipse.jgit.lib.Repository repo, org.eclipse.jgit.revwalk.RevWalk rw, org.eclipse.jgit.lib.ObjectInserter ins, ChainedReceiveCommands cmds)
NoteDbUpdateManager	setPushCertificate(org.eclipse.jgit.transport.PushCertificate pushCert)	Set a push certificate for the push that originally triggered this NoteDb update.
NoteDbUpdateManager	setRefLogIdent(org.eclipse.jgit.lib.PersonIdent ident)
NoteDbUpdateManager	setRefLogMessage(String message)

Methods inherited from class java.lang.Object

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

Method Details

close

public void close()

Specified by:

close in interface AutoCloseable

setChangeRepo

@CanIgnoreReturnValue
public NoteDbUpdateManager setChangeRepo(org.eclipse.jgit.lib.Repository repo,
 org.eclipse.jgit.revwalk.RevWalk rw,
 org.eclipse.jgit.lib.ObjectInserter ins,
 ChainedReceiveCommands cmds)

setRefLogMessage

@CanIgnoreReturnValue
public NoteDbUpdateManager setRefLogMessage(String message)

setRefLogIdent

@CanIgnoreReturnValue
public NoteDbUpdateManager setRefLogIdent(org.eclipse.jgit.lib.PersonIdent ident)

setPushCertificate

@CanIgnoreReturnValue
public NoteDbUpdateManager setPushCertificate(org.eclipse.jgit.transport.PushCertificate pushCert)

Set a push certificate for the push that originally triggered this NoteDb update.

The pusher will not necessarily have specified any of the NoteDb refs explicitly, such as when processing a push to refs/for/master. That's fine; this is just passed to the underlying BatchRefUpdate, and the implementation decides what to do with it.

The cert should be associated with the main repo. There is currently no way of associating a push cert with the All-Users repo, since it is not currently possible to update draft changes via push.

Parameters:

pushCert - push certificate; may be null.

Returns:

this

setBatchUpdateListeners

@CanIgnoreReturnValue
public NoteDbUpdateManager setBatchUpdateListeners(com.google.common.collect.ImmutableList<BatchUpdateListener> batchUpdateListeners)

isExecuted

public boolean isExecuted()

add

public void add(ChangeUpdate update)

Add an update to the list of updates to execute.

Updates should only be added to the manager after all mutations have been made, as this method may eagerly access the update.

Parameters:

update - the update to add.

add

public void add(ChangeDraftUpdate draftUpdate)

deleteChange

public void deleteChange(Change.Id id)

execute

@CanIgnoreReturnValue
public com.google.common.collect.ImmutableMultimap<Project.NameKey,org.eclipse.jgit.lib.BatchRefUpdate> execute()
                                                                                                         throws IOException

Throws:

IOException

execute

@CanIgnoreReturnValue
public com.google.common.collect.ImmutableMultimap<Project.NameKey,org.eclipse.jgit.lib.BatchRefUpdate> execute(boolean dryrun)
                                                                                                         throws IOException

Throws:

IOException

attentionSetUpdates

public com.google.common.collect.ImmutableListMultimap<ProjectChangeKey,AttentionSetUpdate> attentionSetUpdates()