com.google.gerrit.server.notedb

Class NoteDbChangeState

java.lang.Object

com.google.gerrit.server.notedb.NoteDbChangeState

public class NoteDbChangeState
extends java.lang.Object

The state of all relevant NoteDb refs across all repos corresponding to a given Change entity.

Stored serialized in the Change#noteDbState field, and used to determine whether the state in NoteDb is out of date.

Serialized in one of the forms:

• [meta-sha],[account1]=[drafts-sha],[account2]=[drafts-sha]...
• R,[meta-sha],[account1]=[drafts-sha],[account2]=[drafts-sha]...
• R=[read-only-until],[meta-sha],[account1]=[drafts-sha],[account2]=[drafts-sha]...
• N
• N=[read-only-until]

in numeric account ID order, with hex SHA-1s for human readability.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	NoteDbChangeState.Delta
static class	NoteDbChangeState.PrimaryStorage
static class	NoteDbChangeState.RefState

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	NOTE_DB_PRIMARY_STATE

Constructor Summary

Constructors

Constructor and Description
NoteDbChangeState(Change.Id changeId, NoteDbChangeState.PrimaryStorage primaryStorage, java.util.Optional<NoteDbChangeState.RefState> refState, java.util.Optional<java.sql.Timestamp> readOnlyUntil)

Method Summary

Modifier and Type	Method and Description
static NoteDbChangeState	applyDelta(Change change, NoteDbChangeState.Delta delta) Apply a delta to the state stored in a change entity.
static boolean	areDraftsUpToDate(NoteDbChangeState state, RefCache draftsRepoRefs, Change.Id changeId, Account.Id accountId)
boolean	areDraftsUpToDate(RefCache draftsRepoRefs, Account.Id accountId)
static void	checkNotReadOnly(Change change, long skewMs)
static void	checkNotReadOnly(NoteDbChangeState state, long skewMs)
boolean	equals(java.lang.Object o)
Change.Id	getChangeId()
org.eclipse.jgit.lib.ObjectId	getChangeMetaId()
com.google.common.collect.ImmutableMap<Account.Id,org.eclipse.jgit.lib.ObjectId>	getDraftIds()
NoteDbChangeState.PrimaryStorage	getPrimaryStorage()
static long	getReadOnlySkew(org.eclipse.jgit.lib.Config cfg)
java.util.Optional<java.sql.Timestamp>	getReadOnlyUntil()
java.util.Optional<NoteDbChangeState.RefState>	getRefState()
int	hashCode()
static boolean	isChangeUpToDate(NoteDbChangeState state, RefCache changeRepoRefs, Change.Id changeId)
boolean	isChangeUpToDate(RefCache changeRepoRefs)
boolean	isReadOnly(java.sql.Timestamp now)
boolean	isUpToDate(RefCache changeRepoRefs, RefCache draftsRepoRefs)
static NoteDbChangeState	parse(Change.Id id, java.lang.String str)
static NoteDbChangeState	parse(Change c)
java.lang.String	toString()
NoteDbChangeState	withReadOnlyUntil(java.sql.Timestamp ts)

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Field Detail

NOTE_DB_PRIMARY_STATE

public static final java.lang.String NOTE_DB_PRIMARY_STATE

See Also:

Constant Field Values

Constructor Detail

NoteDbChangeState

public NoteDbChangeState(Change.Id changeId,
                         NoteDbChangeState.PrimaryStorage primaryStorage,
                         java.util.Optional<NoteDbChangeState.RefState> refState,
                         java.util.Optional<java.sql.Timestamp> readOnlyUntil)

Method Detail

parse

public static NoteDbChangeState parse(Change c)

parse

public static NoteDbChangeState parse(Change.Id id,
                                      java.lang.String str)

applyDelta

public static NoteDbChangeState applyDelta(Change change,
                                           NoteDbChangeState.Delta delta)

Apply a delta to the state stored in a change entity.

This method does not check whether the old state was read-only; it is up to the caller to not violate read-only semantics when storing the change back in ReviewDb.

Parameters:

change - change entity. The delta is applied against this entity's noteDbState and the new state is stored back in the entity as a side effect.

delta - delta to apply.

Returns:

new state, equivalent to what is stored in change as a side effect.

isChangeUpToDate

public static boolean isChangeUpToDate(NoteDbChangeState state,
                                       RefCache changeRepoRefs,
                                       Change.Id changeId)
                                throws java.io.IOException

Throws:

java.io.IOException

areDraftsUpToDate

public static boolean areDraftsUpToDate(NoteDbChangeState state,
                                        RefCache draftsRepoRefs,
                                        Change.Id changeId,
                                        Account.Id accountId)
                                 throws java.io.IOException

Throws:

java.io.IOException

getReadOnlySkew

public static long getReadOnlySkew(org.eclipse.jgit.lib.Config cfg)

checkNotReadOnly

public static void checkNotReadOnly(Change change,
                                    long skewMs)

checkNotReadOnly

public static void checkNotReadOnly(NoteDbChangeState state,
                                    long skewMs)

getPrimaryStorage

public NoteDbChangeState.PrimaryStorage getPrimaryStorage()

isChangeUpToDate

public boolean isChangeUpToDate(RefCache changeRepoRefs)
                         throws java.io.IOException

Throws:

java.io.IOException

areDraftsUpToDate

public boolean areDraftsUpToDate(RefCache draftsRepoRefs,
                                 Account.Id accountId)
                          throws java.io.IOException

Throws:

java.io.IOException

isUpToDate

public boolean isUpToDate(RefCache changeRepoRefs,
                          RefCache draftsRepoRefs)
                   throws java.io.IOException

Throws:

java.io.IOException

isReadOnly

public boolean isReadOnly(java.sql.Timestamp now)

getReadOnlyUntil

public java.util.Optional<java.sql.Timestamp> getReadOnlyUntil()

withReadOnlyUntil

public NoteDbChangeState withReadOnlyUntil(java.sql.Timestamp ts)

getChangeId

public Change.Id getChangeId()

getChangeMetaId

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

getDraftIds

public com.google.common.collect.ImmutableMap<Account.Id,org.eclipse.jgit.lib.ObjectId> getDraftIds()

getRefState

public java.util.Optional<NoteDbChangeState.RefState> getRefState()

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object

hashCode

public int hashCode()

Overrides:

hashCode in class java.lang.Object

equals

public boolean equals(java.lang.Object o)

Overrides:

equals in class java.lang.Object