org.mases.jcobridge.netreflection

Class NetGenericHelper

java.lang.Object

org.mases.jcobridge.netreflection.NetGenericHelper

public final class NetGenericHelper
extends java.lang.Object

Helper for the generic classes that do not extend NetObject, such as the generic delegates.

It offers the same logic used by NetObject: it reads the type arguments from the anonymous subclass of a generic class (new Foo<Bar>() {}), builds the name of the closed CLR type and instantiates the type arguments reflectively.

Method Summary

Modifier and Type	Method and Description
static java.lang.String	buildClosedClrName(java.lang.String openClrName, java.lang.Class<?>[] typeArguments) Builds the name of a closed generic CLR type, for example System.Collections.Generic.List`1[System.Object].
static <X> X	instantiate(java.lang.Class<?>[] typeArguments, int index, java.lang.Object nativeHandle) Reflectively builds an instance of a type argument, wrapping a native handle returned from the bridge.
static java.lang.Class<?>[]	resolveTypeArguments(java.lang.Class<?> instanceClass) Returns the type arguments captured by the anonymous subclass, as in new Foo<Bar>() {}.

Methods inherited from class java.lang.Object

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

Method Detail

buildClosedClrName

public static java.lang.String buildClosedClrName(java.lang.String openClrName,
                                                  java.lang.Class<?>[] typeArguments)

Builds the name of a closed generic CLR type, for example System.Collections.Generic.List`1[System.Object]. The name of each type argument is read from its public static className field.

Parameters:

openClrName - the name of the open generic type, for example System.Collections.Generic.List`1

typeArguments - the classes of the type arguments

Returns:

the name of the closed generic type

Throws:

java.lang.IllegalArgumentException - if a type argument does not expose a public static className field

instantiate

public static <X> X instantiate(java.lang.Class<?>[] typeArguments,
                                int index,
                                java.lang.Object nativeHandle)
                         throws java.lang.Throwable

Reflectively builds an instance of a type argument, wrapping a native handle returned from the bridge. It uses the public constructor of the type argument that accepts a single Object.

Type Parameters:

X - the type of the instance to build

Parameters:

typeArguments - the classes of the type arguments

index - the position of the type argument to instantiate

nativeHandle - the native object returned from the bridge

Returns:

the new instance of the type argument

Throws:

java.lang.Throwable - if the type argument has no public constructor accepting a single Object, or if that constructor fails

resolveTypeArguments

public static java.lang.Class<?>[] resolveTypeArguments(java.lang.Class<?> instanceClass)

Returns the type arguments captured by the anonymous subclass, as in new Foo<Bar>() {}. The result is cached for each class.

Parameters:

instanceClass - the class of the instance: it must be an anonymous subclass of a generic class

Returns:

the classes of the type arguments, in declaration order

Throws:

java.lang.IllegalArgumentException - if the instance was not created with the anonymous subclass syntax, or if a type argument is not a plain class