Package io.aether.utils.streams

Class ValueProxy<T>

java.lang.Object

io.aether.utils.streams.ValueProxy<T>

All Implemented Interfaces:

Value<T>, io.aether.utils.ToString

Direct Known Subclasses:

ValueAddRequest, ValueExclusiveOnReject, ValueNotClose, ValueOnDrop, ValueOnEnter, ValueOnReject, ValueProxyTimeout, ValueWithClose, ValueWithForce

public class ValueProxy<T>
extends java.lang.Object
implements Value<T>

Field Summary

Fields

Modifier and Type	Field	Description
protected Value<T>	self

Fields inherited from interface io.aether.utils.streams.Value

BLOCK_COUNTER, CLOSE_INSTANCE, FORCE_INSTANCE, TIMEOUT

Constructor Summary

Constructors

Constructor	Description
ValueProxy(Value<T> self)

Method Summary

Modifier and Type	Method	Description
T	data()	Retrieves the data payload contained in this value.
void	enter(java.lang.Object owner)	Marks the beginning of value processing by a handler.
long	getRequestDataId()
boolean	isClose()	Checks if this value signals stream/processing closure.
boolean	isData()	Checks if this value contains processable data.
boolean	isForce()	Checks if this value is marked as "force".
boolean	isRequestData()	Determines if this value represents a data request.
int	priority()	Returns the processing priority of this value.
void	reject(java.lang.Object owner, long blockId)	Rejects the value sending process due to a stream being blocked.
void	success(java.lang.Object owner)	Releases resources associated with this value when it's no longer needed.
java.lang.String	toString()
void	toString(io.aether.utils.AString sb)

Methods inherited from class java.lang.Object

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

Methods inherited from interface io.aether.utils.ToString

toString2

Methods inherited from interface io.aether.utils.streams.Value

addRequest, isOnlyRequestData, linkFuture, linkOnRejectExclusive, map, map2, notClose, onEnter, onReject, onSuccess, reject, timeout, timeout, withClose, withForce

Field Detail

self

protected final Value<T> self

Constructor Detail

ValueProxy

public ValueProxy(Value<T> self)

Method Detail

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object

toString

public void toString(io.aether.utils.AString sb)

Specified by:

toString in interface io.aether.utils.ToString

data

public T data()

Description copied from interface: Value

Retrieves the data payload contained in this value. The actual data type is determined by the generic parameter T.

Specified by:

data in interface Value<T>

Returns:

The contained data object, which may be null for special values

success

public void success(java.lang.Object owner)

Description copied from interface: Value

Releases resources associated with this value when it's no longer needed. This is the normal end-of-life operation for a value.

Specified by:

success in interface Value<T>

Parameters:

owner - The object initiating the success operation (for tracking/logging)

enter

public void enter(java.lang.Object owner)

Description copied from interface: Value

Marks the beginning of value processing by a handler. Called when a processor starts working with this value.

Specified by:

enter in interface Value<T>

Parameters:

owner - The object that begins processing this value

isForce

public boolean isForce()

Description copied from interface: Value

Checks if this value is marked as "force". Force values typically bypass normal processing constraints and must be handled immediately regardless of system state.

Specified by:

isForce in interface Value<T>

Returns:

true if this is a force value, false otherwise

priority

public int priority()

Description copied from interface: Value

Returns the processing priority of this value. Higher priority values should be processed before lower priority ones. Default implementation returns 0 (normal priority).

Specified by:

priority in interface Value<T>

Returns:

Priority level as an integer (higher = more important)

isRequestData

public boolean isRequestData()

Description copied from interface: Value

Determines if this value represents a data request. Request values typically ask for data to be generated/sent rather than containing data themselves.

Specified by:

isRequestData in interface Value<T>

Returns:

true if this is a request value, false otherwise

getRequestDataId

public long getRequestDataId()

Specified by:

getRequestDataId in interface Value<T>

isClose

public boolean isClose()

Description copied from interface: Value

Checks if this value signals stream/processing closure. Close values typically indicate the end of a data stream or processing sequence.

Specified by:

isClose in interface Value<T>

Returns:

true if this is a close signal, false otherwise

reject

public void reject(java.lang.Object owner,
                   long blockId)

Description copied from interface: Value

Rejects the value sending process due to a stream being blocked.

Specified by:

reject in interface Value<T>

Parameters:

owner - An object that provides information about the current state of the block.

When the creator of the Value object receives an reject call, it understands that the stream is currently blocked and data cannot be sent at this moment.

If, at the same time, a Value object with the isRequestData flag arrives from the stream, a race condition can occur. To resolve this issue, the checkWritable method should be called to determine the actual state of the remote node.

isData

public boolean isData()

Description copied from interface: Value

Checks if this value contains processable data. Returns false for control values (force, request, close).

Specified by:

isData in interface Value<T>

Returns:

true if this value contains data, false otherwise