Package org.dataloader.instrumentation

Interface DataLoaderInstrumentation

All Known Implementing Classes:

ChainedDataLoaderInstrumentation

@PublicSpi
public interface DataLoaderInstrumentation

This interface is called when certain actions happen inside a data loader

Method Summary

Modifier and Type	Method	Description
default DataLoaderInstrumentationContext<List<?>>	beginBatchLoader(DataLoader<?,?> dataLoader, List<?> keys, BatchLoaderEnvironment environment)	This call back is done just before the `batch loader` of a DataLoader is invoked.
default DataLoaderInstrumentationContext<DispatchResult<?>>	beginDispatch(DataLoader<?,?> dataLoader)	This call back is done just before the DataLoader.dispatch() is invoked, and it completes when the dispatch call promise is done.
default DataLoaderInstrumentationContext<Object>	beginLoad(DataLoader<?,?> dataLoader, Object key, Object loadContext)	This call back is done just before the DataLoader.load(Object) methods are invoked, and it completes when the load promise is completed.

Method Details

beginLoad

default DataLoaderInstrumentationContext<Object> beginLoad(DataLoader<?,?> dataLoader,
 Object key,
 Object loadContext)

This call back is done just before the DataLoader.load(Object) methods are invoked, and it completes when the load promise is completed. If the value is a cached CompletableFuture then it might return almost immediately, otherwise it will return when the batch load function is invoked and values get returned

Parameters:

dataLoader - the DataLoader in question

key - the key used during the DataLoader.load(Object) call

loadContext - the load context used during the DataLoader.load(Object, Object) call

Returns:

a DataLoaderInstrumentationContext or null to be more performant

beginDispatch

default DataLoaderInstrumentationContext<DispatchResult<?>> beginDispatch(DataLoader<?,?> dataLoader)

This call back is done just before the DataLoader.dispatch() is invoked, and it completes when the dispatch call promise is done.

Parameters:

dataLoader - the DataLoader in question

Returns:

a DataLoaderInstrumentationContext or null to be more performant

beginBatchLoader

default DataLoaderInstrumentationContext<List<?>> beginBatchLoader(DataLoader<?,?> dataLoader,
 List<?> keys,
 BatchLoaderEnvironment environment)

This call back is done just before the `batch loader` of a DataLoader is invoked. Remember a batch loader could be called multiple times during a dispatch event (because of max batch sizes)

Parameters:

dataLoader - the DataLoader in question

keys - the set of keys being fetched

environment - the BatchLoaderEnvironment

Returns:

a DataLoaderInstrumentationContext or null to be more performant