com.oracle.truffle.js.runtime.util

Class StableContextOptionValue<T>

java.lang.Object

com.oracle.truffle.js.runtime.util.StableContextOptionValue<T>

public final class StableContextOptionValue<T>
extends Object

A wrapper around a context option that may be treated as stable, and optionally patchable. Certain restrictions apply to how these options may be used, and care must be taken not to sidestep these restrictions to ensure option-dependent behavior is preserved, namely: Stable options must not be used during language initialization and must not be stored anywhere else or affect how JS code is parsed and how nodes are created. Dependent compiled code will be invalidated and interpreted code must observe the new option value immediately. Patchable options must either not be used during context initialization at all or carefully be used in such a way that context patching will leave the context not observably different from a newly created context, as if reversing and reapplying the effects of the option.

See Also:

JSContextOptions

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	StableContextOptionValue.UpdateKind

Constructor Summary

Constructors

Constructor and Description
StableContextOptionValue(Function<JSContextOptions,T> getter, org.graalvm.options.OptionKey<T> optionKey, String optionName)

Method Summary

Modifier and Type	Method and Description
boolean	equals(Object obj)
T	get()
T	getFromContext()
int	hashCode()
void	update(JSContextOptions contextOptions, StableContextOptionValue.UpdateKind kind)

Methods inherited from class java.lang.Object

clone, getClass, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

StableContextOptionValue

public StableContextOptionValue(Function<JSContextOptions,T> getter,
                                org.graalvm.options.OptionKey<T> optionKey,
                                String optionName)

Method Detail

get

public T get()

getFromContext

public T getFromContext()

update

public void update(JSContextOptions contextOptions,
                   StableContextOptionValue.UpdateKind kind)

hashCode

public int hashCode()

Overrides:

hashCode in class Object

equals

public boolean equals(Object obj)

Overrides:

equals in class Object