javax.realtime
Class VTMemory

java.lang.Object
  javax.realtime.MemoryArea
      javax.realtime.ScopedMemory
          javax.realtime.VTMemory

public class VTMemory

extends ScopedMemory

A scoped memory area with an allocator that doesn't provide a time complexity guarantee on allocation requests.

Author:

Angelo Corsaro, Morgan Deters

Field Summary

Fields inherited from class javax.realtime.ScopedMemory

joinSynchronizer

Fields inherited from class javax.realtime.MemoryArea

logic, parent, sizeInBytes

Constructor Summary

VTMemory(long size)
Creates an VTMemory of the given size.

VTMemory(long initial, long maximum)
Creates an VTMemory of the given initial and maximal sizes.

VTMemory(long initial, long maximum, Runnable logic)
Creates an VTMemory of the given initial and maximal sizes, associated with the given Runnable.

VTMemory(long size, Runnable logic)
Creates an VTMemory of the given size, associated with the given Runnable.

VTMemory(SizeEstimator size)
Creates an VTMemory of the given size.

VTMemory(SizeEstimator size, Runnable logic)
Creates an VTMemory of the given size, associated with the given Runnable.

VTMemory(SizeEstimator initial, SizeEstimator maximum)
Creates an VTMemory of the given initial and maximal sizes.

VTMemory(SizeEstimator initial, SizeEstimator maximum, Runnable logic)
Creates an VTMemory of the given initial and maximal sizes, associated with the given Runnable.

Method Summary

String

toString() Returns a user-friendly representation of this ScopedMemory.

Methods inherited from class javax.realtime.ScopedMemory

enter, enter, getMaximumSize, getPortal, getReferenceCount, join, join, joinAndEnter, joinAndEnter, joinAndEnter, joinAndEnter, setPortal

Methods inherited from class javax.realtime.MemoryArea

executeInArea, finalize, getMemoryArea, guardedRun, memoryConsumed, memoryRemaining, newArray, newInstance, newInstance, size

Methods inherited from class java.lang.Object

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

Constructor Detail

VTMemory

public VTMemory(long size)

Creates an VTMemory of the given size.

Parameters:

size - the size of the memory area to create

Throws:

IllegalArgumentException - if size is less than zero

OutOfMemoryError - if there isn't enough storage available for the backing memory

VTMemory

public VTMemory(long initial,
                long maximum)

Creates an VTMemory of the given initial and maximal sizes.

Parameters:

initial - the initial size for this memory area

maximum - the maximum size for this memory area

Throws:

IllegalArgumentException - if initial is less than zero or greater than maximum

OutOfMemoryError - if there isn't enough storage available for the backing memory

VTMemory

public VTMemory(long initial,
                long maximum,
                Runnable logic)

Creates an VTMemory of the given initial and maximal sizes, associated with the given Runnable.

Parameters:

initial - the initial size for this memory area

maximum - the maximum size for this memory area

logic - the Runnable to associate

Throws:

IllegalArgumentException - if initial is less than zero or greater than maximum

IllegalAssignmentError - if storing logic in this violates referencing rules

OutOfMemoryError - if there isn't enough storage available for the backing memory

VTMemory

public VTMemory(long size,
                Runnable logic)

Creates an VTMemory of the given size, associated with the given Runnable.

Parameters:

size - the size of the memory area to create

logic - the Runnable to associate

Throws:

IllegalArgumentException - if size is less than zero

IllegalAssignmentError - if storing logic in this violates referencing rules

OutOfMemoryError - if there isn't enough storage available for the backing memory

VTMemory

public VTMemory(SizeEstimator size)

Creates an VTMemory of the given size.

Parameters:

size - the size of the memory area to create

Throws:

IllegalArgumentException - if size is null

OutOfMemoryError - if there isn't enough storage available for the backing memory

VTMemory

public VTMemory(SizeEstimator initial,
                SizeEstimator maximum)

Creates an VTMemory of the given initial and maximal sizes.

Parameters:

initial - the initial size for this memory area

maximum - the maximum size for this memory area

Throws:

IllegalArgumentException - if initial is greater than maximum, or if either is null

OutOfMemoryError - if there isn't enough storage available for the backing memory

VTMemory

public VTMemory(SizeEstimator initial,
                SizeEstimator maximum,
                Runnable logic)

Creates an VTMemory of the given initial and maximal sizes, associated with the given Runnable.

Parameters:

initial - the initial size for this memory area

maximum - the maximum size for this memory area

logic - the Runnable to associate

Throws:

IllegalArgumentException - if initial is greater than maximum, or if either is null

IllegalAssignmentError - if storing logic in this violates referencing rules

OutOfMemoryError - if there isn't enough storage available for the backing memory

VTMemory

public VTMemory(SizeEstimator size,
                Runnable logic)

Creates an VTMemory of the given size, associated with the given Runnable.

Parameters:

size - the size of the memory area to create

logic - the Runnable to associate

Throws:

IllegalArgumentException - if size is null

IllegalAssignmentError - if storing logic in this violates referencing rules

OutOfMemoryError - if there isn't enough storage available for the backing memory

Method Detail

toString

public String toString()

Returns a user-friendly representation of this ScopedMemory. This String is of the form "(VTMemory) Scoped memory # N" where N is a unique ID identifying this scoped memory area.

Please see the implementation note in the superclass.

Overrides:

toString in class ScopedMemory

Returns:

the user-friendly String representation