Class MemberMatcher
- java.lang.Object
-
- org.powermock.api.support.membermodification.MemberMatcher
-
- Direct Known Subclasses:
MemberModifier
public class MemberMatcher extends java.lang.Object
Finds members in classes.
-
-
Constructor Summary
Constructors Constructor Description MemberMatcher()
-
Method Summary
All Methods Static Methods Concrete Methods Modifier and Type Method Description static <T> java.lang.reflect.Constructor<T>
constructor(java.lang.Class<T> declaringClass)
Returns any one constructor specified in declaringClass.static <T> java.lang.reflect.Constructor<T>
constructor(java.lang.Class<T> declaringClass, java.lang.Class<?>... parameterTypes)
Returns a constructor specified in declaringClass.static java.lang.reflect.Constructor<?>[]
constructors(java.lang.reflect.Constructor<?> constructor, java.lang.reflect.Constructor<?>... additionalConstructors)
Convenience method to get a constructor from a class.static java.lang.reflect.Constructor<?>[]
constructorsDeclaredIn(java.lang.Class<?> cls, java.lang.Class<?>... additionalClasses)
Get all constructors in the supplied class(es).static <T> java.lang.reflect.Constructor<T>
defaultConstructorIn(java.lang.Class<T> declaringClass)
Returns the default constructor indeclaringClass
static java.lang.reflect.AccessibleObject[]
everythingDeclaredIn(java.lang.Class<?> cls, java.lang.Class<?>... additionalClasses)
Get all constructors and methods in the supplied class(es).static java.lang.reflect.Field
field(java.lang.Class<?> declaringClass, java.lang.String fieldName)
Get a field from a class.static java.lang.reflect.Field[]
fields(java.lang.Class<?> clazz)
Get all fields in a class hierarchy.static java.lang.reflect.Field[]
fields(java.lang.Class<?> clazz, java.lang.String[] fieldNames)
Get an array ofField
's that matches the supplied list of field names.static java.lang.reflect.Field[]
fields(java.lang.Class<?> clazz, java.lang.String firstFieldName, java.lang.String... additionalfieldNames)
Get an array ofField
's that matches the supplied list of field names.static java.lang.reflect.Field[]
fields(java.lang.reflect.Field field, java.lang.reflect.Field... additionalFields)
Get an array ofField
's.private static java.lang.reflect.Constructor<?>[]
merge(java.lang.reflect.Constructor<?> first, java.lang.reflect.Constructor<?>... additional)
private static java.lang.reflect.Field[]
merge(java.lang.reflect.Field first, java.lang.reflect.Field... additional)
private static java.lang.reflect.Method[]
merge(java.lang.reflect.Method first, java.lang.reflect.Method... additional)
private static java.lang.String[]
merge(java.lang.String first, java.lang.String... additional)
static java.lang.reflect.Method
method(java.lang.Class<?> declaringClass, java.lang.Class<?>... parameterTypes)
Get a method without having to specify the method name.static java.lang.reflect.Method
method(java.lang.Class<?> declaringClass, java.lang.String methodName, java.lang.Class<?>... parameterTypes)
Get a method when it cannot be determined by methodName or parameter types only.static java.lang.reflect.Method[]
methods(java.lang.Class<?> clazz, java.lang.String[] methodNames)
Get an array ofMethod
's that matches the supplied list of method names.static java.lang.reflect.Method[]
methods(java.lang.Class<?> clazz, java.lang.String methodName, java.lang.String... additionalMethodNames)
Get an array ofMethod
's that matches the supplied list of method names.static java.lang.reflect.Method[]
methods(java.lang.reflect.Method method, java.lang.reflect.Method... additionalMethods)
Get an array ofField
's.static java.lang.reflect.Method[]
methodsDeclaredIn(java.lang.Class<?> cls, java.lang.Class<?>... additionalClasses)
Get all methods in a class hierarchy of the supplied classes.
-
-
-
Method Detail
-
methodsDeclaredIn
public static java.lang.reflect.Method[] methodsDeclaredIn(java.lang.Class<?> cls, java.lang.Class<?>... additionalClasses)
Get all methods in a class hierarchy of the supplied classes. Both declared an non-declared (no duplicates).- Parameters:
cls
- The class whose methods to get.additionalClasses
- Additional classes whose methods to get.- Returns:
- All methods declared in this class hierarchy.
-
method
public static java.lang.reflect.Method method(java.lang.Class<?> declaringClass, java.lang.String methodName, java.lang.Class<?>... parameterTypes)
Get a method when it cannot be determined by methodName or parameter types only.The method will first try to look for a declared method in the same class. If the method is not declared in this class it will look for the method in the super class. This will continue throughout the whole class hierarchy. If the method is not found an
IllegalArgumentException
is thrown.- Parameters:
declaringClass
- The declaringClass of the class where the method is located.methodName
- The method names.parameterTypes
- All parameter types of the method (may benull
).- Returns:
- A
java.lang.reflect.Method
. - Throws:
MethodNotFoundException
- If a method cannot be found in the hierarchy.
-
method
public static java.lang.reflect.Method method(java.lang.Class<?> declaringClass, java.lang.Class<?>... parameterTypes)
Get a method without having to specify the method name.The method will first try to look for a declared method in the same class. If the method is not declared in this class it will look for the method in the super class. This will continue throughout the whole class hierarchy. If the method is not found an
IllegalArgumentException
is thrown. Since the method name is not specified anIllegalArgumentException
is thrown if two or more methods matches the same parameter types in the same class.- Parameters:
declaringClass
- The declaringClass of the class where the method is located.parameterTypes
- All parameter types of the method (may benull
).- Returns:
- A
java.lang.reflect.Method
. - Throws:
MethodNotFoundException
- If a method cannot be found in the hierarchy.TooManyMethodsFoundException
- If several methods were found.
-
methods
public static java.lang.reflect.Method[] methods(java.lang.Class<?> clazz, java.lang.String methodName, java.lang.String... additionalMethodNames)
Get an array ofMethod
's that matches the supplied list of method names. Both instance and static methods are taken into account.- Parameters:
clazz
- The class that should contain the methods.methodName
- The name of the first method.additionalMethodNames
- Additional names of the methods that will be returned.- Returns:
- An array of Method's. May be of length 0 but not
null
. - Throws:
MethodNotFoundException
- If no method was found.
-
methods
public static java.lang.reflect.Method[] methods(java.lang.reflect.Method method, java.lang.reflect.Method... additionalMethods)
Get an array ofField
's.- Parameters:
method
- The first field.additionalMethods
- Additional fields- Returns:
- An array of
Field
.
-
methods
public static java.lang.reflect.Method[] methods(java.lang.Class<?> clazz, java.lang.String[] methodNames)
Get an array ofMethod
's that matches the supplied list of method names. Both instance and static methods are taken into account.- Parameters:
clazz
- The class that should contain the methods.methodNames
- The names of the methods.- Returns:
- An array of Method's. May be of length 0 but not
null
. - Throws:
MethodNotFoundException
- If no method was found.
-
field
public static java.lang.reflect.Field field(java.lang.Class<?> declaringClass, java.lang.String fieldName)
Get a field from a class.The method will first try to look for a declared field in the same class. If the method is not declared in this class it will look for the field in the super class. This will continue throughout the whole class hierarchy. If the field is not found an
IllegalArgumentException
is thrown.- Parameters:
declaringClass
- The declaringClass of the class where the method is located.fieldName
- The method names.- Returns:
- A
java.lang.reflect.Field
. - Throws:
FieldNotFoundException
- If a field cannot be found in the hierarchy.
-
fields
public static java.lang.reflect.Field[] fields(java.lang.Class<?> clazz, java.lang.String firstFieldName, java.lang.String... additionalfieldNames)
Get an array ofField
's that matches the supplied list of field names.- Parameters:
clazz
- The class that should contain the fields.firstFieldName
- The name of the first field.additionalfieldNames
- The additional names of the fields that will be returned.- Returns:
- An array of Field's. May be of length 0 but not
null
-
fields
public static java.lang.reflect.Field[] fields(java.lang.Class<?> clazz)
Get all fields in a class hierarchy.- Parameters:
clazz
- The class that should contain the fields.firstFieldName
- The name of the first field.additionalfieldNames
- The additional names of the fields that will be returned.- Returns:
- An array of Field's. May be of length 0 but not
null
-
fields
public static java.lang.reflect.Field[] fields(java.lang.reflect.Field field, java.lang.reflect.Field... additionalFields)
Get an array ofField
's.- Parameters:
field
- The first field.additionalFields
- Additional fields- Returns:
- An array of
Field
.
-
fields
public static java.lang.reflect.Field[] fields(java.lang.Class<?> clazz, java.lang.String[] fieldNames)
Get an array ofField
's that matches the supplied list of field names.- Parameters:
clazz
- The class that should contain the fields.fieldNames
- The names of the fields that will be returned.- Returns:
- An array of Field's. May be of length 0 but not
null
-
constructor
public static <T> java.lang.reflect.Constructor<T> constructor(java.lang.Class<T> declaringClass, java.lang.Class<?>... parameterTypes)
Returns a constructor specified in declaringClass.- Parameters:
declaringClass
- The declaringClass of the class where the constructor is located.parameterTypes
- All parameter types of the constructor (may benull
).- Returns:
- A
java.lang.reflect.Constructor
. - Throws:
ConstructorNotFoundException
- if the constructor cannot be found.
-
constructor
public static <T> java.lang.reflect.Constructor<T> constructor(java.lang.Class<T> declaringClass)
Returns any one constructor specified in declaringClass. Is is useful when you only have ONE constructor declared indeclaringClass
but you don't care which parameters it take.- Parameters:
declaringClass
- The declaringClass of the class where the constructor is located.- Returns:
- A
java.lang.reflect.Constructor
. - Throws:
TooManyConstructorsFoundException
- If more than one constructor was present indeclaringClass
-
defaultConstructorIn
public static <T> java.lang.reflect.Constructor<T> defaultConstructorIn(java.lang.Class<T> declaringClass)
Returns the default constructor indeclaringClass
- Parameters:
declaringClass
- The declaringClass of the class where the constructor is located.- Returns:
- A
java.lang.reflect.Constructor
. - Throws:
ConstructorNotFoundException
- If no default constructor was found indeclaringClass
-
constructorsDeclaredIn
public static java.lang.reflect.Constructor<?>[] constructorsDeclaredIn(java.lang.Class<?> cls, java.lang.Class<?>... additionalClasses)
Get all constructors in the supplied class(es).- Parameters:
cls
- The class whose constructors to get.additionalClasses
- Additional classes whose constructors to get.- Returns:
- All constructors declared in this class.
-
constructors
public static java.lang.reflect.Constructor<?>[] constructors(java.lang.reflect.Constructor<?> constructor, java.lang.reflect.Constructor<?>... additionalConstructors)
Convenience method to get a constructor from a class.- Parameters:
constructor
- The first constructor.additionalConstructors
- Additional constructors- Returns:
- An array of
java.lang.reflect.Constructor
.
-
everythingDeclaredIn
public static java.lang.reflect.AccessibleObject[] everythingDeclaredIn(java.lang.Class<?> cls, java.lang.Class<?>... additionalClasses)
Get all constructors and methods in the supplied class(es).- Parameters:
cls
- The class whose constructors and methods to get.additionalClasses
- Additional classes whose constructors and methods to get.- Returns:
- All constructors and methods declared in this class.
-
merge
private static java.lang.String[] merge(java.lang.String first, java.lang.String... additional)
-
merge
private static java.lang.reflect.Method[] merge(java.lang.reflect.Method first, java.lang.reflect.Method... additional)
-
merge
private static java.lang.reflect.Field[] merge(java.lang.reflect.Field first, java.lang.reflect.Field... additional)
-
merge
private static java.lang.reflect.Constructor<?>[] merge(java.lang.reflect.Constructor<?> first, java.lang.reflect.Constructor<?>... additional)
-
-