javax.realtime

Class LTMemory

java.lang.Object

javax.realtime.MemoryArea

javax.realtime.ScopedMemory

javax.realtime.LTMemory

Deprecated.

since RTSJ 2.0; moved to package javax.realtime.memory.

@Deprecated
public class LTMemory
extends ScopedMemory

Equivalent to and superseded by LTMemory.

Constructor Summary

Constructors

Constructor and Description
LTMemory(long size) Deprecated. Equivalent to LTMemory(long, long, Runnable) with the argument list (size, size, null).
LTMemory(long initial, long maximum) Deprecated. Equivalent to LTMemory(long, long, Runnable) with the argument list (initial, maximum, null).
LTMemory(long initial, long maximum, java.lang.Runnable logic) Deprecated. Creates an LTMemory of the given size.
LTMemory(long size, java.lang.Runnable logic) Deprecated. Equivalent to LTMemory(long, long, Runnable) with the argument list (size, size, logic).
LTMemory(SizeEstimator size) Deprecated. Equivalent to LTMemory(long, long, Runnable) with the argument list (size.getEstimate(), size.getEstimate(), null).
LTMemory(SizeEstimator size, java.lang.Runnable logic) Deprecated. Equivalent to LTMemory(long, long, Runnable) with the argument list (size.getEstimate(), size.getEstimate(), logic).
LTMemory(SizeEstimator initial, SizeEstimator maximum) Deprecated. Equivalent to LTMemory(long, long, Runnable) with the argument list (initial.getEstimate(), maximum.getEstimate(), null).
LTMemory(SizeEstimator initial, SizeEstimator maximum, java.lang.Runnable logic) Deprecated. Equivalent to LTMemory(long, long, Runnable) with the argument list (initial.getEstimate(), maximum.getEstimate(), logic).

Method Summary

Modifier and Type	Method and Description
java.lang.String	toString() Deprecated. Creates a string representation of this object.

Methods inherited from class javax.realtime.ScopedMemory

enter, enter, executeInArea, getMaximumSize, getPortal, getReferenceCount, join, join, joinAndEnter, joinAndEnter, joinAndEnter, joinAndEnter, newArray, newInstance, newInstance, setPortal

Methods inherited from class javax.realtime.MemoryArea

enter, enter, enter, enter, enter, executeInArea, executeInArea, executeInArea, executeInArea, executeInArea, getMemoryArea, mayHoldReferenceTo, mayHoldReferenceTo, memoryConsumed, memoryRemaining, newArrayInArea, size

Methods inherited from class java.lang.Object

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

Constructor Detail

LTMemory

public LTMemory(long initial,
                long maximum,
                java.lang.Runnable logic)

Deprecated.

Creates an LTMemory of the given size.

Parameters:

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

maximum - The size in bytes of the memory to allocate for this area.

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 initial, long maximum).

Throws:

java.lang.IllegalArgumentException - when initial is greater than maximum, or when initial or maximum is less than zero.

StaticOutOfMemoryError - when there is insufficient memory for the LTMemory object or for its allocation area in its backing store.

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

LTMemory

public LTMemory(SizeEstimator initial,
                SizeEstimator maximum,
                java.lang.Runnable logic)

Deprecated.

Equivalent to LTMemory(long, long, Runnable) with the argument list (initial.getEstimate(), maximum.getEstimate(), logic).

Parameters:

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

maximum - An instance of SizeEstimator used to give an estimate for the maximum bytes to allocate for this area.

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 initial, SizeEstimator maximum).

Throws:

java.lang.IllegalArgumentException - when initial is null, maximum is null, initial.getEstimate() is greater than maximum.getEstimate(), or when initial.getEstimate() is less than zero.

StaticOutOfMemoryError - when there is insufficient memory for the LTMemory object or for its allocation area in its backing store.

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

LTMemory

public LTMemory(long initial,
                long maximum)

Deprecated.

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

Parameters:

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

maximum - The size in bytes of the memory to allocate for this area.

Throws:

java.lang.IllegalArgumentException - when initial is greater than maximum, or when initial or maximum is less than zero.

StaticOutOfMemoryError - when there is insufficient memory for the LTMemory object or for its allocation area in its backing store.

LTMemory

public LTMemory(SizeEstimator initial,
                SizeEstimator maximum)

Deprecated.

Equivalent to LTMemory(long, long, Runnable) with the argument list (initial.getEstimate(), maximum.getEstimate(), null).

Parameters:

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

maximum - An instance of SizeEstimator used to give an estimate for the maximum bytes to allocate for this area.

Throws:

java.lang.IllegalArgumentException - when initial is null, maximum is null, initial.getEstimate() is greater than maximum.getEstimate(), or when initial.getEstimate() is less than zero.

StaticOutOfMemoryError - when there is insufficient memory for the LTMemory object or for its allocation area in its backing store.

LTMemory

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

Deprecated.

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

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 size).

Throws:

java.lang.IllegalArgumentException - 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.

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)

Deprecated.

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

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 size).

Throws:

java.lang.IllegalArgumentException - when size is null, or size.getEstimate() is less than zero.

StaticOutOfMemoryError - when there is insufficient memory for the LTMemory object or for its allocation area in its backing store.

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

Since:

RTSJ 1.0.1

LTMemory

public LTMemory(long size)

Deprecated.

Equivalent to LTMemory(long, long, Runnable) with the argument list (size, 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:

java.lang.IllegalArgumentException - 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.

Since:

RTSJ 1.0.1

LTMemory

public LTMemory(SizeEstimator size)

Deprecated.

Equivalent to LTMemory(long, long, Runnable) with the argument list (size.getEstimate(), 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:

java.lang.IllegalArgumentException - when size is null, or size.getEstimate() is less than zero.

StaticOutOfMemoryError - when there is insufficient memory for the LTMemory object or for its allocation area in its backing store.

Since:

RTSJ 1.0.1

Method Detail

toString

public java.lang.String toString()

Deprecated.

Creates a string representation of this object. The string is of the form

  (LTMemory) ScopedMemory#<num>
 

where <num> uniquely identifies the LTMemory area.

Overrides:

toString in class ScopedMemory

Returns:

a string representing the value of this.