Package org.apache.cassandra.db

Class Mutation

java.lang.Object

org.apache.cassandra.db.Mutation

All Implemented Interfaces:

java.util.function.Supplier<Mutation>, IMutation

public class Mutation
extends java.lang.Object
implements IMutation, java.util.function.Supplier<Mutation>

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	Mutation.MutationSerializer
static class	Mutation.PartitionUpdateCollector	Collects finalized partition updates
static interface	Mutation.SimpleBuilder	Interface for building mutations geared towards human.

Field Summary

Fields

Modifier and Type	Field	Description
static Mutation.MutationSerializer	serializer

Fields inherited from interface org.apache.cassandra.db.IMutation

MAX_MUTATION_SIZE

Constructor Summary

Constructors

Constructor	Description
Mutation(java.lang.String keyspaceName, DecoratedKey key, com.google.common.collect.ImmutableMap<TableId,PartitionUpdate> modifications, long approxCreatedAtNanos)
Mutation(java.lang.String keyspaceName, DecoratedKey key, com.google.common.collect.ImmutableMap<TableId,PartitionUpdate> modifications, long approxCreatedAtNanos, boolean cdcEnabled)
Mutation(PartitionUpdate update)

Method Summary

Modifier and Type	Method	Description
void	apply()
void	apply(boolean durableWrites)
void	apply(boolean durableWrites, boolean isDroppable)
Future<?>	applyFuture()
void	applyUnsafe()
Mutation	get()
long	getApproxCreatedAtNanos()
java.lang.String	getKeyspaceName()
PartitionUpdate	getPartitionUpdate(TableMetadata table)
com.google.common.collect.ImmutableCollection<PartitionUpdate>	getPartitionUpdates()
java.util.Collection<TableId>	getTableIds()
long	getTimeout(java.util.concurrent.TimeUnit unit)
java.util.function.Supplier<Mutation>	hintOnFailure()
boolean	isEmpty()
DecoratedKey	key()
static Mutation	merge(java.util.List<Mutation> mutations)	Creates a new mutation that merges all the provided mutations.
int	serializedSize(int version)
static Mutation.SimpleBuilder	simpleBuilder(java.lang.String keyspaceName, DecoratedKey partitionKey)	Creates a new simple mutuation builder.
int	smallestGCGS()
java.lang.String	toString()
java.lang.String	toString(boolean shallow)
boolean	trackedByCDC()
void	validateSize(int version, int overhead)	Validates size of mutation does not exceed DatabaseDescriptor.getMaxMutationSize().
Mutation	without(java.util.Set<TableId> tableIds)
Mutation	without(TableId tableId)

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.apache.cassandra.db.IMutation

validateIndexedColumns

Field Detail

serializer

public static final Mutation.MutationSerializer serializer

Constructor Detail

Mutation

public Mutation(PartitionUpdate update)

Mutation

public Mutation(java.lang.String keyspaceName,
                DecoratedKey key,
                com.google.common.collect.ImmutableMap<TableId,PartitionUpdate> modifications,
                long approxCreatedAtNanos)

Mutation

public Mutation(java.lang.String keyspaceName,
                DecoratedKey key,
                com.google.common.collect.ImmutableMap<TableId,PartitionUpdate> modifications,
                long approxCreatedAtNanos,
                boolean cdcEnabled)

Method Detail

without

public Mutation without(java.util.Set<TableId> tableIds)

without

public Mutation without(TableId tableId)

getKeyspaceName

public java.lang.String getKeyspaceName()

Specified by:

getKeyspaceName in interface IMutation

getTableIds

public java.util.Collection<TableId> getTableIds()

Specified by:

getTableIds in interface IMutation

key

public DecoratedKey key()

Specified by:

key in interface IMutation

getPartitionUpdates

public com.google.common.collect.ImmutableCollection<PartitionUpdate> getPartitionUpdates()

Specified by:

getPartitionUpdates in interface IMutation

getApproxCreatedAtNanos

public long getApproxCreatedAtNanos()

hintOnFailure

public java.util.function.Supplier<Mutation> hintOnFailure()

Specified by:

hintOnFailure in interface IMutation

get

public Mutation get()

Specified by:

get in interface java.util.function.Supplier<Mutation>

validateSize

public void validateSize(int version,
                         int overhead)

Description copied from interface: IMutation

Validates size of mutation does not exceed DatabaseDescriptor.getMaxMutationSize().

Specified by:

validateSize in interface IMutation

Parameters:

version - the MessagingService version the mutation is being serialized for. see MessagingService.current_version

overhead - overhadd to add for mutation size to validate. Pass zero if not required but not a negative value.

getPartitionUpdate

public PartitionUpdate getPartitionUpdate(TableMetadata table)

isEmpty

public boolean isEmpty()

merge

public static Mutation merge(java.util.List<Mutation> mutations)

Creates a new mutation that merges all the provided mutations.

Parameters:

mutations - the mutations to merge together. All mutation must be on the same keyspace and partition key. There should also be at least one mutation.

Returns:

a mutation that contains all the modifications contained in mutations.

Throws:

java.lang.IllegalArgumentException - if not all the mutations are on the same keyspace and key.

applyFuture

public Future<?> applyFuture()

apply

public void apply(boolean durableWrites,
                  boolean isDroppable)

apply

public void apply(boolean durableWrites)

apply

public void apply()

Specified by:

apply in interface IMutation

applyUnsafe

public void applyUnsafe()

getTimeout

public long getTimeout(java.util.concurrent.TimeUnit unit)

Specified by:

getTimeout in interface IMutation

smallestGCGS

public int smallestGCGS()

trackedByCDC

public boolean trackedByCDC()

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object

toString

public java.lang.String toString(boolean shallow)

Specified by:

toString in interface IMutation

serializedSize

public int serializedSize(int version)

simpleBuilder

public static Mutation.SimpleBuilder simpleBuilder(java.lang.String keyspaceName,
                                                   DecoratedKey partitionKey)

Creates a new simple mutuation builder.

Parameters:

keyspaceName - the name of the keyspace this is a mutation for.

partitionKey - the key of partition this if a mutation for.

Returns:

a newly created builder.