Package graphql.execution.instrumentation

Class ChainedInstrumentation

java.lang.Object

graphql.execution.instrumentation.ChainedInstrumentation

All Implemented Interfaces:

Instrumentation

Direct Known Subclasses:

NoContextChainedInstrumentation

@PublicApi
public class ChainedInstrumentation
extends Object
implements Instrumentation

This allows you to chain together a number of Instrumentation implementations and run them in sequence. The list order of instrumentation objects is always guaranteed to be followed and the InstrumentationState objects they create will be passed back to the originating implementation.

See Also:

• Instrumentation

Field Summary

Fields

Modifier and Type	Field	Description
protected final com.google.common.collect.ImmutableList<Instrumentation>	instrumentations

Constructor Summary

Constructors

Constructor	Description
ChainedInstrumentation(Instrumentation... instrumentations)
ChainedInstrumentation(List<Instrumentation> instrumentations)

Method Summary

Modifier and Type	Method	Description
InstrumentationContext<Object>	beginDeferredField(InstrumentationFieldParameters parameters, InstrumentationState state)	This is called just before a deferred field is resolved into a value.
@Nullable ExecuteObjectInstrumentationContext	beginExecuteObject(InstrumentationExecutionStrategyParameters parameters, InstrumentationState state)	This is called each time an ExecutionStrategy object resolution is called, which may be multiple times per query as the engine recursively descends over the query.
InstrumentationContext<ExecutionResult>	beginExecuteOperation(InstrumentationExecuteOperationParameters parameters, InstrumentationState state)	This is called just before the execution of the query operation is started.
InstrumentationContext<ExecutionResult>	beginExecution(InstrumentationExecutionParameters parameters, InstrumentationState state)	This is called right at the start of query execution, and it's the first step in the instrumentation chain.
ExecutionStrategyInstrumentationContext	beginExecutionStrategy(InstrumentationExecutionStrategyParameters parameters, InstrumentationState state)	This is called each time an ExecutionStrategy is invoked, which may be multiple times per query as the engine recursively descends over the query.
@Nullable InstrumentationContext<Object>	beginFieldCompletion(InstrumentationFieldCompleteParameters parameters, InstrumentationState state)	This is called just before the complete field is started.
@Nullable InstrumentationContext<Object>	beginFieldExecution(InstrumentationFieldParameters parameters, InstrumentationState state)	This is called just before a field is resolved into a value.
InstrumentationContext<Object>	beginFieldFetch(InstrumentationFieldFetchParameters parameters, InstrumentationState state)	This is called just before a field DataFetcher is invoked.
FieldFetchingInstrumentationContext	beginFieldFetching(InstrumentationFieldFetchParameters parameters, InstrumentationState state)	This is called just before a field DataFetcher is invoked.
@Nullable InstrumentationContext<Object>	beginFieldListCompletion(InstrumentationFieldCompleteParameters parameters, InstrumentationState state)	This is called just before the complete field list is started.
InstrumentationContext<Document>	beginParse(InstrumentationExecutionParameters parameters, InstrumentationState state)	This is called just before a query is parsed.
@Nullable InstrumentationContext<Void>	beginReactiveResults(InstrumentationReactiveResultsParameters parameters, InstrumentationState state)	This is called just before the execution of any reactive results, namely incremental deferred results or subscriptions.
InstrumentationContext<ExecutionResult>	beginSubscribedFieldEvent(InstrumentationFieldParameters parameters, InstrumentationState state)	This is called each time a subscription field produces a new reactive stream event value and it needs to be mapped over via the graphql field subselection.
InstrumentationContext<List<ValidationError>>	beginValidation(InstrumentationValidationParameters parameters, InstrumentationState state)	This is called just before the parsed query document is validated.
protected void	chainedConsume(InstrumentationState state, BiConsumer<Instrumentation,InstrumentationState> stateConsumer)
protected <T> com.google.common.collect.ImmutableList<T>	chainedMapAndDropNulls(InstrumentationState state, BiFunction<Instrumentation,InstrumentationState,T> mapper)
@NonNull CompletableFuture<InstrumentationState>	createStateAsync(InstrumentationCreateStateParameters parameters)	This will be called just before execution to create an object, in an asynchronous manner, that is given back to all instrumentation methods to allow them to have per execution request state
List<Instrumentation>	getInstrumentations()
@NonNull DataFetcher<?>	instrumentDataFetcher(DataFetcher<?> dataFetcher, InstrumentationFieldFetchParameters parameters, InstrumentationState state)	This is called to instrument a DataFetcher just before it is used to fetch a field, allowing you to adjust what information is passed back or record information about specific data fetches.
@NonNull DocumentAndVariables	instrumentDocumentAndVariables(DocumentAndVariables documentAndVariables, InstrumentationExecutionParameters parameters, InstrumentationState state)	This is called to instrument a Document and variables before it is used allowing you to adjust the query AST if you so desire
@NonNull ExecutionContext	instrumentExecutionContext(ExecutionContext executionContext, InstrumentationExecutionParameters parameters, InstrumentationState state)	This is called to instrument a ExecutionContext before it is used to execute a query, allowing you to adjust the base data used.
@NonNull ExecutionInput	instrumentExecutionInput(ExecutionInput executionInput, InstrumentationExecutionParameters parameters, InstrumentationState state)	This is called to instrument a ExecutionInput before it is used to parse, validate and execute a query, allowing you to adjust what query input parameters are used
@NonNull CompletableFuture<ExecutionResult>	instrumentExecutionResult(ExecutionResult executionResult, InstrumentationExecutionParameters parameters, InstrumentationState state)	This is called to allow instrumentation to instrument the execution result in some way
@NonNull GraphQLSchema	instrumentSchema(GraphQLSchema schema, InstrumentationExecutionParameters parameters, InstrumentationState state)	This is called to instrument a GraphQLSchema before it is used to parse, validate and execute a query, allowing you to adjust what types are used.

Methods inherited from class java.lang.Object

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

Methods inherited from interface graphql.execution.instrumentation.Instrumentation

createState

Field Details

instrumentations

protected final com.google.common.collect.ImmutableList<Instrumentation> instrumentations

Constructor Details

ChainedInstrumentation

public ChainedInstrumentation(List<Instrumentation> instrumentations)

ChainedInstrumentation

public ChainedInstrumentation(Instrumentation... instrumentations)

Method Details

getInstrumentations

public List<Instrumentation> getInstrumentations()

Returns:

the list of instrumentations in play

chainedMapAndDropNulls

protected <T>
com.google.common.collect.ImmutableList<T> chainedMapAndDropNulls(InstrumentationState state,
 BiFunction<Instrumentation,InstrumentationState,T> mapper)

chainedConsume

protected void chainedConsume(InstrumentationState state,
 BiConsumer<Instrumentation,InstrumentationState> stateConsumer)

createStateAsync

public @NonNull CompletableFuture<InstrumentationState> createStateAsync(InstrumentationCreateStateParameters parameters)

Description copied from interface: Instrumentation

This will be called just before execution to create an object, in an asynchronous manner, that is given back to all instrumentation methods to allow them to have per execution request state

Specified by:

createStateAsync in interface Instrumentation

Parameters:

parameters - the parameters to this step

Returns:

a state object that is passed to each method

beginExecution

public InstrumentationContext<ExecutionResult> beginExecution(InstrumentationExecutionParameters parameters,
 InstrumentationState state)

Description copied from interface: Instrumentation

This is called right at the start of query execution, and it's the first step in the instrumentation chain.

Specified by:

beginExecution in interface Instrumentation

Parameters:

parameters - the parameters to this step

state - the state created during the call to Instrumentation.createStateAsync(InstrumentationCreateStateParameters)

Returns:

a nullable InstrumentationContext object that will be called back when the step ends (assuming it's not null)

beginParse

public InstrumentationContext<Document> beginParse(InstrumentationExecutionParameters parameters,
 InstrumentationState state)

Description copied from interface: Instrumentation

This is called just before a query is parsed.

Specified by:

beginParse in interface Instrumentation

Parameters:

parameters - the parameters to this step

state - the state created during the call to Instrumentation.createStateAsync(InstrumentationCreateStateParameters)

Returns:

a nullable InstrumentationContext object that will be called back when the step ends (assuming it's not null)

beginValidation

public InstrumentationContext<List<ValidationError>> beginValidation(InstrumentationValidationParameters parameters,
 InstrumentationState state)

Description copied from interface: Instrumentation

This is called just before the parsed query document is validated.

Specified by:

beginValidation in interface Instrumentation

Parameters:

parameters - the parameters to this step

state - the state created during the call to Instrumentation.createStateAsync(InstrumentationCreateStateParameters)

Returns:

a nullable InstrumentationContext object that will be called back when the step ends (assuming it's not null)

beginExecuteOperation

public InstrumentationContext<ExecutionResult> beginExecuteOperation(InstrumentationExecuteOperationParameters parameters,
 InstrumentationState state)

Description copied from interface: Instrumentation

This is called just before the execution of the query operation is started.

Specified by:

beginExecuteOperation in interface Instrumentation

Parameters:

parameters - the parameters to this step

state - the state created during the call to Instrumentation.createStateAsync(InstrumentationCreateStateParameters)

Returns:

a nullable InstrumentationContext object that will be called back when the step ends (assuming it's not null)

beginReactiveResults

public @Nullable InstrumentationContext<Void> beginReactiveResults(InstrumentationReactiveResultsParameters parameters,
 InstrumentationState state)

Description copied from interface: Instrumentation

This is called just before the execution of any reactive results, namely incremental deferred results or subscriptions. When the Publisher finally ends (with either a Throwable or none) then the InstrumentationContext wil be called back to say the reactive results have finished.

Specified by:

beginReactiveResults in interface Instrumentation

Parameters:

parameters - the parameters to this step

state - the state created during the call to Instrumentation.createStateAsync(InstrumentationCreateStateParameters)

Returns:

a nullable InstrumentationContext object that will be called back when the step ends (assuming it's not null)

beginExecutionStrategy

public ExecutionStrategyInstrumentationContext beginExecutionStrategy(InstrumentationExecutionStrategyParameters parameters,
 InstrumentationState state)

Description copied from interface: Instrumentation

This is called each time an ExecutionStrategy is invoked, which may be multiple times per query as the engine recursively descends over the query.

Specified by:

beginExecutionStrategy in interface Instrumentation

Parameters:

parameters - the parameters to this step

state - the state created during the call to Instrumentation.createStateAsync(InstrumentationCreateStateParameters)

Returns:

a nullable ExecutionStrategyInstrumentationContext object that will be called back when the step ends (assuming it's not null)

beginExecuteObject

public @Nullable ExecuteObjectInstrumentationContext beginExecuteObject(InstrumentationExecutionStrategyParameters parameters,
 InstrumentationState state)

Description copied from interface: Instrumentation

This is called each time an ExecutionStrategy object resolution is called, which may be multiple times per query as the engine recursively descends over the query.

Specified by:

beginExecuteObject in interface Instrumentation

Parameters:

parameters - the parameters to this step

state - the state created during the call to Instrumentation.createStateAsync(InstrumentationCreateStateParameters)

Returns:

a nullable ExecutionStrategyInstrumentationContext object that will be called back when the step ends (assuming it's not null)

beginDeferredField

@ExperimentalApi
public InstrumentationContext<Object> beginDeferredField(InstrumentationFieldParameters parameters,
 InstrumentationState state)

Description copied from interface: Instrumentation

This is called just before a deferred field is resolved into a value.

This is an EXPERIMENTAL instrumentation callback. The method signature will definitely change.

Specified by:

beginDeferredField in interface Instrumentation

Parameters:

parameters - the parameters to this step

state - the state created during the call to Instrumentation.createStateAsync(InstrumentationCreateStateParameters)

Returns:

a nullable InstrumentationContext object that will be called back when the step ends (assuming it's not null)

beginSubscribedFieldEvent

public InstrumentationContext<ExecutionResult> beginSubscribedFieldEvent(InstrumentationFieldParameters parameters,
 InstrumentationState state)

Description copied from interface: Instrumentation

This is called each time a subscription field produces a new reactive stream event value and it needs to be mapped over via the graphql field subselection.

Specified by:

beginSubscribedFieldEvent in interface Instrumentation

Parameters:

parameters - the parameters to this step

state - the state created during the call to Instrumentation.createStateAsync(InstrumentationCreateStateParameters)

Returns:

a nullable InstrumentationContext object that will be called back when the step ends (assuming it's not null)

beginFieldExecution

public @Nullable InstrumentationContext<Object> beginFieldExecution(InstrumentationFieldParameters parameters,
 InstrumentationState state)

Description copied from interface: Instrumentation

This is called just before a field is resolved into a value.

Specified by:

beginFieldExecution in interface Instrumentation

Parameters:

parameters - the parameters to this step

state - the state created during the call to Instrumentation.createStateAsync(InstrumentationCreateStateParameters)

Returns:

a nullable InstrumentationContext object that will be called back when the step ends (assuming it's not null)

beginFieldFetch

public InstrumentationContext<Object> beginFieldFetch(InstrumentationFieldFetchParameters parameters,
 InstrumentationState state)

Description copied from interface: Instrumentation

This is called just before a field DataFetcher is invoked.

Specified by:

beginFieldFetch in interface Instrumentation

Parameters:

parameters - the parameters to this step

state - the state created during the call to Instrumentation.createStateAsync(InstrumentationCreateStateParameters)

Returns:

a nullable InstrumentationContext object that will be called back when the step ends (assuming it's not null)

beginFieldFetching

public FieldFetchingInstrumentationContext beginFieldFetching(InstrumentationFieldFetchParameters parameters,
 InstrumentationState state)

Description copied from interface: Instrumentation

This is called just before a field DataFetcher is invoked. The FieldFetchingInstrumentationContext.onFetchedValue(Object) callback will be invoked once a value is returned by a DataFetcher but perhaps before its value is completed if it's a CompletableFuture value.

This method is the replacement method for the now deprecated Instrumentation.beginFieldFetch(InstrumentationFieldFetchParameters, InstrumentationState) method, and it should be implemented in new Instrumentation classes. This default version of this method calls back to the deprecated Instrumentation.beginFieldFetch(InstrumentationFieldFetchParameters, InstrumentationState) method so that older implementations continue to work.

Specified by:

beginFieldFetching in interface Instrumentation

Parameters:

parameters - the parameters to this step

state - the state created during the call to Instrumentation.createStateAsync(InstrumentationCreateStateParameters)

Returns:

a nullable InstrumentationContext object that will be called back when the step ends (assuming it's not null)

beginFieldCompletion

public @Nullable InstrumentationContext<Object> beginFieldCompletion(InstrumentationFieldCompleteParameters parameters,
 InstrumentationState state)

Description copied from interface: Instrumentation

This is called just before the complete field is started.

Specified by:

beginFieldCompletion in interface Instrumentation

Parameters:

parameters - the parameters to this step

state - the state created during the call to Instrumentation.createStateAsync(InstrumentationCreateStateParameters)

Returns:

a nullable InstrumentationContext object that will be called back when the step ends (assuming it's not null)

beginFieldListCompletion

public @Nullable InstrumentationContext<Object> beginFieldListCompletion(InstrumentationFieldCompleteParameters parameters,
 InstrumentationState state)

Description copied from interface: Instrumentation

This is called just before the complete field list is started.

Specified by:

beginFieldListCompletion in interface Instrumentation

Parameters:

parameters - the parameters to this step

state - the state created during the call to Instrumentation.createStateAsync(InstrumentationCreateStateParameters)

Returns:

a nullable InstrumentationContext object that will be called back when the step ends (assuming it's not null)

instrumentExecutionInput

public @NonNull ExecutionInput instrumentExecutionInput(ExecutionInput executionInput,
 InstrumentationExecutionParameters parameters,
 InstrumentationState state)

Description copied from interface: Instrumentation

This is called to instrument a ExecutionInput before it is used to parse, validate and execute a query, allowing you to adjust what query input parameters are used

Specified by:

instrumentExecutionInput in interface Instrumentation

Parameters:

executionInput - the execution input to be used

parameters - the parameters describing the field to be fetched

state - the state created during the call to Instrumentation.createStateAsync(InstrumentationCreateStateParameters)

Returns:

a non-null instrumented ExecutionInput, the default is to return to the same object

instrumentDocumentAndVariables

public @NonNull DocumentAndVariables instrumentDocumentAndVariables(DocumentAndVariables documentAndVariables,
 InstrumentationExecutionParameters parameters,
 InstrumentationState state)

Description copied from interface: Instrumentation

This is called to instrument a Document and variables before it is used allowing you to adjust the query AST if you so desire

Specified by:

instrumentDocumentAndVariables in interface Instrumentation

Parameters:

documentAndVariables - the document and variables to be used

parameters - the parameters describing the execution

state - the state created during the call to Instrumentation.createStateAsync(InstrumentationCreateStateParameters)

Returns:

a non-null instrumented DocumentAndVariables, the default is to return to the same objects

instrumentSchema

public @NonNull GraphQLSchema instrumentSchema(GraphQLSchema schema,
 InstrumentationExecutionParameters parameters,
 InstrumentationState state)

Description copied from interface: Instrumentation

This is called to instrument a GraphQLSchema before it is used to parse, validate and execute a query, allowing you to adjust what types are used.

Specified by:

instrumentSchema in interface Instrumentation

Parameters:

schema - the schema to be used

parameters - the parameters describing the field to be fetched

state - the state created during the call to Instrumentation.createStateAsync(InstrumentationCreateStateParameters)

Returns:

a non-null instrumented GraphQLSchema, the default is to return to the same object

instrumentExecutionContext

public @NonNull ExecutionContext instrumentExecutionContext(ExecutionContext executionContext,
 InstrumentationExecutionParameters parameters,
 InstrumentationState state)

Description copied from interface: Instrumentation

This is called to instrument a ExecutionContext before it is used to execute a query, allowing you to adjust the base data used.

Specified by:

instrumentExecutionContext in interface Instrumentation

Parameters:

executionContext - the execution context to be used

parameters - the parameters describing the field to be fetched

state - the state created during the call to Instrumentation.createStateAsync(InstrumentationCreateStateParameters)

Returns:

a non-null instrumented ExecutionContext, the default is to return to the same object

instrumentDataFetcher

public @NonNull DataFetcher<?> instrumentDataFetcher(DataFetcher<?> dataFetcher,
 InstrumentationFieldFetchParameters parameters,
 InstrumentationState state)

Description copied from interface: Instrumentation

This is called to instrument a DataFetcher just before it is used to fetch a field, allowing you to adjust what information is passed back or record information about specific data fetches. Note the same data fetcher instance maybe presented to you many times and that data fetcher implementations widely vary.

Specified by:

instrumentDataFetcher in interface Instrumentation

Parameters:

dataFetcher - the data fetcher about to be used

parameters - the parameters describing the field to be fetched

state - the state created during the call to Instrumentation.createStateAsync(InstrumentationCreateStateParameters)

Returns:

a non-null instrumented DataFetcher, the default is to return to the same object

instrumentExecutionResult

public @NonNull CompletableFuture<ExecutionResult> instrumentExecutionResult(ExecutionResult executionResult,
 InstrumentationExecutionParameters parameters,
 InstrumentationState state)

Description copied from interface: Instrumentation

This is called to allow instrumentation to instrument the execution result in some way

Specified by:

instrumentExecutionResult in interface Instrumentation

Parameters:

executionResult - CompletableFuture of the result to instrument

parameters - the parameters to this step

state - the state created during the call to Instrumentation.createStateAsync(InstrumentationCreateStateParameters)

Returns:

a new execution result completable future