org.jruby.javasupport

Class JavaUtil

java.lang.Object

org.jruby.javasupport.JavaUtil

public class JavaUtil
extends Object

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	JavaUtil.JavaConverter
static interface	JavaUtil.NumericConverter
static interface	JavaUtil.RubyConverter Deprecated.

Field Summary

Fields

Modifier and Type	Field and Description
static JavaUtil.RubyConverter	ARRAY_BIGDECIMAL_CONVERTER Deprecated.
static JavaUtil.RubyConverter	ARRAY_BIGINTEGER_CONVERTER Deprecated.
static JavaUtil.RubyConverter	ARRAY_BOOLEAN_CONVERTER Deprecated.
static JavaUtil.RubyConverter	ARRAY_BYTE_CONVERTER Deprecated.
static JavaUtil.RubyConverter	ARRAY_CHAR_CONVERTER Deprecated.
static JavaUtil.RubyConverter	ARRAY_CLASS_CONVERTER Deprecated.
static Map<Class,JavaUtil.RubyConverter>	ARRAY_CONVERTERS Deprecated.
static JavaUtil.RubyConverter	ARRAY_DOUBLE_CONVERTER Deprecated.
static JavaUtil.RubyConverter	ARRAY_FLOAT_CONVERTER Deprecated.
static JavaUtil.RubyConverter	ARRAY_INT_CONVERTER Deprecated.
static JavaUtil.RubyConverter	ARRAY_LONG_CONVERTER Deprecated.
static JavaUtil.RubyConverter	ARRAY_OBJECT_CONVERTER Deprecated.
static JavaUtil.RubyConverter	ARRAY_SHORT_CONVERTER Deprecated.
static JavaUtil.RubyConverter	ARRAY_STRING_CONVERTER Deprecated.
static boolean	CAN_SET_ACCESSIBLE
static Map<String,Class>	PRIMITIVE_CLASSES
static JavaUtil.RubyConverter	RUBY_BOOLEAN_CONVERTER Deprecated.
static JavaUtil.RubyConverter	RUBY_BYTE_CONVERTER Deprecated.
static JavaUtil.RubyConverter	RUBY_CHAR_CONVERTER Deprecated.
static Map<Class,JavaUtil.RubyConverter>	RUBY_CONVERTERS Deprecated.
static JavaUtil.RubyConverter	RUBY_DOUBLE_CONVERTER Deprecated.
static JavaUtil.RubyConverter	RUBY_FLOAT_CONVERTER Deprecated.
static JavaUtil.RubyConverter	RUBY_INTEGER_CONVERTER Deprecated.
static JavaUtil.RubyConverter	RUBY_LONG_CONVERTER Deprecated.
static JavaUtil.RubyConverter	RUBY_SHORT_CONVERTER Deprecated.

Constructor Summary

Constructors

Constructor and Description
JavaUtil()

Method Summary

Methods

Modifier and Type	Method and Description
static <T> T	clone(Object object) Clone a Java object, assuming its class has an accessible clone method.
static Object	coerceJavaObjectToType(ThreadContext context, Object javaObject, Class target) Deprecated.
static Object	coerceNilToType(RubyNil nil, Class target) Deprecated.
static Object	coerceOtherToType(ThreadContext context, IRubyObject arg, Class target) Deprecated.
static Object	coerceStringToType(RubyString string, Class target) Deprecated.
static Object	convertArgument(Ruby runtime, Object argument, Class<?> parameterType) Deprecated.
static Object[]	convertArguments(IRubyObject[] args, Class<?>[] types)
static Object[]	convertArguments(IRubyObject[] args, Class<?>[] types, int offset)
static Object	convertArgumentToType(ThreadContext context, IRubyObject arg, Class target) Deprecated.
static IRubyObject	convertJavaArrayElementToRuby(Ruby runtime, JavaUtil.JavaConverter converter, Object array, int i)
static IRubyObject[]	convertJavaArrayToRuby(Ruby runtime, Object[] objects)
static RubyArray	convertJavaArrayToRubyWithNesting(ThreadContext context, Object array)
static IRubyObject	convertJavaToRuby(Ruby runtime, boolean b)
static IRubyObject	convertJavaToRuby(Ruby runtime, double d)
static IRubyObject	convertJavaToRuby(Ruby runtime, float f)
static IRubyObject	convertJavaToRuby(Ruby runtime, int i)
static IRubyObject	convertJavaToRuby(Ruby runtime, JavaUtil.JavaConverter converter, Object object) Deprecated.
static IRubyObject	convertJavaToRuby(Ruby runtime, long l)
static IRubyObject	convertJavaToRuby(Ruby runtime, Object object)
static IRubyObject	convertJavaToRuby(Ruby runtime, Object object, Class javaClass)
static IRubyObject	convertJavaToUsableRubyObject(Ruby runtime, Object object) Returns a usable RubyObject; for types that are not converted to Ruby native types, a Java proxy will be returned.
static IRubyObject	convertJavaToUsableRubyObjectWithConverter(Ruby runtime, Object object, JavaUtil.JavaConverter converter)
static <T> T	convertProcToInterface(ThreadContext context, RubyBasicObject rubyObject, Class<T> targetType)
static <T> T	convertProcToInterface(ThreadContext context, RubyObject rubyObject, Class<T> targetType)
static Object	convertRubyToJava(IRubyObject rubyObject) Deprecated.
static Object	convertRubyToJava(IRubyObject rubyObject, Class javaClass) Deprecated.
static boolean	convertRubyToJavaBoolean(IRubyObject rubyObject) Deprecated.
static byte	convertRubyToJavaByte(IRubyObject rubyObject) Deprecated.
static char	convertRubyToJavaChar(IRubyObject rubyObject) Deprecated.
static double	convertRubyToJavaDouble(IRubyObject rubyObject) Deprecated.
static float	convertRubyToJavaFloat(IRubyObject rubyObject) Deprecated.
static int	convertRubyToJavaInt(IRubyObject rubyObject) Deprecated.
static long	convertRubyToJavaLong(IRubyObject rubyObject) Deprecated.
static short	convertRubyToJavaShort(IRubyObject rubyObject) Deprecated.
static JavaUtil.RubyConverter	getArrayConverter(Class type) Deprecated.
static String	getJavaCasedName(String javaCasedName)
static JavaUtil.JavaConverter	getJavaConverter(Class clazz)
static String	getJavaPropertyName(String beanMethodName) For methods that match /(get|set|is)([A-Z0-9])(.*)/, return the "name" part of the property with leading lower-case.
static JavaUtil.NumericConverter	getNumericConverter(Class target)
static Class<?>	getPrimitiveClass(String name)
static String	getRubyCasedName(String javaCasedName) Build a Ruby name from a Java name by treating '_' as divider and successive caps as all the same word.
static Set<String>	getRubyNamesForJavaName(String javaName, List<Method> methods) Given a simple Java method name and the Java Method objects that represent all its overloads, add to the given nameSet all possible Ruby names that would be valid.
static boolean	isDuckTypeConvertable(Class<?> argumentType, Class<?> targetType)
static boolean	isJavaObject(IRubyObject object) Test if a passed instance is a wrapper Java object.
static IRubyObject	java_to_primitive(IRubyObject recv, IRubyObject object, Block unusedBlock) Deprecated.
static IRubyObject	java_to_ruby(Ruby runtime, IRubyObject object) Deprecated.
static Object	objectFromJavaProxy(IRubyObject self)
static IRubyObject	primitive_to_java(IRubyObject recv, IRubyObject object, Block unusedBlock) Deprecated.
static Class<?>	primitiveToWrapper(Class<?> type)
static IRubyObject	ruby_to_java(IRubyObject recv, IRubyObject object, Block unusedBlock) Deprecated.
static String	toJavaGetName(String propertyName)
static String	toJavaIsName(String propertyName)
static <T> T	unwrapIfJavaObject(IRubyObject object) Unwrap if the passed object is a Java object, otherwise return object.
static <T> T	unwrapJavaObject(IRubyObject object) Unwrap a wrapped Java object.
static JavaObject	unwrapJavaObject(Ruby runtime, IRubyObject convertee, String errorMessage) Deprecated.
static Object	unwrapJavaValue(IRubyObject object)
static Object	unwrapJavaValue(Ruby runtime, IRubyObject object, String errorMessage) Deprecated.

Methods inherited from class java.lang.Object

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

Field Detail

CAN_SET_ACCESSIBLE

public static final boolean CAN_SET_ACCESSIBLE

PRIMITIVE_CLASSES

public static final Map<String,Class> PRIMITIVE_CLASSES

RUBY_BOOLEAN_CONVERTER

@Deprecated
public static final JavaUtil.RubyConverter RUBY_BOOLEAN_CONVERTER

Deprecated.

RUBY_BYTE_CONVERTER

@Deprecated
public static final JavaUtil.RubyConverter RUBY_BYTE_CONVERTER

Deprecated.

RUBY_SHORT_CONVERTER

@Deprecated
public static final JavaUtil.RubyConverter RUBY_SHORT_CONVERTER

Deprecated.

RUBY_CHAR_CONVERTER

@Deprecated
public static final JavaUtil.RubyConverter RUBY_CHAR_CONVERTER

Deprecated.

RUBY_INTEGER_CONVERTER

@Deprecated
public static final JavaUtil.RubyConverter RUBY_INTEGER_CONVERTER

Deprecated.

RUBY_LONG_CONVERTER

@Deprecated
public static final JavaUtil.RubyConverter RUBY_LONG_CONVERTER

Deprecated.

RUBY_FLOAT_CONVERTER

@Deprecated
public static final JavaUtil.RubyConverter RUBY_FLOAT_CONVERTER

Deprecated.

RUBY_DOUBLE_CONVERTER

@Deprecated
public static final JavaUtil.RubyConverter RUBY_DOUBLE_CONVERTER

Deprecated.

RUBY_CONVERTERS

@Deprecated
public static final Map<Class,JavaUtil.RubyConverter> RUBY_CONVERTERS

Deprecated.

ARRAY_BOOLEAN_CONVERTER

@Deprecated
public static final JavaUtil.RubyConverter ARRAY_BOOLEAN_CONVERTER

Deprecated.

ARRAY_BYTE_CONVERTER

@Deprecated
public static final JavaUtil.RubyConverter ARRAY_BYTE_CONVERTER

Deprecated.

ARRAY_SHORT_CONVERTER

@Deprecated
public static final JavaUtil.RubyConverter ARRAY_SHORT_CONVERTER

Deprecated.

ARRAY_CHAR_CONVERTER

@Deprecated
public static final JavaUtil.RubyConverter ARRAY_CHAR_CONVERTER

Deprecated.

ARRAY_INT_CONVERTER

@Deprecated
public static final JavaUtil.RubyConverter ARRAY_INT_CONVERTER

Deprecated.

ARRAY_LONG_CONVERTER

@Deprecated
public static final JavaUtil.RubyConverter ARRAY_LONG_CONVERTER

Deprecated.

ARRAY_FLOAT_CONVERTER

@Deprecated
public static final JavaUtil.RubyConverter ARRAY_FLOAT_CONVERTER

Deprecated.

ARRAY_DOUBLE_CONVERTER

@Deprecated
public static final JavaUtil.RubyConverter ARRAY_DOUBLE_CONVERTER

Deprecated.

ARRAY_OBJECT_CONVERTER

@Deprecated
public static final JavaUtil.RubyConverter ARRAY_OBJECT_CONVERTER

Deprecated.

ARRAY_CLASS_CONVERTER

@Deprecated
public static final JavaUtil.RubyConverter ARRAY_CLASS_CONVERTER

Deprecated.

ARRAY_STRING_CONVERTER

@Deprecated
public static final JavaUtil.RubyConverter ARRAY_STRING_CONVERTER

Deprecated.

ARRAY_BIGINTEGER_CONVERTER

@Deprecated
public static final JavaUtil.RubyConverter ARRAY_BIGINTEGER_CONVERTER

Deprecated.

ARRAY_BIGDECIMAL_CONVERTER

@Deprecated
public static final JavaUtil.RubyConverter ARRAY_BIGDECIMAL_CONVERTER

Deprecated.

ARRAY_CONVERTERS

@Deprecated
public static final Map<Class,JavaUtil.RubyConverter> ARRAY_CONVERTERS

Deprecated.

Constructor Detail

JavaUtil

public JavaUtil()

Method Detail

convertJavaArrayToRuby

public static IRubyObject[] convertJavaArrayToRuby(Ruby runtime,
                                   Object[] objects)

convertJavaArrayToRubyWithNesting

public static RubyArray convertJavaArrayToRubyWithNesting(ThreadContext context,
                                          Object array)

getJavaConverter

public static JavaUtil.JavaConverter getJavaConverter(Class clazz)

convertJavaToRuby

public static IRubyObject convertJavaToRuby(Ruby runtime,
                            Object object)

convertJavaToRuby

public static IRubyObject convertJavaToRuby(Ruby runtime,
                            Object object,
                            Class javaClass)

convertJavaToRuby

public static IRubyObject convertJavaToRuby(Ruby runtime,
                            int i)

convertJavaToRuby

public static IRubyObject convertJavaToRuby(Ruby runtime,
                            long l)

convertJavaToRuby

public static IRubyObject convertJavaToRuby(Ruby runtime,
                            float f)

convertJavaToRuby

public static IRubyObject convertJavaToRuby(Ruby runtime,
                            double d)

convertJavaToRuby

public static IRubyObject convertJavaToRuby(Ruby runtime,
                            boolean b)

convertJavaToUsableRubyObject

public static IRubyObject convertJavaToUsableRubyObject(Ruby runtime,
                                        Object object)

Returns a usable RubyObject; for types that are not converted to Ruby native types, a Java proxy will be returned.

Parameters:

runtime -

object -

Returns:

corresponding Ruby type, or a functional Java proxy

convertJavaToUsableRubyObjectWithConverter

public static IRubyObject convertJavaToUsableRubyObjectWithConverter(Ruby runtime,
                                                     Object object,
                                                     JavaUtil.JavaConverter converter)

convertJavaArrayElementToRuby

public static IRubyObject convertJavaArrayElementToRuby(Ruby runtime,
                                        JavaUtil.JavaConverter converter,
                                        Object array,
                                        int i)

primitiveToWrapper

public static Class<?> primitiveToWrapper(Class<?> type)

isDuckTypeConvertable

public static boolean isDuckTypeConvertable(Class<?> argumentType,
                            Class<?> targetType)

convertProcToInterface

public static <T> T convertProcToInterface(ThreadContext context,
                           RubyObject rubyObject,
                           Class<T> targetType)

convertProcToInterface

public static <T> T convertProcToInterface(ThreadContext context,
                           RubyBasicObject rubyObject,
                           Class<T> targetType)

getNumericConverter

public static JavaUtil.NumericConverter getNumericConverter(Class target)

isJavaObject

public static boolean isJavaObject(IRubyObject object)

Test if a passed instance is a wrapper Java object.

Parameters:

object -

Returns:

true if the object is wrapping a Java object

unwrapJavaObject

public static <T> T unwrapJavaObject(IRubyObject object)

Unwrap a wrapped Java object.

Parameters:

object -

Returns:

Java object

See Also:

isJavaObject(IRubyObject)

unwrapIfJavaObject

public static <T> T unwrapIfJavaObject(IRubyObject object)

Unwrap if the passed object is a Java object, otherwise return object.

Parameters:

object -

Returns:

java object or passed object

See Also:

isJavaObject(IRubyObject)

unwrapJavaValue

@Deprecated
public static Object unwrapJavaValue(Ruby runtime,
                                IRubyObject object,
                                String errorMessage)

Deprecated.

unwrapJavaValue

public static Object unwrapJavaValue(IRubyObject object)

Parameters:

object -

Returns:

unwrapped Java (object's) value

getJavaPropertyName

public static String getJavaPropertyName(String beanMethodName)

For methods that match /(get|set|is)([A-Z0-9])(.*)/, return the "name" part of the property with leading lower-case.

Parameters:

beanMethodName - the bean method from which to extract a name

Returns:

the bean property name (or null)

toJavaGetName

public static String toJavaGetName(String propertyName)

toJavaIsName

public static String toJavaIsName(String propertyName)

getRubyCasedName

public static String getRubyCasedName(String javaCasedName)

Build a Ruby name from a Java name by treating '_' as divider and successive caps as all the same word.

Parameters:

javaCasedName -

Returns:

Ruby (under-score) cased named e.g. "get_foo_bar"

getJavaCasedName

public static String getJavaCasedName(String javaCasedName)

getRubyNamesForJavaName

public static Set<String> getRubyNamesForJavaName(String javaName,
                                  List<Method> methods)

Given a simple Java method name and the Java Method objects that represent all its overloads, add to the given nameSet all possible Ruby names that would be valid.

Parameters:

javaName -

methods -

Returns:

method names

convertArguments

public static Object[] convertArguments(IRubyObject[] args,
                        Class<?>[] types)

convertArguments

public static Object[] convertArguments(IRubyObject[] args,
                        Class<?>[] types,
                        int offset)

clone

public static <T> T clone(Object object)

Clone a Java object, assuming its class has an accessible clone method.

Parameters:

object -

Returns:

cloned object or null (if method is not found or inaccessible)

objectFromJavaProxy

public static Object objectFromJavaProxy(IRubyObject self)

getPrimitiveClass

public static Class<?> getPrimitiveClass(String name)

convertRubyToJava

@Deprecated
public static Object convertRubyToJava(IRubyObject rubyObject)

Deprecated.

convertRubyToJava

@Deprecated
public static Object convertRubyToJava(IRubyObject rubyObject,
                                  Class javaClass)

Deprecated.

convertRubyToJavaByte

@Deprecated
public static byte convertRubyToJavaByte(IRubyObject rubyObject)

Deprecated.

convertRubyToJavaShort

@Deprecated
public static short convertRubyToJavaShort(IRubyObject rubyObject)

Deprecated.

convertRubyToJavaChar

@Deprecated
public static char convertRubyToJavaChar(IRubyObject rubyObject)

Deprecated.

convertRubyToJavaInt

@Deprecated
public static int convertRubyToJavaInt(IRubyObject rubyObject)

Deprecated.

convertRubyToJavaLong

@Deprecated
public static long convertRubyToJavaLong(IRubyObject rubyObject)

Deprecated.

convertRubyToJavaFloat

@Deprecated
public static float convertRubyToJavaFloat(IRubyObject rubyObject)

Deprecated.

convertRubyToJavaDouble

@Deprecated
public static double convertRubyToJavaDouble(IRubyObject rubyObject)

Deprecated.

convertRubyToJavaBoolean

@Deprecated
public static boolean convertRubyToJavaBoolean(IRubyObject rubyObject)

Deprecated.

convertArgumentToType

@Deprecated
public static Object convertArgumentToType(ThreadContext context,
                                      IRubyObject arg,
                                      Class target)

Deprecated.

coerceNilToType

@Deprecated
public static Object coerceNilToType(RubyNil nil,
                                Class target)

Deprecated.

convertJavaToRuby

@Deprecated
public static IRubyObject convertJavaToRuby(Ruby runtime,
                                       JavaUtil.JavaConverter converter,
                                       Object object)

Deprecated.

getArrayConverter

@Deprecated
public static JavaUtil.RubyConverter getArrayConverter(Class type)

Deprecated.

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.

primitive_to_java

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

Deprecated.

convertArgument

@Deprecated
public static Object convertArgument(Ruby runtime,
                                Object argument,
                                Class<?> parameterType)

Deprecated.

java_to_ruby

@Deprecated
public static IRubyObject java_to_ruby(Ruby runtime,
                                  IRubyObject object)

Deprecated.

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

coerceStringToType

@Deprecated
public static Object coerceStringToType(RubyString string,
                                   Class target)

Deprecated.

coerceOtherToType

@Deprecated
public static Object coerceOtherToType(ThreadContext context,
                                  IRubyObject arg,
                                  Class target)

Deprecated.

coerceJavaObjectToType

@Deprecated
public static Object coerceJavaObjectToType(ThreadContext context,
                                       Object javaObject,
                                       Class target)

Deprecated.

unwrapJavaObject

@Deprecated
public static JavaObject unwrapJavaObject(Ruby runtime,
                                     IRubyObject convertee,
                                     String errorMessage)

Deprecated.