javax.realtime.memory

Class LTMemory

java.lang.Object

javax.realtime.MemoryArea

javax.realtime.memory.ScopedMemory

javax.realtime.memory.LTMemory

public class LTMemory
extends ScopedMemory

LTMemory represents a memory area guaranteed by the system to have linear time allocation when memory consumption from the memory area is less than the memory area's size.

The memory area described by a LTMemory instance does not exist in the Java heap, and is not subject to garbage collection. Thus, it is safe to use a LTMemory object as the initial memory area for a Schedulable instance which may not use the HeapMemory or to enter the memory area using the ScopedMemory.enter() method within such an instance.

Enough memory must be committed by the completion of the constructor to satisfy the memory requirement given in the constructor. Committed means that this memory must always be available for allocation. The memory allocation must behave, with respect to successful allocation, as if it were contiguous; i.e., a correct implementation must guarantee that any sequence of object allocations that could ever succeed without exceeding a specified initial memory size will always succeed without exceeding that initial memory size and succeed for any instance of LTMemory with that initial memory size.

Creation of an LTMemory shall fail with a StaticOutOfMemoryError when the current Schedulable has been configured with a ScopedMemoryParameters.getMaxGlobalBackingStore() that would be exceeded by said creation.

Methods from LTMemory should be overridden only by methods that use super.

Since:

RTSJ 2.0 moved to this package.

See Also:

MemoryArea, ScopedMemory, Schedulable

Constructor Summary

Constructors

Constructor and Description
LTMemory(long size) Equivalent to LTMemory(long, Runnable) with the argument list ((size, null).
LTMemory(long size, java.lang.Runnable logic) Create a scoped memory of the given size and with the give logic to run upon entry when no other logic is given.
LTMemory(SizeEstimator size) Equivalent to LTMemory(long, Runnable) with argument list (size.getEstimate(), null).
LTMemory(SizeEstimator size, java.lang.Runnable logic) Equivalent to LTMemory(long, Runnable) with argument list (size.getEstimate(), runnable).

Method Summary

Methods inherited from class javax.realtime.memory.ScopedMemory

enter, enter, enter, enter, enter, enter, enter, executeInArea, executeInArea, executeInArea, executeInArea, executeInArea, executeInArea, finalize, getParent, getPortal, getReferenceCount, globalBackingStoreConsumed, globalBackingStoreRemaining, globalBackingStoreSize, join, join, joinAndEnter, joinAndEnter, joinAndEnter, joinAndEnter, joinAndEnter, joinAndEnter, joinAndEnter, joinAndEnter, joinAndEnter, joinAndEnter, joinAndEnter, joinAndEnter, joinAndEnter, joinAndEnter, newArray, newInstance, newInstance, setPortal, toString, visitNestedScopes, visitScopeRoots

Methods inherited from class javax.realtime.MemoryArea

getMemoryArea, mayHoldReferenceTo, mayHoldReferenceTo, memoryConsumed, memoryRemaining, newArrayInArea, size

Methods inherited from class java.lang.Object

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

Constructor Detail

LTMemory

public LTMemory(long size,
                java.lang.Runnable logic)

Create a scoped memory of the given size and with the give logic to run upon entry when no other logic is given.

Parameters:

size - The size in bytes of the memory to allocate for this area. This memory must be committed before the completion of the constructor.

logic - The run() of the given Runnable will be executed using this as its initial memory area. When logic is null, this constructor is equivalent to LTMemory(long).

Throws:

StaticIllegalArgumentException - when size is less than zero.

StaticOutOfMemoryError - when there is insufficient memory for the LTMemory object or for its allocation area in its backing store, or when the current Schedulable would exceed its configured allowance of global backing store.

IllegalAssignmentError - when storing logic in this would violate the assignment rules.

Since:

RTSJ 1.0.1

LTMemory

public LTMemory(SizeEstimator size,
                java.lang.Runnable logic)

Equivalent to LTMemory(long, Runnable) with argument list (size.getEstimate(), runnable).

Parameters:

size - An instance of SizeEstimator used to give an estimate of the initial size. This memory must be committed before the completion of the constructor.

logic - The run() of the given Runnable will be executed using this as its initial memory area. When logic is null, this constructor is equivalent to LTMemory(SizeEstimator).

Throws:

StaticIllegalArgumentException - when size is null.

StaticOutOfMemoryError - when there is insufficient memory for the LTMemory object or for its allocation area in its backing store, or when the current Schedulable would exceed its configured allowance of global backing store.

IllegalAssignmentError - when storing logic in this would violate the assignment rules.

Since:

RTSJ 1.0.1

LTMemory

public LTMemory(long size)

Equivalent to LTMemory(long, Runnable) with the argument list ((size, null).

Parameters:

size - The size in bytes of the memory to allocate for this area. This memory must be committed before the completion of the constructor.

Throws:

StaticIllegalArgumentException - when size is less than zero.

StaticOutOfMemoryError - when there is insufficient memory for the LTMemory object or for its allocation area in its backing store, or when the current Schedulable would exceed its configured allowance of global backing store.

Since:

RTSJ 1.0.1

LTMemory

public LTMemory(SizeEstimator size)

Equivalent to LTMemory(long, Runnable) with argument list (size.getEstimate(), null).

Parameters:

size - An instance of SizeEstimator used to give an estimate of the initial size. This memory must be committed before the completion of the constructor.

Throws:

StaticIllegalArgumentException - when size is null.

StaticOutOfMemoryError - when there is insufficient memory for the LTMemory object, or when the current Schedulable would exceed its configured allowance of global backing store.

Since:

RTSJ 1.0.1