/*
 * Copyright 2014 - 2020 Rafael Winterhalter
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */
package net.bytebuddy.matcher;

import net.bytebuddy.description.ByteCodeElement;
import net.bytebuddy.description.ModifierReviewable;
import net.bytebuddy.description.NamedElement;
import net.bytebuddy.description.annotation.AnnotationDescription;
import net.bytebuddy.description.annotation.AnnotationList;
import net.bytebuddy.description.annotation.AnnotationSource;
import net.bytebuddy.description.field.FieldDescription;
import net.bytebuddy.description.field.FieldList;
import net.bytebuddy.description.method.MethodDescription;
import net.bytebuddy.description.method.MethodList;
import net.bytebuddy.description.method.ParameterDescription;
import net.bytebuddy.description.method.ParameterList;
import net.bytebuddy.description.type.TypeDefinition;
import net.bytebuddy.description.type.TypeDescription;
import net.bytebuddy.description.type.TypeList;
import net.bytebuddy.utility.JavaModule;

import java.lang.annotation.Annotation;
import java.lang.annotation.ElementType;
import java.lang.reflect.Constructor;
import java.lang.reflect.Field;
import java.lang.reflect.Method;
import java.lang.reflect.Type;
import java.util.*;
import java.util.concurrent.ConcurrentHashMap;
import java.util.concurrent.ConcurrentMap;

A utility class that contains a human-readable language for creating ElementMatchers.
/** * A utility class that contains a human-readable language for creating {@link net.bytebuddy.matcher.ElementMatcher}s. */
public final class ElementMatchers {
A readable reference to the bootstrap class loader which is represented by null.
/** * A readable reference to the bootstrap class loader which is represented by {@code null}. */
private static final ClassLoader BOOTSTRAP_CLASSLOADER = null;
A private constructor that must not be invoked.
/** * A private constructor that must not be invoked. */
private ElementMatchers() { throw new UnsupportedOperationException("This class is a utility class and not supposed to be instantiated"); }
Wraps another matcher to assure that an element is not matched in case that the matching causes an Exception.
Params:
  • matcher – The element matcher that potentially throws an exception.
Type parameters:
  • <T> – The type of the matched object.
Returns:A matcher that returns false in case that the given matcher throws an exception.
/** * Wraps another matcher to assure that an element is not matched in case that the matching causes an {@link Exception}. * * @param matcher The element matcher that potentially throws an exception. * @param <T> The type of the matched object. * @return A matcher that returns {@code false} in case that the given matcher throws an exception. */
public static <T> ElementMatcher.Junction<T> failSafe(ElementMatcher<? super T> matcher) { return new FailSafeMatcher<T>(matcher, false); }

Wraps another matcher but caches the result of previously matched elements. Caching can be important if a matcher requires expensive calculations.

Warning: The supplied map can however introduce a memory leak as the matched elements are stored within the map. It is therefore important to dereference this matcher at some point or to regularly evict entries from the supplied map.

Params:
  • matcher – The actual matcher for which the results are cached.
  • map – The map for storing results of previously matched elements.
Type parameters:
  • <T> – The type of the matched object.
Returns:A matcher that stores the results of a previous matching in the supplied map.
/** * <p> * Wraps another matcher but caches the result of previously matched elements. Caching can be important if a * matcher requires expensive calculations. * </p> * <p> * <b>Warning</b>: The supplied map can however introduce a memory leak as the matched elements are stored within the map. * It is therefore important to dereference this matcher at some point or to regularly evict entries from the supplied map. * </p> * * @param matcher The actual matcher for which the results are cached. * @param map The map for storing results of previously matched elements. * @param <T> The type of the matched object. * @return A matcher that stores the results of a previous matching in the supplied map. */
public static <T> ElementMatcher.Junction<T> cached(ElementMatcher<? super T> matcher, ConcurrentMap<? super T, Boolean> map) { return new CachingMatcher<T>(matcher, map); }

Wraps another matcher but caches the result of previously matched elements. Caching can be important if a matcher requires expensive calculations.

Warning: The cache will hold evictionSize elements and evict a random element once the cache contains more than the specified amount of elements. Cached elements are referenced strongly and might cause a memory leak if instance are of a significant size. Using cached(ElementMatcher<? super Object>, ConcurrentMap<? super Object,Boolean>) allows for explicit control over cache eviction.

Params:
  • matcher – The actual matcher for which the results are cached.
  • evictionSize – The maximum amount of elements that are stored in the cache. Must be a positive number.
Type parameters:
  • <T> – The type of the matched object.
Returns:A matcher that stores the results of a previous matching in the supplied map.
/** * <p> * Wraps another matcher but caches the result of previously matched elements. Caching can be important if a * matcher requires expensive calculations. * </p> * <p> * <b>Warning</b>: The cache will hold {@code evictionSize} elements and evict a random element once the cache * contains more than the specified amount of elements. Cached elements are referenced strongly and might cause * a memory leak if instance are of a significant size. Using {@link ElementMatchers#cached(ElementMatcher, ConcurrentMap)} * allows for explicit control over cache eviction. * </p> * * @param matcher The actual matcher for which the results are cached. * @param evictionSize The maximum amount of elements that are stored in the cache. Must be a positive number. * @param <T> The type of the matched object. * @return A matcher that stores the results of a previous matching in the supplied map. */
public static <T> ElementMatcher.Junction<T> cached(ElementMatcher<? super T> matcher, int evictionSize) { if (evictionSize < 1) { throw new IllegalArgumentException("Eviction size must be a positive number: " + evictionSize); } return new CachingMatcher.WithInlineEviction<T>(matcher, new ConcurrentHashMap<T, Boolean>(), evictionSize); }
Matches the given value which can also be null by the Object.equals(Object) method or by a null-check.
Params:
  • value – The value that is to be matched.
Type parameters:
  • <T> – The type of the matched object.
Returns:A matcher that matches an exact value.
/** * Matches the given value which can also be {@code null} by the {@link java.lang.Object#equals(Object)} method or * by a null-check. * * @param value The value that is to be matched. * @param <T> The type of the matched object. * @return A matcher that matches an exact value. */
public static <T> ElementMatcher.Junction<T> is(Object value) { return value == null ? new NullMatcher<T>() : new EqualityMatcher<T>(value); }
Exactly matches a given field as a FieldDescription in its defined shape.
Params:
  • field – The field to match by its description
Type parameters:
  • <T> – The type of the matched object.
Returns:An element matcher that exactly matches the given field in its defined shape.
/** * Exactly matches a given field as a {@link FieldDescription} in its defined shape. * * @param field The field to match by its description * @param <T> The type of the matched object. * @return An element matcher that exactly matches the given field in its defined shape. */
public static <T extends FieldDescription> ElementMatcher.Junction<T> is(Field field) { return is(new FieldDescription.ForLoadedField(field)); }
Exactly matches a given field as a FieldDescription in its defined shape.
Params:
  • field – The field to match by its description
Type parameters:
  • <T> – The type of the matched object.
Returns:An element matcher that exactly matches the given field in its defined shape.
/** * Exactly matches a given field as a {@link FieldDescription} in its defined shape. * * @param field The field to match by its description * @param <T> The type of the matched object. * @return An element matcher that exactly matches the given field in its defined shape. */
public static <T extends FieldDescription> ElementMatcher.Junction<T> is(FieldDescription.InDefinedShape field) { return definedField(new EqualityMatcher<FieldDescription.InDefinedShape>(field)); }
Matches a field in its defined shape.
Params:
  • matcher – The matcher to apply to the matched field's defined shape.
Type parameters:
  • <T> – The matched object's type.
Returns:A matcher that matches a matched field's defined shape.
/** * Matches a field in its defined shape. * * @param matcher The matcher to apply to the matched field's defined shape. * @param <T> The matched object's type. * @return A matcher that matches a matched field's defined shape. */
public static <T extends FieldDescription> ElementMatcher.Junction<T> definedField(ElementMatcher<? super FieldDescription.InDefinedShape> matcher) { return new DefinedShapeMatcher<T, FieldDescription.InDefinedShape>(matcher); }
Exactly matches a given method as a MethodDescription in its defined shape.
Params:
  • method – The method to match by its description
Type parameters:
  • <T> – The type of the matched object.
Returns:An element matcher that exactly matches the given method in its defined shape.
/** * Exactly matches a given method as a {@link MethodDescription} in its defined shape. * * @param method The method to match by its description * @param <T> The type of the matched object. * @return An element matcher that exactly matches the given method in its defined shape. */
public static <T extends MethodDescription> ElementMatcher.Junction<T> is(Method method) { return is(new MethodDescription.ForLoadedMethod(method)); }
Exactly matches a given constructor as a MethodDescription in its defined shape.
Params:
  • constructor – The constructor to match by its description
Type parameters:
  • <T> – The type of the matched object.
Returns:An element matcher that exactly matches the given constructor in its defined shape.
/** * Exactly matches a given constructor as a {@link MethodDescription} in its defined shape. * * @param constructor The constructor to match by its description * @param <T> The type of the matched object. * @return An element matcher that exactly matches the given constructor in its defined shape. */
public static <T extends MethodDescription> ElementMatcher.Junction<T> is(Constructor<?> constructor) { return is(new MethodDescription.ForLoadedConstructor(constructor)); }
Exactly matches a given method or constructor as a MethodDescription in its defined shape.
Params:
  • method – The method to match by its description
Type parameters:
  • <T> – The type of the matched object.
Returns:An element matcher that exactly matches the given method or constructor in its defined shape.
/** * Exactly matches a given method or constructor as a {@link MethodDescription} in its defined shape. * * @param method The method to match by its description * @param <T> The type of the matched object. * @return An element matcher that exactly matches the given method or constructor in its defined shape. */
public static <T extends MethodDescription> ElementMatcher.Junction<T> is(MethodDescription.InDefinedShape method) { return definedMethod(new EqualityMatcher<MethodDescription.InDefinedShape>(method)); }
Matches a method in its defined shape.
Params:
  • matcher – The matcher to apply to the matched method's defined shape.
Type parameters:
  • <T> – The matched object's type.
Returns:A matcher that matches a matched method's defined shape.
/** * Matches a method in its defined shape. * * @param matcher The matcher to apply to the matched method's defined shape. * @param <T> The matched object's type. * @return A matcher that matches a matched method's defined shape. */
public static <T extends MethodDescription> ElementMatcher.Junction<T> definedMethod(ElementMatcher<? super MethodDescription.InDefinedShape> matcher) { return new DefinedShapeMatcher<T, MethodDescription.InDefinedShape>(matcher); }
Exactly matches a given parameter as a ParameterDescription in its defined shape.
Params:
  • parameter – The parameter to match by its description
Type parameters:
  • <T> – The type of the matched object.
Returns:An element matcher that exactly matches the given parameter in its defined shape.
/** * Exactly matches a given parameter as a {@link ParameterDescription} in its defined shape. * * @param parameter The parameter to match by its description * @param <T> The type of the matched object. * @return An element matcher that exactly matches the given parameter in its defined shape. */
public static <T extends ParameterDescription> ElementMatcher.Junction<T> is(ParameterDescription.InDefinedShape parameter) { return definedParameter(new EqualityMatcher<ParameterDescription.InDefinedShape>(parameter)); }
Matches a parameter in its defined shape.
Params:
  • matcher – The matcher to apply to the matched parameter's defined shape.
Type parameters:
  • <T> – The matched object's type.
Returns:A matcher that matches a matched parameter's defined shape.
/** * Matches a parameter in its defined shape. * * @param matcher The matcher to apply to the matched parameter's defined shape. * @param <T> The matched object's type. * @return A matcher that matches a matched parameter's defined shape. */
public static <T extends ParameterDescription> ElementMatcher.Junction<T> definedParameter(ElementMatcher<? super ParameterDescription.InDefinedShape> matcher) { return new DefinedShapeMatcher<T, ParameterDescription.InDefinedShape>(matcher); }
Matches a parameter's type by the given matcher.
Params:
  • matcher – The matcher to apply to the parameter's type.
Type parameters:
  • <T> – The type of the matched object.
Returns:A matcher that matches a parameter's type by the given matcher.
/** * Matches a parameter's type by the given matcher. * * @param matcher The matcher to apply to the parameter's type. * @param <T> The type of the matched object. * @return A matcher that matches a parameter's type by the given matcher. */
public static <T extends ParameterDescription> ElementMatcher.Junction<T> hasType(ElementMatcher<? super TypeDescription> matcher) { return hasGenericType(erasure(matcher)); }
Matches a method parameter by its generic type.
Params:
  • matcher – The matcher to apply to a parameter's generic type.
Type parameters:
  • <T> – The type of the matched object.
Returns:A matcher that matches the matched parameter's generic type.
/** * Matches a method parameter by its generic type. * * @param matcher The matcher to apply to a parameter's generic type. * @param <T> The type of the matched object. * @return A matcher that matches the matched parameter's generic type. */
public static <T extends ParameterDescription> ElementMatcher.Junction<T> hasGenericType(ElementMatcher<? super TypeDescription.Generic> matcher) { return new MethodParameterTypeMatcher<T>(matcher); }
Matches a parameter description for a mandated parameter.
Type parameters:
  • <T> – The type of the matched object.
Returns:A matcher for a mandated parameter.
/** * Matches a parameter description for a {@code mandated} parameter. * * @param <T> The type of the matched object. * @return A matcher for a {@code mandated} parameter. */
public static <T extends ParameterDescription> ElementMatcher.Junction<T> isMandated() { return new ModifierMatcher<T>(ModifierMatcher.Mode.MANDATED); }
Exactly matches a given type as a TypeDescription.
Params:
  • type – The type to match by its description
Type parameters:
  • <T> – The type of the matched object.
Returns:An element matcher that exactly matches the given type.
/** * Exactly matches a given type as a {@link TypeDescription}. * * @param type The type to match by its description * @param <T> The type of the matched object. * @return An element matcher that exactly matches the given type. */
public static <T extends TypeDefinition> ElementMatcher.Junction<T> is(Type type) { return is(TypeDefinition.Sort.describe(type)); }
Exactly matches a given annotation as an AnnotationDescription.
Params:
  • annotation – The annotation to match by its description.
Type parameters:
  • <T> – The type of the matched object.
Returns:An element matcher that exactly matches the given annotation.
/** * Exactly matches a given annotation as an {@link AnnotationDescription}. * * @param annotation The annotation to match by its description. * @param <T> The type of the matched object. * @return An element matcher that exactly matches the given annotation. */
public static <T extends AnnotationDescription> ElementMatcher.Junction<T> is(Annotation annotation) { return is(AnnotationDescription.ForLoadedAnnotation.of(annotation)); }
Inverts another matcher.
Params:
  • matcher – The matcher to invert.
Type parameters:
  • <T> – The type of the matched object.
Returns:An inverted version of the given matcher.
/** * Inverts another matcher. * * @param matcher The matcher to invert. * @param <T> The type of the matched object. * @return An inverted version of the given {@code matcher}. */
public static <T> ElementMatcher.Junction<T> not(ElementMatcher<? super T> matcher) { return new NegatingMatcher<T>(matcher); }
Creates a matcher that always returns true.
Type parameters:
  • <T> – The type of the matched object.
Returns:A matcher that matches anything.
/** * Creates a matcher that always returns {@code true}. * * @param <T> The type of the matched object. * @return A matcher that matches anything. */
public static <T> ElementMatcher.Junction<T> any() { return new BooleanMatcher<T>(true); }
Creates a matcher that always returns false.
Type parameters:
  • <T> – The type of the matched object.
Returns:A matcher that matches nothing.
/** * Creates a matcher that always returns {@code false}. * * @param <T> The type of the matched object. * @return A matcher that matches nothing. */
public static <T> ElementMatcher.Junction<T> none() { return new BooleanMatcher<T>(false); }

Creates a matcher that matches any of the given objects by the Object.equals(Object) method. None of the values must be null.

Important: This method cannot be used interchangeably with any of its overloaded versions which also apply a type conversion.

Params:
  • value – The input values to be compared against.
Type parameters:
  • <T> – The type of the matched object.
Returns:A matcher that checks for the equality with any of the given objects.
/** * <p> * Creates a matcher that matches any of the given objects by the {@link java.lang.Object#equals(Object)} method. * None of the values must be {@code null}. * </p> * <p> * <b>Important</b>: This method cannot be used interchangeably with any of its overloaded versions which also apply a type * conversion. * </p> * * @param value The input values to be compared against. * @param <T> The type of the matched object. * @return A matcher that checks for the equality with any of the given objects. */
public static <T> ElementMatcher.Junction<T> anyOf(Object... value) { return anyOf(Arrays.asList(value)); }

Creates a matcher that matches any of the given objects by the Object.equals(Object) method. None of the values must be null.

Important: This method cannot be used interchangeably with any of the overloaded versions of anyOf(Object...) which also apply a type conversion.

Params:
  • values – The input values to be compared against.
Type parameters:
  • <T> – The type of the matched object.
Returns:A matcher that checks for the equality with any of the given objects.
/** * <p> * Creates a matcher that matches any of the given objects by the {@link java.lang.Object#equals(Object)} method. * None of the values must be {@code null}. * </p> * <p> * <b>Important</b>: This method cannot be used interchangeably with any of the overloaded versions of {@link ElementMatchers#anyOf(Object...)} * which also apply a type conversion. * </p> * * @param values The input values to be compared against. * @param <T> The type of the matched object. * @return A matcher that checks for the equality with any of the given objects. */
public static <T> ElementMatcher.Junction<T> anyOf(Iterable<?> values) { ElementMatcher.Junction<T> matcher = null; for (Object value : values) { matcher = matcher == null ? ElementMatchers.<T>is(value) : matcher.or(is(value)); } return matcher == null ? ElementMatchers.<T>none() : matcher; }
Creates a matcher that matches any of the given types as TypeDescriptions by the Object.equals(Object) method. None of the values must be null.
Params:
  • value – The input values to be compared against.
Type parameters:
  • <T> – The type of the matched object.
Returns:A matcher that checks for the equality with any of the given objects.
/** * Creates a matcher that matches any of the given types as {@link TypeDescription}s * by the {@link java.lang.Object#equals(Object)} method. None of the values must be {@code null}. * * @param value The input values to be compared against. * @param <T> The type of the matched object. * @return A matcher that checks for the equality with any of the given objects. */
public static <T extends TypeDefinition> ElementMatcher.Junction<T> anyOf(Type... value) { return anyOf(new TypeList.Generic.ForLoadedTypes(value)); }
Creates a matcher that matches any of the given constructors as MethodDescriptions by the Object.equals(Object) method. None of the values must be null.
Params:
  • value – The input values to be compared against.
Type parameters:
  • <T> – The type of the matched object.
Returns:A matcher that checks for the equality with any of the given objects.
/** * Creates a matcher that matches any of the given constructors as {@link MethodDescription}s * by the {@link java.lang.Object#equals(Object)} method. None of the values must be {@code null}. * * @param value The input values to be compared against. * @param <T> The type of the matched object. * @return A matcher that checks for the equality with any of the given objects. */
public static <T extends MethodDescription> ElementMatcher.Junction<T> anyOf(Constructor<?>... value) { return definedMethod(anyOf(new MethodList.ForLoadedMethods(value, new Method[0]))); }
Creates a matcher that matches any of the given methods as MethodDescriptions by the Object.equals(Object) method. None of the values must be null.
Params:
  • value – The input values to be compared against.
Type parameters:
  • <T> – The type of the matched object.
Returns:A matcher that checks for the equality with any of the given objects.
/** * Creates a matcher that matches any of the given methods as {@link MethodDescription}s * by the {@link java.lang.Object#equals(Object)} method. None of the values must be {@code null}. * * @param value The input values to be compared against. * @param <T> The type of the matched object. * @return A matcher that checks for the equality with any of the given objects. */
public static <T extends MethodDescription> ElementMatcher.Junction<T> anyOf(Method... value) { return definedMethod(anyOf(new MethodList.ForLoadedMethods(new Constructor<?>[0], value))); }
Creates a matcher that matches any of the given fields as FieldDescriptions by the Object.equals(Object) method. None of the values must be null.
Params:
  • value – The input values to be compared against.
Type parameters:
  • <T> – The type of the matched object.
Returns:A matcher that checks for the equality with any of the given objects.
/** * Creates a matcher that matches any of the given fields as {@link FieldDescription}s * by the {@link java.lang.Object#equals(Object)} method. None of the values must be {@code null}. * * @param value The input values to be compared against. * @param <T> The type of the matched object. * @return A matcher that checks for the equality with any of the given objects. */
public static <T extends FieldDescription> ElementMatcher.Junction<T> anyOf(Field... value) { return definedField(anyOf(new FieldList.ForLoadedFields(value))); }
Creates a matcher that matches any of the given annotations as AnnotationDescriptions by the Object.equals(Object) method. None of the values must be null.
Params:
  • value – The input values to be compared against.
Type parameters:
  • <T> – The type of the matched object.
Returns:A matcher that checks for the equality with any of the given objects.
/** * Creates a matcher that matches any of the given annotations as {@link AnnotationDescription}s * by the {@link java.lang.Object#equals(Object)} method. None of the values must be {@code null}. * * @param value The input values to be compared against. * @param <T> The type of the matched object. * @return A matcher that checks for the equality with any of the given objects. */
public static <T extends AnnotationDescription> ElementMatcher.Junction<T> anyOf(Annotation... value) { return anyOf(new AnnotationList.ForLoadedAnnotations(value)); }
Creates a matcher that matches none of the given objects by the Object.equals(Object) method. None of the values must be null.
Params:
  • value – The input values to be compared against.
Type parameters:
  • <T> – The type of the matched object.
Returns:A matcher that checks for the equality with none of the given objects.
/** * Creates a matcher that matches none of the given objects by the {@link java.lang.Object#equals(Object)} method. * None of the values must be {@code null}. * * @param value The input values to be compared against. * @param <T> The type of the matched object. * @return A matcher that checks for the equality with none of the given objects. */
public static <T> ElementMatcher.Junction<T> noneOf(Object... value) { return noneOf(Arrays.asList(value)); }
Creates a matcher that matches none of the given objects by the Object.equals(Object) method. None of the values must be null.
Params:
  • values – The input values to be compared against.
Type parameters:
  • <T> – The type of the matched object.
Returns:A matcher that checks for the equality with none of the given objects.
/** * Creates a matcher that matches none of the given objects by the {@link java.lang.Object#equals(Object)} method. * None of the values must be {@code null}. * * @param values The input values to be compared against. * @param <T> The type of the matched object. * @return A matcher that checks for the equality with none of the given objects. */
public static <T> ElementMatcher.Junction<T> noneOf(Iterable<?> values) { ElementMatcher.Junction<T> matcher = null; for (Object value : values) { matcher = matcher == null ? ElementMatchers.<T>not(is(value)) : matcher.and(not(is(value))); } return matcher == null ? ElementMatchers.<T>any() : matcher; }
Creates a matcher that matches none of the given types as TypeDescriptions by the Object.equals(Object) method. None of the values must be null.
Params:
  • value – The input values to be compared against.
Type parameters:
  • <T> – The type of the matched object.
Returns:A matcher that checks for the equality with none of the given objects.
/** * Creates a matcher that matches none of the given types as {@link TypeDescription}s * by the {@link java.lang.Object#equals(Object)} method. None of the values must be {@code null}. * * @param value The input values to be compared against. * @param <T> The type of the matched object. * @return A matcher that checks for the equality with none of the given objects. */
public static <T extends TypeDefinition> ElementMatcher.Junction<T> noneOf(Type... value) { return noneOf(new TypeList.Generic.ForLoadedTypes(value)); }
Creates a matcher that matches none of the given constructors as MethodDescriptions by the Object.equals(Object) method. None of the values must be null.
Params:
  • value – The input values to be compared against.
Type parameters:
  • <T> – The type of the matched object.
Returns:A matcher that checks for the equality with none of the given objects.
/** * Creates a matcher that matches none of the given constructors as {@link MethodDescription}s * by the {@link java.lang.Object#equals(Object)} method. None of the values must be {@code null}. * * @param value The input values to be compared against. * @param <T> The type of the matched object. * @return A matcher that checks for the equality with none of the given objects. */
public static <T extends MethodDescription> ElementMatcher.Junction<T> noneOf(Constructor<?>... value) { return definedMethod(noneOf(new MethodList.ForLoadedMethods(value, new Method[0]))); }
Creates a matcher that matches none of the given methods as MethodDescriptions by the Object.equals(Object) method. None of the values must be null.
Params:
  • value – The input values to be compared against.
Type parameters:
  • <T> – The type of the matched object.
Returns:A matcher that checks for the equality with none of the given objects.
/** * Creates a matcher that matches none of the given methods as {@link MethodDescription}s * by the {@link java.lang.Object#equals(Object)} method. None of the values must be {@code null}. * * @param value The input values to be compared against. * @param <T> The type of the matched object. * @return A matcher that checks for the equality with none of the given objects. */
public static <T extends MethodDescription> ElementMatcher.Junction<T> noneOf(Method... value) { return definedMethod(noneOf(new MethodList.ForLoadedMethods(new Constructor<?>[0], value))); }
Creates a matcher that matches none of the given methods as FieldDescriptions by the Object.equals(Object) method. None of the values must be null.
Params:
  • value – The input values to be compared against.
Type parameters:
  • <T> – The type of the matched object.
Returns:A matcher that checks for the equality with none of the given objects.
/** * Creates a matcher that matches none of the given methods as {@link FieldDescription}s * by the {@link java.lang.Object#equals(Object)} method. None of the values must be {@code null}. * * @param value The input values to be compared against. * @param <T> The type of the matched object. * @return A matcher that checks for the equality with none of the given objects. */
public static <T extends FieldDescription> ElementMatcher.Junction<T> noneOf(Field... value) { return definedField(noneOf(new FieldList.ForLoadedFields(value))); }
Creates a matcher that matches none of the given annotations as AnnotationDescriptions by the Object.equals(Object) method. None of the values must be null.
Params:
  • value – The input values to be compared against.
Type parameters:
  • <T> – The type of the matched object.
Returns:A matcher that checks for the equality with any of the given objects.
/** * Creates a matcher that matches none of the given annotations as {@link AnnotationDescription}s * by the {@link java.lang.Object#equals(Object)} method. None of the values must be {@code null}. * * @param value The input values to be compared against. * @param <T> The type of the matched object. * @return A matcher that checks for the equality with any of the given objects. */
public static <T extends AnnotationDescription> ElementMatcher.Junction<T> noneOf(Annotation... value) { return noneOf(new AnnotationList.ForLoadedAnnotations(value)); }
Matches an iterable by assuring that at least one element of the iterable collection matches the provided matcher.
Params:
  • matcher – The matcher to apply to each element.
Type parameters:
  • <T> – The type of the matched object.
Returns:A matcher that matches an iterable if at least one element matches the provided matcher.
/** * Matches an iterable by assuring that at least one element of the iterable collection matches the * provided matcher. * * @param matcher The matcher to apply to each element. * @param <T> The type of the matched object. * @return A matcher that matches an iterable if at least one element matches the provided matcher. */
public static <T> ElementMatcher.Junction<Iterable<? extends T>> whereAny(ElementMatcher<? super T> matcher) { return new CollectionItemMatcher<T>(matcher); }
Matches an iterable by assuring that no element of the iterable collection matches the provided matcher.
Params:
  • matcher – The matcher to apply to each element.
Type parameters:
  • <T> – The type of the matched object.
Returns:A matcher that matches an iterable if no element matches the provided matcher.
/** * Matches an iterable by assuring that no element of the iterable collection matches the provided matcher. * * @param matcher The matcher to apply to each element. * @param <T> The type of the matched object. * @return A matcher that matches an iterable if no element matches the provided matcher. */
public static <T> ElementMatcher.Junction<Iterable<? extends T>> whereNone(ElementMatcher<? super T> matcher) { return not(whereAny(matcher)); }
Matches a generic type's erasure against the provided type. As a wildcard does not define an erasure, a runtime exception is thrown when this matcher is applied to a wildcard.
Params:
  • type – The type to match a generic type's erasure against.
Type parameters:
  • <T> – The type of the matched object.
Returns:A matcher that matches a generic type's raw type against the provided non-generic type.
/** * Matches a generic type's erasure against the provided type. As a wildcard does not define an erasure, a runtime exception is thrown when * this matcher is applied to a wildcard. * * @param type The type to match a generic type's erasure against. * @param <T> The type of the matched object. * @return A matcher that matches a generic type's raw type against the provided non-generic type. */
public static <T extends TypeDescription.Generic> ElementMatcher.Junction<T> erasure(Class<?> type) { return erasure(is(type)); }
Matches a generic type's erasure against the provided type. As a wildcard does not define an erasure, a runtime exception is thrown when this matcher is applied to a wildcard.
Params:
  • type – The type to match a generic type's erasure against.
Type parameters:
  • <T> – The type of the matched object.
Returns:A matcher that matches a generic type's raw type against the provided non-generic type.
/** * Matches a generic type's erasure against the provided type. As a wildcard does not define an erasure, a runtime exception is thrown * when this matcher is applied to a wildcard. * * @param type The type to match a generic type's erasure against. * @param <T> The type of the matched object. * @return A matcher that matches a generic type's raw type against the provided non-generic type. */
public static <T extends TypeDescription.Generic> ElementMatcher.Junction<T> erasure(TypeDescription type) { return erasure(is(type)); }
Converts a matcher for a type description into a matcher for the matched type's erasure. As a wildcard does not define an erasure, a runtime exception is thrown when this matcher is applied to a wildcard.
Params:
  • matcher – The matcher to match the matched object's raw type against.
Type parameters:
  • <T> – The type of the matched object.
Returns:A type matcher for a generic type that matches the matched type's raw type against the given type description matcher.
/** * Converts a matcher for a type description into a matcher for the matched type's erasure. As a wildcard does not define an erasure, * a runtime exception is thrown when this matcher is applied to a wildcard. * * @param matcher The matcher to match the matched object's raw type against. * @param <T> The type of the matched object. * @return A type matcher for a generic type that matches the matched type's raw type against the given type description matcher. */
public static <T extends TypeDescription.Generic> ElementMatcher.Junction<T> erasure(ElementMatcher<? super TypeDescription> matcher) { return new ErasureMatcher<T>(matcher); }
Matches an iteration of generic types' erasures against the provided types. As a wildcard does not define an erasure, a runtime exception is thrown when this matcher is applied to a wildcard.
Params:
  • type – The types to match.
Type parameters:
  • <T> – The type of the matched object.
Returns:A matcher that matches an iteration of generic types' raw types against the provided non-generic types.
/** * Matches an iteration of generic types' erasures against the provided types. As a wildcard does not define an erasure, a runtime * exception is thrown when this matcher is applied to a wildcard. * * @param type The types to match. * @param <T> The type of the matched object. * @return A matcher that matches an iteration of generic types' raw types against the provided non-generic types. */
public static <T extends Iterable<? extends TypeDescription.Generic>> ElementMatcher.Junction<T> erasures(Class<?>... type) { return erasures(new TypeList.ForLoadedTypes(type)); }
Matches an iteration of generic types' erasures against the provided types. As a wildcard does not define an erasure, a runtime exception is thrown when this matcher is applied to a wildcard.
Params:
  • type – The types to match.
Type parameters:
  • <T> – The type of the matched object.
Returns:A matcher that matches an iteration of generic types' raw types against the provided non-generic types.
/** * Matches an iteration of generic types' erasures against the provided types. As a wildcard does not define an erasure, a runtime * exception is thrown when this matcher is applied to a wildcard. * * @param type The types to match. * @param <T> The type of the matched object. * @return A matcher that matches an iteration of generic types' raw types against the provided non-generic types. */
public static <T extends Iterable<? extends TypeDescription.Generic>> ElementMatcher.Junction<T> erasures(TypeDescription... type) { return erasures(Arrays.asList(type)); }
Matches an iteration of generic types' erasures against the provided types. As a wildcard does not define an erasure, a runtime exception is thrown when this matcher is applied to a wildcard.
Params:
  • types – The types to match.
Type parameters:
  • <T> – The type of the matched object.
Returns:A matcher that matches an iteration of generic types' raw types against the provided non-generic types.
/** * Matches an iteration of generic types' erasures against the provided types. As a wildcard does not define an erasure, a runtime * exception is thrown when this matcher is applied to a wildcard. * * @param types The types to match. * @param <T> The type of the matched object. * @return A matcher that matches an iteration of generic types' raw types against the provided non-generic types. */
public static <T extends Iterable<? extends TypeDescription.Generic>> ElementMatcher.Junction<T> erasures( Iterable<? extends TypeDescription> types) { List<ElementMatcher<? super TypeDescription>> typeMatchers = new ArrayList<ElementMatcher<? super TypeDescription>>(); for (TypeDescription type : types) { typeMatchers.add(is(type)); } return erasures(new CollectionOneToOneMatcher<TypeDescription>(typeMatchers)); }
Applies the provided matchers to an iteration og generic types' erasures. As a wildcard does not define an erasure, a runtime exception is thrown when this matcher is applied to a wildcard.
Params:
  • matcher – The matcher to apply at the erased types.
Type parameters:
  • <T> – The type of the matched object.
Returns:A matcher that matches an iteration of generic types' raw types against the provided matcher.
/** * Applies the provided matchers to an iteration og generic types' erasures. As a wildcard does not define an erasure, a runtime * exception is thrown when this matcher is applied to a wildcard. * * @param matcher The matcher to apply at the erased types. * @param <T> The type of the matched object. * @return A matcher that matches an iteration of generic types' raw types against the provided matcher. */
public static <T extends Iterable<? extends TypeDescription.Generic>> ElementMatcher.Junction<T> erasures( ElementMatcher<? super Iterable<? extends TypeDescription>> matcher) { return new CollectionErasureMatcher<T>(matcher); }
Matches a type variable with the given name.
Params:
  • symbol – The name of the type variable to be match.
Type parameters:
  • <T> – The type of the matched object.
Returns:A matcher that matches type variables with the given name.
/** * Matches a type variable with the given name. * * @param symbol The name of the type variable to be match. * @param <T> The type of the matched object. * @return A matcher that matches type variables with the given name. */
public static <T extends TypeDefinition> ElementMatcher.Junction<T> isVariable(String symbol) { return isVariable(named(symbol)); }
Matches a type variable with the given name.
Params:
  • matcher – A matcher for the type variable's name.
Type parameters:
  • <T> – The type of the matched object.
Returns:A matcher that matches type variables with the given name.
/** * Matches a type variable with the given name. * * @param matcher A matcher for the type variable's name. * @param <T> The type of the matched object. * @return A matcher that matches type variables with the given name. */
public static <T extends TypeDefinition> ElementMatcher.Junction<T> isVariable(ElementMatcher<? super NamedElement> matcher) { return new TypeSortMatcher<T>(anyOf(TypeDefinition.Sort.VARIABLE, TypeDefinition.Sort.VARIABLE_SYMBOLIC)).and(matcher); }
Matches a NamedElement for its exact name.
Params:
  • name – The expected name.
Type parameters:
  • <T> – The type of the matched object.
Returns:An element matcher for a named element's exact name.
/** * Matches a {@link NamedElement} for its exact name. * * @param name The expected name. * @param <T> The type of the matched object. * @return An element matcher for a named element's exact name. */
public static <T extends NamedElement> ElementMatcher.Junction<T> named(String name) { return new NameMatcher<T>(new StringMatcher(name, StringMatcher.Mode.EQUALS_FULLY)); }
Matches a NamedElement for its membership of a set.
Params:
  • names – The set of expected names.
Type parameters:
  • <T> – The type of the matched object.
Returns:An element matcher which matches if the element's name is found in the set.
/** * Matches a {@link NamedElement} for its membership of a set. * * @param names The set of expected names. * @param <T> The type of the matched object. * @return An element matcher which matches if the element's name is found in the set. */
public static <T extends NamedElement> ElementMatcher.Junction<T> namedOneOf(String... names) { return new NameMatcher<T>(new StringSetMatcher(new HashSet<String>(Arrays.asList(names)))); }
Matches a NamedElement for its name. The name's capitalization is ignored.
Params:
  • name – The expected name.
Type parameters:
  • <T> – The type of the matched object.
Returns:An element matcher for a named element's name.
/** * Matches a {@link NamedElement} for its name. The name's * capitalization is ignored. * * @param name The expected name. * @param <T> The type of the matched object. * @return An element matcher for a named element's name. */
public static <T extends NamedElement> ElementMatcher.Junction<T> namedIgnoreCase(String name) { return new NameMatcher<T>(new StringMatcher(name, StringMatcher.Mode.EQUALS_FULLY_IGNORE_CASE)); }
Matches a NamedElement for its name's prefix.
Params:
  • prefix – The expected name's prefix.
Type parameters:
  • <T> – The type of the matched object.
Returns:An element matcher for a named element's name's prefix.
/** * Matches a {@link NamedElement} for its name's prefix. * * @param prefix The expected name's prefix. * @param <T> The type of the matched object. * @return An element matcher for a named element's name's prefix. */
public static <T extends NamedElement> ElementMatcher.Junction<T> nameStartsWith(String prefix) { return new NameMatcher<T>(new StringMatcher(prefix, StringMatcher.Mode.STARTS_WITH)); }
Matches a NamedElement for its name's prefix. The name's capitalization is ignored.
Params:
  • prefix – The expected name's prefix.
Type parameters:
  • <T> – The type of the matched object.
Returns:An element matcher for a named element's name's prefix.
/** * Matches a {@link NamedElement} for its name's prefix. The name's * capitalization is ignored. * * @param prefix The expected name's prefix. * @param <T> The type of the matched object. * @return An element matcher for a named element's name's prefix. */
public static <T extends NamedElement> ElementMatcher.Junction<T> nameStartsWithIgnoreCase(String prefix) { return new NameMatcher<T>(new StringMatcher(prefix, StringMatcher.Mode.STARTS_WITH_IGNORE_CASE)); }
Matches a NamedElement for its name's suffix.
Params:
  • suffix – The expected name's suffix.
Type parameters:
  • <T> – The type of the matched object.
Returns:An element matcher for a named element's name's suffix.
/** * Matches a {@link NamedElement} for its name's suffix. * * @param suffix The expected name's suffix. * @param <T> The type of the matched object. * @return An element matcher for a named element's name's suffix. */
public static <T extends NamedElement> ElementMatcher.Junction<T> nameEndsWith(String suffix) { return new NameMatcher<T>(new StringMatcher(suffix, StringMatcher.Mode.ENDS_WITH)); }
Matches a NamedElement for its name's suffix. The name's capitalization is ignored.
Params:
  • suffix – The expected name's suffix.
Type parameters:
  • <T> – The type of the matched object.
Returns:An element matcher for a named element's name's suffix.
/** * Matches a {@link NamedElement} for its name's suffix. The name's * capitalization is ignored. * * @param suffix The expected name's suffix. * @param <T> The type of the matched object. * @return An element matcher for a named element's name's suffix. */
public static <T extends NamedElement> ElementMatcher.Junction<T> nameEndsWithIgnoreCase(String suffix) { return new NameMatcher<T>(new StringMatcher(suffix, StringMatcher.Mode.ENDS_WITH_IGNORE_CASE)); }
Matches a NamedElement for an infix of its name.
Params:
  • infix – The expected infix of the name.
Type parameters:
  • <T> – The type of the matched object.
Returns:An element matcher for a named element's name's infix.
/** * Matches a {@link NamedElement} for an infix of its name. * * @param infix The expected infix of the name. * @param <T> The type of the matched object. * @return An element matcher for a named element's name's infix. */
public static <T extends NamedElement> ElementMatcher.Junction<T> nameContains(String infix) { return new NameMatcher<T>(new StringMatcher(infix, StringMatcher.Mode.CONTAINS)); }
Matches a NamedElement for an infix of its name. The name's capitalization is ignored.
Params:
  • infix – The expected infix of the name.
Type parameters:
  • <T> – The type of the matched object.
Returns:An element matcher for a named element's name's infix.
/** * Matches a {@link NamedElement} for an infix of its name. The name's * capitalization is ignored. * * @param infix The expected infix of the name. * @param <T> The type of the matched object. * @return An element matcher for a named element's name's infix. */
public static <T extends NamedElement> ElementMatcher.Junction<T> nameContainsIgnoreCase(String infix) { return new NameMatcher<T>(new StringMatcher(infix, StringMatcher.Mode.CONTAINS_IGNORE_CASE)); }
Matches a NamedElement name against a regular expression.
Params:
  • regex – The regular expression to match the name against.
Type parameters:
  • <T> – The type of the matched object.
Returns:An element matcher for a named element's name's against the given regular expression.
/** * Matches a {@link NamedElement} name against a regular expression. * * @param regex The regular expression to match the name against. * @param <T> The type of the matched object. * @return An element matcher for a named element's name's against the given regular expression. */
public static <T extends NamedElement> ElementMatcher.Junction<T> nameMatches(String regex) { return new NameMatcher<T>(new StringMatcher(regex, StringMatcher.Mode.MATCHES)); }
Matches a WithOptionalName for having an explicit name.
Type parameters:
  • <T> – The type of the matched object.
Returns:An element matcher that checks if the matched optionally named element has an explicit name.
/** * Matches a {@link NamedElement.WithOptionalName} for having an explicit name. * * @param <T> The type of the matched object. * @return An element matcher that checks if the matched optionally named element has an explicit name. */
public static <T extends NamedElement.WithOptionalName> ElementMatcher.Junction<T> isNamed() { return new IsNamedMatcher<T>(); }
Matches a WithDescriptor's descriptor against a given value.
Params:
  • descriptor – The expected descriptor.
Type parameters:
  • <T> – The type of the matched object.
Returns:A matcher for the given descriptor.
/** * Matches a {@link NamedElement.WithDescriptor}'s descriptor against a given value. * * @param descriptor The expected descriptor. * @param <T> The type of the matched object. * @return A matcher for the given {@code descriptor}. */
public static <T extends NamedElement.WithDescriptor> ElementMatcher.Junction<T> hasDescriptor(String descriptor) { return new DescriptorMatcher<T>(new StringMatcher(descriptor, StringMatcher.Mode.EQUALS_FULLY)); }
Matches a ByteCodeElement for being declared by a given Class. This matcher matches a declared element's raw declaring type.
Params:
  • type – The type that is expected to declare the matched byte code element.
Type parameters:
  • <T> – The type of the matched object.
Returns:A matcher for byte code elements being declared by the given type.
/** * Matches a {@link ByteCodeElement} for being declared by a given {@link java.lang.Class}. This matcher matches * a declared element's raw declaring type. * * @param type The type that is expected to declare the matched byte code element. * @param <T> The type of the matched object. * @return A matcher for byte code elements being declared by the given {@code type}. */
public static <T extends ByteCodeElement> ElementMatcher.Junction<T> isDeclaredBy(Class<?> type) { return isDeclaredBy(TypeDescription.ForLoadedType.of(type)); }
Matches a ByteCodeElement for being declared by a given TypeDescription. This matcher matches a declared element's raw declaring type.
Params:
  • type – The type that is expected to declare the matched byte code element.
Type parameters:
  • <T> – The type of the matched object.
Returns:A matcher for byte code elements being declared by the given type.
/** * Matches a {@link ByteCodeElement} for being declared by a given {@link TypeDescription}. This matcher matches * a declared element's raw declaring type. * * @param type The type that is expected to declare the matched byte code element. * @param <T> The type of the matched object. * @return A matcher for byte code elements being declared by the given {@code type}. */
public static <T extends ByteCodeElement> ElementMatcher.Junction<T> isDeclaredBy(TypeDescription type) { return isDeclaredBy(is(type)); }
Matches a ByteCodeElement for being declared by a TypeDescription that is matched by the given matcher. This matcher matches a declared element's raw declaring type.
Params:
  • matcher – A matcher for the declaring type of the matched byte code element as long as it is not null.
Type parameters:
  • <T> – The type of the matched object.
Returns:A matcher for byte code elements being declared by a type matched by the given matcher.
/** * Matches a {@link ByteCodeElement} for being declared by a {@link TypeDescription} that is matched by the given matcher. This matcher matches * a declared element's raw declaring type. * * @param matcher A matcher for the declaring type of the matched byte code element as long as it * is not {@code null}. * @param <T> The type of the matched object. * @return A matcher for byte code elements being declared by a type matched by the given {@code matcher}. */
public static <T extends ByteCodeElement> ElementMatcher.Junction<T> isDeclaredBy(ElementMatcher<? super TypeDescription> matcher) { return isDeclaredByGeneric(erasure(matcher)); }
Matches a ByteCodeElement for being declared by a given generic Type.
Params:
  • type – The type that is expected to declare the matched byte code element.
Type parameters:
  • <T> – The type of the matched object.
Returns:A matcher for byte code elements being declared by the given type.
/** * Matches a {@link ByteCodeElement} for being declared by a given generic {@link Type}. * * @param type The type that is expected to declare the matched byte code element. * @param <T> The type of the matched object. * @return A matcher for byte code elements being declared by the given {@code type}. */
public static <T extends ByteCodeElement> ElementMatcher.Junction<T> isDeclaredByGeneric(Type type) { return isDeclaredByGeneric(TypeDefinition.Sort.describe(type)); }
Matches a ByteCodeElement for being declared by a given Generic.
Params:
  • type – The type that is expected to declare the matched byte code element.
Type parameters:
  • <T> – The type of the matched object.
Returns:A matcher for byte code elements being declared by the given type.
/** * Matches a {@link ByteCodeElement} for being declared by a given {@link TypeDescription.Generic}. * * @param type The type that is expected to declare the matched byte code element. * @param <T> The type of the matched object. * @return A matcher for byte code elements being declared by the given {@code type}. */
public static <T extends ByteCodeElement> ElementMatcher.Junction<T> isDeclaredByGeneric(TypeDescription.Generic type) { return isDeclaredByGeneric(is(type)); }
Matches a ByteCodeElement for being declared by a Generic that is matched by the given matcher.
Params:
  • matcher – A matcher for the declaring type of the matched byte code element as long as it is not null.
Type parameters:
  • <T> – The type of the matched object.
Returns:A matcher for byte code elements being declared by a type matched by the given matcher.
/** * Matches a {@link ByteCodeElement} for being declared by a {@link TypeDescription.Generic} that is matched by the given matcher. * * @param matcher A matcher for the declaring type of the matched byte code element as long as it is not {@code null}. * @param <T> The type of the matched object. * @return A matcher for byte code elements being declared by a type matched by the given {@code matcher}. */
public static <T extends ByteCodeElement> ElementMatcher.Junction<T> isDeclaredByGeneric(ElementMatcher<? super TypeDescription.Generic> matcher) { return new DeclaringTypeMatcher<T>(matcher); }
Matches a ByteCodeElement that is visible to a given Class.
Params:
  • type – The type that a matched byte code element is expected to be visible to.
Type parameters:
  • <T> – The type of the matched object.
Returns:A matcher for a byte code element to be visible to a given type.
/** * Matches a {@link ByteCodeElement} that is visible to a given {@link java.lang.Class}. * * @param type The type that a matched byte code element is expected to be visible to. * @param <T> The type of the matched object. * @return A matcher for a byte code element to be visible to a given {@code type}. */
public static <T extends ByteCodeElement> ElementMatcher.Junction<T> isVisibleTo(Class<?> type) { return isVisibleTo(TypeDescription.ForLoadedType.of(type)); }
Matches a ByteCodeElement that is visible to a given TypeDescription.
Params:
  • type – The type that a matched byte code element is expected to be visible to.
Type parameters:
  • <T> – The type of the matched object.
Returns:A matcher for a byte code element to be visible to a given type.
/** * Matches a {@link ByteCodeElement} that is visible to a given {@link TypeDescription}. * * @param type The type that a matched byte code element is expected to be visible to. * @param <T> The type of the matched object. * @return A matcher for a byte code element to be visible to a given {@code type}. */
public static <T extends ByteCodeElement> ElementMatcher.Junction<T> isVisibleTo(TypeDescription type) { return new VisibilityMatcher<T>(type); }
Matches a ByteCodeElement that is accessible to a given Class.
Params:
  • type – The type that a matched byte code element is expected to be accessible to.
Type parameters:
  • <T> – The type of the matched object.
Returns:A matcher for a byte code element to be accessible to a given type.
/** * Matches a {@link ByteCodeElement} that is accessible to a given {@link java.lang.Class}. * * @param type The type that a matched byte code element is expected to be accessible to. * @param <T> The type of the matched object. * @return A matcher for a byte code element to be accessible to a given {@code type}. */
public static <T extends ByteCodeElement> ElementMatcher.Junction<T> isAccessibleTo(Class<?> type) { return isAccessibleTo(TypeDescription.ForLoadedType.of(type)); }
Matches a ByteCodeElement that is accessible to a given Class.
Params:
  • type – The type that a matched byte code element is expected to be accessible to.
Type parameters:
  • <T> – The type of the matched object.
Returns:A matcher for a byte code element to be accessible to a given type.
/** * Matches a {@link ByteCodeElement} that is accessible to a given {@link java.lang.Class}. * * @param type The type that a matched byte code element is expected to be accessible to. * @param <T> The type of the matched object. * @return A matcher for a byte code element to be accessible to a given {@code type}. */
public static <T extends ByteCodeElement> ElementMatcher.Junction<T> isAccessibleTo(TypeDescription type) { return new AccessibilityMatcher<T>(type); }
Matches a OfAbstraction that is abstract.
Type parameters:
  • <T> – The type of the matched object.
Returns:A matcher for a abstract modifier reviewable.
/** * Matches a {@link ModifierReviewable.OfAbstraction} that is {@code abstract}. * * @param <T> The type of the matched object. * @return A matcher for a {@code abstract} modifier reviewable. */
public static <T extends ModifierReviewable.OfAbstraction> ElementMatcher.Junction<T> isAbstract() { return new ModifierMatcher<T>(ModifierMatcher.Mode.ABSTRACT); }
Matches a OfEnumeration that is an enum or a field holding an enum.
Type parameters:
  • <T> – The type of the matched object.
Returns:A matcher for an enum.
/** * Matches a {@link ModifierReviewable.OfEnumeration} that is an {@code enum} or a field holding an enum. * * @param <T> The type of the matched object. * @return A matcher for an enum. */
public static <T extends ModifierReviewable.OfEnumeration> ElementMatcher.Junction<T> isEnum() { return new ModifierMatcher<T>(ModifierMatcher.Mode.ENUMERATION); }
Matches an AnnotationSource for declared annotations. This matcher does not match inherited annotations which only exist for classes. Use inheritsAnnotation(Class<?>) for matching inherited annotations.
Params:
  • type – The annotation type to match against.
Type parameters:
  • <T> – The type of the matched object.
Returns:A matcher that validates that an annotated element is annotated with an annotation of type.
/** * Matches an {@link AnnotationSource} for declared annotations. * This matcher does not match inherited annotations which only exist for classes. Use * {@link net.bytebuddy.matcher.ElementMatchers#inheritsAnnotation(Class)} for matching inherited annotations. * * @param type The annotation type to match against. * @param <T> The type of the matched object. * @return A matcher that validates that an annotated element is annotated with an annotation of {@code type}. */
public static <T extends AnnotationSource> ElementMatcher.Junction<T> isAnnotatedWith(Class<? extends Annotation> type) { return isAnnotatedWith(TypeDescription.ForLoadedType.of(type)); }
Matches an AnnotationSource for declared annotations. This matcher does not match inherited annotations which only exist for classes. Use inheritsAnnotation(TypeDescription) for matching inherited annotations.
Params:
  • type – The annotation type to match against.
Type parameters:
  • <T> – The type of the matched object.
Returns:A matcher that validates that an annotated element is annotated with an annotation of type.
/** * Matches an {@link AnnotationSource} for declared annotations. * This matcher does not match inherited annotations which only exist for classes. Use * {@link net.bytebuddy.matcher.ElementMatchers#inheritsAnnotation(TypeDescription)} * for matching inherited annotations. * * @param type The annotation type to match against. * @param <T> The type of the matched object. * @return A matcher that validates that an annotated element is annotated with an annotation of {@code type}. */
public static <T extends AnnotationSource> ElementMatcher.Junction<T> isAnnotatedWith(TypeDescription type) { return isAnnotatedWith(is(type)); }
Matches an AnnotationSource for declared annotations. This matcher does not match inherited annotations which only exist for classes. Use inheritsAnnotation(ElementMatcher<? super TypeDescription>) for matching inherited annotations.
Params:
  • matcher – The matcher to apply to any annotation's type found on the matched annotated element.
Type parameters:
  • <T> – The type of the matched object.
Returns:A matcher that validates that an annotated element is annotated with an annotation of a type that matches the given matcher.
/** * Matches an {@link AnnotationSource} for declared annotations. * This matcher does not match inherited annotations which only exist for classes. Use * {@link net.bytebuddy.matcher.ElementMatchers#inheritsAnnotation(net.bytebuddy.matcher.ElementMatcher)} * for matching inherited annotations. * * @param matcher The matcher to apply to any annotation's type found on the matched annotated element. * @param <T> The type of the matched object. * @return A matcher that validates that an annotated element is annotated with an annotation of a type * that matches the given {@code matcher}. */
public static <T extends AnnotationSource> ElementMatcher.Junction<T> isAnnotatedWith(ElementMatcher<? super TypeDescription> matcher) { return declaresAnnotation(annotationType(matcher)); }
Matches an AnnotationSource to declare any annotation that matches the given matcher. Note that this matcher does not match inherited annotations that only exist for types. Use inheritsAnnotation(ElementMatcher<? super TypeDescription>) for matching inherited annotations.
Params:
  • matcher – A matcher to apply on any declared annotation of the matched annotated element.
Type parameters:
  • <T> – The type of the matched object.
Returns:A matcher that validates that an annotated element is annotated with an annotation that matches the given matcher.
/** * Matches an {@link AnnotationSource} to declare any annotation * that matches the given matcher. Note that this matcher does not match inherited annotations that only exist * for types. Use {@link net.bytebuddy.matcher.ElementMatchers#inheritsAnnotation(net.bytebuddy.matcher.ElementMatcher)} * for matching inherited annotations. * * @param matcher A matcher to apply on any declared annotation of the matched annotated element. * @param <T> The type of the matched object. * @return A matcher that validates that an annotated element is annotated with an annotation that matches * the given {@code matcher}. */
public static <T extends AnnotationSource> ElementMatcher.Junction<T> declaresAnnotation(ElementMatcher<? super AnnotationDescription> matcher) { return new DeclaringAnnotationMatcher<T>(new CollectionItemMatcher<AnnotationDescription>(matcher)); }
Matches a ModifierReviewable that is public.
Type parameters:
  • <T> – The type of the matched object.
Returns:A matcher for a public modifier reviewable.
/** * Matches a {@link ModifierReviewable} that is {@code public}. * * @param <T> The type of the matched object. * @return A matcher for a {@code public} modifier reviewable. */
public static <T extends ModifierReviewable.OfByteCodeElement> ElementMatcher.Junction<T> isPublic() { return new ModifierMatcher<T>(ModifierMatcher.Mode.PUBLIC); }
Matches a ModifierReviewable that is protected.
Type parameters:
  • <T> – The type of the matched object.
Returns:A matcher for a protected modifier reviewable.
/** * Matches a {@link ModifierReviewable} that is {@code protected}. * * @param <T> The type of the matched object. * @return A matcher for a {@code protected} modifier reviewable. */
public static <T extends ModifierReviewable.OfByteCodeElement> ElementMatcher.Junction<T> isProtected() { return new ModifierMatcher<T>(ModifierMatcher.Mode.PROTECTED); }
Matches a ModifierReviewable that is package-private.
Type parameters:
  • <T> – The type of the matched object.
Returns:A matcher for a package-private modifier reviewable.
/** * Matches a {@link ModifierReviewable} that is package-private. * * @param <T> The type of the matched object. * @return A matcher for a package-private modifier reviewable. */
public static <T extends ModifierReviewable.OfByteCodeElement> ElementMatcher.Junction<T> isPackagePrivate() { return not(isPublic().or(isProtected()).or(isPrivate())); }
Matches a ModifierReviewable that is private.
Type parameters:
  • <T> – The type of the matched object.
Returns:A matcher for a private modifier reviewable.
/** * Matches a {@link ModifierReviewable} that is {@code private}. * * @param <T> The type of the matched object. * @return A matcher for a {@code private} modifier reviewable. */
public static <T extends ModifierReviewable.OfByteCodeElement> ElementMatcher.Junction<T> isPrivate() { return new ModifierMatcher<T>(ModifierMatcher.Mode.PRIVATE); }
Matches a ModifierReviewable that is static.
Type parameters:
  • <T> – The type of the matched object.
Returns:A matcher for a static modifier reviewable.
/** * Matches a {@link ModifierReviewable} that is {@code static}. * * @param <T> The type of the matched object. * @return A matcher for a {@code static} modifier reviewable. */
public static <T extends ModifierReviewable.OfByteCodeElement> ElementMatcher.Junction<T> isStatic() { return new ModifierMatcher<T>(ModifierMatcher.Mode.STATIC); }
Matches a ModifierReviewable that is final.
Type parameters:
  • <T> – The type of the matched object.
Returns:A matcher for a final modifier reviewable.
/** * Matches a {@link ModifierReviewable} that is {@code final}. * * @param <T> The type of the matched object. * @return A matcher for a {@code final} modifier reviewable. */
public static <T extends ModifierReviewable> ElementMatcher.Junction<T> isFinal() { return new ModifierMatcher<T>(ModifierMatcher.Mode.FINAL); }
Matches a ModifierReviewable that is synthetic.
Type parameters:
  • <T> – The type of the matched object.
Returns:A matcher for a synthetic modifier reviewable.
/** * Matches a {@link ModifierReviewable} that is synthetic. * * @param <T> The type of the matched object. * @return A matcher for a synthetic modifier reviewable. */
public static <T extends ModifierReviewable> ElementMatcher.Junction<T> isSynthetic() { return new ModifierMatcher<T>(ModifierMatcher.Mode.SYNTHETIC); }
Matches a MethodDescription that is synchronized.
Type parameters:
  • <T> – The type of the matched object.
Returns:A matcher for a synchronized method description.
/** * Matches a {@link MethodDescription} that is {@code synchronized}. * * @param <T> The type of the matched object. * @return A matcher for a {@code synchronized} method description. */
public static <T extends ModifierReviewable.ForMethodDescription> ElementMatcher.Junction<T> isSynchronized() { return new ModifierMatcher<T>(ModifierMatcher.Mode.SYNCHRONIZED); }
Matches a MethodDescription that is native.
Type parameters:
  • <T> – The type of the matched object.
Returns:A matcher for a native method description.
/** * Matches a {@link MethodDescription} that is {@code native}. * * @param <T> The type of the matched object. * @return A matcher for a {@code native} method description. */
public static <T extends ModifierReviewable.ForMethodDescription> ElementMatcher.Junction<T> isNative() { return new ModifierMatcher<T>(ModifierMatcher.Mode.NATIVE); }
Matches a MethodDescription that is strictfp.
Type parameters:
  • <T> – The type of the matched object.
Returns:A matcher for a strictfp method description.
/** * Matches a {@link MethodDescription} that is {@code strictfp}. * * @param <T> The type of the matched object. * @return A matcher for a {@code strictfp} method description. */
public static <T extends ModifierReviewable.ForMethodDescription> ElementMatcher.Junction<T> isStrict() { return new ModifierMatcher<T>(ModifierMatcher.Mode.STRICT); }
Matches a MethodDescription that is a var-args.
Type parameters:
  • <T> – The type of the matched object.
Returns:A matcher for a var-args method description.
/** * Matches a {@link MethodDescription} that is a var-args. * * @param <T> The type of the matched object. * @return A matcher for a var-args method description. */
public static <T extends ModifierReviewable.ForMethodDescription> ElementMatcher.Junction<T> isVarArgs() { return new ModifierMatcher<T>(ModifierMatcher.Mode.VAR_ARGS); }
Matches a MethodDescription that is a bridge.
Type parameters:
  • <T> – The type of the matched object.
Returns:A matcher for a bridge method.
/** * Matches a {@link MethodDescription} that is a bridge. * * @param <T> The type of the matched object. * @return A matcher for a bridge method. */
public static <T extends ModifierReviewable.ForMethodDescription> ElementMatcher.Junction<T> isBridge() { return new ModifierMatcher<T>(ModifierMatcher.Mode.BRIDGE); }
Matches MethodDescriptions that return a given generic type.
Params:
  • type – The generic type the matched method is expected to return.
Type parameters:
  • <T> – The type of the matched object.
Returns:An element matcher that matches a given generic return type for a method description.
/** * Matches {@link MethodDescription}s that return a given generic type. * * @param type The generic type the matched method is expected to return. * @param <T> The type of the matched object. * @return An element matcher that matches a given generic return type for a method description. */
public static <T extends MethodDescription> ElementMatcher.Junction<T> returnsGeneric(Type type) { return returnsGeneric(TypeDefinition.Sort.describe(type)); }
Matches MethodDescriptions that returns a given TypeDescription.
Params:
  • type – The type the matched method is expected to return.
Type parameters:
  • <T> – The type of the matched object.
Returns:An element matcher that matches a given return type for a method description.
/** * Matches {@link MethodDescription}s that returns a given * {@link TypeDescription}. * * @param type The type the matched method is expected to return. * @param <T> The type of the matched object. * @return An element matcher that matches a given return type for a method description. */
public static <T extends MethodDescription> ElementMatcher.Junction<T> returnsGeneric(TypeDescription.Generic type) { return returnsGeneric(is(type)); }
Matches MethodDescriptions that return a given erasure type.
Params:
  • type – The raw type the matched method is expected to return.
Type parameters:
  • <T> – The type of the matched object.
Returns:An element matcher that matches a given return type for a method description.
/** * Matches {@link MethodDescription}s that return a given erasure type. * * @param type The raw type the matched method is expected to return. * @param <T> The type of the matched object. * @return An element matcher that matches a given return type for a method description. */
public static <T extends MethodDescription> ElementMatcher.Junction<T> returns(Class<?> type) { return returnsGeneric(erasure(type)); }
Matches MethodDescriptions that return a given erasure type.
Params:
  • type – The raw type the matched method is expected to return.
Type parameters:
  • <T> – The type of the matched object.
Returns:An element matcher that matches a given return type for a method description.
/** * Matches {@link MethodDescription}s that return a given erasure type. * * @param type The raw type the matched method is expected to return. * @param <T> The type of the matched object. * @return An element matcher that matches a given return type for a method description. */
public static <T extends MethodDescription> ElementMatcher.Junction<T> returns(TypeDescription type) { return returns(is(type)); }
Matches a method's return type's erasure by the given matcher.
Params:
  • matcher – The matcher to apply to a method's return type's erasure.
Type parameters:
  • <T> – The type of the matched object.
Returns:A matcher that matches the matched method's return type's erasure.
/** * Matches a method's return type's erasure by the given matcher. * * @param matcher The matcher to apply to a method's return type's erasure. * @param <T> The type of the matched object. * @return A matcher that matches the matched method's return type's erasure. */
public static <T extends MethodDescription> ElementMatcher.Junction<T> returns(ElementMatcher<? super TypeDescription> matcher) { return returnsGeneric(erasure(matcher)); }
Matches MethodDescriptions that match a matched method's return type.
Params:
  • matcher – A matcher to apply onto a matched method's return type.
Type parameters:
  • <T> – The type of the matched object.
Returns:An element matcher that matches a given return type against another matcher.
/** * Matches {@link MethodDescription}s that match a matched method's return type. * * @param matcher A matcher to apply onto a matched method's return type. * @param <T> The type of the matched object. * @return An element matcher that matches a given return type against another {@code matcher}. */
public static <T extends MethodDescription> ElementMatcher.Junction<T> returnsGeneric(ElementMatcher<? super TypeDescription.Generic> matcher) { return new MethodReturnTypeMatcher<T>(matcher); }
Matches MethodDescriptions that define a given generic type as a parameter at the given index.
Params:
  • index – The index of the parameter.
  • type – The generic type the matched method is expected to define as a parameter type.
Type parameters:
  • <T> – The type of the matched object.
Returns:An element matcher that matches a given generic return type for a method description.
/** * Matches {@link MethodDescription}s that define a given generic type as a parameter at the given index. * * @param index The index of the parameter. * @param type The generic type the matched method is expected to define as a parameter type. * @param <T> The type of the matched object. * @return An element matcher that matches a given generic return type for a method description. */
public static <T extends MethodDescription> ElementMatcher.Junction<T> takesGenericArgument(int index, Type type) { return takesGenericArgument(index, TypeDefinition.Sort.describe(type)); }
Matches MethodDescriptions that define a given generic type as a parameter at the given index.
Params:
  • index – The index of the parameter.
  • type – The generic type the matched method is expected to define as a parameter type.
Type parameters:
  • <T> – The type of the matched object.
Returns:An element matcher that matches a given generic return type for a method description.
/** * Matches {@link MethodDescription}s that define a given generic type as a parameter at the given index. * * @param index The index of the parameter. * @param type The generic type the matched method is expected to define as a parameter type. * @param <T> The type of the matched object. * @return An element matcher that matches a given generic return type for a method description. */
public static <T extends MethodDescription> ElementMatcher.Junction<T> takesGenericArgument(int index, TypeDescription.Generic type) { return takesGenericArgument(index, is(type)); }
Matches MethodDescriptions that define a given generic type as a parameter at the given index.
Params:
  • index – The index of the parameter.
  • matcher – A matcher for the generic type the matched method is expected to define as a parameter type.
Type parameters:
  • <T> – The type of the matched object.
Returns:An element matcher that matches a given generic return type for a method description.
/** * Matches {@link MethodDescription}s that define a given generic type as a parameter at the given index. * * @param index The index of the parameter. * @param matcher A matcher for the generic type the matched method is expected to define as a parameter type. * @param <T> The type of the matched object. * @return An element matcher that matches a given generic return type for a method description. */
public static <T extends MethodDescription> ElementMatcher.Junction<T> takesGenericArgument(int index, ElementMatcher<? super TypeDescription.Generic> matcher) { return takesGenericArguments(new CollectionElementMatcher<TypeDescription.Generic>(index, matcher)); }
Matches a method description that takes the provided generic arguments.
Params:
  • type – The arguments to match against the matched method.
Type parameters:
  • <T> – The type of the matched object.
Returns:A method matcher that matches a method's generic parameter types against the supplied arguments.
/** * Matches a method description that takes the provided generic arguments. * * @param type The arguments to match against the matched method. * @param <T> The type of the matched object. * @return A method matcher that matches a method's generic parameter types against the supplied arguments. */
public static <T extends MethodDescription> ElementMatcher.Junction<T> takesGenericArguments(Type... type) { return takesGenericArguments(new TypeList.Generic.ForLoadedTypes(type)); }
Matches a method description that takes the provided generic arguments.
Params:
  • type – The arguments to match against the matched method.
Type parameters:
  • <T> – The type of the matched object.
Returns:A method matcher that matches a method's generic parameter types against the supplied arguments.
/** * Matches a method description that takes the provided generic arguments. * * @param type The arguments to match against the matched method. * @param <T> The type of the matched object. * @return A method matcher that matches a method's generic parameter types against the supplied arguments. */
public static <T extends MethodDescription> ElementMatcher.Junction<T> takesGenericArguments(TypeDefinition... type) { return takesGenericArguments((Arrays.asList(type))); }
Matches a method description that takes the provided generic arguments.
Params:
  • types – The arguments to match against the matched method.
Type parameters:
  • <T> – The type of the matched object.
Returns:A method matcher that matches a method's generic parameter types against the supplied arguments.
/** * Matches a method description that takes the provided generic arguments. * * @param types The arguments to match against the matched method. * @param <T> The type of the matched object. * @return A method matcher that matches a method's generic parameter types against the supplied arguments. */
public static <T extends MethodDescription> ElementMatcher.Junction<T> takesGenericArguments(List<? extends TypeDefinition> types) { List<ElementMatcher<? super TypeDescription.Generic>> typeMatchers = new ArrayList<ElementMatcher<? super TypeDescription.Generic>>(); for (TypeDefinition type : types) { typeMatchers.add(is(type)); } return takesGenericArguments(new CollectionOneToOneMatcher<TypeDescription.Generic>(typeMatchers)); }
Matches a MethodDescription by applying an iterable collection of element matcher on any parameter's Generic.
Params:
  • matchers – The matcher that are applied onto the parameter types of the matched method description.
Type parameters:
  • <T> – The type of the matched object.
Returns:A matcher that matches a method description by applying another element matcher onto each parameter's type.
/** * Matches a {@link MethodDescription} by applying an iterable collection of element matcher on any parameter's {@link TypeDescription.Generic}. * * @param matchers The matcher that are applied onto the parameter types of the matched method description. * @param <T> The type of the matched object. * @return A matcher that matches a method description by applying another element matcher onto each parameter's type. */
public static <T extends MethodDescription> ElementMatcher.Junction<T> takesGenericArguments(ElementMatcher<? super Iterable<? extends TypeDescription.Generic>> matchers) { return new MethodParametersMatcher<T>(new MethodParameterTypesMatcher<ParameterList<?>>(matchers)); }
Matches MethodDescriptions that define a given generic type as a parameter at the given index.
Params:
  • index – The index of the parameter.
  • type – The erasure of the type the matched method is expected to define as a parameter type.
Type parameters:
  • <T> – The type of the matched object.
Returns:An element matcher that matches a given argument type for a method description.
/** * Matches {@link MethodDescription}s that define a given generic type as a parameter at the given index. * * @param index The index of the parameter. * @param type The erasure of the type the matched method is expected to define as a parameter type. * @param <T> The type of the matched object. * @return An element matcher that matches a given argument type for a method description. */
public static <T extends MethodDescription> ElementMatcher.Junction<T> takesArgument(int index, Class<?> type) { return takesArgument(index, TypeDescription.ForLoadedType.of(type)); }
Matches MethodDescriptions that define a given type erasure as a parameter at the given index.
Params:
  • index – The index of the parameter.
  • type – The erasure of the type the matched method is expected to define as a parameter type.
Type parameters:
  • <T> – The type of the matched object.
Returns:An element matcher that matches a given argument type for a method description.
/** * Matches {@link MethodDescription}s that define a given type erasure as a parameter at the given index. * * @param index The index of the parameter. * @param type The erasure of the type the matched method is expected to define as a parameter type. * @param <T> The type of the matched object. * @return An element matcher that matches a given argument type for a method description. */
public static <T extends MethodDescription> ElementMatcher.Junction<T> takesArgument(int index, TypeDescription type) { return takesArgument(index, is(type)); }
Matches MethodDescriptions that define a type erasure as a parameter at the given index that matches the supplied matcher.
Params:
  • index – The index of the parameter.
  • matcher – A matcher to apply to the argument at the specified index.
Type parameters:
  • <T> – The type of the matched object.
Returns:An element matcher that matches a given argument type for a method description.
/** * Matches {@link MethodDescription}s that define a type erasure as a parameter at the given index that matches the supplied matcher. * * @param index The index of the parameter. * @param matcher A matcher to apply to the argument at the specified index. * @param <T> The type of the matched object. * @return An element matcher that matches a given argument type for a method description. */
public static <T extends MethodDescription> ElementMatcher.Junction<T> takesArgument(int index, ElementMatcher<? super TypeDescription> matcher) { return takesGenericArgument(index, erasure(matcher)); }
Matches a method description that takes the provided raw arguments.
Params:
  • type – The arguments to match against the matched method.
Type parameters:
  • <T> – The type of the matched object.
Returns:A method matcher that matches a method's raw parameter types against the supplied arguments.
/** * Matches a method description that takes the provided raw arguments. * * @param type The arguments to match against the matched method. * @param <T> The type of the matched object. * @return A method matcher that matches a method's raw parameter types against the supplied arguments. */
public static <T extends MethodDescription> ElementMatcher.Junction<T> takesArguments(Class<?>... type) { return takesGenericArguments(erasures(type)); }
Matches a method description that takes the provided raw arguments.
Params:
  • type – The arguments to match against the matched method.
Type parameters:
  • <T> – The type of the matched object.
Returns:A method matcher that matches a method's raw parameter types against the supplied arguments.
/** * Matches a method description that takes the provided raw arguments. * * @param type The arguments to match against the matched method. * @param <T> The type of the matched object. * @return A method matcher that matches a method's raw parameter types against the supplied arguments. */
public static <T extends MethodDescription> ElementMatcher.Junction<T> takesArguments(TypeDescription... type) { return takesGenericArguments(erasures(type)); }
Matches a method description that takes the provided raw arguments.
Params:
  • types – The arguments to match against the matched method.
Type parameters:
  • <T> – The type of the matched object.
Returns:A method matcher that matches a method's raw parameter types against the supplied arguments.
/** * Matches a method description that takes the provided raw arguments. * * @param types The arguments to match against the matched method. * @param <T> The type of the matched object. * @return A method matcher that matches a method's raw parameter types against the supplied arguments. */
public static <T extends MethodDescription> ElementMatcher.Junction<T> takesArguments(Iterable<? extends TypeDescription> types) { List<ElementMatcher<? super TypeDescription.Generic>> typeMatchers = new ArrayList<ElementMatcher<? super TypeDescription.Generic>>(); for (TypeDescription type : types) { typeMatchers.add(erasure(type)); } return takesGenericArguments(new CollectionOneToOneMatcher<TypeDescription.Generic>(typeMatchers)); }
Matches a MethodDescription by applying an iterable collection of element matcher on any parameter's TypeDescription.
Params:
  • matchers – The matcher that are applied onto the parameter types of the matched method description.
Type parameters:
  • <T> – The type of the matched object.
Returns:A matcher that matches a method description by applying another element matcher onto each parameter's type.
/** * Matches a {@link MethodDescription} by applying an iterable collection of element matcher on any parameter's {@link TypeDescription}. * * @param matchers The matcher that are applied onto the parameter types of the matched method description. * @param <T> The type of the matched object. * @return A matcher that matches a method description by applying another element matcher onto each parameter's type. */
public static <T extends MethodDescription> ElementMatcher.Junction<T> takesArguments(ElementMatcher<? super Iterable<? extends TypeDescription>> matchers) { return new MethodParametersMatcher<T>(new MethodParameterTypesMatcher<ParameterList<?>>(erasures(matchers))); }
Matches a MethodDescription by the number of its parameters.
Params:
  • length – The expected length.
Type parameters:
  • <T> – The type of the matched object.
Returns:A matcher that matches a method description by the number of its parameters.
/** * Matches a {@link MethodDescription} by the number of its parameters. * * @param length The expected length. * @param <T> The type of the matched object. * @return A matcher that matches a method description by the number of its parameters. */
public static <T extends MethodDescription> ElementMatcher.Junction<T> takesArguments(int length) { return new MethodParametersMatcher<T>(new CollectionSizeMatcher<ParameterList<?>>(length)); }
Matches a MethodDescription with no parameters.
Type parameters:
  • <T> – The type of the matched object.
Returns:A matcher that matches a method description by the number of its parameters.
/** * Matches a {@link MethodDescription} with no parameters. * * @param <T> The type of the matched object. * @return A matcher that matches a method description by the number of its parameters. */
public static <T extends MethodDescription> ElementMatcher.Junction<T> takesNoArguments() { return takesArguments(0); }
Matches a MethodDescription by validating that its parameters fulfill a given constraint.
Params:
  • matcher – The matcher to apply for validating the parameters.
Type parameters:
  • <T> – The type of the matched object.
Returns:A matcher that matches a method description's parameters against the given constraint.
/** * Matches a {@link MethodDescription} by validating that its parameters * fulfill a given constraint. * * @param matcher The matcher to apply for validating the parameters. * @param <T> The type of the matched object. * @return A matcher that matches a method description's parameters against the given constraint. */
public static <T extends MethodDescription> ElementMatcher.Junction<T> hasParameters( ElementMatcher<? super Iterable<? extends ParameterDescription>> matcher) { return new MethodParametersMatcher<T>(matcher); }
Matches a MethodDescription by its capability to throw a given checked exception. For specifying a non-checked exception, any method is matched.
Params:
  • exceptionType – The type of the exception that should be declared by the method to be matched.
Type parameters:
  • <T> – The type of the matched object.
Returns:A matcher that matches a method description by its declaration of throwing a checked exception.
/** * Matches a {@link MethodDescription} by its capability to throw a given * checked exception. For specifying a non-checked exception, any method is matched. * * @param exceptionType The type of the exception that should be declared by the method to be matched. * @param <T> The type of the matched object. * @return A matcher that matches a method description by its declaration of throwing a checked exception. */
public static <T extends MethodDescription> ElementMatcher.Junction<T> canThrow(Class<? extends Throwable> exceptionType) { return canThrow(TypeDescription.ForLoadedType.of(exceptionType)); }
Matches a MethodDescription by its capability to throw a given checked exception. For specifying a non-checked exception, any method is matched.
Params:
  • exceptionType – The type of the exception that should be declared by the method to be matched.
Type parameters:
  • <T> – The type of the matched object.
Returns:A matcher that matches a method description by its declaration of throwing a checked exception.
/** * Matches a {@link MethodDescription} by its capability to throw a given * checked exception. For specifying a non-checked exception, any method is matched. * * @param exceptionType The type of the exception that should be declared by the method to be matched. * @param <T> The type of the matched object. * @return A matcher that matches a method description by its declaration of throwing a checked exception. */
public static <T extends MethodDescription> ElementMatcher.Junction<T> canThrow(TypeDescription exceptionType) { return exceptionType.isAssignableTo(RuntimeException.class) || exceptionType.isAssignableTo(Error.class) ? new BooleanMatcher<T>(true) : ElementMatchers.<T>declaresGenericException(new CollectionItemMatcher<TypeDescription.Generic>(erasure(isSuperTypeOf(exceptionType)))); }
Matches a method that declares the given generic exception type. For non-generic type, this matcher behaves identically to declaresException(Class<? extends Throwable>). For exceptions that are expressed as type variables, only exceptions that are represented as this type variable are matched.
Params:
  • exceptionType – The generic exception type that is matched exactly.
Type parameters:
  • <T> – The type of the matched object.
Returns:A matcher that matches any method that exactly matches the provided generic exception.
/** * Matches a method that declares the given generic exception type. For non-generic type, this matcher behaves identically to * {@link ElementMatchers#declaresException(Class)}. For exceptions that are expressed as type variables, only exceptions * that are represented as this type variable are matched. * * @param exceptionType The generic exception type that is matched exactly. * @param <T> The type of the matched object. * @return A matcher that matches any method that exactly matches the provided generic exception. */
public static <T extends MethodDescription> ElementMatcher.Junction<T> declaresGenericException(Type exceptionType) { return declaresGenericException(TypeDefinition.Sort.describe(exceptionType)); }
Matches a method that declares the given generic exception type. For non-generic type, this matcher behaves identically to declaresException(TypeDescription). For exceptions that are expressed as type variables, only exceptions that are represented as this type variable are matched.
Params:
  • exceptionType – The generic exception type that is matched exactly.
Type parameters:
  • <T> – The type of the matched object.
Returns:A matcher that matches any method that exactly matches the provided generic exception.
/** * Matches a method that declares the given generic exception type. For non-generic type, this matcher behaves identically to * {@link ElementMatchers#declaresException(TypeDescription)}. For exceptions that are expressed as type variables, only exceptions * that are represented as this type variable are matched. * * @param exceptionType The generic exception type that is matched exactly. * @param <T> The type of the matched object. * @return A matcher that matches any method that exactly matches the provided generic exception. */
public static <T extends MethodDescription> ElementMatcher.Junction<T> declaresGenericException(TypeDescription.Generic exceptionType) { return !exceptionType.getSort().isWildcard() && exceptionType.asErasure().isAssignableTo(Throwable.class) ? ElementMatchers.<T>declaresGenericException(new CollectionItemMatcher<TypeDescription.Generic>(is(exceptionType))) : new BooleanMatcher<T>(false); }
Matches a method that declares the given generic exception type as a (erased) exception type.
Params:
  • exceptionType – The exception type that is matched.
Type parameters:
  • <T> – The type of the matched object.
Returns:A matcher that matches any method that exactly matches the provided exception.
/** * Matches a method that declares the given generic exception type as a (erased) exception type. * * @param exceptionType The exception type that is matched. * @param <T> The type of the matched object. * @return A matcher that matches any method that exactly matches the provided exception. */
public static <T extends MethodDescription> ElementMatcher.Junction<T> declaresException(Class<? extends Throwable> exceptionType) { return declaresException(TypeDescription.ForLoadedType.of(exceptionType)); }
Matches a method that declares the given generic exception type as a (erased) exception type.
Params:
  • exceptionType – The exception type that is matched.
Type parameters:
  • <T> – The type of the matched object.
Returns:A matcher that matches any method that exactly matches the provided exception.
/** * Matches a method that declares the given generic exception type as a (erased) exception type. * * @param exceptionType The exception type that is matched. * @param <T> The type of the matched object. * @return A matcher that matches any method that exactly matches the provided exception. */
public static <T extends MethodDescription> ElementMatcher.Junction<T> declaresException(TypeDescription exceptionType) { return exceptionType.isAssignableTo(Throwable.class) ? ElementMatchers.<T>declaresGenericException(new CollectionItemMatcher<TypeDescription.Generic>(erasure(exceptionType))) : new BooleanMatcher<T>(false); }
Matches a method's generic exception types against the provided matcher.
Params:
  • matcher – The exception matcher to apply onto the matched method's generic exceptions.
Type parameters:
  • <T> – The type of the matched object.
Returns:A matcher that applies the provided matcher to a method's generic exception types.
/** * Matches a method's generic exception types against the provided matcher. * * @param matcher The exception matcher to apply onto the matched method's generic exceptions. * @param <T> The type of the matched object. * @return A matcher that applies the provided matcher to a method's generic exception types. */
public static <T extends MethodDescription> ElementMatcher.Junction<T> declaresGenericException( ElementMatcher<? super Iterable<? extends TypeDescription.Generic>> matcher) { return new MethodExceptionTypeMatcher<T>(matcher); }
Matches any virtual method with a signature that is compatible to a method that is declared the supplied type.
Params:
  • type – The super type of interest for which to check if it declares a method with the same signature as the matched method.
Type parameters:
  • <T> – The type of the matched object.
Returns:A matcher that checks a method's signature equality for any method declared by the declaring type.
/** * Matches any virtual method with a signature that is compatible to a method that is declared the supplied type. * * @param type The super type of interest for which to check if it declares a method with the same signature as the matched method. * @param <T> The type of the matched object. * @return A matcher that checks a method's signature equality for any method declared by the declaring type. */
public static <T extends MethodDescription> ElementMatcher.Junction<T> isOverriddenFrom(Class<?> type) { return isOverriddenFrom(TypeDescription.ForLoadedType.of(type)); }
Matches any virtual method with a signature that is compatible to a method that is declared the supplied type.
Params:
  • type – The super type of interest for which to check if it declares a method with the same signature as the matched method.
Type parameters:
  • <T> – The type of the matched object.
Returns:A matcher that checks a method's signature equality for any method declared by the declaring type.
/** * Matches any virtual method with a signature that is compatible to a method that is declared the supplied type. * * @param type The super type of interest for which to check if it declares a method with the same signature as the matched method. * @param <T> The type of the matched object. * @return A matcher that checks a method's signature equality for any method declared by the declaring type. */
public static <T extends MethodDescription> ElementMatcher.Junction<T> isOverriddenFrom(TypeDescription type) { return isOverriddenFrom(is(type)); }
Matches any virtual method with a signature that is compatible to a method that is declared by a type that matches the supplied matcher.
Params:
  • matcher – A matcher for a method's declaring type that needs to be matched if that type declares a method with the same signature as the matched method.
Type parameters:
  • <T> – The type of the matched object.
Returns:A matcher that checks a method's signature equality for any method declared by the declaring type.
/** * Matches any virtual method with a signature that is compatible to a method that is declared by a type that matches the supplied matcher. * * @param matcher A matcher for a method's declaring type that needs to be matched if that type declares a method with the same signature * as the matched method. * @param <T> The type of the matched object. * @return A matcher that checks a method's signature equality for any method declared by the declaring type. */
public static <T extends MethodDescription> ElementMatcher.Junction<T> isOverriddenFrom(ElementMatcher<? super TypeDescription> matcher) { return isOverriddenFromGeneric(erasure(matcher)); }
Matches any virtual method with a signature that is compatible to a method that is declared the supplied type.
Params:
  • type – The super type of interest for which to check if it declares a method with the same signature as the matched method.
Type parameters:
  • <T> – The type of the matched object.
Returns:A matcher that checks a method's signature equality for any method declared by the declaring type.
/** * Matches any virtual method with a signature that is compatible to a method that is declared the supplied type. * * @param type The super type of interest for which to check if it declares a method with the same signature as the matched method. * @param <T> The type of the matched object. * @return A matcher that checks a method's signature equality for any method declared by the declaring type. */
public static <T extends MethodDescription> ElementMatcher.Junction<T> isOverriddenFromGeneric(Type type) { return isOverriddenFromGeneric(TypeDescription.Generic.Sort.describe(type)); }
Matches any virtual method with a signature that is compatible to a method that is declared the supplied type.
Params:
  • type – The super type of interest for which to check if it declares a method with the same signature as the matched method.
Type parameters:
  • <T> – The type of the matched object.
Returns:A matcher that checks a method's signature equality for any method declared by the declaring type.
/** * Matches any virtual method with a signature that is compatible to a method that is declared the supplied type. * * @param type The super type of interest for which to check if it declares a method with the same signature as the matched method. * @param <T> The type of the matched object. * @return A matcher that checks a method's signature equality for any method declared by the declaring type. */
public static <T extends MethodDescription> ElementMatcher.Junction<T> isOverriddenFromGeneric(TypeDescription.Generic type) { return isOverriddenFromGeneric(is(type)); }
Matches any virtual method with a signature that is compatible to a method that is declared by a type that matches the supplied matcher.
Params:
  • matcher – A matcher for a method's declaring type that needs to be matched if that type declares a method with the same signature as the matched method.
Type parameters:
  • <T> – The type of the matched object.
Returns:A matcher that checks a method's signature equality for any method declared by the declaring type.
/** * Matches any virtual method with a signature that is compatible to a method that is declared by a type that matches the supplied matcher. * * @param matcher A matcher for a method's declaring type that needs to be matched if that type declares a method with the same signature * as the matched method. * @param <T> The type of the matched object. * @return A matcher that checks a method's signature equality for any method declared by the declaring type. */
public static <T extends MethodDescription> ElementMatcher.Junction<T> isOverriddenFromGeneric(ElementMatcher<? super TypeDescription.Generic> matcher) { return new MethodOverrideMatcher<T>(matcher); }
Matches a TypeDescription that is an interface. Annotation types are also considered interface types.
Type parameters:
  • <T> – The type of the matched object.
See Also:
Returns:A matcher for an interface.
/** * Matches a {@link TypeDescription} that is an interface. Annotation types are also considered interface types. * * @param <T> The type of the matched object. * @return A matcher for an interface. * @see ElementMatchers#isAnnotation() */
public static <T extends TypeDescription> ElementMatcher.Junction<T> isInterface() { return new ModifierMatcher<T>(ModifierMatcher.Mode.INTERFACE); }
Matches a TypeDescription that is an annotation type.
Type parameters:
  • <T> – The type of the matched object.
Returns:A matcher for an annotation type.
/** * Matches a {@link TypeDescription} that is an annotation type. * * @param <T> The type of the matched object. * @return A matcher for an annotation type. */
public static <T extends TypeDescription> ElementMatcher.Junction<T> isAnnotation() { return new ModifierMatcher<T>(ModifierMatcher.Mode.ANNOTATION); }
Only matches method descriptions that represent a Method.
Type parameters:
  • <T> – The type of the matched object.
Returns:A matcher that only matches method descriptions that represent a Java method.
/** * Only matches method descriptions that represent a {@link java.lang.reflect.Method}. * * @param <T> The type of the matched object. * @return A matcher that only matches method descriptions that represent a Java method. */
public static <T extends MethodDescription> ElementMatcher.Junction<T> isMethod() { return new MethodSortMatcher<T>(MethodSortMatcher.Sort.METHOD); }
Only matches method descriptions that represent a Constructor.
Type parameters:
  • <T> – The type of the matched object.
Returns:A matcher that only matches method descriptions that represent a Java constructor.
/** * Only matches method descriptions that represent a {@link java.lang.reflect.Constructor}. * * @param <T> The type of the matched object. * @return A matcher that only matches method descriptions that represent a Java constructor. */
public static <T extends MethodDescription> ElementMatcher.Junction<T> isConstructor() { return new MethodSortMatcher<T>(MethodSortMatcher.Sort.CONSTRUCTOR); }
Only matches method descriptions that represent a Class type initializer.
Type parameters:
  • <T> – The type of the matched object.
Returns:A matcher that only matches method descriptions that represent the type initializer.
/** * Only matches method descriptions that represent a {@link java.lang.Class} type initializer. * * @param <T> The type of the matched object. * @return A matcher that only matches method descriptions that represent the type initializer. */
public static <T extends MethodDescription> ElementMatcher.Junction<T> isTypeInitializer() { return new MethodSortMatcher<T>(MethodSortMatcher.Sort.TYPE_INITIALIZER); }
Matches any method that is virtual, i.e. non-constructors that are non-static and non-private.
Type parameters:
  • <T> – The type of the matched object.
Returns:A matcher for virtual methods.
/** * Matches any method that is virtual, i.e. non-constructors that are non-static and non-private. * * @param <T> The type of the matched object. * @return A matcher for virtual methods. */
public static <T extends MethodDescription> ElementMatcher.Junction<T> isVirtual() { return new MethodSortMatcher<T>(MethodSortMatcher.Sort.VIRTUAL); }
Only matches Java 8 default methods.
Type parameters:
  • <T> – The type of the matched object.
Returns:A matcher that only matches Java 8 default methods.
/** * Only matches Java 8 default methods. * * @param <T> The type of the matched object. * @return A matcher that only matches Java 8 default methods. */
public static <T extends MethodDescription> ElementMatcher.Junction<T> isDefaultMethod() { return new MethodSortMatcher<T>(MethodSortMatcher.Sort.DEFAULT_METHOD); }
Matches a default constructor, i.e. a constructor without arguments.
Type parameters:
  • <T> – The type of the matched object.
Returns:A matcher that matches a default constructor.
/** * Matches a default constructor, i.e. a constructor without arguments. * * @param <T> The type of the matched object. * @return A matcher that matches a default constructor. */
public static <T extends MethodDescription> ElementMatcher.Junction<T> isDefaultConstructor() { return isConstructor().and(takesNoArguments()); }
Only matches the Object.finalize() method if it was not overridden.
Type parameters:
  • <T> – The type of the matched object.
Returns:A matcher that only matches a non-overridden Object.finalize() method.
/** * Only matches the {@link Object#finalize()} method if it was not overridden. * * @param <T> The type of the matched object. * @return A matcher that only matches a non-overridden {@link Object#finalize()} method. */
public static <T extends MethodDescription> ElementMatcher.Junction<T> isDefaultFinalizer() { return isFinalizer().and(isDeclaredBy(TypeDescription.OBJECT)); }
Only matches the Object.finalize() method, even if it was overridden.
Type parameters:
  • <T> – The type of the matched object.
Returns:A matcher that only matches the Object.finalize() method.
/** * Only matches the {@link Object#finalize()} method, even if it was overridden. * * @param <T> The type of the matched object. * @return A matcher that only matches the {@link Object#finalize()} method. */
public static <T extends MethodDescription> ElementMatcher.Junction<T> isFinalizer() { return named("finalize").and(takesNoArguments()).and(returns(TypeDescription.VOID)); }
Only matches the Object.hashCode() method, also if it was overridden.
Type parameters:
  • <T> – The type of the matched object.
Returns:A matcher that only matches the Object.hashCode() method.
/** * Only matches the {@link Object#hashCode()} method, also if it was overridden. * * @param <T> The type of the matched object. * @return A matcher that only matches the {@link Object#hashCode()} method. */
public static <T extends MethodDescription> ElementMatcher.Junction<T> isHashCode() { return named("hashCode").and(takesNoArguments()).and(returns(int.class)); }
Only matches the Object.equals(Object) method, also if it was overridden.
Type parameters:
  • <T> – The type of the matched object.
Returns:A matcher that only matches the Object.equals(Object) method.
/** * Only matches the {@link Object#equals(Object)} method, also if it was overridden. * * @param <T> The type of the matched object. * @return A matcher that only matches the {@link Object#equals(Object)} method. */
public static <T extends MethodDescription> ElementMatcher.Junction<T> isEquals() { return named("equals").and(takesArguments(TypeDescription.OBJECT)).and(returns(boolean.class)); }
Only matches the Object.clone() method, also if it was overridden.
Type parameters:
  • <T> – The type of the matched object.
Returns:A matcher that only matches the Object.clone() method.
/** * Only matches the {@link Object#clone()} method, also if it was overridden. * * @param <T> The type of the matched object. * @return A matcher that only matches the {@link Object#clone()} method. */
public static <T extends MethodDescription> ElementMatcher.Junction<T> isClone() { return named("clone").and(takesNoArguments()); }
Only matches the Object.toString() method, also if it was overridden.
Type parameters:
  • <T> – The type of the matched object.
Returns:A matcher that only matches the Object.toString() method.
/** * Only matches the {@link Object#toString()} method, also if it was overridden. * * @param <T> The type of the matched object. * @return A matcher that only matches the {@link Object#toString()} method. */
public static <T extends MethodDescription> ElementMatcher.Junction<T> isToString() { return named("toString").and(takesNoArguments()).and(returns(TypeDescription.STRING)); }
Matches any Java bean setter method.
Type parameters:
  • <T> – The type of the matched object.
Returns:A matcher that matches any setter method.
/** * Matches any Java bean setter method. * * @param <T> The type of the matched object. * @return A matcher that matches any setter method. */
public static <T extends MethodDescription> ElementMatcher.Junction<T> isSetter() { return nameStartsWith("set").and(takesArguments(1)).and(returns(TypeDescription.VOID)); }
An element matcher that matches any setter for the given property. When given an empty string, any setter named set is matched despite that such a setter is not fulfilling the Java bean naming conventions.
Params:
  • property – The property to match a setter for.
Type parameters:
  • <T> – The type of the matched object.
Returns:A matcher that matches any setter method for the supplied property.
/** * An element matcher that matches any setter for the given property. When given an empty string, any setter named {@code set} * is matched despite that such a setter is not fulfilling the Java bean naming conventions. * * @param property The property to match a setter for. * @param <T> The type of the matched object. * @return A matcher that matches any setter method for the supplied property. */
public static <T extends MethodDescription> ElementMatcher.Junction<T> isSetter(String property) { return isSetter().and(property.length() == 0 ? named("set") : named("set" + Character.toUpperCase(property.charAt(0)) + property.substring(1))); }
Matches any Java bean setter method which takes an argument the given type.
Params:
  • type – The required setter type.
Type parameters:
  • <T> – The type of the matched object.
Returns:A matcher that matches any setter method.
/** * Matches any Java bean setter method which takes an argument the given type. * * @param type The required setter type. * @param <T> The type of the matched object. * @return A matcher that matches any setter method. */
public static <T extends MethodDescription> ElementMatcher.Junction<T> isSetter(Class<?> type) { return isSetter(TypeDescription.ForLoadedType.of(type)); }
Matches any Java bean setter method which takes an argument the given type.
Params:
  • type – The required setter type.
Type parameters:
  • <T> – The type of the matched object.
Returns:A matcher that matches any setter method.
/** * Matches any Java bean setter method which takes an argument the given type. * * @param type The required setter type. * @param <T> The type of the matched object. * @return A matcher that matches any setter method. */
public static <T extends MethodDescription> ElementMatcher.Junction<T> isGenericSetter(Type type) { return isGenericSetter(TypeDefinition.Sort.describe(type)); }
Matches any Java bean setter method which takes an argument the given type.
Params:
  • type – The required setter type.
Type parameters:
  • <T> – The type of the matched object.
Returns:A matcher that matches a setter method with the specified argument type.
/** * Matches any Java bean setter method which takes an argument the given type. * * @param type The required setter type. * @param <T> The type of the matched object. * @return A matcher that matches a setter method with the specified argument type. */
public static <T extends MethodDescription> ElementMatcher.Junction<T> isSetter(TypeDescription type) { return isSetter(is(type)); }
Matches any Java bean setter method which takes an argument the given type.
Params:
  • type – The required setter type.
Type parameters:
  • <T> – The type of the matched object.
Returns:A matcher that matches a setter method with the specified argument type.
/** * Matches any Java bean setter method which takes an argument the given type. * * @param type The required setter type. * @param <T> The type of the matched object. * @return A matcher that matches a setter method with the specified argument type. */
public static <T extends MethodDescription> ElementMatcher.Junction<T> isGenericSetter(TypeDescription.Generic type) { return isGenericSetter(is(type)); }
Matches any Java bean setter method which takes an argument that matches the supplied matcher.
Params:
  • matcher – A matcher to be allied to a setter method's argument type.
Type parameters:
  • <T> – The type of the matched object.
Returns:A matcher that matches a setter method with an argument type that matches the supplied matcher.
/** * Matches any Java bean setter method which takes an argument that matches the supplied matcher. * * @param matcher A matcher to be allied to a setter method's argument type. * @param <T> The type of the matched object. * @return A matcher that matches a setter method with an argument type that matches the supplied matcher. */
public static <T extends MethodDescription> ElementMatcher.Junction<T> isSetter(ElementMatcher<? super TypeDescription> matcher) { return isGenericSetter(erasure(matcher)); }
Matches any Java bean setter method which takes an argument that matches the supplied matcher.
Params:
  • matcher – A matcher to be allied to a setter method's argument type.
Type parameters:
  • <T> – The type of the matched object.
Returns:A matcher that matches a setter method with an argument type that matches the supplied matcher.
/** * Matches any Java bean setter method which takes an argument that matches the supplied matcher. * * @param matcher A matcher to be allied to a setter method's argument type. * @param <T> The type of the matched object. * @return A matcher that matches a setter method with an argument type that matches the supplied matcher. */
public static <T extends MethodDescription> ElementMatcher.Junction<T> isGenericSetter(ElementMatcher<? super TypeDescription.Generic> matcher) { return isSetter().and(takesGenericArguments(new CollectionOneToOneMatcher<TypeDescription.Generic>(Collections.singletonList(matcher)))); }
Matches any Java bean getter method.
Type parameters:
  • <T> – The type of the matched object.
Returns:A matcher that matches any getter method.
/** * Matches any Java bean getter method. * * @param <T> The type of the matched object. * @return A matcher that matches any getter method. */
public static <T extends MethodDescription> ElementMatcher.Junction<T> isGetter() { return takesNoArguments().and(not(returns(TypeDescription.VOID))).and(nameStartsWith("get").or(nameStartsWith("is").and(returnsGeneric(anyOf(boolean.class, Boolean.class))))); }
An element matcher that matches any getter for the given property. When given an empty string, any getter named get is matched despite that such a getter is not fulfilling the Java bean naming conventions. If a getter's type is boolean or Boolean, is is also accepted as a prefix.
Params:
  • property – The property to match a getter for.
Type parameters:
  • <T> – The type of the matched object.
Returns:A matcher that matches any getter method for the supplied property.
/** * An element matcher that matches any getter for the given property. When given an empty string, any getter named {@code get} * is matched despite that such a getter is not fulfilling the Java bean naming conventions. If a getter's type is {@code boolean} * or {@link Boolean}, {@code is} is also accepted as a prefix. * * @param property The property to match a getter for. * @param <T> The type of the matched object. * @return A matcher that matches any getter method for the supplied property. */
public static <T extends MethodDescription> ElementMatcher.Junction<T> isGetter(String property) { return isGetter().and(property.length() == 0 ? named("get").or(named("is")) : named("get" + Character.toUpperCase(property.charAt(0)) + property.substring(1)).or(named("is" + Character.toUpperCase(property.charAt(0)) + property.substring(1)))); }
Matches any Java bean getter method which returns the given type.
Params:
  • type – The required getter type.
Type parameters:
  • <T> – The type of the matched object.
Returns:A matcher that matches a getter method with the given type.
/** * Matches any Java bean getter method which returns the given type. * * @param type The required getter type. * @param <T> The type of the matched object. * @return A matcher that matches a getter method with the given type. */
public static <T extends MethodDescription> ElementMatcher.Junction<T> isGetter(Class<?> type) { return isGetter(TypeDescription.ForLoadedType.of(type)); }
Matches any Java bean getter method which returns the given type.
Params:
  • type – The required getter type.
Type parameters:
  • <T> – The type of the matched object.
Returns:A matcher that matches a getter method with the given type.
/** * Matches any Java bean getter method which returns the given type. * * @param type The required getter type. * @param <T> The type of the matched object. * @return A matcher that matches a getter method with the given type. */
public static <T extends MethodDescription> ElementMatcher.Junction<T> isGenericGetter(Type type) { return isGenericGetter(TypeDefinition.Sort.describe(type)); }
Matches any Java bean getter method which returns the given type.
Params:
  • type – The required getter type.
Type parameters:
  • <T> – The type of the matched object.
Returns:A matcher that matches a getter method with the given type.
/** * Matches any Java bean getter method which returns the given type. * * @param type The required getter type. * @param <T> The type of the matched object. * @return A matcher that matches a getter method with the given type. */
public static <T extends MethodDescription> ElementMatcher.Junction<T> isGetter(TypeDescription type) { return isGetter(is(type)); }
Matches any Java bean getter method which returns the given type.
Params:
  • type – The required getter type.
Type parameters:
  • <T> – The type of the matched object.
Returns:A matcher that matches a getter method with the given type.
/** * Matches any Java bean getter method which returns the given type. * * @param type The required getter type. * @param <T> The type of the matched object. * @return A matcher that matches a getter method with the given type. */
public static <T extends MethodDescription> ElementMatcher.Junction<T> isGenericGetter(TypeDescription.Generic type) { return isGenericGetter(is(type)); }
Matches any Java bean getter method which returns an value with a type matches the supplied matcher.
Params:
  • matcher – A matcher to be allied to a getter method's argument type.
Type parameters:
  • <T> – The type of the matched object.
Returns:A matcher that matches a getter method with a return type that matches the supplied matcher.
/** * Matches any Java bean getter method which returns an value with a type matches the supplied matcher. * * @param matcher A matcher to be allied to a getter method's argument type. * @param <T> The type of the matched object. * @return A matcher that matches a getter method with a return type that matches the supplied matcher. */
public static <T extends MethodDescription> ElementMatcher.Junction<T> isGetter(ElementMatcher<? super TypeDescription> matcher) { return isGenericGetter(erasure(matcher)); }
Matches any Java bean getter method which returns an value with a type matches the supplied matcher.
Params:
  • matcher – A matcher to be allied to a getter method's argument type.
Type parameters:
  • <T> – The type of the matched object.
Returns:A matcher that matches a getter method with a return type that matches the supplied matcher.
/** * Matches any Java bean getter method which returns an value with a type matches the supplied matcher. * * @param matcher A matcher to be allied to a getter method's argument type. * @param <T> The type of the matched object. * @return A matcher that matches a getter method with a return type that matches the supplied matcher. */
public static <T extends MethodDescription> ElementMatcher.Junction<T> isGenericGetter(ElementMatcher<? super TypeDescription.Generic> matcher) { return isGetter().and(returnsGeneric(matcher)); }
Matches a method against its internal name such that constructors and type initializers are matched appropriately.
Params:
  • internalName – The internal name of the method.
Type parameters:
  • <T> – The type of the matched object.
Returns:A matcher for a method with the provided internal name.
/** * Matches a method against its internal name such that constructors and type initializers are matched appropriately. * * @param internalName The internal name of the method. * @param <T> The type of the matched object. * @return A matcher for a method with the provided internal name. */
public static <T extends MethodDescription> ElementMatcher.Junction<T> hasMethodName(String internalName) { if (MethodDescription.CONSTRUCTOR_INTERNAL_NAME.equals(internalName)) { return isConstructor(); } else if (MethodDescription.TYPE_INITIALIZER_INTERNAL_NAME.equals(internalName)) { return isTypeInitializer(); } else { return named(internalName); } }
Only matches method descriptions that yield the provided signature token.
Params:
  • token – The signature token to match against.
Type parameters:
  • <T> – The type of the matched object.
Returns:A matcher for a method with the provided signature token.
/** * Only matches method descriptions that yield the provided signature token. * * @param token The signature token to match against. * @param <T> The type of the matched object. * @return A matcher for a method with the provided signature token. */
public static <T extends MethodDescription> ElementMatcher.Junction<T> hasSignature(MethodDescription.SignatureToken token) { return new SignatureTokenMatcher<T>(is(token)); }
Matches any type description that is a subtype of the given type.
Params:
  • type – The type to be checked for being a subtype of the matched type.
Type parameters:
  • <T> – The type of the matched object.
Returns:A matcher that matches any type description that represents a sub type of the given type.
/** * Matches any type description that is a subtype of the given type. * * @param type The type to be checked for being a subtype of the matched type. * @param <T> The type of the matched object. * @return A matcher that matches any type description that represents a sub type of the given type. */
public static <T extends TypeDescription> ElementMatcher.Junction<T> isSubTypeOf(Class<?> type) { return isSubTypeOf(TypeDescription.ForLoadedType.of(type)); }
Matches any type description that is a subtype of the given type.
Params:
  • type – The type to be checked for being a subtype of the matched type.
Type parameters:
  • <T> – The type of the matched object.
Returns:A matcher that matches any type description that represents a sub type of the given type.
/** * Matches any type description that is a subtype of the given type. * * @param type The type to be checked for being a subtype of the matched type. * @param <T> The type of the matched object. * @return A matcher that matches any type description that represents a sub type of the given type. */
public static <T extends TypeDescription> ElementMatcher.Junction<T> isSubTypeOf(TypeDescription type) { return new SubTypeMatcher<T>(type); }
Matches any type description that is a super type of the given type.
Params:
  • type – The type to be checked for being a subtype of the matched type.
Type parameters:
  • <T> – The type of the matched object.
Returns:A matcher that matches any type description that represents a super type of the given type.
/** * Matches any type description that is a super type of the given type. * * @param type The type to be checked for being a subtype of the matched type. * @param <T> The type of the matched object. * @return A matcher that matches any type description that represents a super type of the given type. */
public static <T extends TypeDescription> ElementMatcher.Junction<T> isSuperTypeOf(Class<?> type) { return isSuperTypeOf(TypeDescription.ForLoadedType.of(type)); }
Matches any type description that is a super type of the given type.
Params:
  • type – The type to be checked for being a subtype of the matched type.
Type parameters:
  • <T> – The type of the matched object.
Returns:A matcher that matches any type description that represents a super type of the given type.
/** * Matches any type description that is a super type of the given type. * * @param type The type to be checked for being a subtype of the matched type. * @param <T> The type of the matched object. * @return A matcher that matches any type description that represents a super type of the given type. */
public static <T extends TypeDescription> ElementMatcher.Junction<T> isSuperTypeOf(TypeDescription type) { return new SuperTypeMatcher<T>(type); }
Matches any type description that declares a super class (but not interface) that matches the provided matcher.
Params:
  • matcher – The type to be checked for being a super class of the matched type.
Type parameters:
  • <T> – The type of the matched object.
Returns:A matcher that matches any type description that declares a super class that matches the provided matcher.
/** * Matches any type description that declares a super class (but not interface) that matches the provided matcher. * * @param matcher The type to be checked for being a super class of the matched type. * @param <T> The type of the matched object. * @return A matcher that matches any type description that declares a super class that matches the provided matcher. */
public static <T extends TypeDescription> ElementMatcher.Junction<T> hasSuperClass(ElementMatcher<? super TypeDescription> matcher) { return hasGenericSuperClass(erasure(matcher)); }
Matches any type description that declares a super class (but not interface) that matches the provided matcher.
Params:
  • matcher – The type to be checked for being a super class of the matched type.
Type parameters:
  • <T> – The type of the matched object.
Returns:A matcher that matches any type description that declares a super class that matches the provided matcher.
/** * Matches any type description that declares a super class (but not interface) that matches the provided matcher. * * @param matcher The type to be checked for being a super class of the matched type. * @param <T> The type of the matched object. * @return A matcher that matches any type description that declares a super class that matches the provided matcher. */
public static <T extends TypeDescription> ElementMatcher.Junction<T> hasGenericSuperClass(ElementMatcher<? super TypeDescription.Generic> matcher) { return new HasSuperClassMatcher<T>(matcher); }
Matches any type description that declares a super type that matches the provided matcher.
Params:
  • matcher – The type to be checked for being a super type of the matched type.
Type parameters:
  • <T> – The type of the matched object.
Returns:A matcher that matches any type description that declares a super type that matches the provided matcher.
/** * Matches any type description that declares a super type that matches the provided matcher. * * @param matcher The type to be checked for being a super type of the matched type. * @param <T> The type of the matched object. * @return A matcher that matches any type description that declares a super type that matches the provided matcher. */
public static <T extends TypeDescription> ElementMatcher.Junction<T> hasSuperType(ElementMatcher<? super TypeDescription> matcher) { return hasGenericSuperType(erasure(matcher)); }
Matches any type description that declares a super type that matches the provided matcher.
Params:
  • matcher – The type to be checked for being a super type of the matched type.
Type parameters:
  • <T> – The type of the matched object.
Returns:A matcher that matches any type description that declares a super type that matches the provided matcher.
/** * Matches any type description that declares a super type that matches the provided matcher. * * @param matcher The type to be checked for being a super type of the matched type. * @param <T> The type of the matched object. * @return A matcher that matches any type description that declares a super type that matches the provided matcher. */
public static <T extends TypeDescription> ElementMatcher.Junction<T> hasGenericSuperType(ElementMatcher<? super TypeDescription.Generic> matcher) { return new HasSuperTypeMatcher<T>(matcher); }
Matches any annotations by their type on a type that declared these annotations or inherited them from its super classes.
Params:
  • type – The annotation type to be matched.
Type parameters:
  • <T> – The type of the matched object.
Returns:A matcher that matches any inherited annotation by their type.
/** * Matches any annotations by their type on a type that declared these annotations or inherited them from its * super classes. * * @param type The annotation type to be matched. * @param <T> The type of the matched object. * @return A matcher that matches any inherited annotation by their type. */
public static <T extends TypeDescription> ElementMatcher.Junction<T> inheritsAnnotation(Class<?> type) { return inheritsAnnotation(TypeDescription.ForLoadedType.of(type)); }
Matches any annotations by their type on a type that declared these annotations or inherited them from its super classes.
Params:
  • type – The annotation type to be matched.
Type parameters:
  • <T> – The type of the matched object.
Returns:A matcher that matches any inherited annotation by their type.
/** * Matches any annotations by their type on a type that declared these annotations or inherited them from its * super classes. * * @param type The annotation type to be matched. * @param <T> The type of the matched object. * @return A matcher that matches any inherited annotation by their type. */
public static <T extends TypeDescription> ElementMatcher.Junction<T> inheritsAnnotation(TypeDescription type) { return inheritsAnnotation(is(type)); }
Matches any annotations by a given matcher on a type that declared these annotations or inherited them from its super classes.
Params:
  • matcher – A matcher to apply onto the inherited annotations.
Type parameters:
  • <T> – The type of the matched object.
Returns:A matcher that matches any inherited annotation by a given matcher.
/** * Matches any annotations by a given matcher on a type that declared these annotations or inherited them from its * super classes. * * @param matcher A matcher to apply onto the inherited annotations. * @param <T> The type of the matched object. * @return A matcher that matches any inherited annotation by a given matcher. */
public static <T extends TypeDescription> ElementMatcher.Junction<T> inheritsAnnotation(ElementMatcher<? super TypeDescription> matcher) { return hasAnnotation(annotationType(matcher)); }
Matches a list of annotations by a given matcher on a type that declared these annotations or inherited them from its super classes.
Params:
  • matcher – A matcher to apply onto a list of inherited annotations.
Type parameters:
  • <T> – The type of the matched object.
Returns:A matcher that matches a list of inherited annotation by a given matcher.
/** * Matches a list of annotations by a given matcher on a type that declared these annotations or inherited them * from its super classes. * * @param matcher A matcher to apply onto a list of inherited annotations. * @param <T> The type of the matched object. * @return A matcher that matches a list of inherited annotation by a given matcher. */
public static <T extends TypeDescription> ElementMatcher.Junction<T> hasAnnotation(ElementMatcher<? super AnnotationDescription> matcher) { return new InheritedAnnotationMatcher<T>(new CollectionItemMatcher<AnnotationDescription>(matcher)); }
Matches a type by a another matcher that is applied on any of its declared fields.
Params:
  • matcher – The matcher that is applied onto each declared field.
Type parameters:
  • <T> – The type of the matched object.
Returns:A matcher that matches any type where another matcher is matched positively on at least on declared field.
/** * Matches a type by a another matcher that is applied on any of its declared fields. * * @param matcher The matcher that is applied onto each declared field. * @param <T> The type of the matched object. * @return A matcher that matches any type where another matcher is matched positively on at least on declared field. */
public static <T extends TypeDefinition> ElementMatcher.Junction<T> declaresField(ElementMatcher<? super FieldDescription> matcher) { return new DeclaringFieldMatcher<T>(new CollectionItemMatcher<FieldDescription>(matcher)); }
Matches a type by a another matcher that is applied on any of its declared methods.
Params:
  • matcher – The matcher that is applied onto each declared method.
Type parameters:
  • <T> – The type of the matched object.
Returns:A matcher that matches any type where another matcher is matched positively on at least on declared methods.
/** * Matches a type by a another matcher that is applied on any of its declared methods. * * @param matcher The matcher that is applied onto each declared method. * @param <T> The type of the matched object. * @return A matcher that matches any type where another matcher is matched positively on at least on declared methods. */
public static <T extends TypeDefinition> ElementMatcher.Junction<T> declaresMethod(ElementMatcher<? super MethodDescription> matcher) { return new DeclaringMethodMatcher<T>(new CollectionItemMatcher<MethodDescription>(matcher)); }
Matches generic type descriptions of the given sort.
Params:
  • sort – The generic type sort to match.
Type parameters:
  • <T> – The type of the matched object.
Returns:A matcher that matches generic types of the given sort.
/** * Matches generic type descriptions of the given sort. * * @param sort The generic type sort to match. * @param <T> The type of the matched object. * @return A matcher that matches generic types of the given sort. */
public static <T extends TypeDefinition> ElementMatcher.Junction<T> ofSort(TypeDefinition.Sort sort) { return ofSort(is(sort)); }
Matches generic type descriptions of the given sort.
Params:
  • matcher – A matcher for a generic type's sort.
Type parameters:
  • <T> – The type of the matched object.
Returns:A matcher that matches generic types of the given sort.
/** * Matches generic type descriptions of the given sort. * * @param matcher A matcher for a generic type's sort. * @param <T> The type of the matched object. * @return A matcher that matches generic types of the given sort. */
public static <T extends TypeDefinition> ElementMatcher.Junction<T> ofSort(ElementMatcher<? super TypeDefinition.Sort> matcher) { return new TypeSortMatcher<T>(matcher); }
Matches a type if it is primitive.
Type parameters:
  • <T> – The type of the matched object.
Returns:A matcher that determines if a type is primitive.
/** * Matches a type if it is primitive. * * @param <T> The type of the matched object. * @return A matcher that determines if a type is primitive. */
public static <T extends TypeDefinition> ElementMatcher.Junction<T> isPrimitive() { return new PrimitiveTypeMatcher<T>(); }
Matches a type if it is an array type.
Type parameters:
  • <T> – The type of the matched object.
Returns:A matcher that determines if a type is an array type.
/** * Matches a type if it is an array type. * * @param <T> The type of the matched object. * @return A matcher that determines if a type is an array type. */
public static <T extends TypeDefinition> ElementMatcher.Junction<T> isArray() { return new ArrayTypeMatcher<T>(); }
Matches a type if it is a record type.
Type parameters:
  • <T> – The type of the matched object.
Returns:A matcher that determines if a type is a record type.
/** * Matches a type if it is a record type. * * @param <T> The type of the matched object. * @return A matcher that determines if a type is a record type. */
public static <T extends TypeDefinition> ElementMatcher.Junction<T> isRecord() { return new RecordMatcher<T>(); }
Matches a field's generic type against the provided matcher.
Params:
  • fieldType – The field type to match.
Type parameters:
  • <T> – The type of the matched object.
Returns:A matcher matching the provided field type.
/** * Matches a field's generic type against the provided matcher. * * @param fieldType The field type to match. * @param <T> The type of the matched object. * @return A matcher matching the provided field type. */
public static <T extends FieldDescription> ElementMatcher.Junction<T> genericFieldType(Type fieldType) { return genericFieldType(TypeDefinition.Sort.describe(fieldType)); }
Matches a field's generic type against the provided matcher.
Params:
  • fieldType – The field type to match.
Type parameters:
  • <T> – The type of the matched object.
Returns:A matcher matching the provided field type.
/** * Matches a field's generic type against the provided matcher. * * @param fieldType The field type to match. * @param <T> The type of the matched object. * @return A matcher matching the provided field type. */
public static <T extends FieldDescription> ElementMatcher.Junction<T> genericFieldType(TypeDescription.Generic fieldType) { return genericFieldType(is(fieldType)); }
Matches a field's generic type against the provided matcher.
Params:
  • matcher – The matcher to apply to the field's type.
Type parameters:
  • <T> – The type of the matched object.
Returns:A matcher matching the provided field type.
/** * Matches a field's generic type against the provided matcher. * * @param matcher The matcher to apply to the field's type. * @param <T> The type of the matched object. * @return A matcher matching the provided field type. */
public static <T extends FieldDescription> ElementMatcher.Junction<T> genericFieldType(ElementMatcher<? super TypeDescription.Generic> matcher) { return new FieldTypeMatcher<T>(matcher); }
Matches a field's raw type against the provided matcher.
Params:
  • fieldType – The field type to match.
Type parameters:
  • <T> – The type of the matched object.
Returns:A matcher matching the provided field type.
/** * Matches a field's raw type against the provided matcher. * * @param fieldType The field type to match. * @param <T> The type of the matched object. * @return A matcher matching the provided field type. */
public static <T extends FieldDescription> ElementMatcher.Junction<T> fieldType(Class<?> fieldType) { return fieldType(TypeDescription.ForLoadedType.of(fieldType)); }
Matches a field's raw type against the provided matcher.
Params:
  • fieldType – The field type to match.
Type parameters:
  • <T> – The type of the matched object.
Returns:A matcher matching the provided field type.
/** * Matches a field's raw type against the provided matcher. * * @param fieldType The field type to match. * @param <T> The type of the matched object. * @return A matcher matching the provided field type. */
public static <T extends FieldDescription> ElementMatcher.Junction<T> fieldType(TypeDescription fieldType) { return fieldType(is(fieldType)); }
Matches a field's raw type against the provided matcher.
Params:
  • matcher – The matcher to apply to the field's type.
Type parameters:
  • <T> – The type of the matched object.
Returns:A matcher matching the provided field type.
/** * Matches a field's raw type against the provided matcher. * * @param matcher The matcher to apply to the field's type. * @param <T> The type of the matched object. * @return A matcher matching the provided field type. */
public static <T extends FieldDescription> ElementMatcher.Junction<T> fieldType(ElementMatcher<? super TypeDescription> matcher) { return genericFieldType(erasure(matcher)); }
Matches a volatile field.
Type parameters:
  • <T> – The type of the matched object.
Returns:A matcher for a volatile field.
/** * Matches a {@code volatile} field. * * @param <T> The type of the matched object. * @return A matcher for a {@code volatile} field. */
public static <T extends FieldDescription> ElementMatcher.Junction<T> isVolatile() { return new ModifierMatcher<T>(ModifierMatcher.Mode.VOLATILE); }
Matches a transient field.
Type parameters:
  • <T> – The type of the matched object.
Returns:A matcher for a transient field.
/** * Matches a {@code transient} field. * * @param <T> The type of the matched object. * @return A matcher for a {@code transient} field. */
public static <T extends FieldDescription> ElementMatcher.Junction<T> isTransient() { return new ModifierMatcher<T>(ModifierMatcher.Mode.TRANSIENT); }
Matches if an annotation is of a given type.
Params:
  • type – The expected annotation type.
Type parameters:
  • <T> – The type of the matched object.
Returns:A matcher that matches the annotation's type for being equal to the given type.
/** * Matches if an annotation is of a given type. * * @param type The expected annotation type. * @param <T> The type of the matched object. * @return A matcher that matches the annotation's type for being equal to the given type. */
public static <T extends AnnotationDescription> ElementMatcher.Junction<T> annotationType(Class<? extends Annotation> type) { return annotationType(TypeDescription.ForLoadedType.of(type)); }
Matches if an annotation is of a given type.
Params:
  • type – The expected annotation type.
Type parameters:
  • <T> – The type of the matched object.
Returns:A matcher that matches the annotation's type for being equal to the given type.
/** * Matches if an annotation is of a given type. * * @param type The expected annotation type. * @param <T> The type of the matched object. * @return A matcher that matches the annotation's type for being equal to the given type. */
public static <T extends AnnotationDescription> ElementMatcher.Junction<T> annotationType(TypeDescription type) { return annotationType(is(type)); }
Matches if an annotation's type matches the supplied matcher.
Params:
  • matcher – The matcher to match the annotation's type against.
Type parameters:
  • <T> – The type of the matched object.
Returns:A matcher that matches the annotation's type.
/** * Matches if an annotation's type matches the supplied matcher. * * @param matcher The matcher to match the annotation's type against. * @param <T> The type of the matched object. * @return A matcher that matches the annotation's type. */
public static <T extends AnnotationDescription> ElementMatcher.Junction<T> annotationType(ElementMatcher<? super TypeDescription> matcher) { return new AnnotationTypeMatcher<T>(matcher); }
Matches if an annotation can target a given element type.
Params:
  • elementType – The element type we target.
Type parameters:
  • <T> – The type of the matched object.
Returns:A matcher that matches annotations that target an element type.
/** * Matches if an annotation can target a given element type. * * @param elementType The element type we target. * @param <T> The type of the matched object. * @return A matcher that matches annotations that target an element type. */
public static <T extends AnnotationDescription> ElementMatcher.Junction<T> targetsElement(ElementType elementType) { return new AnnotationTargetMatcher<T>(elementType); }
Matches exactly the bootstrap ClassLoader. The returned matcher is a synonym to a matcher matching null.
Type parameters:
  • <T> – The type of the matched object.
Returns:A matcher that only matches the bootstrap class loader.
/** * Matches exactly the bootstrap {@link java.lang.ClassLoader}. The returned matcher is a synonym to * a matcher matching {@code null}. * * @param <T> The type of the matched object. * @return A matcher that only matches the bootstrap class loader. */
public static <T extends ClassLoader> ElementMatcher.Junction<T> isBootstrapClassLoader() { return new NullMatcher<T>(); }
Matches exactly the system ClassLoader. The returned matcher is a synonym to a matcher matching ClassLoader.gerSystemClassLoader().
Type parameters:
  • <T> – The type of the matched object.
Returns:A matcher that only matches the system class loader.
/** * Matches exactly the system {@link java.lang.ClassLoader}. The returned matcher is a synonym to * a matcher matching {@code ClassLoader.gerSystemClassLoader()}. * * @param <T> The type of the matched object. * @return A matcher that only matches the system class loader. */
public static <T extends ClassLoader> ElementMatcher.Junction<T> isSystemClassLoader() { return new EqualityMatcher<T>(ClassLoader.getSystemClassLoader()); }
Matches exactly the extension ClassLoader. The returned matcher is a synonym to a matcher matching ClassLoader.gerSystemClassLoader().getParent().
Type parameters:
  • <T> – The type of the matched object.
Returns:A matcher that only matches the extension class loader.
/** * Matches exactly the extension {@link java.lang.ClassLoader}. The returned matcher is a synonym to * a matcher matching {@code ClassLoader.gerSystemClassLoader().getParent()}. * * @param <T> The type of the matched object. * @return A matcher that only matches the extension class loader. */
public static <T extends ClassLoader> ElementMatcher.Junction<T> isExtensionClassLoader() { ClassLoader classLoader = ClassLoader.getSystemClassLoader().getParent(); return classLoader == null // Check if VM supports the extension class loader. ? ElementMatchers.<T>none() : new EqualityMatcher<T>(classLoader); }
Matches any class loader that is either the given class loader or a child of the given class loader.
Params:
  • classLoader – The class loader of which child class loaders are matched.
Type parameters:
  • <T> – The type of the matched object.
Returns:A matcher that matches the given class loader and any class loader that is a child of the given class loader.
/** * Matches any class loader that is either the given class loader or a child of the given class loader. * * @param classLoader The class loader of which child class loaders are matched. * @param <T> The type of the matched object. * @return A matcher that matches the given class loader and any class loader that is a child of the given * class loader. */
public static <T extends ClassLoader> ElementMatcher.Junction<T> isChildOf(ClassLoader classLoader) { return classLoader == BOOTSTRAP_CLASSLOADER ? new BooleanMatcher<T>(true) : ElementMatchers.<T>hasChild(is(classLoader)); }
Matches all class loaders in the hierarchy of the matched class loader against a given matcher.
Params:
  • matcher – The matcher to apply to all class loaders in the hierarchy of the matched class loader.
Type parameters:
  • <T> – The type of the matched object.
Returns:A matcher that matches all class loaders in the hierarchy of the matched class loader.
/** * Matches all class loaders in the hierarchy of the matched class loader against a given matcher. * * @param matcher The matcher to apply to all class loaders in the hierarchy of the matched class loader. * @param <T> The type of the matched object. * @return A matcher that matches all class loaders in the hierarchy of the matched class loader. */
public static <T extends ClassLoader> ElementMatcher.Junction<T> hasChild(ElementMatcher<? super ClassLoader> matcher) { return new ClassLoaderHierarchyMatcher<T>(matcher); }
Matches any class loader that is either the given class loader or a parent of the given class loader.
Params:
  • classLoader – The class loader of which parent class loaders are matched.
Type parameters:
  • <T> – The type of the matched object.
Returns:A matcher that matches the given class loader and any class loader that is a parent of the given class loader.
/** * Matches any class loader that is either the given class loader or a parent of the given class loader. * * @param classLoader The class loader of which parent class loaders are matched. * @param <T> The type of the matched object. * @return A matcher that matches the given class loader and any class loader that is a parent of the given * class loader. */
public static <T extends ClassLoader> ElementMatcher.Junction<T> isParentOf(ClassLoader classLoader) { return classLoader == BOOTSTRAP_CLASSLOADER ? ElementMatchers.<T>isBootstrapClassLoader() : new ClassLoaderParentMatcher<T>(classLoader); }
Matches a class loader's type unless it is the bootstrap class loader which is never matched.
Params:
  • matcher – The matcher to apply to the class loader's type.
Type parameters:
  • <T> – The type of the matched object.
Returns:A matcher that matches the class loader's type.
/** * Matches a class loader's type unless it is the bootstrap class loader which is never matched. * * @param matcher The matcher to apply to the class loader's type. * @param <T> The type of the matched object. * @return A matcher that matches the class loader's type. */
public static <T extends ClassLoader> ElementMatcher.Junction<T> ofType(ElementMatcher<? super TypeDescription> matcher) { return new InstanceTypeMatcher<T>(matcher); }
Matches a module if it exists, i.e. not null.
Type parameters:
  • <T> – The type of the matched object.
Returns:A matcher that validates a module's existence.
/** * Matches a module if it exists, i.e. not {@code null}. * * @param <T> The type of the matched object. * @return A matcher that validates a module's existence. */
public static <T extends JavaModule> ElementMatcher.Junction<T> supportsModules() { return not(new NullMatcher<T>()); } }