gololang

Class DynamicObject

java.lang.Object

gololang.DynamicObject

public final class DynamicObject
extends Object

A dynamic object is an object whose properties can be dynamically added, changed and removed. Properties can be any object value or a method handle to a closure.

The methods plug and propertyMissing are left undocumented. They are being used by the Golo runtime to dispatch method invocations on dynamic objects.

Constructor Summary

Constructors

Constructor and Description
DynamicObject()

Method Summary

Modifier and Type	Method and Description
DynamicObject	copy()
DynamicObject	define(String name, Object value) Defines a property.
DynamicObject	fallback(Object value) Let the user define a fallback behavior.
DynamicObject	freeze() Freezes a dynamic object, meaning that its properties cannot be added, updated and removed anymore.
Object	get(String name)
boolean	hasMethod(String method) Verify if a method is defined for the dynamic object.
MethodHandle	invoker(String property, MethodType type) Gives an invoker method handle for a given property.
boolean	isFrozen() Tells whether the dynamic object is frozen or not.
DynamicObject	mixin(DynamicObject other) Mixes all properties from another dynamic object into this one, overwriting existing properties.
Set<Map.Entry<String,Object>>	properties()
DynamicObject	undefine(String name) Removes a property.

Methods inherited from class java.lang.Object

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

Constructor Detail

DynamicObject

public DynamicObject()

Method Detail

define

public DynamicObject define(String name,
                            Object value)

Defines a property.

Parameters:

name - the property name.

value - the property value.

Returns:

the same dynamic object.

Throws:

IllegalStateException - if the dynamic object is frozen.

properties

public Set<Map.Entry<String,Object>> properties()

Returns:

a view of all properties.

get

public Object get(String name)

Parameters:

name - the property name.

Returns:

the property value.

undefine

public DynamicObject undefine(String name)

Removes a property.

Parameters:

name - the property name.

Returns:

the same dynamic object.

copy

public DynamicObject copy()

Returns:

a new dynamic object whose properties point to the same objects.

mixin

public DynamicObject mixin(DynamicObject other)

Mixes all properties from another dynamic object into this one, overwriting existing properties.

Parameters:

other - the dynamic object to mix the properties from.

Returns:

the same dynamic object.

freeze

public DynamicObject freeze()

Freezes a dynamic object, meaning that its properties cannot be added, updated and removed anymore.

Returns:

the same dynamic object.

isFrozen

public boolean isFrozen()

Tells whether the dynamic object is frozen or not.

Returns:

true if frozen, false otherwise.

invoker

public MethodHandle invoker(String property,
                            MethodType type)

Gives an invoker method handle for a given property.

While this method may be useful in itself, it is mostly relevant for the Golo runtime internals so as to allow calling "methods" on dynamic objects, as in:

 # obj is some dynamic object...
 obj: foo("bar")
 println(foo: bar())

 obj: define("plop", |this| -> "Plop!")
 println(obj: plop())
 

Parameters:

property - the name of a property.

type - the expected invoker type with at least one parameter (the dynamic object as a receiver).

Returns:

a method handle.

hasMethod

public boolean hasMethod(String method)

Verify if a method is defined for the dynamic object.

Parameters:

method - the method name.

Returns:

true if method is defined, false otherwise.

fallback

public DynamicObject fallback(Object value)

Let the user define a fallback behavior.

Parameters:

value - the fallback value

Returns:

the current object