Package com.tameif.tame.lang

Interface ReferenceSaveable

All Known Implementing Classes:

Value, ValueSet

public interface ReferenceSaveable

Describes an object that can be saved/loaded but preserves value references.

Author:

Matthew Tropiano

Method Summary

Modifier and Type	Method and Description
default void	fromReferentialBytes(java.util.Map<java.lang.Long,Value> referenceMap, byte[] data) Reads this object's representation from a byte array, looking up value references in a map.
void	readReferentialBytes(java.util.Map<java.lang.Long,Value> referenceMap, java.io.InputStream in) Imports this object from bytes, looking up value references in a map.
default byte[]	toReferentialBytes(java.util.concurrent.atomic.AtomicLong referenceCounter, java.util.Map<java.lang.Object,java.lang.Long> referenceSet) Gets this object's representation as bytes, preserving up value references from a map.
void	writeReferentialBytes(java.util.concurrent.atomic.AtomicLong referenceCounter, java.util.Map<java.lang.Object,java.lang.Long> referenceSet, java.io.OutputStream out) Exports this object to bytes, preserving up value references from a map.

Method Detail

writeReferentialBytes

void writeReferentialBytes(java.util.concurrent.atomic.AtomicLong referenceCounter,
                           java.util.Map<java.lang.Object,java.lang.Long> referenceSet,
                           java.io.OutputStream out)
                    throws java.io.IOException

Exports this object to bytes, preserving up value references from a map.

Parameters:

referenceCounter - the reference counter to use for when unique values are seen.

referenceSet - the reference set to use for "seen" value references - maps object reference to counter value.

out - the output stream to write to.

Throws:

java.io.IOException - if a write problem occurs.

readReferentialBytes

void readReferentialBytes(java.util.Map<java.lang.Long,Value> referenceMap,
                          java.io.InputStream in)
                   throws java.io.IOException

Imports this object from bytes, looking up value references in a map.

Parameters:

referenceMap - the reference map to use for "seen" value references.

in - the input stream to read from.

Throws:

java.io.IOException - if a read problem occurs.

toReferentialBytes

default byte[] toReferentialBytes(java.util.concurrent.atomic.AtomicLong referenceCounter,
                                  java.util.Map<java.lang.Object,java.lang.Long> referenceSet)
                           throws java.io.IOException

Gets this object's representation as bytes, preserving up value references from a map.

Parameters:

referenceCounter - the reference counter to use for when unique values are seen.

referenceSet - the reference set to use for "seen" value references - maps object reference to counter value.

Returns:

the byte array of state bytes.

Throws:

java.io.IOException - if a write problem occurs.

fromReferentialBytes

default void fromReferentialBytes(java.util.Map<java.lang.Long,Value> referenceMap,
                                  byte[] data)
                           throws java.io.IOException

Reads this object's representation from a byte array, looking up value references in a map.

Parameters:

referenceMap - the reference map to use for "seen" value references.

data - the data to read.

Throws:

java.io.IOException - if a read problem occurs.