Top Description Inners Fields Constructors Methods
org.jruby.runtime.opto

public Class OptoFactory

extends Object
Class Inheritance
Imports
org.jruby.Ruby, .RubyModule, org.jruby.runtime.ThreadContext, org.jruby.util.cli.Options, java.lang.invoke.MethodHandles
A set of factory methods to construct optimizing utilities for compilation, cache invalidation, and so on.

Nested and Inner Type Summary

Modifier and TypeClass and Description
public static interface
OptoFactory.ConstantFactory

A factory for abstract "constant" representations of objects.

private static class
OptoFactory.MethodHandleConstantFactory

A constant factory that produces MethodHandle constants that drop an initial ThreadContext argument.

Field Summary

Modifier and TypeField and Description
private static final OptoFactory.ConstantFactory
CONSTANT_FACTORY

The constant factory we'll be using for this run.

Constructor Summary

AccessConstructor and Description
public
OptoFactory()

Method Summary

Modifier and TypeMethod and Description
private static void
disableIndy()

private static Boolean
indyEnabled()

public static Invalidator
newConstantInvalidator(Ruby runtime)

public static final Object

Returns:

a "constant" representation of this object appropriate to the current JVM and runtime modes
newConstantWrapper(Class<T>
the class to which the constant should conform
type, Object object)

Create a new "constant" representation for this object, conforming to the given concrete type.

public static Invalidator
newGlobalInvalidator(int maxFailures)

public static Invalidator
newMethodInvalidator(RubyModule module)

Inherited from java.lang.Object:
cloneequalsfinalizegetClasshashCodenotifynotifyAlltoStringwaitwaitwait

Field Detail

CONSTANT_FACTORYback to summary
private static final OptoFactory.ConstantFactory CONSTANT_FACTORY

The constant factory we'll be using for this run.

Constructor Detail

OptoFactoryback to summary
public OptoFactory()

Method Detail

disableIndyback to summary
private static void disableIndy()
indyEnabledback to summary
private static Boolean indyEnabled()
newConstantInvalidatorback to summary
public static Invalidator newConstantInvalidator(Ruby runtime)
newConstantWrapperback to summary
public static final Object newConstantWrapper(Class<T> type, Object object)

Create a new "constant" representation for this object, conforming to the given concrete type. This is currently only used by invokedynamic to cache "constant" method handle wrappers for common literal fixnums and symbols.

Parameters
type:Class<T>

the class to which the constant should conform

Returns:Object

a "constant" representation of this object appropriate to the current JVM and runtime modes

newGlobalInvalidatorback to summary
public static Invalidator newGlobalInvalidator(int maxFailures)
newMethodInvalidatorback to summary
public static Invalidator newMethodInvalidator(RubyModule module)
org.jruby.runtime.opto back to summary

public Interface OptoFactory.ConstantFactory

Known Direct Implementers
org.jruby.runtime.opto.OptoFactory.MethodHandleConstantFactory
A factory for abstract "constant" representations of objects. This is currently only used by our invokedynamic support to cache the "constant" handles that wrap common literal fixnums and symbols. See #2058.

Method Summary

Modifier and TypeMethod and Description
public Object

Returns:

a constant representation suitable for optimization
create(Class<T>
the type to which the constant should conform
type, Object
the object which represents the constant's value
object)

Return a representation of a "constant" suitable for optimization in the current runtime.

Method Detail

createback to summary
public Object create(Class<T> type, Object object)

Return a representation of a "constant" suitable for optimization in the current runtime. For invokedynamic, this produces a MethodHandles.constant wrapper around the given object, typed with the given type.

Parameters
type:Class<T>

the type to which the constant should conform

object:Object

the object which represents the constant's value

Returns:Object

a constant representation suitable for optimization

org.jruby.runtime.opto back to summary

private Class OptoFactory.MethodHandleConstantFactory

extends Object
implements ConstantFactory
Class Inheritance
  • java.lang.Object
  • org.jruby.runtime.opto.OptoFactory.MethodHandleConstantFactory
All Implemented Interfaces
org.jruby.runtime.opto.OptoFactory.ConstantFactory
A constant factory that produces MethodHandle constants that drop an initial ThreadContext argument.

Constructor Summary

AccessConstructor and Description
private
MethodHandleConstantFactory()

Method Summary

Modifier and TypeMethod and Description
public Object
create(Class<T>
the type to which the constant should conform
type, Object
the object which represents the constant's value
object)

Implements org.jruby.runtime.opto.OptoFactory.ConstantFactory.create.

Return a representation of a "constant" suitable for optimization in the current runtime.

Inherited from java.lang.Object:
cloneequalsfinalizegetClasshashCodenotifynotifyAlltoStringwaitwaitwait

Constructor Detail

MethodHandleConstantFactoryback to summary
private MethodHandleConstantFactory()

Method Detail

createback to summary
public Object create(Class<T> type, Object object)

Implements org.jruby.runtime.opto.OptoFactory.ConstantFactory.create.

Doc from org.jruby.runtime.opto.OptoFactory.ConstantFactory.create.

Return a representation of a "constant" suitable for optimization in the current runtime. For invokedynamic, this produces a MethodHandles.constant wrapper around the given object, typed with the given type.

Parameters
type:Class<T>

the type to which the constant should conform

object:Object

the object which represents the constant's value

Returns:Object

a constant representation suitable for optimization