graphql.execution.instrumentation

Class NoContextChainedInstrumentation

java.lang.Object

graphql.execution.instrumentation.ChainedInstrumentation

graphql.execution.instrumentation.NoContextChainedInstrumentation

All Implemented Interfaces:

Instrumentation

@PublicApi
public class NoContextChainedInstrumentation
extends ChainedInstrumentation

This version of ChainedInstrumentation will call a list of Instrumentations but it will never back on the returned InstrumentationContext objects, hence it is only suitable to certain use cases. Only use this class if you are optimising for memory usage as scale. In most cases the ChainedInstrumentation will do the job required with all the instrumentation features used however some users require the fastest performance and lowest memory usage at scale and this class can be used. At scale, the fact that the graphql engine holds the InstrumentationContext objects in memory for a (relatively) long time (the length of the request or the length of a large field fetch) means that memory pressure can grow and objects move into longer tenure GC pools. Holding these contexts is also not necessary if the instrumentation never needs to know when a certain execution step finishes. The InstrumentationContext is used ot know when an execution step has completed, so instrumentations that do timings say need to use this callback mechanism. Putting such an instrumentation into NoContextChainedInstrumentation would be a mistake because no callback will occur. Therefore, use of this class is reserved for very specific us cases. You are fore-warned. This class never holds onto the returned InstrumentationContext objects and always returns null as itself.

Field Summary

Fields inherited from class graphql.execution.instrumentation.ChainedInstrumentation

instrumentations

Constructor Summary

Constructors

Constructor and Description
NoContextChainedInstrumentation(Instrumentation... instrumentations)
NoContextChainedInstrumentation(java.util.List<Instrumentation> instrumentations)

Method Summary

Modifier and Type	Method and Description
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 down over the query.
InstrumentationContext<ExecutionResult>	beginField(InstrumentationFieldParameters parameters, InstrumentationState state) This is called just before a field is resolved into a value.
InstrumentationContext<ExecutionResult>	beginFieldComplete(InstrumentationFieldCompleteParameters parameters, InstrumentationState state) This is called just before the complete field is started.
InstrumentationContext<java.lang.Object>	beginFieldFetch(InstrumentationFieldFetchParameters parameters, InstrumentationState state) This is called just before a field DataFetcher is invoked.
InstrumentationContext<ExecutionResult>	beginFieldListComplete(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.
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<java.util.List<ValidationError>>	beginValidation(InstrumentationValidationParameters parameters, InstrumentationState state) This is called just before the parsed query document is validated.

Methods inherited from class graphql.execution.instrumentation.ChainedInstrumentation

beginExecuteOperation, beginExecution, beginExecutionStrategy, beginField, beginFieldComplete, beginFieldFetch, beginFieldListComplete, beginParse, beginSubscribedFieldEvent, beginValidation, createState, getInstrumentations, getSpecificState, instrumentDataFetcher, instrumentDataFetcher, instrumentDocumentAndVariables, instrumentDocumentAndVariables, instrumentExecutionContext, instrumentExecutionContext, instrumentExecutionInput, instrumentExecutionInput, instrumentExecutionResult, instrumentExecutionResult, instrumentSchema, instrumentSchema

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

Constructor Detail

NoContextChainedInstrumentation

public NoContextChainedInstrumentation(java.util.List<Instrumentation> instrumentations)

NoContextChainedInstrumentation

public NoContextChainedInstrumentation(Instrumentation... instrumentations)

Method Detail

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

Overrides:

beginExecution in class ChainedInstrumentation

Parameters:

parameters - the parameters to this step

state - the state created during the call to Instrumentation.createState(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

Overrides:

beginParse in class ChainedInstrumentation

Parameters:

parameters - the parameters to this step

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

Returns:

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

beginValidation

public InstrumentationContext<java.util.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

Overrides:

beginValidation in class ChainedInstrumentation

Parameters:

parameters - the parameters to this step

state - the state created during the call to Instrumentation.createState(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

Overrides:

beginExecuteOperation in class ChainedInstrumentation

Parameters:

parameters - the parameters to this step

state - the state created during the call to Instrumentation.createState(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 down over the query.

Specified by:

beginExecutionStrategy in interface Instrumentation

Overrides:

beginExecutionStrategy in class ChainedInstrumentation

Parameters:

parameters - the parameters to this step

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

Returns:

a nullable ExecutionStrategyInstrumentationContext 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

Overrides:

beginSubscribedFieldEvent in class ChainedInstrumentation

Parameters:

parameters - the parameters to this step

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

Returns:

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

beginField

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

Description copied from interface: Instrumentation

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

Specified by:

beginField in interface Instrumentation

Overrides:

beginField in class ChainedInstrumentation

Parameters:

parameters - the parameters to this step

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

Returns:

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

beginFieldFetch

public InstrumentationContext<java.lang.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

Overrides:

beginFieldFetch in class ChainedInstrumentation

Parameters:

parameters - the parameters to this step

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

Returns:

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

beginFieldComplete

public InstrumentationContext<ExecutionResult> beginFieldComplete(InstrumentationFieldCompleteParameters parameters,
                                                                  InstrumentationState state)

Description copied from interface: Instrumentation

This is called just before the complete field is started.

Specified by:

beginFieldComplete in interface Instrumentation

Overrides:

beginFieldComplete in class ChainedInstrumentation

Parameters:

parameters - the parameters to this step

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

Returns:

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

beginFieldListComplete

public InstrumentationContext<ExecutionResult> beginFieldListComplete(InstrumentationFieldCompleteParameters parameters,
                                                                      InstrumentationState state)

Description copied from interface: Instrumentation

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

Specified by:

beginFieldListComplete in interface Instrumentation

Overrides:

beginFieldListComplete in class ChainedInstrumentation

Parameters:

parameters - the parameters to this step

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

Returns:

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