Package org.jdbi.v3.core.extension

Interface ExtensionHandler

All Known Subinterfaces:

ExtensionHandler.Simple, Handler

Functional Interface:

This is a functional interface and can therefore be used as the assignment target for a lambda expression or method reference.

@FunctionalInterface
@Alpha
public interface ExtensionHandler

Provides functionality for a single method on an extension object. Each extension handler can either call another piece of code to return the result (e.g. the method on the underlying object) or return the result itself.

Since:

3.38.0

Nested Class Summary

Nested Classes

Modifier and Type	Interface	Description
static interface	ExtensionHandler.Simple

Method Summary

Modifier and Type	Method	Description
AttachedExtensionHandler	attachTo(ConfigRegistry config, Object target)	Attach this extension handler to a target instance.
static ExtensionHandler	createForMethod(Method method)	Create an extension handler and bind it to a method that will be called on the target object when invoked.
static ExtensionHandler	createForMethodHandle(MethodHandle methodHandle)	Create an extension handler and bind it to a MethodHandle instance.
static ExtensionHandler	createForSpecialMethod(Method method)	Create an extension handler and bind it to a special method that will be called on the target object when invoked.
static ExtensionHandler	missingExtensionHandler(Method method)	Returns a default handler for missing functionality.

Method Details

attachTo

AttachedExtensionHandler attachTo(ConfigRegistry config,
 Object target)

Attach this extension handler to a target instance.

Parameters:

config - the configuration at time of attach

target - the target object on which the handler should operate

missingExtensionHandler

static ExtensionHandler missingExtensionHandler(Method method)

Returns a default handler for missing functionality. The handler will throw an exception when invoked.

Parameters:

method - The method to which this specific handler instance is bound

Returns:

An ExtensionHandler instance

createForMethod

static ExtensionHandler createForMethod(Method method)
                                 throws IllegalAccessException

Create an extension handler and bind it to a method that will be called on the target object when invoked.

Parameters:

method - The Method to bind to

Returns:

An ExtensionHandler

Throws:

IllegalAccessException - If the method could not be unreflected

createForSpecialMethod

static ExtensionHandler createForSpecialMethod(Method method)
                                        throws IllegalAccessException

Create an extension handler and bind it to a special method that will be called on the target object when invoked. This is needed e.g. for interface default methods.

Parameters:

method - The Method to bind to

Returns:

An ExtensionHandler

Throws:

IllegalAccessException - If the method could not be unreflected

createForMethodHandle

static ExtensionHandler createForMethodHandle(MethodHandle methodHandle)

Create an extension handler and bind it to a MethodHandle instance.

Parameters:

methodHandle - The MethodHandle to bind to

Returns:

An ExtensionHandler