org.jruby.javasupport.proxy

Class JavaProxyClass

java.lang.Object

org.jruby.RubyBasicObject

org.jruby.RubyObject

org.jruby.javasupport.proxy.JavaProxyReflectionObject

org.jruby.javasupport.proxy.JavaProxyClass

All Implemented Interfaces:

java.io.Serializable, java.lang.Cloneable, java.lang.Comparable<IRubyObject>, InstanceVariables, InternalVariables, IRubyObject, CoreObjectType

public class JavaProxyClass
extends JavaProxyReflectionObject

Generalized proxy for classes and interfaces. API looks a lot like java.lang.reflect.Proxy, except that you can specify a super class in addition to a set of interfaces. The main implication for users of this class is to handle the case where a proxy method overrides an existing method, because in this case the invocation handler should "default" to calling the super implementation {JavaProxyMethod.invokeSuper}.

See Also:

Proxy, Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	JavaProxyClass.ProxyMethodImpl

Nested classes/interfaces inherited from class org.jruby.RubyObject

RubyObject.Data

Nested classes/interfaces inherited from class org.jruby.RubyBasicObject

RubyBasicObject.Finalizer

Field Summary

Fields

Modifier and Type	Field and Description
private JavaProxyConstructor[]	constructors
private static java.util.HashSet<java.lang.String>	EXCLUDE_METHODS
private static java.util.HashSet<java.lang.String>	EXCLUDE_MODULES
private java.util.HashMap<java.lang.String,java.util.ArrayList<JavaProxyMethod>>	methodMap
private java.util.ArrayList<JavaProxyMethod>	methods
private java.lang.Class	proxyClass
(package private) static java.lang.ThreadLocal<Ruby>	runtimeTLS

Fields inherited from class org.jruby.RubyObject

FIELD_ALLOCATED_CLASSES, FIELD_ALLOCATORS, IVAR_INSPECTING_OBJECT_ALLOCATOR, OBJECT_ALLOCATOR, OBJECT_VAR0_ALLOCATOR, OBJECT_VAR1_ALLOCATOR, OBJECT_VAR2_ALLOCATOR, OBJECT_VAR3_ALLOCATOR, OBJECT_VAR4_ALLOCATOR, OBJECT_VAR5_ALLOCATOR, OBJECT_VAR6_ALLOCATOR, OBJECT_VAR7_ALLOCATOR, OBJECT_VAR8_ALLOCATOR, OBJECT_VAR9_ALLOCATOR, REIFYING_OBJECT_ALLOCATOR

Fields inherited from class org.jruby.RubyBasicObject

ALL_F, BASICOBJECT_ALLOCATOR, COMPARE_BY_IDENTITY_F, ERR_INSECURE_SET_INST_VAR, FALSE_F, FL_USHIFT, flags, FROZEN_F, metaClass, NEVER, NIL_F, STAMP_OFFSET, TAINTED_F, UNDEF, UNTRUSTED_F, USER0_F, USER1_F, USER2_F, USER3_F, USER4_F, USER5_F, USER6_F, USER7_F, USER8_F, VAR_TABLE_OFFSET, varTable, varTableStamp

Fields inherited from interface org.jruby.runtime.builtin.IRubyObject

NULL_ARRAY

Constructor Summary

Constructors

Constructor and Description
JavaProxyClass(java.lang.Class<?> proxyClass)

Method Summary

Modifier and Type	Method and Description
RubyArray	constructors()
static RubyClass	createJavaProxyClassClass(Ruby runtime, RubyModule Java)
static void	createJavaProxyClasses(Ruby runtime, RubyModule Java)
static void	createJavaProxyModule(Ruby runtime) Deprecated.
boolean	equals(java.lang.Object other) This method is just a wrapper around the Ruby "==" method, provided so that RubyObjects can be used as keys in the Java HashMap object underlying RubyHash.
static RubyObject	get_with_class(IRubyObject recv, IRubyObject obj)
static RubyObject	get(IRubyObject self, IRubyObject obj)
JavaProxyConstructor	getConstructor(java.lang.Class[] args)
JavaProxyConstructor[]	getConstructors()
java.lang.Class[]	getInterfaces()
java.lang.Class	getJavaClass() Will return the Java interface that most closely can represent this object, when working through JAva integration translations.
JavaProxyMethod	getMethod(java.lang.String name, java.lang.Class[] parameterTypes)
JavaProxyMethod[]	getMethods()
(package private) java.lang.Class	getProxyClass() return the class of instances of this proxy class
static JavaProxyClass	getProxyClass(Ruby runtime, java.lang.Class superClass, java.lang.Class[] interfaces)
static JavaProxyClass	getProxyClass(Ruby runtime, java.lang.Class superClass, java.lang.Class[] interfaces, java.util.Set<java.lang.String> names)
java.lang.Class	getSuperclass()
private static Ruby	getThreadLocalRuntime()
java.lang.Object	getValue()
int	hashCode() Override the Object#hashCode method to make sure that the Ruby hash is actually used as the hashcode for Ruby objects.
(package private) JavaProxyMethod	initMethod(java.lang.String name, java.lang.String desc, boolean hasSuper)
RubyArray	interfaces()
RubyArray	methods()
java.lang.String	nameOnInspection()
static java.lang.Object	newProxyInstance(Ruby runtime, java.lang.Class superClass, java.lang.Class[] interfaces, java.lang.Class[] constructorParameters, java.lang.Object[] constructorArgs, JavaProxyInvocationHandler handler)
private static java.lang.Class[]	parse(java.lang.ClassLoader loader, java.lang.String desc)
RubyObject	superclass()

Methods inherited from class org.jruby.javasupport.proxy.JavaProxyReflectionObject

aref, aset, buildRubyArray, buildRubyArray, hash, is_java_proxy, java_class, java_type, length, op_eqq, op_equal, op_equal, registerRubyMethods, same, to_s, toRubyArray, toRubyArray, toString

Methods inherited from class org.jruby.RubyObject

attachToObjectSpace, callInit, callInit, callInit, callInit, callInit, callInit, callInit, callInit, callInit, callInit, convertToType, createObjectClass, eqlInternal, equalInternal, getNativeTypeIndex, initialize, initialize, inspect, puts, specificEval

Methods inherited from class org.jruby.RubyBasicObject

addFinalizer, anyToString, asJavaString, asString, callMethod, callMethod, callMethod, callMethod, callMethod, callMethod, callMethod, callMethod, callSuper, checkArrayType, checkCallMethod, checkFrozen, checkStringType, checkStringType19, compareTo, convertToArray, convertToFloat, convertToHash, convertToInteger, convertToInteger, convertToInteger, convertToString, copyInstanceVariablesInto, copySpecialInstanceVariables, createBasicObjectClass, dataGetStruct, dataGetStructChecked, dataWrapStruct, display, dup, ensureInstanceVariablesSettable, eql_p, eql, equal_p, equal_p19, evalUnder, extend, fastGetInstanceVariable, fastGetInternalVariable, fastHasInstanceVariable, fastHasInternalVariable, fastSetInstanceVariable, fastSetInternalVariable, freeze, frozen_p, getFFIHandle, getFlag, getInstanceEvalClass, getInstanceVariable, getInstanceVariableList, getInstanceVariableNameList, getInstanceVariables, getInternalVariable, getInternalVariables, getMetaClass, getNativeHandle, getObjectId, getRuntime, getSingletonClass, getSingletonClassClone, getType, getVariable, getVariableCount, getVariableList, getVariableNameList, hashyInspect, hasInstanceVariable, hasInternalVariable, hasVariables, id_deprecated, id, infectBy, initialize_copy, initialize19, inspect, inspectHashCode, instance_eval, instance_eval, instance_eval, instance_eval, instance_eval19, instance_eval19, instance_eval19, instance_eval19, instance_exec, instance_exec19, instance_of_p, instance_variable_defined_p, instance_variable_get, instance_variable_set, instance_variables, instance_variables19, isBuiltin, isClass, isFalse, isFrozen, isImmediate, isModule, isNil, isTaint, isTrue, isUntrusted, kind_of_p, makeMetaClass, method_missing19, method, method19, methods, methods, methods19, nil_p, op_cmp, op_equal_19, op_match, op_match19, op_not_equal, op_not_match, op_not, private_methods, private_methods19, protected_methods, protected_methods19, public_methods, public_methods19, rbClone, remove_instance_variable, removeFinalizers, removeInstanceVariable, removeInternalVariable, respond_to_p, respond_to_p, respond_to_p19, respond_to_p19, respondsTo, respondsToMissing, respondsToMissing, send, send, send, send, send, send19, send19, send19, send19, setFFIHandle, setFlag, setFrozen, setInstanceVariable, setInternalVariable, setMetaClass, setNativeHandle, setTaint, setUntrusted, setVariable, singleton_method_added19, singleton_method_removed19, singleton_method_undefined19, singleton_methods, singleton_methods19, specificEval, specificEval, specificEval, specificEval, syncVariables, syncVariables, taint, taint, tainted_p, testFrozen, testFrozen, to_a, toJava, trust, type_deprecated, type, untaint, untrust, untrusted_p, validateInstanceVariable, variableTableContains, variableTableFastContains, variableTableFastFetch, variableTableFastStore, variableTableFetch, variableTableRemove, variableTableStore, variableTableSync, yieldUnder, yieldUnder

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Field Detail

runtimeTLS

static java.lang.ThreadLocal<Ruby> runtimeTLS

proxyClass

private final java.lang.Class proxyClass

methods

private final java.util.ArrayList<JavaProxyMethod> methods

methodMap

private final java.util.HashMap<java.lang.String,java.util.ArrayList<JavaProxyMethod>> methodMap

constructors

private transient JavaProxyConstructor[] constructors

EXCLUDE_MODULES

private static final java.util.HashSet<java.lang.String> EXCLUDE_MODULES

EXCLUDE_METHODS

private static final java.util.HashSet<java.lang.String> EXCLUDE_METHODS

Constructor Detail

JavaProxyClass

JavaProxyClass(java.lang.Class<?> proxyClass)

Method Detail

equals

public boolean equals(java.lang.Object other)

Description copied from class: RubyObject

This method is just a wrapper around the Ruby "==" method, provided so that RubyObjects can be used as keys in the Java HashMap object underlying RubyHash.

Overrides:

equals in class JavaProxyReflectionObject

hashCode

public int hashCode()

Description copied from class: RubyObject

Override the Object#hashCode method to make sure that the Ruby hash is actually used as the hashcode for Ruby objects. If the Ruby "hash" method doesn't return a number, the Object#hashCode implementation will be used instead.

Overrides:

hashCode in class JavaProxyReflectionObject

getValue

public java.lang.Object getValue()

getThreadLocalRuntime

private static Ruby getThreadLocalRuntime()

getProxyClass

public static JavaProxyClass getProxyClass(Ruby runtime,
                                           java.lang.Class superClass,
                                           java.lang.Class[] interfaces,
                                           java.util.Set<java.lang.String> names)
                                    throws java.lang.reflect.InvocationTargetException

Throws:

java.lang.reflect.InvocationTargetException

getProxyClass

public static JavaProxyClass getProxyClass(Ruby runtime,
                                           java.lang.Class superClass,
                                           java.lang.Class[] interfaces)
                                    throws java.lang.reflect.InvocationTargetException

Throws:

java.lang.reflect.InvocationTargetException

newProxyInstance

public static java.lang.Object newProxyInstance(Ruby runtime,
                                                java.lang.Class superClass,
                                                java.lang.Class[] interfaces,
                                                java.lang.Class[] constructorParameters,
                                                java.lang.Object[] constructorArgs,
                                                JavaProxyInvocationHandler handler)
                                         throws java.lang.IllegalArgumentException,
                                                java.lang.InstantiationException,
                                                java.lang.IllegalAccessException,
                                                java.lang.reflect.InvocationTargetException,
                                                java.lang.SecurityException,
                                                java.lang.NoSuchMethodException

Throws:

java.lang.IllegalArgumentException

java.lang.InstantiationException

java.lang.IllegalAccessException

java.lang.reflect.InvocationTargetException

java.lang.SecurityException

java.lang.NoSuchMethodException

getSuperclass

public java.lang.Class getSuperclass()

getInterfaces

public java.lang.Class[] getInterfaces()

getConstructors

public JavaProxyConstructor[] getConstructors()

getConstructor

public JavaProxyConstructor getConstructor(java.lang.Class[] args)
                                    throws java.lang.SecurityException,
                                           java.lang.NoSuchMethodException

Throws:

java.lang.SecurityException

java.lang.NoSuchMethodException

getMethods

public JavaProxyMethod[] getMethods()

getMethod

public JavaProxyMethod getMethod(java.lang.String name,
                                 java.lang.Class[] parameterTypes)

getProxyClass

final java.lang.Class getProxyClass()

return the class of instances of this proxy class

getJavaClass

public java.lang.Class getJavaClass()

Description copied from class: RubyBasicObject

Will return the Java interface that most closely can represent this object, when working through JAva integration translations.

Specified by:

getJavaClass in interface IRubyObject

Overrides:

getJavaClass in class RubyBasicObject

Returns:

Class

initMethod

JavaProxyMethod initMethod(java.lang.String name,
                           java.lang.String desc,
                           boolean hasSuper)

parse

private static java.lang.Class[] parse(java.lang.ClassLoader loader,
                                       java.lang.String desc)
                                throws java.lang.ClassNotFoundException

Throws:

java.lang.ClassNotFoundException

createJavaProxyModule

@Deprecated
public static void createJavaProxyModule(Ruby runtime)

Deprecated.

createJavaProxyClasses

public static void createJavaProxyClasses(Ruby runtime,
                                          RubyModule Java)

createJavaProxyClassClass

public static RubyClass createJavaProxyClassClass(Ruby runtime,
                                                  RubyModule Java)

get

public static RubyObject get(IRubyObject self,
                             IRubyObject obj)

get_with_class

public static RubyObject get_with_class(IRubyObject recv,
                                        IRubyObject obj)

superclass

public RubyObject superclass()

methods

public RubyArray methods()

interfaces

public RubyArray interfaces()

constructors

public final RubyArray constructors()

nameOnInspection

public final java.lang.String nameOnInspection()