com.thoughtworks.proxy.kit

Class ReflectionUtils

java.lang.Object

com.thoughtworks.proxy.kit.ReflectionUtils

public class ReflectionUtils
extends java.lang.Object

Helper class for introspecting interface and class hierarchies.

Since:

0.2

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.reflect.Method	equals the Object.equals(Object) method.
static java.lang.reflect.Method	hashCode the Object.hashCode() method.
static java.lang.reflect.Method	toString the Object.toString() method.

Constructor Summary

Constructors

Modifier	Constructor and Description
private	ReflectionUtils() Constructor.

Method Summary

Modifier and Type	Method and Description
static void	addIfClassProxyingSupportedAndNotObject(java.lang.Class<?> type, java.util.Set<java.lang.Class<?>> interfaces, ProxyFactory proxyFactory) Add the given type to the set of interfaces, if the given ProxyFactory supports proxy generation for this type.
static java.util.Set<java.lang.Class<?>>	getAllInterfaces(java.lang.Class<?> type) Get all interfaces of the given type.
static java.util.Set<java.lang.Class<?>>	getAllInterfaces(java.lang.Object... objects) Get all the interfaces implemented by a list of objects.
private static void	getInterfaces(java.lang.Class<?> type, java.util.Set<java.lang.Class<?>> interfaces)
static java.lang.reflect.Method	getMatchingMethod(java.lang.Class<?> type, java.lang.String methodName, java.lang.Object[] args) Get the method of the given type, that has matching parameter types to the given arguments.
static java.lang.Class<?>	getMostCommonSuperclass(java.lang.Object... objects) Get most common superclass for all given objects.
static java.lang.Class<?>[]	makeTypesArray(java.lang.Class<?> primaryType, java.lang.Class<?>[] types) Create an array of types.
static java.lang.reflect.Method	readMethod(java.io.ObjectInputStream in) Read a Method from an ObjectInputStream.
static void	writeMethod(java.io.ObjectOutputStream out, java.lang.reflect.Method method) Write a Method into an ObjectOutputStream.

Methods inherited from class java.lang.Object

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

Field Detail

equals

public static final java.lang.reflect.Method equals

the Object.equals(Object) method.

hashCode

public static final java.lang.reflect.Method hashCode

the Object.hashCode() method.

toString

public static final java.lang.reflect.Method toString

the Object.toString() method.

Constructor Detail

ReflectionUtils

private ReflectionUtils()

Constructor. Do not call, it is a factory.

Method Detail

getAllInterfaces

public static java.util.Set<java.lang.Class<?>> getAllInterfaces(java.lang.Object... objects)

Get all the interfaces implemented by a list of objects.

Parameters:

objects - the list of objects to consider.

Returns:

an set of interfaces. The set may be empty

Since:

0.2

getAllInterfaces

public static java.util.Set<java.lang.Class<?>> getAllInterfaces(java.lang.Class<?> type)

Get all interfaces of the given type. If the type is a class, the returned set contains any interface, that is implemented by the class. If the type is an interface, the all superinterfaces and the interface itself are included.

Parameters:

type - type to explore.

Returns:

a Set with all interfaces. The set may be empty.

Since:

0.2

getInterfaces

private static void getInterfaces(java.lang.Class<?> type,
                                  java.util.Set<java.lang.Class<?>> interfaces)

getMostCommonSuperclass

public static java.lang.Class<?> getMostCommonSuperclass(java.lang.Object... objects)

Get most common superclass for all given objects.

Parameters:

objects - the array of objects to consider.

Returns:

the superclass or Void.class for an empty array.

Since:

0.2

addIfClassProxyingSupportedAndNotObject

public static void addIfClassProxyingSupportedAndNotObject(java.lang.Class<?> type,
                                                           java.util.Set<java.lang.Class<?>> interfaces,
                                                           ProxyFactory proxyFactory)

Add the given type to the set of interfaces, if the given ProxyFactory supports proxy generation for this type.

Parameters:

type - the class type (Object.class will be ignored)

interfaces - the set of interfaces

proxyFactory - the ProxyFactory in use

Since:

0.2

getMatchingMethod

public static java.lang.reflect.Method getMatchingMethod(java.lang.Class<?> type,
                                                         java.lang.String methodName,
                                                         java.lang.Object[] args)
                                                  throws java.lang.NoSuchMethodException

Get the method of the given type, that has matching parameter types to the given arguments.

Parameters:

type - the type

methodName - the name of the method to search

args - the arguments to match

Returns:

the matching Method

Throws:

java.lang.NoSuchMethodException - if no matching Method exists

Since:

0.2

writeMethod

public static void writeMethod(java.io.ObjectOutputStream out,
                               java.lang.reflect.Method method)
                        throws java.io.IOException

Write a Method into an ObjectOutputStream.

Parameters:

out - the stream

method - the Method to write

Throws:

java.io.IOException - if writing causes a problem

Since:

0.2

readMethod

public static java.lang.reflect.Method readMethod(java.io.ObjectInputStream in)
                                           throws java.io.IOException,
                                                  java.lang.ClassNotFoundException

Read a Method from an ObjectInputStream.

Parameters:

in - the stream

Returns:

the read Method

Throws:

java.io.IOException - if reading causes a problem

java.lang.ClassNotFoundException - if class types from objects of the InputStream cannot be found

java.io.InvalidObjectException - if the Method cannot be found

Since:

0.2

makeTypesArray

public static java.lang.Class<?>[] makeTypesArray(java.lang.Class<?> primaryType,
                                                  java.lang.Class<?>[] types)

Create an array of types.

Parameters:

primaryType - the primary types

types - the additional types (may be null)

Returns:

an array of all the given types with the primary type as first element

Since:

1.0