org.jruby.ext.jruby

Class JRubyLibrary

java.lang.Object

org.jruby.ext.jruby.JRubyLibrary

All Implemented Interfaces:

Library

public class JRubyLibrary
extends Object
implements Library

Native part of require 'jruby'. Provides methods for swapping between the normal Ruby reference to an object and the Java-integration-wrapped reference.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	JRubyLibrary.JRubyConfig
static class	JRubyLibrary.MethodExtensions

Field Summary

Fields inherited from interface org.jruby.runtime.load.Library

DUMMY

Constructor Summary

Constructors

Constructor and Description
JRubyLibrary()

Method Summary

Modifier and Type	Method and Description
static IRubyObject	dereference(ThreadContext context, IRubyObject recv, IRubyObject obj) Unwrap the given Java-integration-wrapped object, returning the unwrapped object.
static IRubyObject	identity_hash(ThreadContext context, IRubyObject recv, IRubyObject obj) Provide the "identity" hash code that System.identityHashCode would produce.
void	load(Ruby runtime, boolean wrap)
static IRubyObject	reference(ThreadContext context, IRubyObject recv, IRubyObject obj) Wrap the given object as in Java integration and return the wrapper.
static IRubyObject	reference0(ThreadContext context, IRubyObject recv, IRubyObject obj) Wrap the given object as in Java integration and return the wrapper.

Methods inherited from class java.lang.Object

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

Constructor Detail

JRubyLibrary

public JRubyLibrary()

Method Detail

load

public void load(Ruby runtime,
                 boolean wrap)

Specified by:

load in interface Library

reference

public static IRubyObject reference(ThreadContext context,
                                    IRubyObject recv,
                                    IRubyObject obj)

Wrap the given object as in Java integration and return the wrapper. This version uses ObjectProxyCache to guarantee the same wrapper is returned as long as it is in use somewhere.

reference0

public static IRubyObject reference0(ThreadContext context,
                                     IRubyObject recv,
                                     IRubyObject obj)

Wrap the given object as in Java integration and return the wrapper. This version does not use ObjectProxyCache.

dereference

public static IRubyObject dereference(ThreadContext context,
                                      IRubyObject recv,
                                      IRubyObject obj)

Unwrap the given Java-integration-wrapped object, returning the unwrapped object. If the wrapped object is not a Ruby object, an error will raise.

identity_hash

public static IRubyObject identity_hash(ThreadContext context,
                                        IRubyObject recv,
                                        IRubyObject obj)

Provide the "identity" hash code that System.identityHashCode would produce. Added here as an extension because calling System.identityHashCode (and other Java-integration-related mechanisms) will cause some core types to coerce to Java types, losing their proper identity.