java.lang.Object
- net.bytebuddy.agent.builder.AgentBuilder.RedefinitionStrategy.Collector

Direct Known Subclasses:

AgentBuilder.RedefinitionStrategy.Collector.ForRedefinition, AgentBuilder.RedefinitionStrategy.Collector.ForRetransformation

Enclosing class:

AgentBuilder.RedefinitionStrategy
```
protected abstract static class AgentBuilder.RedefinitionStrategy.Collector
extends java.lang.Object
```
A collector is responsible for collecting classes that are to be considered for modification.

Nested Class Summary

Nested Classes
Modifier and Type	Class	Description
`protected static class`	`AgentBuilder.RedefinitionStrategy.Collector.ForRedefinition`	A collector that applies a redefinition of already loaded classes.
`protected static class`	`AgentBuilder.RedefinitionStrategy.Collector.ForRetransformation`	A collector that applies a retransformation of already loaded classes.
`protected static class`	`AgentBuilder.RedefinitionStrategy.Collector.PrependableIterator`	An iterator that allows prepending of iterables to be applied previous to another iterator.

Field Summary

Fields
Modifier and Type	Field	Description
`protected AgentBuilder.CircularityLock`	`circularityLock`	The circularity lock to use.
`private AgentBuilder.DescriptionStrategy`	`descriptionStrategy`	The description strategy for resolving type descriptions for types.
`private AgentBuilder.FallbackStrategy`	`fallbackStrategy`	The fallback strategy to apply.
`protected AgentBuilder.Listener`	`listener`	The listener to notify on transformations.
`protected AgentBuilder.LocationStrategy`	`locationStrategy`	The location strategy to use.
`private AgentBuilder.RawMatcher`	`matcher`	The matcher to identify what types to redefine.
`private AgentBuilder.PoolStrategy`	`poolStrategy`	The pool strategy to use.
`protected java.util.List<java.lang.Class<?>>`	`types`	All types that were collected for redefinition.

Constructor Summary

Constructors
Modifier	Constructor	Description
`protected`	`Collector(AgentBuilder.RawMatcher matcher, AgentBuilder.PoolStrategy poolStrategy, AgentBuilder.LocationStrategy locationStrategy, AgentBuilder.DescriptionStrategy descriptionStrategy, AgentBuilder.Listener listener, AgentBuilder.FallbackStrategy fallbackStrategy, AgentBuilder.CircularityLock circularityLock)`	Creates a new collector.

Method Summary

All Methods Instance Methods Abstract Methods Concrete Methods
Modifier and Type	Method	Description
`protected int`	`apply(java.lang.instrument.Instrumentation instrumentation, AgentBuilder.RedefinitionStrategy.BatchAllocator redefinitionBatchAllocator, AgentBuilder.RedefinitionStrategy.Listener redefinitionListener, int batch)`	Applies all types that this collector collected.
`protected void`	`consider(java.lang.Class<?> type, boolean modifiable)`	Considers a loaded class for collection.
`protected abstract void`	`doApply(java.lang.instrument.Instrumentation instrumentation, java.util.List<java.lang.Class<?>> types)`	Applies this collector.
`private void`	`doConsider(AgentBuilder.RawMatcher matcher, AgentBuilder.Listener listener, TypeDescription typeDescription, java.lang.Class<?> type, java.lang.Class<?> classBeingRedefined, JavaModule module, boolean modifiable)`	Does consider the retransformation or redefinition of a loaded type.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

matcher
```
private final AgentBuilder.RawMatcher matcher
```
The matcher to identify what types to redefine.

poolStrategy

private final AgentBuilder.PoolStrategy poolStrategy

The pool strategy to use.

locationStrategy

protected final AgentBuilder.LocationStrategy locationStrategy

The location strategy to use.

descriptionStrategy
```
private final AgentBuilder.DescriptionStrategy descriptionStrategy
```
The description strategy for resolving type descriptions for types.

listener

protected final AgentBuilder.Listener listener

The listener to notify on transformations.

fallbackStrategy

private final AgentBuilder.FallbackStrategy fallbackStrategy

The fallback strategy to apply.

circularityLock

protected final AgentBuilder.CircularityLock circularityLock

The circularity lock to use.

types

protected final java.util.List<java.lang.Class<?>> types

All types that were collected for redefinition.

Constructor Detail

Collector

protected Collector(AgentBuilder.RawMatcher matcher,
                    AgentBuilder.PoolStrategy poolStrategy,
                    AgentBuilder.LocationStrategy locationStrategy,
                    AgentBuilder.DescriptionStrategy descriptionStrategy,
                    AgentBuilder.Listener listener,
                    AgentBuilder.FallbackStrategy fallbackStrategy,
                    AgentBuilder.CircularityLock circularityLock)

Creates a new collector.

Parameters:: matcher - The matcher to identify what types to redefine.; poolStrategy - The pool strategy to use.; locationStrategy - The location strategy to use.; descriptionStrategy - The description strategy for resolving type descriptions for types.; listener - The listener to notify on transformations.; fallbackStrategy - The fallback strategy to apply.; circularityLock - The circularity lock to use.

Method Detail

consider
```
protected void consider(java.lang.Class<?> type,
                        boolean modifiable)
```
Considers a loaded class for collection.

Parameters:

type - The loaded type being considered.

modifiable - true if the considered type is considered modifiable.

doConsider

private void doConsider(AgentBuilder.RawMatcher matcher,
                        AgentBuilder.Listener listener,
                        TypeDescription typeDescription,
                        java.lang.Class<?> type,
                        @MaybeNull
                        java.lang.Class<?> classBeingRedefined,
                        @MaybeNull
                        JavaModule module,
                        boolean modifiable)

Does consider the retransformation or redefinition of a loaded type.

Parameters:: matcher - A type matcher to apply.; listener - The listener to apply during the consideration.; typeDescription - The type description of the type being considered.; type - The loaded type being considered.; classBeingRedefined - The loaded type being considered or null if it should be considered non-available.; module - The type's Java module or null if the current VM does not support modules.; modifiable - true if the considered type is considered modifiable.

apply

protected int apply(java.lang.instrument.Instrumentation instrumentation,
                    AgentBuilder.RedefinitionStrategy.BatchAllocator redefinitionBatchAllocator,
                    AgentBuilder.RedefinitionStrategy.Listener redefinitionListener,
                    int batch)

Applies all types that this collector collected.

Parameters:: instrumentation - The instrumentation instance to apply changes to.; redefinitionBatchAllocator - The redefinition batch allocator to use.; redefinitionListener - The redefinition listener to use.; batch - The next batch's index.
Returns:: The next batch's index after this application.

doApply
```
protected abstract void doApply(java.lang.instrument.Instrumentation instrumentation,
                                java.util.List<java.lang.Class<?>> types)
                         throws java.lang.instrument.UnmodifiableClassException,
                                java.lang.ClassNotFoundException
```
Applies this collector.

Parameters:

instrumentation - The instrumentation instance to apply the transformation for.

types - The types of the current patch to transform.

Throws:

java.lang.instrument.UnmodifiableClassException - If a class is not modifiable.

java.lang.ClassNotFoundException - If a class could not be found.

Class AgentBuilder.RedefinitionStrategy.Collector