added @experimentalapi

bbakerman · bbakerman · commit e55ddee19d27 · 2023-08-05T16:59:16.000+10:00
diff --git a/src/main/java/graphql/Directives.java b/src/main/java/graphql/Directives.java
@@ -37,6 +37,7 @@ public class Directives {
     public static final String NO_LONGER_SUPPORTED = "No longer supported";
     public static final DirectiveDefinition DEPRECATED_DIRECTIVE_DEFINITION;
     public static final DirectiveDefinition SPECIFIED_BY_DIRECTIVE_DEFINITION;
+    @ExperimentalApi
     public static final DirectiveDefinition ONE_OF_DIRECTIVE_DEFINITION;
 
 
@@ -128,6 +129,7 @@ public class Directives {
             .definition(SPECIFIED_BY_DIRECTIVE_DEFINITION)
             .build();
 
+    @ExperimentalApi
     public static final GraphQLDirective OneOfDirective = GraphQLDirective.newDirective()
             .name(ONE_OF)
             .description("Indicates an Input Object is a OneOf Input Object.")
diff --git a/src/main/java/graphql/introspection/Introspection.java b/src/main/java/graphql/introspection/Introspection.java
@@ -450,6 +450,7 @@ private static String printDefaultValue(InputValueWithState inputValueWithState,
                     .type(typeRef("__Type")))
             .field(newFieldDefinition()
                     .name("isOneOf")
+                    .description("This field is considered experimental because it has not yet been ratified in the graphql specification")
                     .type(GraphQLBoolean))
             .field(newFieldDefinition()
                     .name("specifiedByURL")
diff --git a/src/main/java/graphql/schema/GraphQLInputObjectType.java b/src/main/java/graphql/schema/GraphQLInputObjectType.java
@@ -4,6 +4,7 @@
 import com.google.common.collect.ImmutableMap;
 import graphql.Directives;
 import graphql.DirectivesUtil;
+import graphql.ExperimentalApi;
 import graphql.Internal;
 import graphql.PublicApi;
 import graphql.language.InputObjectTypeDefinition;
@@ -86,9 +87,13 @@ public String getName() {
 
     /**
      * An Input Object is considered a OneOf Input Object if it has the `@oneOf` directive applied to it.
+     * <p>
+     * This API is currently considered experimental since the graphql specification has not yet ratified
+     * this approach.
      *
      * @return true if it's a OneOf Input Object
      */
+    @ExperimentalApi
     public boolean isOneOf() {
         return isOneOf;
     }
diff --git a/src/main/java/graphql/schema/validation/OneOfInputObjectRules.java b/src/main/java/graphql/schema/validation/OneOfInputObjectRules.java
@@ -1,5 +1,6 @@
 package graphql.schema.validation;
 
+import graphql.ExperimentalApi;
 import graphql.schema.GraphQLInputObjectField;
 import graphql.schema.GraphQLInputObjectType;
 import graphql.schema.GraphQLSchemaElement;
@@ -15,6 +16,7 @@
  * The type of the input field must be nullable.
  * The input field must not have a default value.
  */
+@ExperimentalApi
 public class OneOfInputObjectRules extends GraphQLTypeVisitorStub {
 
     @Override
