com.tangosol.io

Interface ExternalizableLite

All Superinterfaces:

Serializable

All Known Implementing Classes:

AbstractAggregator, AbstractBigDecimalAggregator, AbstractCoherenceBasedCompleteConfiguration, AbstractComparableAggregator, AbstractCompositeExtractor, AbstractDoubleAggregator, AbstractHttpSessionModel, AbstractLongAggregator, AbstractPriorityTask, AllFilter, AlwaysFilter, AndFilter, AnyFilter, ArrayFilter, BetweenFilter, BigDecimalAverage, BigDecimalMax, BigDecimalMin, BigDecimalSum, Binary, CacheEventFilter, ChainedComparator, ChainedExtractor, CoherenceEntryProcessorResult, ComparableMax, ComparableMin, ComparisonFilter, ComparisonValueExtractor, CompositeAggregator, CompositeAggregator.Parallel, CompositeKey, CompositeProcessor, CompositeUpdater, ConditionalExtractor, ConditionalProcessor, ConditionalPut, ConditionalPutAll, ConditionalRemove, ContainsAllFilter, ContainsAnyFilter, ContainsFilter, ContextJCacheStatistics, Count, DeserializationAccelerator, DistinctValues, DoubleAverage, DoubleMax, DoubleMin, DoubleSum, EntryComparator, EntryExtractor, EqualsFilter, ExitAgent, ExtractorComparator, ExtractorEventTransformer, ExtractorFilter, ExtractorProcessor, FilterTrigger, GetElasticMaxValueSizeProcessor, GreaterEqualsFilter, GreaterFilter, GroupAggregator, GroupAggregator.Parallel, IdentityExtractor, ImmutableArrayList, InFilter, InKeySetFilter, InstanceBuilder, InverseComparator, IsNotNullFilter, IsNullFilter, JCacheEntryMetaInf, JCacheIdentifier, JsonMap, KeyAssociatedFilter, KeyExtractor, LessEqualsFilter, LessFilter, LikeFilter, LimitFilter, LiteMap, LiteSet, LocalCacheAsynchronousMapListener.NonSyntheticEntryFilter, LocalCacheConfiguration, LogThreadsHoldingLockAgent, LongMax, LongMin, LongSum, MapEventFilter, MapEventTransformerFilter, MapSet, MethodInvocationProcessor, MonolithicHttpSessionModel, MultiExtractor, MvelExtractor, MvelManipulator, MvelUpdater, NeverFilter, NonSyntheticEntryFilter, NotEqualsFilter, NotFilter, NullFilter, NullImplementation.NullEntryProcessor, NullImplementation.NullMap, NullImplementation.NullObservableMap, NullImplementation.NullSet, NullImplementation.NullValueExtractor, NumberIncrementor, NumberMultiplier, OptimizedHolder, OrFilter, Ownership, ParameterMacroExpression, PartitionedCacheAsynchronousMapListener.NonSyntheticEntryFilter, PartitionedCacheConfiguration, PartitionedFilter, PartitionedJCacheStatistics.CacheStatisticsExtractor, PartitionedJCacheStatistics.PartitionedCacheStatisticsAggregator, PartitionedJCacheStatistics.PartitionedCacheStatisticsClear, PartitionSet, PartitionStatistics, PassThroughFilterAdapter, PredicateFilter, PreloadRequest, PresentFilter, PriorityAggregator, PriorityFilter, PriorityProcessor, PropertyManipulator, PropertyProcessor, PropertySet, QueryRecorder, ReducerAggregator, ReflectionExtractor, ReflectionUpdater, RegexFilter, RemoteCacheConfiguration, ResolvableParameterList, SafeComparator, SafeHashSet, SamplingEventTransformer, SegmentedHashSet, SemiLiteEventTransformer, SimpleDocument, SimpleElement, SimpleElement.AttributeMap, SimpleElement.ElementList, SimpleHolder, SimpleParameterList, SimplePartitionKey, SimpleQueryRecord, SimpleQueryRecord.PartialResult, SimpleQueryRecord.PartialResult.AbstractRecordableStep, SimpleQueryRecord.PartialResult.ExplainStep, SimpleQueryRecord.PartialResult.IndexLookupRecord, SimpleQueryRecord.PartialResult.Step, SimpleQueryRecord.PartialResult.TraceStep, SimpleValue, SplitHttpSessionModel, SplitHttpSessionModel.ElasticKey, SplittableHolder, StaticContent, StaticFactoryInstanceBuilder, TopNAggregator, TopNAggregator.PartialResult, TouchProcessor, TraditionalHttpSessionModel, UID, UniversalExtractor, UniversalUpdater, UpdaterProcessor, UUID, ValueChangeEventFilter, VersionedOwnership, VersionedPut, VersionedPutAll, WorkManager.AbstractWork, WorkManager.CollectMembershipInfo, WorkManager.ReleaseWork, WorkManager.RequestStatus, WorkManager.ScheduleWork, WorkManager.SendFeedback, WorkManager.WorkStatus, XmlBean, XorFilter

public interface ExternalizableLite
extends Serializable

Optimized serialization.

The readExternal and writeExternal methods of the ExternalizableLite interface are implemented by a class to give the class complete control over the format and contents of the stream for an object. Unlike the Externalizable interface, these methods operate on more primitive DataInput and DataOutput streams, allowing for significantly better performance, but often requiring more effort to implement.

These methods must explicitly coordinate with the supertype to save its state. When an ExternalizableLite object is reconstructed, an instance is created using the public no-arg constructor, then the readExternal method called. Therefore, in addition to the methods listed below, a public default constructor is required.

Since a graph traversal is not managed by the stream, only uni-directional object graphs (e.g. object trees) can be serialized using this approach.

Note: it is extremely important that objects that are equivalent according to their "equals()" implementation produce equivalent serialized streams. Violating this relationship will result in non-deterministic behavior for many Coherence services.

Since:

Coherence 2.1

Author:

gg 2003.02.08

Method Summary

Modifier and Type	Method and Description
void	readExternal(DataInput in) Restore the contents of this object by loading the object's state from the passed DataInput object.
void	writeExternal(DataOutput out) Save the contents of this object by storing the object's state into the passed DataOutput object.

Method Detail

readExternal

void readExternal(DataInput in)
           throws IOException

Restore the contents of this object by loading the object's state from the passed DataInput object.

Parameters:

in - the DataInput stream to read data from in order to restore the state of this object

Throws:

IOException - if an I/O exception occurs

NotActiveException - if the object is not in its initial state, and therefore cannot be deserialized into

writeExternal

void writeExternal(DataOutput out)
            throws IOException

Save the contents of this object by storing the object's state into the passed DataOutput object.

Parameters:

out - the DataOutput stream to write the state of this object to

Throws:

IOException - if an I/O exception occurs