net.bytebuddy.build

Class CachedReturnPlugin

java.lang.Object

net.bytebuddy.build.Plugin.ForElementMatcher

net.bytebuddy.build.CachedReturnPlugin

All Implemented Interfaces:

Plugin, ElementMatcher<TypeDescription>

public class CachedReturnPlugin
extends Plugin.ForElementMatcher

A plugin that caches the return value of a method in a synthetic field. The caching mechanism is not thread-safe but can be used in a concurrent setup if the cached value is frozen, i.e. only defines final fields. In this context, it is possible that the method is executed multiple times by different threads but at the same time, this approach avoids a volatile field declaration. For methods with a primitive return type, the type's default value is used to indicate that a method was not yet invoked. For methods that return a reference type, null is used as an indicator. If a method returns such a value, this mechanism will not work.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
protected static class	CachedReturnPlugin.CacheFieldOffsetMapping An offset mapping for the cached field.
static interface	CachedReturnPlugin.Enhance Indicates methods that should be cached, i.e.

Nested classes/interfaces inherited from interface net.bytebuddy.build.Plugin

Plugin.Compound, Plugin.ForElementMatcher, Plugin.NoOp

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

ElementMatcher.Junction<S>

Constructor Summary

Constructors

Constructor and Description
CachedReturnPlugin() Creates a plugin for caching method return values.

Method Summary

Modifier and Type	Method and Description
DynamicType.Builder<?>	apply(DynamicType.Builder<?> builder, TypeDescription typeDescription, ClassFileLocator classFileLocator) Applies this plugin.

Methods inherited from class net.bytebuddy.build.Plugin.ForElementMatcher

matches

Methods inherited from class java.lang.Object

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

Constructor Detail

CachedReturnPlugin

public CachedReturnPlugin()

Creates a plugin for caching method return values.

Method Detail

apply

public DynamicType.Builder<?> apply(DynamicType.Builder<?> builder,
                                    TypeDescription typeDescription,
                                    ClassFileLocator classFileLocator)

Description copied from interface: Plugin

Applies this plugin.

Parameters:

builder - The builder to use as a basis for the applied transformation.

typeDescription - The type being transformed.

classFileLocator - A class file locator that can locate other types in the scope of the project.

Returns:

The supplied builder with additional transformations registered.