graphql.execution

Class ExecutorServiceExecutionStrategy

java.lang.Object

graphql.execution.ExecutionStrategy

graphql.execution.ExecutorServiceExecutionStrategy

Deprecated.

Use AsyncExecutionStrategy and CompletableFuture.supplyAsync(java.util.function.Supplier, java.util.concurrent.Executor) in your data fetchers instead.

@PublicApi
 @Deprecated
public class ExecutorServiceExecutionStrategy
extends ExecutionStrategy

Deprecation Notice : This execution strategy does not support all of the graphql-java capabilities such as data loader. Since its so easy to create a data fetcher that uses CompletableFuture.supplyAsync(java.util.function.Supplier, java.util.concurrent.Executor) to make field fetching happen off thread we recommend that you use that instead of this class. This class will be removed in a future version.

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, executionStepInfoFactory, fieldCollector, valuesResolver

Constructor Summary

Constructors

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

Method Summary

Modifier and Type	Method and Description
java.util.concurrent.CompletableFuture<ExecutionResult>	execute(ExecutionContext executionContext, ExecutionStrategyParameters parameters) Deprecated. 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, createExecutionStepInfo, fetchField, getFieldDef, getFieldDef, getNormalizedField, handleFetchingException, handleNonNullException, mkNameForPath, mkNameForPath, mkNameForPath, resolveField, resolveFieldWithInfo, resolveType, toIterable, toIterable, unboxPossibleDataFetcherResult

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)

Deprecated.

ExecutorServiceExecutionStrategy

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

Deprecated.

Method Detail

execute

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

Deprecated.

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:

a promise to an ExecutionResult