graphql.analysis

Class MaxQueryComplexityInstrumentation

java.lang.Object

graphql.execution.instrumentation.SimpleInstrumentation

graphql.analysis.MaxQueryComplexityInstrumentation

All Implemented Interfaces:

Instrumentation

@PublicApi
public class MaxQueryComplexityInstrumentation
extends SimpleInstrumentation

Prevents execution if the query complexity is greater than the specified maxComplexity. Use the Function<QueryComplexityInfo, Boolean> parameter to supply a function to perform a custom action when the max complexity is exceeded. If the function returns true a AbortExecutionException is thrown.

Field Summary

Fields inherited from class graphql.execution.instrumentation.SimpleInstrumentation

INSTANCE

Constructor Summary

Constructors

Constructor and Description
MaxQueryComplexityInstrumentation(int maxComplexity) new Instrumentation with default complexity calculator which is `1 + childComplexity`
MaxQueryComplexityInstrumentation(int maxComplexity, FieldComplexityCalculator fieldComplexityCalculator) new Instrumentation with custom complexity calculator
MaxQueryComplexityInstrumentation(int maxComplexity, FieldComplexityCalculator fieldComplexityCalculator, java.util.function.Function<QueryComplexityInfo,java.lang.Boolean> maxQueryComplexityExceededFunction) new Instrumentation with custom complexity calculator
MaxQueryComplexityInstrumentation(int maxComplexity, java.util.function.Function<QueryComplexityInfo,java.lang.Boolean> maxQueryComplexityExceededFunction) new Instrumentation with default complexity calculator which is `1 + childComplexity`

Method Summary

Modifier and Type	Method and Description
InstrumentationContext<java.util.List<ValidationError>>	beginValidation(InstrumentationValidationParameters parameters) This is called just before the parsed query document is validated.
protected AbortExecutionException	mkAbortException(int totalComplexity, int maxComplexity) Called to generate your own error message or custom exception class

Methods inherited from class graphql.execution.instrumentation.SimpleInstrumentation

beginDeferredField, beginExecuteOperation, beginExecution, beginExecutionStrategy, beginField, beginFieldComplete, beginFieldFetch, beginFieldListComplete, beginParse, createState, instrumentDataFetcher, instrumentExecutionContext, instrumentExecutionResult, 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, instrumentDocumentAndVariables, instrumentExecutionInput

Constructor Detail

MaxQueryComplexityInstrumentation

public MaxQueryComplexityInstrumentation(int maxComplexity)

new Instrumentation with default complexity calculator which is `1 + childComplexity`

Parameters:

maxComplexity - max allowed complexity, otherwise execution will be aborted

MaxQueryComplexityInstrumentation

public MaxQueryComplexityInstrumentation(int maxComplexity,
                                         java.util.function.Function<QueryComplexityInfo,java.lang.Boolean> maxQueryComplexityExceededFunction)

new Instrumentation with default complexity calculator which is `1 + childComplexity`

Parameters:

maxComplexity - max allowed complexity, otherwise execution will be aborted

maxQueryComplexityExceededFunction - the function to perform when the max complexity is exceeded

MaxQueryComplexityInstrumentation

public MaxQueryComplexityInstrumentation(int maxComplexity,
                                         FieldComplexityCalculator fieldComplexityCalculator)

new Instrumentation with custom complexity calculator

Parameters:

maxComplexity - max allowed complexity, otherwise execution will be aborted

fieldComplexityCalculator - custom complexity calculator

MaxQueryComplexityInstrumentation

public MaxQueryComplexityInstrumentation(int maxComplexity,
                                         FieldComplexityCalculator fieldComplexityCalculator,
                                         java.util.function.Function<QueryComplexityInfo,java.lang.Boolean> maxQueryComplexityExceededFunction)

new Instrumentation with custom complexity calculator

Parameters:

maxComplexity - max allowed complexity, otherwise execution will be aborted

fieldComplexityCalculator - custom complexity calculator

maxQueryComplexityExceededFunction - the function to perform when the max complexity is exceeded

Method Detail

beginValidation

public InstrumentationContext<java.util.List<ValidationError>> beginValidation(InstrumentationValidationParameters parameters)

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 SimpleInstrumentation

Parameters:

parameters - the parameters to this step

Returns:

a non null InstrumentationContext object that will be called back when the step ends

mkAbortException

protected AbortExecutionException mkAbortException(int totalComplexity,
                                                   int maxComplexity)

Called to generate your own error message or custom exception class

Parameters:

totalComplexity - the complexity of the query

maxComplexity - the maximum complexity allowed

Returns:

a instance of AbortExecutionException