net.bytebuddy.matcher

Class CachingMatcher<T>

java.lang.Object

net.bytebuddy.matcher.ElementMatcher.Junction.AbstractBase<T>

net.bytebuddy.matcher.CachingMatcher<T>

Type Parameters:

T - The actual matched type of this matcher.

All Implemented Interfaces:

ElementMatcher<T>, ElementMatcher.Junction<T>

Direct Known Subclasses:

CachingMatcher.WithInlineEviction

@HashCodeAndEqualsPlugin.Enhance(permitSubclassEquality=true)
public class CachingMatcher<T>
extends ElementMatcher.Junction.AbstractBase<T>

A matcher that remembers the results of previously matching an equal target.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	CachingMatcher.WithInlineEviction<S> A caching matcher with inline cache eviction.

Nested classes/interfaces inherited from interface net.bytebuddy.matcher.ElementMatcher.Junction

ElementMatcher.Junction.AbstractBase<V>, ElementMatcher.Junction.Conjunction<W>, ElementMatcher.Junction.Disjunction<W>, ElementMatcher.Junction.ForNonNullValues<W>

Nested classes/interfaces inherited from interface net.bytebuddy.matcher.ElementMatcher

ElementMatcher.Junction<S>

Field Summary

Fields

Modifier and Type	Field and Description
protected ConcurrentMap<? super T,Boolean>	map A map that serves as a cache for previous matches.

Constructor Summary

Constructors

Constructor and Description
CachingMatcher(ElementMatcher<? super T> matcher, ConcurrentMap<? super T,Boolean> map) Creates a new caching matcher.

Method Summary

Modifier and Type	Method and Description
boolean	matches(T target) Matches a target against this element matcher.
protected boolean	onCacheMiss(T target) Invoked if the cache is not hit.
String	toString()

Methods inherited from class net.bytebuddy.matcher.ElementMatcher.Junction.AbstractBase

and, or

Methods inherited from class java.lang.Object

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

Field Detail

map

@HashCodeAndEqualsPlugin.ValueHandling(value=IGNORE)
protected final ConcurrentMap<? super T,Boolean> map

A map that serves as a cache for previous matches.

Constructor Detail

CachingMatcher

public CachingMatcher(ElementMatcher<? super T> matcher,
                      ConcurrentMap<? super T,Boolean> map)

Creates a new caching matcher.

Parameters:

matcher - The underlying matcher to apply for non-cached targets.

map - A map that serves as a cache for previous matches. This match is strongly referenced and can cause a memory leak if it is not evicted while keeping this matcher alive.

Method Detail

matches

public boolean matches(@MaybeNull
                       T target)

Matches a target against this element matcher.

Parameters:

target - The instance to be matched or null.

Returns:

true if the given element is matched by this matcher or false otherwise.

onCacheMiss

protected boolean onCacheMiss(@MaybeNull
                              T target)

Invoked if the cache is not hit.

Parameters:

target - The element to be matched.

Returns:

true if the element is matched.

toString

public String toString()

Overrides:

toString in class Object