add getField to DataFetchingEnvironment

andimarek · bbakerman · commit d6391652994b · 2018-02-23T21:08:30.000+11:00
diff --git a/src/main/java/graphql/schema/DataFetchingEnvironment.java b/src/main/java/graphql/schema/DataFetchingEnvironment.java
@@ -80,10 +80,34 @@ public interface DataFetchingEnvironment {
 
 
     /**
-     * @return the list of fields currently in query context
+     * It can happen that a query has overlapping fields which are
+     * are querying the same data. If this is the case they get merged
+     * together and fetched only once, but this method returns all of the Fields
+     * from the query.
+     *
+     * Most of the time you probably want to use {@link #getField()}.
+     *
+     * Example query with more than one Field returned:
+     *
+     *  query Foo {
+     *      bar
+     *      ...BarFragment
+     *  }
+     *
+     *  fragment BarFragment on Query {
+     *      bar
+     *  }
+     *
+     *
+     * @return the list of fields currently queried
      */
     List<Field> getFields();
 
+    /**
+     * @return returns the field which is currently queried. See also {@link #getFields()}
+     */
+    Field getField();
+
     /**
      * @return graphql type of the current field
      */
diff --git a/src/main/java/graphql/schema/DataFetchingEnvironmentImpl.java b/src/main/java/graphql/schema/DataFetchingEnvironmentImpl.java
@@ -83,6 +83,11 @@ public List<Field> getFields() {
         return fields;
     }
 
+    @Override
+    public Field getField() {
+        return fields.get(0);
+    }
+
     @Override
     public GraphQLOutputType getFieldType() {
         return fieldType;
