com.goldencode.p2j.util

Class ReflectionHelper

java.lang.Object

com.goldencode.p2j.util.ReflectionHelper

public final class ReflectionHelper
extends java.lang.Object

Utility methods to ease or replace use of J2SE reflection.

Constructor Summary

Constructors

Modifier	Constructor and Description
private	ReflectionHelper() Private constructor to prevent instances of this class from being created.

Method Summary

Modifier and Type	Method and Description
static java.lang.String	simpleName(java.lang.String full) Removes all text up to and including the last '.' in the given string and returns the remaining text.
static boolean	testSignature(java.lang.Class[] possible, java.lang.Class[] actual) Compare signatures as described by two arrays of classes and report if they are equivalent.
static java.lang.String	toStringSignature(java.lang.String name, java.lang.Class[] parms, java.lang.Class returnType) Create a string representing the signature of the described method.

Methods inherited from class java.lang.Object

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

Constructor Detail

ReflectionHelper

private ReflectionHelper()

Private constructor to prevent instances of this class from being created.

Method Detail

testSignature

public static boolean testSignature(java.lang.Class[] possible,
                                    java.lang.Class[] actual)

Compare signatures as described by two arrays of classes and report if they are equivalent. This is useful because the J2SE 1.4.x reflection services Class.getConstructor() and Class.getMethod() don't check for assignability so a signature based on child classes won't match a compatible signature that uses super classes. The J2SE implementation uses a reference comparison but this method uses isAssignableFrom.

A quick return occurs in any case where the number of parameters in the signatures are different.

Parameters:

possible - The candidate signature list.

actual - The signature being searched for.

Returns:

true if the signatures are compatible.

simpleName

public static java.lang.String simpleName(java.lang.String full)

Removes all text up to and including the last '.' in the given string and returns the remaining text. Some simple attempts are made to detect if this is a J2SE signature string instead of a fully qualified class or method name. In such a case the entire text is returned.

Parameters:

full - A fully qualified class or method name.

Returns:

The simple name or the full text if no '.' qualifiers exist or if this is detected as a J2SE encoded signature string.

toStringSignature

public static java.lang.String toStringSignature(java.lang.String name,
                                                 java.lang.Class[] parms,
                                                 java.lang.Class returnType)

Create a string representing the signature of the described method.

No modifiers are known so there will be no text like public or static in the result.

Parameters:

name - The method name, inserted verbetim into the result.

parms - The list of parameters. If null or 0 length, then there are no parameters in the signature.

returnType - The type the method returns. Use null to indicate that the return type is unknown or irrelevent. Use void.class for a void return.

Returns:

The signature string without any modifiers.