Package org.projectnessie.versioned.persist.adapter

Interface CommitLogEntry

All Superinterfaces:

org.projectnessie.versioned.Hashable

@Immutable
public interface CommitLogEntry
extends org.projectnessie.versioned.Hashable

Represents a commit-log-entry stored in the database.

Nested Class Summary

Nested Classes

Modifier and Type	Interface	Description
static class	CommitLogEntry.KeyListVariant

Method Summary

Modifier and Type	Method	Description
java.util.List<org.projectnessie.versioned.Hash>	getAdditionalParents()
long	getCommitSeq()	Monotonically increasing counter representing the number of commits since the "beginning of time.
long	getCreatedTime()	Creation timestamp in microseconds since epoch.
java.util.List<org.projectnessie.model.ContentKey>	getDeletes()	List of "unchanged" keys, from Delete commit operations.
org.projectnessie.versioned.Hash	getHash()
KeyList	getKeyList()	The list of all "reachable" or "known" ContentKeys up to this commit-log-entry's parent commit consists of all entries in this KeyList plus the KeyListEntitys via getKeyListsIds().
java.lang.Integer	getKeyListBucketCount()	The cumulative total of buckets across all segments.
int	getKeyListDistance()	Number of commits since the last complete key-list.
java.util.List<java.lang.Integer>	getKeyListEntityOffsets()	The indices of the first occupied bucket in each non-embedded segment of the key list.
java.lang.Float	getKeyListLoadFactor()	Load factor for key lists hashed using open-addressing.
java.util.List<org.projectnessie.versioned.Hash>	getKeyListsIds()	IDs of for the linked KeyListEntity that, together with getKeyList() make the complete ContentKey for this commit.
default CommitLogEntry.KeyListVariant	getKeyListVariant()
org.projectnessie.nessie.relocated.protobuf.ByteString	getMetadata()	Serialized commit-metadata.
java.util.List<org.projectnessie.versioned.Hash>	getParents()	Zero, one or more parent-entry hashes of this commit, nearest parent first.
java.util.List<KeyWithBytes>	getPuts()	List of all Put operations, with their keys, content-types and serialized Content.
default boolean	hasKeySummary()
static CommitLogEntry	of(long createdTime, org.projectnessie.versioned.Hash hash, long commitSeq, java.lang.Iterable<org.projectnessie.versioned.Hash> parents, org.projectnessie.nessie.relocated.protobuf.ByteString metadata, java.lang.Iterable<KeyWithBytes> puts, java.lang.Iterable<org.projectnessie.model.ContentKey> deletes, int keyListDistance, KeyList keyList, java.lang.Iterable<org.projectnessie.versioned.Hash> keyListIds, java.lang.Iterable<java.lang.Integer> keyListEntityOffsets, java.lang.Iterable<org.projectnessie.versioned.Hash> additionalParents)

Method Detail

getCreatedTime

long getCreatedTime()

Creation timestamp in microseconds since epoch.

getHash

org.projectnessie.versioned.Hash getHash()

Specified by:

getHash in interface org.projectnessie.versioned.Hashable

getCommitSeq

long getCommitSeq()

Monotonically increasing counter representing the number of commits since the "beginning of time.

getParents

java.util.List<org.projectnessie.versioned.Hash> getParents()

Zero, one or more parent-entry hashes of this commit, nearest parent first.

getMetadata

org.projectnessie.nessie.relocated.protobuf.ByteString getMetadata()

Serialized commit-metadata.

getPuts

java.util.List<KeyWithBytes> getPuts()

List of all Put operations, with their keys, content-types and serialized Content.

getDeletes

java.util.List<org.projectnessie.model.ContentKey> getDeletes()

List of "unchanged" keys, from Delete commit operations.

getKeyList

@Nullable
@Nullable
KeyList getKeyList()

The list of all "reachable" or "known" ContentKeys up to this commit-log-entry's parent commit consists of all entries in this KeyList plus the KeyListEntitys via getKeyListsIds().

This key-list checkpoint, if present, does not contain the key-changes in this entry in getPuts() and getDeletes().

getKeyListsIds

java.util.List<org.projectnessie.versioned.Hash> getKeyListsIds()

IDs of for the linked KeyListEntity that, together with getKeyList() make the complete ContentKey for this commit.

getKeyListEntityOffsets

@Nullable
@Nullable
java.util.List<java.lang.Integer> getKeyListEntityOffsets()

The indices of the first occupied bucket in each non-embedded segment of the key list.

getKeyListLoadFactor

@Nullable
@Nullable
java.lang.Float getKeyListLoadFactor()

Load factor for key lists hashed using open-addressing.

This is a user-configured value, typically on (0, 1). In practice, key lists may be hashed at a lower effective load factor than configured here (e.g. for alignment), but generally not a higher one.

getKeyListBucketCount

@Nullable
@Nullable
java.lang.Integer getKeyListBucketCount()

The cumulative total of buckets across all segments.

This is generally much greater than the segment count. Addressable buckets have indices on the interval [0, this value).

getKeyListDistance

int getKeyListDistance()

Number of commits since the last complete key-list.

getAdditionalParents

java.util.List<org.projectnessie.versioned.Hash> getAdditionalParents()

getKeyListVariant

@Default
default CommitLogEntry.KeyListVariant getKeyListVariant()

hasKeySummary

default boolean hasKeySummary()

of

static CommitLogEntry of(long createdTime,
                         org.projectnessie.versioned.Hash hash,
                         long commitSeq,
                         java.lang.Iterable<org.projectnessie.versioned.Hash> parents,
                         org.projectnessie.nessie.relocated.protobuf.ByteString metadata,
                         java.lang.Iterable<KeyWithBytes> puts,
                         java.lang.Iterable<org.projectnessie.model.ContentKey> deletes,
                         int keyListDistance,
                         KeyList keyList,
                         java.lang.Iterable<org.projectnessie.versioned.Hash> keyListIds,
                         java.lang.Iterable<java.lang.Integer> keyListEntityOffsets,
                         java.lang.Iterable<org.projectnessie.versioned.Hash> additionalParents)