com.google.gerrit.server.notedb

Class AbstractChangeNotes<T>

java.lang.Object

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

Direct Known Subclasses:

ChangeNotes, DraftCommentNotes, RobotCommentNotes

public abstract class AbstractChangeNotes<T>
extends java.lang.Object

View of contents at a single ref related to some change. *

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	AbstractChangeNotes.Args
static class	AbstractChangeNotes.LoadHandle

Field Summary

Fields

Modifier and Type	Field and Description
protected AbstractChangeNotes.Args	args
protected boolean	autoRebuild
protected NoteDbChangeState.PrimaryStorage	primaryStorage

Method Summary

Modifier and Type	Method and Description
Change.Id	getChangeId()
abstract Project.NameKey	getProjectName()
protected abstract java.lang.String	getRefName()
org.eclipse.jgit.lib.ObjectId	getRevision()
T	load()
protected abstract void	loadDefaults() Load default values for any instance variables when NoteDb is disabled.
org.eclipse.jgit.lib.ObjectId	loadRevision()
protected abstract void	onLoad(AbstractChangeNotes.LoadHandle handle) Set up the metadata, parsing any state from the loaded revision.
protected AbstractChangeNotes.LoadHandle	openHandle(org.eclipse.jgit.lib.Repository repo) Open a handle for reading this entity from a repository.
protected AbstractChangeNotes.LoadHandle	openHandle(org.eclipse.jgit.lib.Repository repo, org.eclipse.jgit.lib.ObjectId id)
protected org.eclipse.jgit.lib.ObjectId	readRef(org.eclipse.jgit.lib.Repository repo)
T	reload()
protected T	self()

Methods inherited from class java.lang.Object

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

Field Detail

args

protected final AbstractChangeNotes.Args args

primaryStorage

protected final NoteDbChangeState.PrimaryStorage primaryStorage

autoRebuild

protected final boolean autoRebuild

Method Detail

getChangeId

public Change.Id getChangeId()

getRevision

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

Returns:

revision of the metadata that was loaded.

load

public T load()
       throws com.google.gwtorm.server.OrmException

Throws:

com.google.gwtorm.server.OrmException

readRef

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

Throws:

java.io.IOException

openHandle

protected AbstractChangeNotes.LoadHandle openHandle(org.eclipse.jgit.lib.Repository repo)
                                             throws NoSuchChangeException,
                                                    java.io.IOException

Open a handle for reading this entity from a repository.

Implementations may override this method to provide auto-rebuilding behavior.

Parameters:

repo - open repository.

Returns:

handle for reading the entity.

Throws:

NoSuchChangeException - change does not exist.

java.io.IOException - a repo-level error occurred.

openHandle

protected AbstractChangeNotes.LoadHandle openHandle(org.eclipse.jgit.lib.Repository repo,
                                                    org.eclipse.jgit.lib.ObjectId id)

reload

public T reload()
         throws NoSuchChangeException,
                com.google.gwtorm.server.OrmException

Throws:

NoSuchChangeException

com.google.gwtorm.server.OrmException

loadRevision

public org.eclipse.jgit.lib.ObjectId loadRevision()
                                           throws com.google.gwtorm.server.OrmException

Throws:

com.google.gwtorm.server.OrmException

loadDefaults

protected abstract void loadDefaults()

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

getProjectName

public abstract Project.NameKey getProjectName()

Returns:

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

getRefName

protected abstract java.lang.String getRefName()

Returns:

name of the reference storing this configuration.

onLoad

protected abstract void onLoad(AbstractChangeNotes.LoadHandle handle)
                        throws NoSuchChangeException,
                               java.io.IOException,
                               org.eclipse.jgit.errors.ConfigInvalidException

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

Throws:

NoSuchChangeException

java.io.IOException

org.eclipse.jgit.errors.ConfigInvalidException

self

protected final T self()