org.infinispan.atomic

Interface DeltaAware

All Known Subinterfaces:

CopyableDeltaAware

public interface DeltaAware

This interface allows the extraction of Deltas.
Implementations would be closely coupled to a corresponding Delta implementation, since Delta.merge(DeltaAware) would need to know how to recreate this instance of DeltaAware if needed.
Implementations of DeltaAware automatically gain the ability to perform fine-grained replication in Infinispan, since Infinispan's data container is able to detect these types and only serialize and transport Deltas around the network rather than the entire, serialized object.
Using DeltaAware makes sense if your custom object is large in size and often only sees small portions of the object being updated in a transaction. Implementations would need to be able to track these changes during the course of a transaction though, to be able to produce a Delta instance, so this too is a consideration for implementations.

Since:

4.0

Author:

Manik Surtani

See Also:

Delta

Method Summary

Modifier and Type	Method and Description
void	commit() Indicate that all deltas collected to date has been extracted (via a call to delta()) and can be discarded.
Delta	delta() Extracts changes made to implementations, in an efficient format that can easily and cheaply be serialized and deserialized.

Method Detail

delta

Delta delta()

Extracts changes made to implementations, in an efficient format that can easily and cheaply be serialized and deserialized. This method will only be called once for each changeset as it is assumed that any implementation's internal changelog is wiped and reset after generating and submitting the delta to the caller.

Returns:

an instance of Delta

commit

void commit()

Indicate that all deltas collected to date has been extracted (via a call to delta()) and can be discarded. Often used as an optimization if the delta isn't really needed, but the cleaning and resetting of internal state is desirable.