org.apache.cassandra.db.rows

Class ColumnData

java.lang.Object

org.apache.cassandra.db.rows.ColumnData

All Implemented Interfaces:

IMeasurableMemory

Direct Known Subclasses:

Cell, ComplexColumnData

public abstract class ColumnData
extends java.lang.Object
implements IMeasurableMemory

Generic interface for the data of a given column (inside a row). In practice, there is only 2 implementations of this: either Cell for simple columns or ComplexColumnData for complex columns.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	ColumnData.PostReconciliationFunction
static class	ColumnData.Reconciler

Field Summary

Fields

Modifier and Type	Field and Description
protected ColumnMetadata	column
static java.util.Comparator<ColumnData>	comparator
static ColumnData.PostReconciliationFunction	noOp

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	ColumnData(ColumnMetadata column)

Method Summary

Modifier and Type	Method and Description
abstract ColumnData	clone(Cloner cloner)
ColumnMetadata	column() The column this is data for.
abstract int	dataSize() The size of the data hold by this ColumnData.
abstract void	digest(Digest digest) Adds the data to the provided digest.
static void	digest(Digest digest, ColumnData cd)
abstract boolean	hasInvalidDeletions() Validates the deletions (ttl and local deletion time) if any.
abstract ColumnData	markCounterLocalToBeCleared()
abstract long	maxTimestamp()
abstract ColumnData	purge(DeletionPurger purger, int nowInSec)
abstract ColumnData	purgeDataOlderThan(long timestamp)
static ColumnData.Reconciler	reconciler(ColumnData.PostReconciliationFunction updateF, DeletionTime activeDeletion) Construct an UpdateFunction for reconciling normal ColumnData (i.e.
abstract long	unsharedHeapSize()
abstract long	unsharedHeapSizeExcludingData()
abstract ColumnData	updateAllTimestamp(long newTimestamp) Returns a copy of the data where all timestamps for live data have replaced by newTimestamp and all deletion timestamp by newTimestamp - 1.
abstract void	validate() Validate the column data.

Methods inherited from class java.lang.Object

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

Field Detail

comparator

public static final java.util.Comparator<ColumnData> comparator

noOp

public static ColumnData.PostReconciliationFunction noOp

column

protected final ColumnMetadata column

Constructor Detail

ColumnData

protected ColumnData(ColumnMetadata column)

Method Detail

reconciler

public static ColumnData.Reconciler reconciler(ColumnData.PostReconciliationFunction updateF,
                                               DeletionTime activeDeletion)

Construct an UpdateFunction for reconciling normal ColumnData (i.e. not suitable for ComplexColumnDeletion sentinels, but suitable ComplexColumnData or Cell)

Parameters:

updateF - a consumer receiving all pairs of reconciled cells

activeDeletion - the row or partition deletion time to use for purging

column

public final ColumnMetadata column()

The column this is data for.

Returns:

the column this is a data for.

dataSize

public abstract int dataSize()

The size of the data hold by this ColumnData.

Returns:

the size used by the data of this ColumnData.

unsharedHeapSizeExcludingData

public abstract long unsharedHeapSizeExcludingData()

unsharedHeapSize

public abstract long unsharedHeapSize()

Specified by:

unsharedHeapSize in interface IMeasurableMemory

Returns:

the amount of on-heap memory retained by the object that might be reclaimed if the object were reclaimed, i.e. it should try to exclude globally cached data where possible, or counting portions of arrays that are referenced by the object but used by other objects only (e.g. slabbed byte-buffers), etc.

validate

public abstract void validate()

Validate the column data.

Throws:

MarshalException - if the data is not valid.

hasInvalidDeletions

public abstract boolean hasInvalidDeletions()

Validates the deletions (ttl and local deletion time) if any.

Returns:

true if it has any invalid deletions, false otherwise

digest

public abstract void digest(Digest digest)

Adds the data to the provided digest.

Parameters:

digest - the Digest to add the data to.

digest

public static void digest(Digest digest,
                          ColumnData cd)

clone

public abstract ColumnData clone(Cloner cloner)

updateAllTimestamp

public abstract ColumnData updateAllTimestamp(long newTimestamp)

Returns a copy of the data where all timestamps for live data have replaced by newTimestamp and all deletion timestamp by newTimestamp - 1. This exists for the Paxos path, see PartitionUpdate#updateAllTimestamp for additional details.

markCounterLocalToBeCleared

public abstract ColumnData markCounterLocalToBeCleared()

purge

public abstract ColumnData purge(DeletionPurger purger,
                                 int nowInSec)

purgeDataOlderThan

public abstract ColumnData purgeDataOlderThan(long timestamp)

maxTimestamp

public abstract long maxTimestamp()