Package com.offbynull.coroutines.user

Class CoroutineReader

java.lang.Object

com.offbynull.coroutines.user.CoroutineReader

public final class CoroutineReader
extends Object

Reads in (deserializes) the state of a CoroutineRunner object.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static interface	CoroutineReader.CoroutineDeserializer	Coroutine deserializer.
static final class	CoroutineReader.DefaultCoroutineDeserializer	Default implementation of CoroutineReader.CoroutineDeserializer (uses Java's built-in serialization mechanism).

Field Summary

Fields

Modifier and Type	Field	Description
private final CoroutineReader.CoroutineDeserializer	deserializer
private final Map	interceptersMap
private final Map	updatersMap

Constructor Summary

Constructors

Constructor	Description
CoroutineReader()	Construct a CoroutineReader object.
CoroutineReader(CoroutineReader.CoroutineDeserializer deserializer, SerializedState.FrameUpdatePoint[] frameUpdatePoints, SerializedState.FrameInterceptPoint[] frameInterceptPoints)	Constructs a CoroutineReader object.
CoroutineReader(SerializedState.FrameInterceptPoint[] frameInterceptPoints)	Constructs a CoroutineReader.
CoroutineReader(SerializedState.FrameUpdatePoint[] frameUpdatePoints)	Constructs a CoroutineReader.
CoroutineReader(SerializedState.FrameUpdatePoint[] frameUpdatePoints, SerializedState.FrameInterceptPoint[] frameInterceptPoints)	Constructs a CoroutineReader.

Method Summary

Modifier and Type	Method	Description
private void	placeContinuationReferences(int[] continuationIndexes, Object[] objects, Continuation cn)
CoroutineRunner	read(byte[] data)	Deserializes a CoroutineRunner object from a byte array.
CoroutineRunner	reconstruct(SerializedState state)	Reconstructs a CoroutineRunner object from a serializable state.

Methods inherited from class java.lang.Object

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

Field Details

deserializer

private final CoroutineReader.CoroutineDeserializer deserializer

updatersMap

private final Map updatersMap

interceptersMap

private final Map interceptersMap

Constructor Details

CoroutineReader

public CoroutineReader()

Construct a CoroutineReader object. Equivalent to calling new CoroutineReader(new DefaultCoroutineDeserializer(), new FrameUpdatePoint[0], new FrameInterceptPoint[0]).

CoroutineReader

public CoroutineReader(SerializedState.FrameUpdatePoint[] frameUpdatePoints)

Constructs a CoroutineReader. Equivalent to calling new CoroutineReader(new DefaultCoroutineDeserializer(), frameUpdatePoints, new FrameInterceptPoint[0]).

Parameters:

frameUpdatePoints - frame update points

Throws:

IllegalArgumentException - if frameUpdatePoints contains more than one entry for the same identifier (className/oldMethodId/newMethodId/continuationPoint)

NullPointerException - if any argument is null

CoroutineReader

public CoroutineReader(SerializedState.FrameInterceptPoint[] frameInterceptPoints)

Constructs a CoroutineReader. Equivalent to calling new CoroutineReader(new DefaultCoroutineDeserializer(), new FrameUpdatePoint[0], frameInterceptPoints).

Parameters:

frameInterceptPoints - frame intercept points

Throws:

IllegalArgumentException - if frameInterceptPoints contains more than one entry for the same identifier (className/methodId/continuationPoint)

NullPointerException - if any argument is null

CoroutineReader

public CoroutineReader(SerializedState.FrameUpdatePoint[] frameUpdatePoints,
 SerializedState.FrameInterceptPoint[] frameInterceptPoints)

Constructs a CoroutineReader. Equivalent to calling new CoroutineReader(new DefaultCoroutineDeserializer(), frameUpdatePoints, frameInterceptPoints).

Parameters:

frameUpdatePoints - frame update points

frameInterceptPoints - frame intercept points

Throws:

IllegalArgumentException - if frameUpdatePoints contains more than one entry for the same identifier (className/oldMethodId/newMethodId/continuationPoint), or if frameInterceptPoints contains more than one entry for the same identifier (className/methodId/continuationPoint)

NullPointerException - if any argument is null

CoroutineReader

public CoroutineReader(CoroutineReader.CoroutineDeserializer deserializer,
 SerializedState.FrameUpdatePoint[] frameUpdatePoints,
 SerializedState.FrameInterceptPoint[] frameInterceptPoints)

Constructs a CoroutineReader object.

Parameters:

deserializer - deserializer to write out the coroutine state

frameUpdatePoints - frame update points

frameInterceptPoints - frame intercept points

Throws:

NullPointerException - if any argument is null or contains null

IllegalArgumentException - if frameUpdatePoints contains more than one entry for the same identifier (className/oldMethodId/newMethodId/continuationPoint), or if frameInterceptPoints contains more than one entry for the same identifier (className/methodId/continuationPoint)

Method Details

read

public CoroutineRunner read(byte[] data)

Deserializes a CoroutineRunner object from a byte array.

If you're handling your own deserialization and you simply want to reconstruct the deserialized object to the CoroutineRunner, use reconstruct(com.offbynull.coroutines.user.SerializedState).

Parameters:

data - byte array to deserialize

Returns:

data deserialized to a CoroutineRunner object

Throws:

NullPointerException - if any argument is null

IllegalArgumentException - if failed to deserialize or deserialized to a state for an unrecognized method (e.g. a method that's state is being deserialized for was changed but no SerializedState.FrameUpdatePoint was provided to this class's constructor to handle the changes)

reconstruct

public CoroutineRunner reconstruct(SerializedState state)

Reconstructs a CoroutineRunner object from a serializable state.

Parameters:

state - serialized state to reconstruct

Returns:

reconstructed CoroutineRunner

Throws:

NullPointerException - if any argument is null

IllegalArgumentException - if state contains a reference / was updated to contain a reference to an unrecognized method (e.g. a method that's state is being reconstructed for was changed but no SerializedState.FrameUpdatePoint was provided to this class's constructor to handle the changes)

placeContinuationReferences

private void placeContinuationReferences(int[] continuationIndexes,
 Object[] objects,
 Continuation cn)