graphql.execution

Class ExecutorServiceExecutionStrategy

java.lang.Object

graphql.execution.ExecutionStrategy

graphql.execution.ExecutorServiceExecutionStrategy

@PublicApi
public class ExecutorServiceExecutionStrategy
extends ExecutionStrategy

ExecutorServiceExecutionStrategy uses an ExecutorService to parallelize the resolve.

Due to the nature of execute(ExecutionContext, ExecutionStrategyParameters) implementation, ExecutorService MUST have the following 2 characteristics:

• 1. The underlying ThreadPoolExecutor MUST have a reasonable maximumPoolSize
• 2. The underlying ThreadPoolExecutor SHALL NOT use its task queue.

Failure to follow 1. and 2. can result in a very large number of threads created or hanging. (deadlock)

See graphql.execution.ExecutorServiceExecutionStrategyTest for example usage.

Field Summary

Fields inherited from class graphql.execution.ExecutionStrategy

dataFetcherExceptionHandler, fieldCollector, valuesResolver

Constructor Summary

Constructors

Constructor and Description
ExecutorServiceExecutionStrategy(java.util.concurrent.ExecutorService executorService)
ExecutorServiceExecutionStrategy(java.util.concurrent.ExecutorService executorService, DataFetcherExceptionHandler dataFetcherExceptionHandler)

Method Summary

Modifier and Type	Method and Description
java.util.concurrent.CompletableFuture<ExecutionResult>	execute(ExecutionContext executionContext, ExecutionStrategyParameters parameters) This is the entry point to an execution strategy.

Methods inherited from class graphql.execution.ExecutionStrategy

assertNonNullFieldPrecondition, assertNonNullFieldPrecondition, completeField, completeValue, completeValueForEnum, completeValueForList, completeValueForList, completeValueForObject, completeValueForScalar, fetchField, fieldTypeInfo, getFieldDef, getFieldDef, handleNonNullException, resolveField, resolveType, resolveTypeForInterface, resolveTypeForUnion, toIterable, toIterable, unboxPossibleOptional

Methods inherited from class java.lang.Object

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

Constructor Detail

ExecutorServiceExecutionStrategy

public ExecutorServiceExecutionStrategy(java.util.concurrent.ExecutorService executorService)

ExecutorServiceExecutionStrategy

public ExecutorServiceExecutionStrategy(java.util.concurrent.ExecutorService executorService,
                                        DataFetcherExceptionHandler dataFetcherExceptionHandler)

Method Detail

execute

public java.util.concurrent.CompletableFuture<ExecutionResult> execute(ExecutionContext executionContext,
                                                                       ExecutionStrategyParameters parameters)

Description copied from class: ExecutionStrategy

This is the entry point to an execution strategy. It will be passed the fields to execute and get values for.

Specified by:

execute in class ExecutionStrategy

Parameters:

executionContext - contains the top level execution parameters

parameters - contains the parameters holding the fields to be executed and source object

Returns:

an ExecutionResult