graphql-java · andimarek · Feb 3, 2022 · Feb 1, 2022 · Feb 1, 2022
diff --git a/src/main/java/graphql/Internal.java b/src/main/java/graphql/Internal.java
@@ -7,6 +7,7 @@
 import static java.lang.annotation.ElementType.CONSTRUCTOR;
 import static java.lang.annotation.ElementType.FIELD;
 import static java.lang.annotation.ElementType.METHOD;
+import static java.lang.annotation.ElementType.PACKAGE;
 import static java.lang.annotation.ElementType.TYPE;
 
 /**
@@ -16,6 +17,6 @@
  * In general unnecessary changes will be avoided but you should not depend on internal classes being stable
  */
 @Retention(RetentionPolicy.RUNTIME)
-@Target(value = {CONSTRUCTOR, METHOD, TYPE, FIELD})
+@Target(value = {CONSTRUCTOR, METHOD, TYPE, FIELD, PACKAGE})
 public @interface Internal {
 }
diff --git a/src/main/java/graphql/execution/nextgen/BatchedDataFetcher.java b/src/main/java/graphql/execution/nextgen/BatchedDataFetcher.java
@@ -3,6 +3,10 @@
 import graphql.Internal;
 import graphql.schema.DataFetcher;
 
+/**
+ * @deprecated Jan 2022 - We have decided to deprecate the NextGen engine, and it will be removed in a future release.
+ */
+@Deprecated
 @Internal
 public interface BatchedDataFetcher<T> extends DataFetcher<T> {
 }
diff --git a/src/main/java/graphql/execution/nextgen/BatchedExecutionStrategy.java b/src/main/java/graphql/execution/nextgen/BatchedExecutionStrategy.java
@@ -33,6 +33,10 @@
 import static graphql.util.FpKit.transposeMatrix;
 import static java.util.concurrent.CompletableFuture.completedFuture;
 
+/**
+ * @deprecated Jan 2022 - We have decided to deprecate the NextGen engine, and it will be removed in a future release.
+ */
+@Deprecated
 @Internal
 public class BatchedExecutionStrategy implements ExecutionStrategy {
 
@@ -57,9 +61,9 @@ public CompletableFuture<RootExecutionResultNode> executeImpl(ExecutionContext e
                 .thenApply(RootExecutionResultNode::new);
 
         return rootCF.thenCompose(rootNode -> {
-            NodeMultiZipper<ExecutionResultNode> unresolvedNodes = ResultNodesUtil.getUnresolvedNodes(rootNode);
-            return nextStep(executionContext, unresolvedNodes);
-        })
+                    NodeMultiZipper<ExecutionResultNode> unresolvedNodes = ResultNodesUtil.getUnresolvedNodes(rootNode);
+                    return nextStep(executionContext, unresolvedNodes);
+                })
                 .thenApply(multiZipper -> multiZipper.toRootNode())
                 .thenApply(RootExecutionResultNode.class::cast);
     }

diff --git a/src/main/java/graphql/execution/nextgen/Common.java b/src/main/java/graphql/execution/nextgen/Common.java
@@ -13,6 +13,10 @@
 import static graphql.language.OperationDefinition.Operation.QUERY;
 import static graphql.language.OperationDefinition.Operation.SUBSCRIPTION;
 
+/**
+ * @deprecated Jan 2022 - We have decided to deprecate the NextGen engine, and it will be removed in a future release.
+ */
+@Deprecated
 @Internal
 public class Common {
 

diff --git a/src/main/java/graphql/execution/nextgen/DefaultExecutionStrategy.java b/src/main/java/graphql/execution/nextgen/DefaultExecutionStrategy.java
@@ -19,6 +19,11 @@
 import static graphql.execution.Async.each;
 import static graphql.execution.Async.mapCompose;
 
+/**
+ *
+ * @deprecated Jan 2022 - We have decided to deprecate the NextGen engine, and it will be removed in a future release.
+ */
+@Deprecated
 @Internal
 public class DefaultExecutionStrategy implements ExecutionStrategy {
 

diff --git a/src/main/java/graphql/execution/nextgen/Execution.java b/src/main/java/graphql/execution/nextgen/Execution.java
@@ -13,6 +13,10 @@
 
 import java.util.concurrent.CompletableFuture;
 
+/**
+ * @deprecated Jan 2022 - We have decided to deprecate the NextGen engine, and it will be removed in a future release.
+ */
+@Deprecated
 @Internal
 public class Execution {
 

diff --git a/src/main/java/graphql/execution/nextgen/ExecutionHelper.java b/src/main/java/graphql/execution/nextgen/ExecutionHelper.java
@@ -25,6 +25,10 @@
 import static graphql.execution.ExecutionContextBuilder.newExecutionContextBuilder;
 import static graphql.execution.ExecutionStepInfo.newExecutionStepInfo;
 
+/**
+ * @deprecated Jan 2022 - We have decided to deprecate the NextGen engine, and it will be removed in a future release.
+ */
+@Deprecated
 @Internal
 public class ExecutionHelper {
 

diff --git a/src/main/java/graphql/execution/nextgen/ExecutionStrategy.java b/src/main/java/graphql/execution/nextgen/ExecutionStrategy.java
@@ -6,6 +6,10 @@
 
 import java.util.concurrent.CompletableFuture;
 
+/**
+ * @deprecated Jan 2022 - We have decided to deprecate the NextGen engine, and it will be removed in a future release.
+ */
+@Deprecated
 @Internal
 public interface ExecutionStrategy {
 

diff --git a/src/main/java/graphql/execution/nextgen/ExecutionStrategyUtil.java b/src/main/java/graphql/execution/nextgen/ExecutionStrategyUtil.java
@@ -22,6 +22,10 @@
 import static graphql.collect.ImmutableKit.map;
 import static graphql.execution.FieldCollectorParameters.newParameters;
 
+/**
+ * @deprecated Jan 2022 - We have decided to deprecate the NextGen engine, and it will be removed in a future release.
+ */
+@Deprecated
 @Internal
 public class ExecutionStrategyUtil {
 

diff --git a/src/main/java/graphql/execution/nextgen/FetchedValueAnalysis.java b/src/main/java/graphql/execution/nextgen/FetchedValueAnalysis.java
@@ -13,6 +13,10 @@
 
 import static graphql.Assert.assertNotNull;
 
+/**
+ * @deprecated Jan 2022 - We have decided to deprecate the NextGen engine, and it will be removed in a future release.
+ */
+@Deprecated
 @Internal
 public class FetchedValueAnalysis {
 

diff --git a/src/main/java/graphql/execution/nextgen/FetchedValueAnalyzer.java b/src/main/java/graphql/execution/nextgen/FetchedValueAnalyzer.java
@@ -30,6 +30,10 @@
 import static graphql.execution.nextgen.FetchedValueAnalysis.newFetchedValueAnalysis;
 import static graphql.schema.GraphQLTypeUtil.isList;
 
+/**
+ * @deprecated Jan 2022 - We have decided to deprecate the NextGen engine, and it will be removed in a future release.
+ */
+@Deprecated
 @Internal
 public class FetchedValueAnalyzer {
 

diff --git a/src/main/java/graphql/execution/nextgen/FieldSubSelection.java b/src/main/java/graphql/execution/nextgen/FieldSubSelection.java
@@ -11,7 +11,10 @@
 /**
  * A map from name to List of Field representing the actual sub selections (during execution) of a Field with Fragments
  * evaluated and conditional directives considered.
+ *
+ * @deprecated Jan 2022 - We have decided to deprecate the NextGen engine, and it will be removed in a future release.
  */
+@Deprecated
 @Internal
 public class FieldSubSelection {
 

diff --git a/src/main/java/graphql/execution/nextgen/ResultNodesCreator.java b/src/main/java/graphql/execution/nextgen/ResultNodesCreator.java
@@ -15,6 +15,10 @@
 
 import static graphql.collect.ImmutableKit.map;
 
+/**
+ * @deprecated Jan 2022 - We have decided to deprecate the NextGen engine, and it will be removed in a future release.
+ */
+@Deprecated
 @Internal
 public class ResultNodesCreator {
 

diff --git a/src/main/java/graphql/execution/nextgen/ValueFetcher.java b/src/main/java/graphql/execution/nextgen/ValueFetcher.java
@@ -46,6 +46,10 @@
 import static graphql.schema.DataFetchingEnvironmentImpl.newDataFetchingEnvironment;
 import static java.util.Collections.singletonList;
 
+/**
+ * @deprecated Jan 2022 - We have decided to deprecate the NextGen engine, and it will be removed in a future release.
+ */
+@Deprecated
 @Internal
 public class ValueFetcher {
 

diff --git a/src/main/java/graphql/execution/nextgen/package-info.java b/src/main/java/graphql/execution/nextgen/package-info.java
@@ -1,5 +1,11 @@
 /**
  * WARNING: All code in this package is a work in progress for a new execution engine.
  * It is not really "wired up" and can't be really used and should not be used yet!
+ *
+ * Jan 2022 - We have decided to deprecate the NextGen engine, and it will be removed in a future release.
  */
-package graphql.execution.nextgen;
+@Internal
+@Deprecated
+package graphql.execution.nextgen;
+
+import graphql.Internal;
diff --git a/src/main/java/graphql/execution/nextgen/result/ExecutionResultNode.java b/src/main/java/graphql/execution/nextgen/result/ExecutionResultNode.java
@@ -15,6 +15,10 @@
 
 import static graphql.Assert.assertNotNull;
 
+/**
+ * @deprecated Jan 2022 - We have decided to deprecate the NextGen engine, and it will be removed in a future release.
+ */
+@Deprecated
 @Internal
 public abstract class ExecutionResultNode {
 

diff --git a/src/main/java/graphql/execution/nextgen/result/LeafExecutionResultNode.java b/src/main/java/graphql/execution/nextgen/result/LeafExecutionResultNode.java
@@ -10,6 +10,10 @@
 import java.util.Collections;
 import java.util.List;
 
+/**
+ * @deprecated Jan 2022 - We have decided to deprecate the NextGen engine, and it will be removed in a future release.
+ */
+@Deprecated
 @Internal
 public class LeafExecutionResultNode extends ExecutionResultNode {
 

diff --git a/src/main/java/graphql/execution/nextgen/result/ListExecutionResultNode.java b/src/main/java/graphql/execution/nextgen/result/ListExecutionResultNode.java
@@ -8,6 +8,10 @@
 import java.util.Collections;
 import java.util.List;
 
+/**
+ * @deprecated Jan 2022 - We have decided to deprecate the NextGen engine, and it will be removed in a future release.
+ */
+@Deprecated
 @Internal
 public class ListExecutionResultNode extends ExecutionResultNode {
 

diff --git a/src/main/java/graphql/execution/nextgen/result/NamedResultNode.java b/src/main/java/graphql/execution/nextgen/result/NamedResultNode.java
@@ -2,6 +2,10 @@
 
 import graphql.Internal;
 
+/**
+ * @deprecated Jan 2022 - We have decided to deprecate the NextGen engine, and it will be removed in a future release.
+ */
+@Deprecated
 @Internal
 public class NamedResultNode {
     private final String name;

diff --git a/src/main/java/graphql/execution/nextgen/result/ObjectExecutionResultNode.java b/src/main/java/graphql/execution/nextgen/result/ObjectExecutionResultNode.java
@@ -8,6 +8,10 @@
 import java.util.Collections;
 import java.util.List;
 
+/**
+ * @deprecated Jan 2022 - We have decided to deprecate the NextGen engine, and it will be removed in a future release.
+ */
+@Deprecated
 @Internal
 public class ObjectExecutionResultNode extends ExecutionResultNode {
 

diff --git a/src/main/java/graphql/execution/nextgen/result/ResolvedValue.java b/src/main/java/graphql/execution/nextgen/result/ResolvedValue.java
@@ -9,6 +9,10 @@
 import java.util.List;
 import java.util.function.Consumer;
 
+/**
+ * @deprecated Jan 2022 - We have decided to deprecate the NextGen engine, and it will be removed in a future release.
+ */
+@Deprecated
 @Internal
 public class ResolvedValue {
 

diff --git a/src/main/java/graphql/execution/nextgen/result/ResultNodeAdapter.java b/src/main/java/graphql/execution/nextgen/result/ResultNodeAdapter.java
@@ -12,6 +12,10 @@
 import static graphql.Assert.assertNotNull;
 import static graphql.Assert.assertTrue;
 
+/**
+ * @deprecated Jan 2022 - We have decided to deprecate the NextGen engine, and it will be removed in a future release.
+ */
+@Deprecated
 @Internal
 public class ResultNodeAdapter implements NodeAdapter<ExecutionResultNode> {
 

diff --git a/src/main/java/graphql/execution/nextgen/result/ResultNodeTraverser.java b/src/main/java/graphql/execution/nextgen/result/ResultNodeTraverser.java
@@ -6,6 +6,10 @@
 
 import java.util.Collection;
 
+/**
+ * @deprecated Jan 2022 - We have decided to deprecate the NextGen engine, and it will be removed in a future release.
+ */
+@Deprecated
 @Internal
 public class ResultNodeTraverser {
 

diff --git a/src/main/java/graphql/execution/nextgen/result/ResultNodesUtil.java b/src/main/java/graphql/execution/nextgen/result/ResultNodesUtil.java
@@ -28,6 +28,10 @@
 import static java.util.Collections.emptyList;
 import static java.util.Collections.singleton;
 
+/**
+ * @deprecated Jan 2022 - We have decided to deprecate the NextGen engine, and it will be removed in a future release.
+ */
+@Deprecated
 @Internal
 public class ResultNodesUtil {
 

diff --git a/src/main/java/graphql/execution/nextgen/result/RootExecutionResultNode.java b/src/main/java/graphql/execution/nextgen/result/RootExecutionResultNode.java
@@ -10,6 +10,10 @@
 
 import static graphql.Assert.assertShouldNeverHappen;
 
+/**
+ * @deprecated Jan 2022 - We have decided to deprecate the NextGen engine, and it will be removed in a future release.
+ */
+@Deprecated
 @Internal
 public class RootExecutionResultNode extends ObjectExecutionResultNode {
 

diff --git a/src/main/java/graphql/execution/nextgen/result/UnresolvedObjectResultNode.java b/src/main/java/graphql/execution/nextgen/result/UnresolvedObjectResultNode.java
@@ -5,6 +5,10 @@
 
 import java.util.Collections;
 
+/**
+ * @deprecated Jan 2022 - We have decided to deprecate the NextGen engine, and it will be removed in a future release.
+ */
+@Deprecated
 @Internal
 public class UnresolvedObjectResultNode extends ObjectExecutionResultNode {
 

diff --git a/src/main/java/graphql/nextgen/GraphQL.java b/src/main/java/graphql/nextgen/GraphQL.java
@@ -39,6 +39,11 @@
 
 import static graphql.Assert.assertNotNull;
 
+/**
+ *
+ * @deprecated Jan 2022 - We have decided to deprecate the NextGen engine, and it will be removed in a future release.
+ */
+@Deprecated
 @SuppressWarnings("Duplicates")
 @Internal
 public class GraphQL {

diff --git a/src/main/java/graphql/nextgen/package-info.java b/src/main/java/graphql/nextgen/package-info.java
@@ -1,4 +1,10 @@
 /**
  * WARNING: All code in this package is a work in progress for a new execution engine.
+ *
+ *Jan 2022 - We have decided to deprecate the NextGen engine, and it will be removed in a future release.
  */
+@Internal
+@Deprecated
 package graphql.nextgen;
+
+import graphql.Internal;