Package net.bytebuddy.build

Interface Plugin.Engine.ErrorHandler

All Known Subinterfaces:

Plugin.Engine.Listener

All Known Implementing Classes:

ByteBuddyMojo.TransformationLogger, Plugin.Engine.ErrorHandler.Compound, Plugin.Engine.ErrorHandler.Enforcing, Plugin.Engine.ErrorHandler.Failing, Plugin.Engine.Listener.Adapter, Plugin.Engine.Listener.Compound, Plugin.Engine.Listener.ForErrorHandler, Plugin.Engine.Listener.NoOp, Plugin.Engine.Listener.StreamWriting, Plugin.Engine.Listener.WithErrorsOnly, Plugin.Engine.Listener.WithTransformationsOnly

Enclosing interface:

Plugin.Engine

public static interface Plugin.Engine.ErrorHandler

An error handler that is used during a plugin engine application.

Nested Class Summary

Nested Classes

Modifier and Type	Interface	Description
static class	Plugin.Engine.ErrorHandler.Compound	A compound error handler.
static enum	Plugin.Engine.ErrorHandler.Enforcing	An error handler that enforces certain properties of the transformation.
static enum	Plugin.Engine.ErrorHandler.Failing	An implementation of an error handler that fails the plugin engine application.

Method Summary

Modifier and Type	Method	Description
void	onError(Map<TypeDescription,List<Throwable>> throwables)	Invoked at the end of the build if at least one type transformation failed.
void	onError(Plugin plugin, Throwable throwable)	Invoked at the end of the build if a plugin could not be closed.
void	onError(TypeDescription typeDescription, List<Throwable> throwables)	Invoked after the application of all plugins was attempted if at least one error occured during handling a given type.
void	onError(TypeDescription typeDescription, Plugin plugin, Throwable throwable)	Invoked if an error occured during a plugin's application on a given type.
void	onLiveInitializer(TypeDescription typeDescription, TypeDescription definingType)	Invoked if a type transformation implied a live initializer.
void	onManifest(Manifest manifest)	Invoked when a manifest was found or found missing.
void	onResource(String name)	Invoked if a resource that is not a class file is discovered.
void	onUnresolved(String typeName)	Invoked if a type could not be resolved.

Method Details

onError

void onError(TypeDescription typeDescription,
 Plugin plugin,
 Throwable throwable)

Invoked if an error occured during a plugin's application on a given type.

Parameters:

typeDescription - The type being matched or transformed.

plugin - The plugin being applied.

throwable - The throwable that caused the error.

onError

void onError(TypeDescription typeDescription,
 List<Throwable> throwables)

Invoked after the application of all plugins was attempted if at least one error occured during handling a given type.

Parameters:

typeDescription - The type being transformed.

throwables - The throwables that caused errors during the application.

onError

void onError(Map<TypeDescription,List<Throwable>> throwables)

Invoked at the end of the build if at least one type transformation failed.

Parameters:

throwables - A mapping of types that failed during transformation to the errors that were caught.

onError

void onError(Plugin plugin,
 Throwable throwable)

Invoked at the end of the build if a plugin could not be closed.

Parameters:

plugin - The plugin that could not be closed.

throwable - The error that was caused when the plugin was attempted to be closed.

onLiveInitializer

void onLiveInitializer(TypeDescription typeDescription,
 TypeDescription definingType)

Invoked if a type transformation implied a live initializer.

Parameters:

typeDescription - The type that was transformed.

definingType - The type that implies the initializer which might be the type itself or an auxiliary type.

onUnresolved

void onUnresolved(String typeName)

Invoked if a type could not be resolved.

Parameters:

typeName - The name of the unresolved type.

onManifest

void onManifest(@MaybeNull
 Manifest manifest)

Invoked when a manifest was found or found missing.

Parameters:

manifest - The located manifest or null if no manifest was found.

onResource

void onResource(String name)

Invoked if a resource that is not a class file is discovered.

Parameters:

name - The name of the discovered resource.