Package org.jruby.javasupport

Class Java

java.lang.Object

org.jruby.javasupport.Java

All Implemented Interfaces:

Library

public class Java
extends Object
implements Library

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	Java.ByteArrayProxyMethods
private static final class	Java.DummyInitialize
private static final class	Java.InterfaceProxyHandler
private static class	Java.JavaAccessor
static class	Java.JCreateMethod
static class	Java.JCtorCache	Used for concrete reified classes.
static class	Java.NewStyleExtensionInherited
static class	Java.OldStyleExtensionInherited
(package private) static final class	Java.ProcToInterface

Field Summary

Fields

Modifier and Type	Field	Description
private static final Pattern	CAMEL_CASE_PACKAGE_SPLITTER
static final boolean	NEW_STYLE_EXTENSION
static final boolean	OBJECT_PROXY_CACHE

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

DUMMY

Constructor Summary

Constructors

Constructor	Description
Java()

Method Summary

Modifier and Type	Method	Description
private static void	addToJavaPackageModule(RubyModule proxyClass)
static IRubyObject	allocateProxy(Object javaObject, RubyClass clazz)
private static boolean	allowUppercasePackageNames(Ruby runtime)
private static boolean	bindJavaPackageOrClassMethod(RubyModule parentPackage, String name, RubyModule packageOrClass)
private static boolean	bindJavaPackageOrClassMethod(Ruby runtime, String name, RubyModule packageOrClass)
private static RubyModule	cacheConstant(RubyModule owner, String constName, RubyModule packageOrClass, boolean hidden)
private static <T extends ParameterTypes> T	checkCallableForArity(int arity, T[] callables, int index)
private static void	checkJavaReservedNames(Ruby runtime, String name, boolean allowPrimitives)
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, 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)
private static RubyModule	createPackageModule(Ruby runtime, RubyModule parentModule, String name, String packageString)
private static RubyClass	createProxyClass(Ruby runtime, RubyClass proxyClass, Class<?> javaClass, RubyClass superClass, boolean invokeInherited)
(package private) static RubyModule	createProxyClassForClass(Ruby runtime, Class<?> clazz)
(package private) static <T extends ParameterTypes> ArrayList<T>	findCallablesForArity(int arity, T[] callables)
private static void	generateClassProxy(Ruby runtime, Class<?> clazz, RubyClass proxy, RubyClass superClass)
private static void	generateInterfaceProxy(Ruby runtime, Class javaClass, RubyModule proxy)
static 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 RubyModule	get_package_module(IRubyObject self, IRubyObject name)
static IRubyObject	get_package_module_dot_format(IRubyObject self, IRubyObject dottedName)
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 Method	getFunctionalInterfaceMethod(Class<?> iface)
static IRubyObject	getInstance(Ruby runtime, Object rawJavaObject)	Same as Java#getInstance(runtime, rawJavaObject, false).
static IRubyObject	getInstance(Ruby runtime, 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, Class javaClass)
static RubyModule	getInterfaceModule(Ruby runtime, JavaClass javaClass)	Deprecated.
static Class[]	getInterfacesFromRubyClass(RubyClass klass)
static Class	getJavaClass(Ruby runtime, String className)
static Class	getJavaClass(Ruby runtime, String className, boolean initialize)
static RubyModule	getJavaPackageModule(Ruby runtime, Package pkg)
static RubyModule	getJavaPackageModule(Ruby runtime, String packageString)
private static String	getJavaVersionErrorMessage(UnsupportedClassVersionError ex)
private static RubyModule	getPackageModule(Ruby runtime, String name)
static RubyModule	getProxyClass(Ruby runtime, Class<?> clazz)
static RubyModule	getProxyClass(Ruby runtime, JavaClass javaClass)
static RubyClass	getProxyClassForObject(Ruby runtime, Object object)
private static RubyModule	getProxyClassOrNull(Ruby runtime, String className)
(package private) static RubyModule	getProxyOrPackageUnderPackage(ThreadContext context, RubyModule parentPackage, String name, boolean cacheMethod)
private static RubyModule	getProxyUnderClass(ThreadContext context, RubyModule enclosingClass, String name)
static Constructor<? extends IRubyObject>	getRealClassConstructor(Ruby runtime, Class<? extends IRubyObject> proxyImplClass)
private static RubyModule	getTopLevelProxyOrPackage(Ruby runtime, String name, boolean cacheMethod)
(package private) static RaiseException	initCause(RaiseException ex, Throwable cause)
private static int	interfacesHashCode(Class[] a)
private static IRubyObject	invokeProxyClassInherited(ThreadContext context, IRubyObject clazz, IRubyObject subclazz)
static <T extends AccessibleObject & Member> boolean	isAccessible(T member)	Check if the given member would be accessible without using the deprecated AccessibleObject.isAccessible.
private static boolean	isPrimitiveClassName(String name)
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 Class	loadJavaClass(Ruby runtime, String className)
(package private) static Class	loadJavaClass(Ruby runtime, String className, boolean initialize)
private static RaiseException	mapGeneratedProxyException(Ruby runtime, InvocationTargetException e)
private static RaiseException	mapGeneratedProxyException(Ruby runtime, ReflectiveOperationException e)
private static int	mapMajorMinorClassVersionToJavaVersion(String msg, int offset)
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, Class[] interfaces)
private static Object	newProxyInterfaceImpl(IRubyObject wrapper, Class[] interfaces, ClassLoader loader)
(package private) static Class<?>	resolveClassType(Ruby runtime, IRubyObject type)
static Class<?>	resolveClassType(ThreadContext context, IRubyObject type)
private static Class<?>	resolveJavaClassArgument(Ruby runtime, IRubyObject java_class)
private static Class	resolveShortClassName(String name)
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, String constName, Class<?> javaClass)
private static void	setupJavaSubclass(ThreadContext context, RubyClass subclass)
static <T extends AccessibleObject & 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 Class<?>	unwrapClassProxy(IRubyObject self)
static IRubyObject	wrap(Ruby runtime, IRubyObject java_object)
static IRubyObject	wrapJavaObject(Ruby runtime, Object object)

Methods inherited from class java.lang.Object

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

Field Details

NEW_STYLE_EXTENSION

public static final boolean NEW_STYLE_EXTENSION

OBJECT_PROXY_CACHE

public static final boolean OBJECT_PROXY_CACHE

CAMEL_CASE_PACKAGE_SPLITTER

private static final Pattern CAMEL_CASE_PACKAGE_SPLITTER

Constructor Details

Java

public Java()

Method Details

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,
 String constName,
 Class<?> javaClass)

get_java_class

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

Deprecated.

getInstance

public static IRubyObject getInstance(Ruby runtime,
 Object rawJavaObject)

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

getInstance

public static IRubyObject getInstance(Ruby runtime,
 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,
 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)

resolveJavaClassArgument

private static Class<?> resolveJavaClassArgument(Ruby runtime,
 IRubyObject java_class)

unwrapClassProxy

public static Class<?> unwrapClassProxy(IRubyObject self)

getProxyClassForObject

public static RubyClass getProxyClassForObject(Ruby runtime,
 Object object)

resolveClassType

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

resolveType

public static RubyModule resolveType(Ruby runtime,
 IRubyObject type)

resolveClassType

static Class<?> resolveClassType(Ruby runtime,
 IRubyObject type)

resolveShortClassName

private static Class resolveShortClassName(String name)

getProxyClass

public static RubyModule getProxyClass(Ruby runtime,
 JavaClass javaClass)

getProxyClass

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

createProxyClassForClass

static RubyModule createProxyClassForClass(Ruby runtime,
 Class<?> clazz)

generateInterfaceProxy

private static void generateInterfaceProxy(Ruby runtime,
 Class javaClass,
 RubyModule proxy)

generateClassProxy

private static void generateClassProxy(Ruby runtime,
 Class<?> clazz,
 RubyClass proxy,
 RubyClass superClass)

createProxyClass

private static RubyClass createProxyClass(Ruby runtime,
 RubyClass proxyClass,
 Class<?> javaClass,
 RubyClass superClass,
 boolean invokeInherited)

concrete_proxy_inherited

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

Deprecated.

invokeProxyClassInherited

private static IRubyObject invokeProxyClassInherited(ThreadContext context,
 IRubyObject clazz,
 IRubyObject subclazz)

setupJavaSubclass

private static void setupJavaSubclass(ThreadContext context,
 RubyClass subclass)

findCallablesForArity

static <T extends ParameterTypes> ArrayList<T> findCallablesForArity(int arity,
 T[] callables)

checkCallableForArity

private static <T extends ParameterTypes> T checkCallableForArity(int arity,
 T[] callables,
 int index)

addToJavaPackageModule

private static void addToJavaPackageModule(RubyModule proxyClass)

getJavaPackageModule

public static RubyModule getJavaPackageModule(Ruby runtime,
 Package pkg)

getJavaPackageModule

public static RubyModule getJavaPackageModule(Ruby runtime,
 String packageString)

createPackageModule

private static RubyModule createPackageModule(Ruby runtime,
 RubyModule parentModule,
 String name,
 String packageString)

getPackageModule

private static RubyModule getPackageModule(Ruby runtime,
 String name)

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)

getProxyOrPackageUnderPackage

static RubyModule getProxyOrPackageUnderPackage(ThreadContext context,
 RubyModule parentPackage,
 String name,
 boolean cacheMethod)

allowUppercasePackageNames

private static boolean allowUppercasePackageNames(Ruby runtime)

checkJavaReservedNames

private static void checkJavaReservedNames(Ruby runtime,
 String name,
 boolean allowPrimitives)

isPrimitiveClassName

private static boolean isPrimitiveClassName(String name)

getJavaClass

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

Throws:

RaiseException

getJavaClass

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

Throws:

RaiseException

loadJavaClass

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

Throws:

ClassNotFoundException

RaiseException

loadJavaClass

static Class loadJavaClass(Ruby runtime,
 String className,
 boolean initialize)
                    throws ClassNotFoundException,
RaiseException

Throws:

ClassNotFoundException

RaiseException

getJavaVersionErrorMessage

private static String getJavaVersionErrorMessage(UnsupportedClassVersionError ex)

initCause

static RaiseException initCause(RaiseException ex,
 Throwable cause)

getProxyClassOrNull

private static RubyModule getProxyClassOrNull(Ruby runtime,
 String className)

mapMajorMinorClassVersionToJavaVersion

private static int mapMajorMinorClassVersionToJavaVersion(String msg,
 int offset)

get_proxy_or_package_under_package

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

getTopLevelProxyOrPackage

private static RubyModule getTopLevelProxyOrPackage(Ruby runtime,
 String name,
 boolean cacheMethod)

bindJavaPackageOrClassMethod

private static boolean bindJavaPackageOrClassMethod(Ruby runtime,
 String name,
 RubyModule packageOrClass)

bindJavaPackageOrClassMethod

private static boolean bindJavaPackageOrClassMethod(RubyModule parentPackage,
 String name,
 RubyModule packageOrClass)

getProxyUnderClass

private static RubyModule getProxyUnderClass(ThreadContext context,
 RubyModule enclosingClass,
 String 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)

cacheConstant

private static RubyModule cacheConstant(RubyModule owner,
 String constName,
 RubyModule packageOrClass,
 boolean hidden)

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,
 Class[] interfaces)

newProxyInterfaceImpl

private static Object newProxyInterfaceImpl(IRubyObject wrapper,
 Class[] interfaces,
 ClassLoader loader)

generateRealClass

public static Class generateRealClass(RubyClass clazz)

getRealClassConstructor

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

constructProxy

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

mapGeneratedProxyException

private static RaiseException mapGeneratedProxyException(Ruby runtime,
 ReflectiveOperationException e)

mapGeneratedProxyException

private static RaiseException mapGeneratedProxyException(Ruby runtime,
 InvocationTargetException e)

allocateProxy

public static IRubyObject allocateProxy(Object javaObject,
 RubyClass clazz)

wrapJavaObject

public static IRubyObject wrapJavaObject(Ruby runtime,
 Object object)

getInterfacesFromRubyClass

public static Class[] getInterfacesFromRubyClass(RubyClass klass)

interfacesHashCode

private static int interfacesHashCode(Class[] a)

getFunctionalInterfaceMethod

public static Method getFunctionalInterfaceMethod(Class<?> iface)

Parameters:

iface -

Returns:

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

trySetAccessible

public static <T extends AccessibleObject & 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 AccessibleObject & 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.