org.jruby.runtime.ivars

Class NonvolatileVariableAccessor

java.lang.Object

org.jruby.runtime.ivars.VariableAccessor

org.jruby.runtime.ivars.NonvolatileVariableAccessor

public class NonvolatileVariableAccessor
extends VariableAccessor

A VariableAccessor that directly updates instance variables without an explicit memory fence or synchronization. If the table itself must be created for the first time or grown to accommodate a new variable, those operations will be done in a thread-safe (volatile, atomic) way. However updates of an entry in an existing table will not have any explicit memory fence or synchronization.

Field Summary

Fields inherited from class org.jruby.runtime.ivars.VariableAccessor

classId, DUMMY_ACCESSOR, index, name, realClass

Constructor Summary

Constructors

Constructor and Description
NonvolatileVariableAccessor(RubyClass realClass, java.lang.String name, int index, int classId) Construct a new NonvolatileVariableAccessor for the given "real" class, variable name, variable index, and class ID.

Method Summary

Modifier and Type	Method and Description
void	set(java.lang.Object object, java.lang.Object value) Set this variable into the given object using Unsafe to ensure safe creation or growth of the variable table.
static void	setVariable(RubyBasicObject self, RubyClass realClass, int index, java.lang.Object value) Set the given variable index into the specified object.
static void	setVariableChecked(RubyBasicObject self, RubyClass realClass, int index, java.lang.Object value) Set the given variable index into the specified object.

Methods inherited from class org.jruby.runtime.ivars.VariableAccessor

get, getClassId, getIndex, getName, getVariable, toString, verify

Methods inherited from class java.lang.Object

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

Constructor Detail

NonvolatileVariableAccessor

public NonvolatileVariableAccessor(RubyClass realClass,
                                   java.lang.String name,
                                   int index,
                                   int classId)

Construct a new NonvolatileVariableAccessor for the given "real" class, variable name, variable index, and class ID.

Parameters:

realClass - the "real" class

name - the variable's name

index - the variable's index

classId - the class's ID

Method Detail

set

public void set(java.lang.Object object,
                java.lang.Object value)

Set this variable into the given object using Unsafe to ensure safe creation or growth of the variable table.

Overrides:

set in class VariableAccessor

Parameters:

object - the object into which to set this variable

value - the variable's value

setVariableChecked

public static void setVariableChecked(RubyBasicObject self,
                                      RubyClass realClass,
                                      int index,
                                      java.lang.Object value)

Set the given variable index into the specified object. The "real" class and index are pass in to provide functional access. This version checks if self has been frozen before proceeding to set the variable.

Parameters:

self - the object into which to set the variable

realClass - the "real" class for the object

index - the index of the variable

value - the variable's value

setVariable

public static void setVariable(RubyBasicObject self,
                               RubyClass realClass,
                               int index,
                               java.lang.Object value)

Set the given variable index into the specified object. The "real" class and index are pass in to provide functional access.

Parameters:

self - the object into which to set the variable

realClass - the "real" class for the object

index - the index of the variable

value - the variable's value