com.oracle.truffle.object

Class DynamicObjectImpl

java.lang.Object

com.oracle.truffle.api.object.DynamicObject

com.oracle.truffle.object.DynamicObjectImpl

All Implemented Interfaces:

TruffleObject, Cloneable

public abstract class DynamicObjectImpl
extends DynamicObject
implements Cloneable

Since:

0.17 or earlier

Field Summary

Fields

Modifier and Type	Field and Description
static DebugCounter	reshapeCount

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	DynamicObjectImpl(Shape shape)

Method Summary

Modifier and Type	Method and Description
boolean	changeFlags(Object key, int newFlags)
protected abstract boolean	checkExtensionArrayInvariants(Shape newShape) Check whether the extension arrays are in accordance with the description in the shape.
protected DynamicObject	clone()
protected abstract DynamicObject	cloneWithShape(Shape currentShape)
DynamicObject	copy(Shape currentShape) Create a shallow copy of this object.
void	copyProperties(DynamicObject fromObject, Shape ancestor)
String	debugDump(int level)
String	debugDump(int level, int levelStop)
void	define(Object key, Object value, int flags) Define new property or redefine existing property.
void	define(Object key, Object value, int flags, LocationFactory locationFactory) Define new property with a static location or change existing property.
boolean	delete(Object key) Delete property.
boolean	equals(Object obj)
Object	get(Object key, Object defaultValue) Get property value.
ForeignAccess	getForeignAccess() Provides the ForeignAccessFactory instance for this TruffleObject instance.
ShapeImpl	getShape() Get the object's current shape.
Object	getTypeIdentifier()
protected abstract void	growObjectStore(Shape oldShape, Shape newShape)
protected abstract void	growPrimitiveStore(Shape oldShape, Shape newShape)
int	hashCode()
protected abstract void	initialize(Shape initialShape)
boolean	isEmpty() Returns true if this object contains no properties.
protected abstract void	reshape(ShapeImpl newShape)
protected abstract void	resizeObjectStore(Shape oldShape, Shape newShape)
protected abstract void	resizePrimitiveStore(Shape oldShape, Shape newShape)
boolean	set(Object key, Object value) Set value of existing property.
protected void	setShape(Shape shape)
void	setShapeAndGrow(Shape oldShape, Shape newShape) Set shape to an immediate child of the current shape, optionally growing the extension array.
void	setShapeAndResize(Shape newShape)
void	setShapeAndResize(Shape oldShape, Shape newShape) Set object shape and resize storage if necessary.
int	size() Returns the number of properties in this object.
String	toString()
boolean	updateShape() Ensure object shape is up-to-date.

Methods inherited from class com.oracle.truffle.api.object.DynamicObject

containsKey, define, get

Methods inherited from class java.lang.Object

finalize, getClass, notify, notifyAll, wait, wait, wait

Field Detail

reshapeCount

public static final DebugCounter reshapeCount

Since:

0.17 or earlier

Constructor Detail

DynamicObjectImpl

protected DynamicObjectImpl(Shape shape)

Since:

0.17 or earlier

Method Detail

getTypeIdentifier

public Object getTypeIdentifier()

Since:

0.17 or earlier

getShape

public ShapeImpl getShape()

Description copied from class: DynamicObject

Get the object's current shape.

Specified by:

getShape in class DynamicObject

Since:

0.17 or earlier

setShape

protected void setShape(Shape shape)

Since:

0.17 or earlier

initialize

protected abstract void initialize(Shape initialShape)

Since:

0.17 or earlier

setShapeAndResize

public final void setShapeAndResize(Shape newShape)

Since:

0.17 or earlier

setShapeAndResize

public final void setShapeAndResize(Shape oldShape,
                                    Shape newShape)

Description copied from class: DynamicObject

Set object shape and resize storage if necessary.

Specified by:

setShapeAndResize in class DynamicObject

Parameters:

oldShape - the object's current shape (must equal DynamicObject.getShape())

newShape - the new shape to be set

Since:

0.17 or earlier

setShapeAndGrow

public final void setShapeAndGrow(Shape oldShape,
                                  Shape newShape)

Set shape to an immediate child of the current shape, optionally growing the extension array. Typically this would add a single property. Cannot shrink or grow more than one property at a time.

Specified by:

setShapeAndGrow in class DynamicObject

Parameters:

oldShape - the object's current shape (must equal DynamicObject.getShape())

newShape - the new shape to be set

Since:

0.17 or earlier

See Also:

DynamicObjectImpl.setShapeAndResize(Shape, Shape)

growObjectStore

protected abstract void growObjectStore(Shape oldShape,
                                        Shape newShape)

Since:

0.17 or earlier

growPrimitiveStore

protected abstract void growPrimitiveStore(Shape oldShape,
                                           Shape newShape)

Since:

0.17 or earlier

resizePrimitiveStore

protected abstract void resizePrimitiveStore(Shape oldShape,
                                             Shape newShape)

Since:

0.17 or earlier

resizeObjectStore

protected abstract void resizeObjectStore(Shape oldShape,
                                          Shape newShape)

Since:

0.17 or earlier

checkExtensionArrayInvariants

protected abstract boolean checkExtensionArrayInvariants(Shape newShape)

Check whether the extension arrays are in accordance with the description in the shape.

Since:

0.17 or earlier

clone

protected final DynamicObject clone()

Overrides:

clone in class Object

Since:

0.17 or earlier

cloneWithShape

protected abstract DynamicObject cloneWithShape(Shape currentShape)

Since:

0.17 or earlier

reshape

protected abstract void reshape(ShapeImpl newShape)

Since:

0.17 or earlier

copyProperties

public final void copyProperties(DynamicObject fromObject,
                                 Shape ancestor)

Since:

0.17 or earlier

changeFlags

public boolean changeFlags(Object key,
                           int newFlags)

Since:

0.17 or earlier

debugDump

public String debugDump(int level)

Since:

0.17 or earlier

debugDump

public String debugDump(int level,
                        int levelStop)

Since:

0.17 or earlier

toString

public String toString()

Overrides:

toString in class Object

Since:

0.17 or earlier

equals

public boolean equals(Object obj)

Overrides:

equals in class Object

Since:

0.17 or earlier

hashCode

public int hashCode()

Overrides:

hashCode in class Object

Since:

0.17 or earlier

get

public Object get(Object key,
                  Object defaultValue)

Description copied from class: DynamicObject

Get property value.

Specified by:

get in class DynamicObject

Parameters:

key - property identifier

defaultValue - return value if property is not found

Returns:

property value or defaultValue if object has no such property

Since:

0.17 or earlier

set

public boolean set(Object key,
                   Object value)

Description copied from class: DynamicObject

Set value of existing property.

Specified by:

set in class DynamicObject

Parameters:

key - property identifier

value - value to be set

Returns:

true if successful or false if property not found

Since:

0.17 or earlier

define

public void define(Object key,
                   Object value,
                   int flags)

Description copied from class: DynamicObject

Define new property or redefine existing property.

Specified by:

define in class DynamicObject

Parameters:

key - property identifier

value - value to be set

flags - flags to be set

Since:

0.17 or earlier

define

public void define(Object key,
                   Object value,
                   int flags,
                   LocationFactory locationFactory)

Description copied from class: DynamicObject

Define new property with a static location or change existing property.

Specified by:

define in class DynamicObject

Parameters:

key - property identifier

value - value to be set

flags - flags to be set

locationFactory - factory function that creates a location for a given shape and value

Since:

0.17 or earlier

delete

public boolean delete(Object key)

Description copied from class: DynamicObject

Delete property.

Specified by:

delete in class DynamicObject

Parameters:

key - property identifier

Returns:

true if successful or false if property not found

Since:

0.17 or earlier

size

public int size()

Description copied from class: DynamicObject

Returns the number of properties in this object.

Specified by:

size in class DynamicObject

Since:

0.17 or earlier

isEmpty

public boolean isEmpty()

Description copied from class: DynamicObject

Returns true if this object contains no properties.

Specified by:

isEmpty in class DynamicObject

Since:

0.17 or earlier

updateShape

public final boolean updateShape()

Description copied from class: DynamicObject

Ensure object shape is up-to-date.

Specified by:

updateShape in class DynamicObject

Returns:

true if shape has changed

Since:

0.17 or earlier

copy

public final DynamicObject copy(Shape currentShape)

Description copied from class: DynamicObject

Create a shallow copy of this object.

Specified by:

copy in class DynamicObject

Parameters:

currentShape - the object's current shape (must equal DynamicObject.getShape())

Since:

0.17 or earlier

getForeignAccess

public ForeignAccess getForeignAccess()

Description copied from interface: TruffleObject

Provides the ForeignAccessFactory instance for this TruffleObject instance.

Specified by:

getForeignAccess in interface TruffleObject

Returns:

the ForeignAccessFactory instance for this TruffleObject instance.

Since:

0.17 or earlier