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
private static class	Java.JavaAccessor
private static class	Java.JavaPackageClassProvider
static class	Java.JavaProxyClassMethods Deprecated.
static class	Java.NewStyleExtensionInherited
static class	Java.OldStyleExtensionInherited
(package private) static class	Java.ProcToInterface

Field Summary

Fields

Modifier and Type	Field and Description
private static java.util.regex.Pattern	CAMEL_CASE_PACKAGE_SPLITTER
(package private) static boolean	JAVA8
static boolean	NEW_STYLE_EXTENSION
static boolean	OBJECT_PROXY_CACHE

Constructor Summary

Constructors

Constructor and Description
Java()

Method Summary

Modifier and Type	Method and Description
private static void	addNameClassMappings(Ruby runtime, java.util.Map<java.lang.String,JavaClass> nameClassMap) This populates the master map from short-cut names to JavaClass instances for a number of core Java types.
private static void	addToJavaPackageModule(RubyModule proxyClass)
private static void	addToJavaPackageModule(RubyModule proxyClass, JavaClass javaClass) Deprecated.
static IRubyObject	allocateProxy(java.lang.Object javaObject, RubyClass clazz)
private static boolean	allowUppercasePackageNames(Ruby runtime)
private static boolean	bindJavaPackageOrClassMethod(RubyModule parentPackage, java.lang.String name, RubyModule packageOrClass)
private static boolean	bindJavaPackageOrClassMethod(Ruby runtime, java.lang.String name, RubyModule packageOrClass)
private static void	checkJavaReservedNames(Ruby runtime, java.lang.String name, boolean allowPrimitives)
static IRubyObject	concrete_proxy_inherited(IRubyObject clazz, IRubyObject subclazz)
static IRubyObject	const_missing(ThreadContext context, IRubyObject self, IRubyObject name)
static IRubyObject	constructProxy(Ruby runtime, java.lang.reflect.Constructor proxyConstructor, RubyClass clazz)
static IRubyObject	create_proxy_class(IRubyObject self, IRubyObject name, IRubyObject javaClass, IRubyObject module)
static RubyModule	createJavaModule(Ruby runtime)
private static RubyModule	createPackageModule(Ruby runtime, RubyModule parentModule, java.lang.String name, java.lang.String packageString)
private static RubyClass	createProxyClass(Ruby runtime, RubyClass proxyClass, java.lang.Class<?> javaClass, boolean invokeInherited)
private static RubyClass	createProxyClass(Ruby runtime, RubyClass baseType, JavaClass javaClass, boolean invokeInherited) Deprecated.
(package private) static RubyModule	createProxyClassForClass(Ruby runtime, java.lang.Class<?> clazz)
(package private) static <T extends ParameterTypes> java.util.ArrayList<T>	findCallablesForArity(int arity, T[] callables)
private static void	generateClassProxy(Ruby runtime, java.lang.Class<?> clazz, RubyClass proxy, RubyClass superClass, JavaSupport javaSupport)
private static void	generateInterfaceProxy(Ruby runtime, java.lang.Class javaClass, RubyModule proxy)
static java.lang.Class	generateRealClass(RubyClass clazz)
static RubyModule	get_interface_module(Ruby runtime, IRubyObject javaClassObject)
static IRubyObject	get_java_class(IRubyObject self, IRubyObject name)
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)
static java.lang.Class[]	getInterfacesFromRubyClass(RubyClass klass)
static RubyModule	getJavaPackageModule(Ruby runtime, java.lang.Package pkg)
private static RubyModule	getJavaPackageModule(Ruby runtime, java.lang.String packageString)
private static RubyModule	getPackageModule(Ruby runtime, java.lang.String name)
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)
private static RubyModule	getProxyClassOrNull(Ruby runtime, java.lang.String className)
private static RubyModule	getProxyClassOrNull(Ruby runtime, java.lang.String className, boolean initJavaClass)
private static RubyModule	getProxyOrPackageUnderPackage(ThreadContext context, RubyModule parentPackage, java.lang.String name, boolean cacheMethod)
static java.lang.reflect.Constructor	getRealClassConstructor(Ruby runtime, java.lang.Class<?> proxyImplClass)
private static RubyModule	getTopLevelProxyOrPackage(Ruby runtime, java.lang.String name, boolean cacheMethod)
private static int	interfacesHashCode(java.lang.Class[] a)
(package private) static boolean	isDefaultMethod(java.lang.reflect.Method method)
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 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 IRubyObject	newInterfaceImpl(IRubyObject wrapper, java.lang.Class[] interfaces)
static IRubyObject	ruby_to_java(IRubyObject recv, IRubyObject object, Block unusedBlock) Deprecated.
private static void	setupJavaSubclass(ThreadContext context, RubyClass subclass)
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

CAMEL_CASE_PACKAGE_SPLITTER

private static final java.util.regex.Pattern CAMEL_CASE_PACKAGE_SPLITTER

JAVA8

static final boolean JAVA8

Constructor Detail

Java

public Java()

Method Detail

load

public void load(Ruby runtime,
                 boolean wrap)
          throws java.io.IOException

Specified by:

load in interface Library

Throws:

java.io.IOException

createJavaModule

public static RubyModule createJavaModule(Ruby runtime)

addNameClassMappings

private static void addNameClassMappings(Ruby runtime,
                                         java.util.Map<java.lang.String,JavaClass> nameClassMap)

This populates the master map from short-cut names to JavaClass instances for a number of core Java types.

Parameters:

runtime -

nameClassMap -

create_proxy_class

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

get_java_class

public static IRubyObject get_java_class(IRubyObject self,
                                         IRubyObject name)

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

public static RubyModule getInterfaceModule(Ruby runtime,
                                            JavaClass javaClass)

getInterfaceModule

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

get_interface_module

public static RubyModule get_interface_module(Ruby runtime,
                                              IRubyObject javaClassObject)

get_proxy_class

public static RubyModule get_proxy_class(IRubyObject self,
                                         IRubyObject java_class)

getProxyClassForObject

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

getProxyClass

public static RubyModule getProxyClass(Ruby runtime,
                                       JavaClass javaClass)

getProxyClass

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

createProxyClassForClass

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

generateInterfaceProxy

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

generateClassProxy

private static void generateClassProxy(Ruby runtime,
                                       java.lang.Class<?> clazz,
                                       RubyClass proxy,
                                       RubyClass superClass,
                                       JavaSupport javaSupport)

createProxyClass

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

concrete_proxy_inherited

public static IRubyObject concrete_proxy_inherited(IRubyObject clazz,
                                                   IRubyObject subclazz)

setupJavaSubclass

private static void setupJavaSubclass(ThreadContext context,
                                      RubyClass subclass)

findCallablesForArity

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

addToJavaPackageModule

private static void addToJavaPackageModule(RubyModule proxyClass)

getJavaPackageModule

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

getJavaPackageModule

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

createPackageModule

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

getPackageModule

private static RubyModule getPackageModule(Ruby runtime,
                                           java.lang.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

private static RubyModule getProxyOrPackageUnderPackage(ThreadContext context,
                                                        RubyModule parentPackage,
                                                        java.lang.String name,
                                                        boolean cacheMethod)

allowUppercasePackageNames

private static boolean allowUppercasePackageNames(Ruby runtime)

checkJavaReservedNames

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

getProxyClassOrNull

private static RubyModule getProxyClassOrNull(Ruby runtime,
                                              java.lang.String className)

getProxyClassOrNull

private static RubyModule getProxyClassOrNull(Ruby runtime,
                                              java.lang.String className,
                                              boolean initJavaClass)

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,
                                                    java.lang.String name,
                                                    boolean cacheMethod)

bindJavaPackageOrClassMethod

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

bindJavaPackageOrClassMethod

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

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 IRubyObject newInterfaceImpl(IRubyObject wrapper,
                                           java.lang.Class[] interfaces)

generateRealClass

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

getRealClassConstructor

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

constructProxy

public static IRubyObject constructProxy(Ruby runtime,
                                         java.lang.reflect.Constructor 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)

interfacesHashCode

private static int interfacesHashCode(java.lang.Class[] a)

addToJavaPackageModule

@Deprecated
private static void addToJavaPackageModule(RubyModule proxyClass,
                                                       JavaClass javaClass)

Deprecated.

createProxyClass

@Deprecated
private static RubyClass createProxyClass(Ruby runtime,
                                                      RubyClass baseType,
                                                      JavaClass javaClass,
                                                      boolean invokeInherited)

Deprecated.

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

isDefaultMethod

static boolean isDefaultMethod(java.lang.reflect.Method method)