org.jruby.javasupport

Class Java

java.lang.Object

org.jruby.javasupport.Java

All Implemented Interfaces:

Library

public class Java
extends java.lang.Object
implements Library

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	Java.ByteArrayProxyMethods
static class	Java.JCreateMethod
static class	Java.JCtorCache Used for concrete reified classes.
static class	Java.NewStyleExtensionInherited
static class	Java.OldStyleExtensionInherited

Field Summary

Fields

Modifier and Type	Field and Description
static boolean	NEW_STYLE_EXTENSION
static boolean	OBJECT_PROXY_CACHE

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

DUMMY

Constructor Summary

Constructors

Constructor and Description
Java()

Method Summary

Modifier and Type	Method and Description
static IRubyObject	allocateProxy(java.lang.Object javaObject, RubyClass clazz)
static IRubyObject	concrete_proxy_inherited(IRubyObject clazz, IRubyObject subclazz) Deprecated.
static IRubyObject	const_missing(ThreadContext context, IRubyObject self, IRubyObject name)
static IRubyObject	constructProxy(Ruby runtime, java.lang.reflect.Constructor<? extends IRubyObject> proxyConstructor, RubyClass clazz)
static IRubyObject	create_proxy_class(IRubyObject self, IRubyObject name, IRubyObject javaClass, IRubyObject module) Deprecated.
static RubyModule	createJavaModule(Ruby runtime)
static java.lang.Class	generateRealClass(RubyClass clazz)
static IRubyObject	get_inner_class(ThreadContext context, RubyModule self, IRubyObject name)
static RubyModule	get_interface_module(Ruby runtime, IRubyObject java_class)
static IRubyObject	get_java_class(IRubyObject self, IRubyObject name) Deprecated.
static IRubyObject	get_package_module_dot_format(IRubyObject self, IRubyObject dottedName)
static RubyModule	get_package_module(IRubyObject self, IRubyObject name)
static RubyModule	get_proxy_class(IRubyObject self, IRubyObject java_class)
static IRubyObject	get_proxy_or_package_under_package(ThreadContext context, IRubyObject self, IRubyObject parentPackage, IRubyObject name)
static IRubyObject	get_top_level_proxy_or_package(ThreadContext context, IRubyObject self, IRubyObject name)
static java.lang.reflect.Method	getFunctionalInterfaceMethod(java.lang.Class<?> iface)
static IRubyObject	getInstance(Ruby runtime, java.lang.Object rawJavaObject) Same as Java#getInstance(runtime, rawJavaObject, false).
static IRubyObject	getInstance(Ruby runtime, java.lang.Object rawJavaObject, boolean forceCache) Returns a new proxy instance of a type corresponding to rawJavaObject's class, or the cached proxy if we've already seen this object.
static RubyModule	getInterfaceModule(Ruby runtime, java.lang.Class javaClass)
static RubyModule	getInterfaceModule(Ruby runtime, JavaClass javaClass) Deprecated.
static java.lang.Class[]	getInterfacesFromRubyClass(RubyClass klass)
static java.lang.Class	getJavaClass(Ruby runtime, java.lang.String className)
static java.lang.Class	getJavaClass(Ruby runtime, java.lang.String className, boolean initialize)
static RubyModule	getJavaPackageModule(Ruby runtime, java.lang.Package pkg)
static RubyModule	getJavaPackageModule(Ruby runtime, java.lang.String packageString)
static RubyModule	getProxyClass(Ruby runtime, java.lang.Class<?> clazz)
static RubyModule	getProxyClass(Ruby runtime, JavaClass javaClass)
static RubyClass	getProxyClassForObject(Ruby runtime, java.lang.Object object)
static java.lang.reflect.Constructor<? extends IRubyObject>	getRealClassConstructor(Ruby runtime, java.lang.Class<? extends IRubyObject> proxyImplClass)
static <T extends java.lang.reflect.AccessibleObject & java.lang.reflect.Member> boolean	isAccessible(T member) Check if the given member would be accessible without using the deprecated AccessibleObject.isAccessible.
static IRubyObject	java_to_primitive(IRubyObject recv, IRubyObject object, Block unusedBlock) Deprecated.
static IRubyObject	java_to_ruby(IRubyObject recv, IRubyObject object, Block unusedBlock) Deprecated.
void	load(Ruby runtime, boolean wrap)
static java.lang.Class	loadJavaClass(Ruby runtime, java.lang.String className)
static IRubyObject	method_missing(ThreadContext context, IRubyObject self, IRubyObject name)
static IRubyObject	method_missing(ThreadContext context, IRubyObject self, IRubyObject[] args)
static IRubyObject	new_proxy_instance2(IRubyObject recv, IRubyObject wrapper, IRubyObject ifcs, Block block)
static JavaObject	newInterfaceImpl(IRubyObject wrapper, java.lang.Class[] interfaces)
static java.lang.Class<?>	resolveClassType(ThreadContext context, IRubyObject type)
static RubyModule	resolveType(Ruby runtime, IRubyObject type)
static IRubyObject	ruby_to_java(IRubyObject recv, IRubyObject object, Block unusedBlock) Deprecated.
static RubyModule	setProxyClass(Ruby runtime, RubyModule target, java.lang.String constName, java.lang.Class<?> javaClass)
static <T extends java.lang.reflect.AccessibleObject & java.lang.reflect.Member> boolean	trySetAccessible(T member) Try to set the given member to be accessible, considering open modules and avoiding the actual setAccessible call when it would produce a JPMS warning.
static java.lang.Class<?>	unwrapClassProxy(IRubyObject self)
static IRubyObject	wrap(Ruby runtime, IRubyObject java_object)
static IRubyObject	wrapJavaObject(Ruby runtime, java.lang.Object object)

Methods inherited from class java.lang.Object

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

Field Detail

NEW_STYLE_EXTENSION

public static final boolean NEW_STYLE_EXTENSION

OBJECT_PROXY_CACHE

public static final boolean OBJECT_PROXY_CACHE

Constructor Detail

Java

public Java()

Method Detail

load

public void load(Ruby runtime,
                 boolean wrap)

Specified by:

load in interface Library

createJavaModule

public static RubyModule createJavaModule(Ruby runtime)

create_proxy_class

@Deprecated
public static IRubyObject create_proxy_class(IRubyObject self,
                                                         IRubyObject name,
                                                         IRubyObject javaClass,
                                                         IRubyObject module)

Deprecated.

setProxyClass

public static RubyModule setProxyClass(Ruby runtime,
                                       RubyModule target,
                                       java.lang.String constName,
                                       java.lang.Class<?> javaClass)

get_java_class

@Deprecated
public static IRubyObject get_java_class(IRubyObject self,
                                                     IRubyObject name)

Deprecated.

getInstance

public static IRubyObject getInstance(Ruby runtime,
                                      java.lang.Object rawJavaObject)

Same as Java#getInstance(runtime, rawJavaObject, false).

getInstance

public static IRubyObject getInstance(Ruby runtime,
                                      java.lang.Object rawJavaObject,
                                      boolean forceCache)

Returns a new proxy instance of a type corresponding to rawJavaObject's class, or the cached proxy if we've already seen this object. Note that primitives and strings are not coerced to corresponding Ruby types; use JavaUtil.convertJavaToUsableRubyObject to get coerced types or proxies as appropriate.

Parameters:

runtime - the JRuby runtime

rawJavaObject - the object to get a wrapper for

forceCache - whether to force the use of the proxy cache

Returns:

the new (or cached) proxy for the specified Java object

See Also:

JavaUtil.convertJavaToUsableRubyObject(org.jruby.Ruby, java.lang.Object)

getInterfaceModule

@Deprecated
public static RubyModule getInterfaceModule(Ruby runtime,
                                                        JavaClass javaClass)

Deprecated.

getInterfaceModule

public static RubyModule getInterfaceModule(Ruby runtime,
                                            java.lang.Class javaClass)

get_interface_module

public static RubyModule get_interface_module(Ruby runtime,
                                              IRubyObject java_class)

get_proxy_class

public static RubyModule get_proxy_class(IRubyObject self,
                                         IRubyObject java_class)

unwrapClassProxy

public static java.lang.Class<?> unwrapClassProxy(IRubyObject self)

getProxyClassForObject

public static RubyClass getProxyClassForObject(Ruby runtime,
                                               java.lang.Object object)

resolveClassType

public static java.lang.Class<?> resolveClassType(ThreadContext context,
                                                  IRubyObject type)

resolveType

public static RubyModule resolveType(Ruby runtime,
                                     IRubyObject type)

getProxyClass

public static RubyModule getProxyClass(Ruby runtime,
                                       JavaClass javaClass)

getProxyClass

public static RubyModule getProxyClass(Ruby runtime,
                                       java.lang.Class<?> clazz)

concrete_proxy_inherited

@Deprecated
public static IRubyObject concrete_proxy_inherited(IRubyObject clazz,
                                                               IRubyObject subclazz)

Deprecated.

getJavaPackageModule

public static RubyModule getJavaPackageModule(Ruby runtime,
                                              java.lang.Package pkg)

getJavaPackageModule

public static RubyModule getJavaPackageModule(Ruby runtime,
                                              java.lang.String packageString)

get_package_module

public static RubyModule get_package_module(IRubyObject self,
                                            IRubyObject name)

get_package_module_dot_format

public static IRubyObject get_package_module_dot_format(IRubyObject self,
                                                        IRubyObject dottedName)

getJavaClass

public static java.lang.Class getJavaClass(Ruby runtime,
                                           java.lang.String className)
                                    throws RaiseException

Throws:

RaiseException

getJavaClass

public static java.lang.Class getJavaClass(Ruby runtime,
                                           java.lang.String className,
                                           boolean initialize)
                                    throws RaiseException

Throws:

RaiseException

loadJavaClass

public static java.lang.Class loadJavaClass(Ruby runtime,
                                            java.lang.String className)
                                     throws java.lang.ClassNotFoundException,
                                            RaiseException

Throws:

java.lang.ClassNotFoundException

RaiseException

get_proxy_or_package_under_package

public static IRubyObject get_proxy_or_package_under_package(ThreadContext context,
                                                             IRubyObject self,
                                                             IRubyObject parentPackage,
                                                             IRubyObject name)

get_inner_class

public static IRubyObject get_inner_class(ThreadContext context,
                                          RubyModule self,
                                          IRubyObject name)

const_missing

public static IRubyObject const_missing(ThreadContext context,
                                        IRubyObject self,
                                        IRubyObject name)

method_missing

public static IRubyObject method_missing(ThreadContext context,
                                         IRubyObject self,
                                         IRubyObject name)

method_missing

public static IRubyObject method_missing(ThreadContext context,
                                         IRubyObject self,
                                         IRubyObject[] args)

get_top_level_proxy_or_package

public static IRubyObject get_top_level_proxy_or_package(ThreadContext context,
                                                         IRubyObject self,
                                                         IRubyObject name)

wrap

public static IRubyObject wrap(Ruby runtime,
                               IRubyObject java_object)

java_to_ruby

@Deprecated
public static IRubyObject java_to_ruby(IRubyObject recv,
                                                   IRubyObject object,
                                                   Block unusedBlock)

Deprecated.

High-level object conversion utility function 'java_to_primitive' is the low-level version

ruby_to_java

@Deprecated
public static IRubyObject ruby_to_java(IRubyObject recv,
                                                   IRubyObject object,
                                                   Block unusedBlock)

Deprecated.

High-level object conversion utility.

java_to_primitive

@Deprecated
public static IRubyObject java_to_primitive(IRubyObject recv,
                                                        IRubyObject object,
                                                        Block unusedBlock)

Deprecated.

new_proxy_instance2

public static IRubyObject new_proxy_instance2(IRubyObject recv,
                                              IRubyObject wrapper,
                                              IRubyObject ifcs,
                                              Block block)

newInterfaceImpl

public static JavaObject newInterfaceImpl(IRubyObject wrapper,
                                          java.lang.Class[] interfaces)

generateRealClass

public static java.lang.Class generateRealClass(RubyClass clazz)

getRealClassConstructor

public static java.lang.reflect.Constructor<? extends IRubyObject> getRealClassConstructor(Ruby runtime,
                                                                                           java.lang.Class<? extends IRubyObject> proxyImplClass)

constructProxy

public static IRubyObject constructProxy(Ruby runtime,
                                         java.lang.reflect.Constructor<? extends IRubyObject> proxyConstructor,
                                         RubyClass clazz)

allocateProxy

public static IRubyObject allocateProxy(java.lang.Object javaObject,
                                        RubyClass clazz)

wrapJavaObject

public static IRubyObject wrapJavaObject(Ruby runtime,
                                         java.lang.Object object)

getInterfacesFromRubyClass

public static java.lang.Class[] getInterfacesFromRubyClass(RubyClass klass)

getFunctionalInterfaceMethod

public static java.lang.reflect.Method getFunctionalInterfaceMethod(java.lang.Class<?> iface)

Parameters:

iface -

Returns:

the sole un-implemented method for a functional-style interface or null

trySetAccessible

public static <T extends java.lang.reflect.AccessibleObject & java.lang.reflect.Member> boolean trySetAccessible(T member)

Try to set the given member to be accessible, considering open modules and avoiding the actual setAccessible call when it would produce a JPMS warning. All classes on Java 8 are considered open, allowing setAccessible to proceed. The open check is based on this class, Java.java, which will be in whatever core or dist JRuby module you are using.

isAccessible

public static <T extends java.lang.reflect.AccessibleObject & java.lang.reflect.Member> boolean isAccessible(T member)

Check if the given member would be accessible without using the deprecated AccessibleObject.isAccessible. This uses backport9 logic to check if the given class is in a package that has been opened up to us, since under JPMS that is the only way we can do invasive accesses. On Java 8, it continues to use isAccessible. The open check is based on this class, Java.java, which will be in whatever core or dist JRuby module you are using.