Package org.projectnessie.versioned.persist.adapter

Interface CommitLogEntry

@Immutable
public interface CommitLogEntry

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.versioned.Key>	getDeletes()	List of "unchanged" keys, from Delete commit operations.
org.projectnessie.versioned.Hash	getHash()
KeyList	getKeyList()	The list of all "reachable" or "known" Keys 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 Key for this commit.
default CommitLogEntry.KeyListVariant	getKeyListVariant()
com.google.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, com.google.protobuf.ByteString metadata, java.lang.Iterable<KeyWithBytes> puts, java.lang.Iterable<org.projectnessie.versioned.Key> 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()

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

com.google.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.versioned.Key> getDeletes()

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

getKeyList

@Nullable
@Nullable
KeyList getKeyList()

The list of all "reachable" or "known" Keys 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 Key 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,
                         com.google.protobuf.ByteString metadata,
                         java.lang.Iterable<KeyWithBytes> puts,
                         java.lang.Iterable<org.projectnessie.versioned.Key> 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)