Interface SchemaReport

public interface SchemaReport
Report produced as a result of inspecting schema mappings.

The inspection checks if schema fields are covered either by a DataFetcher registration, or match a Java object property. Fields that have neither are reported as unmappedFields(). The inspection also checks if any DataFetcher are registered against schema fields that don't exist and reports those as unmappedRegistrations().

Since:
1.2.0
Author:
Rossen Stoyanchev

  • Nested Class Summary

    Nested Classes
    Modifier and Type
    Interface
    Description
    static interface 
    SchemaReport.SkippedType
    Information about a schema type skipped during the inspection.

  • Method Summary

    Modifier and Type
    Method
    Description
    graphql.schema.DataFetcher<?>
    dataFetcher(graphql.schema.FieldCoordinates coordinates)
    Return the DataFetcher for the given field coordinates, if registered.
    graphql.schema.GraphQLSchema
    schema()
    Return the inspected schema with type and field definitions.
    List<SchemaReport.SkippedType>
    skippedTypes()
    Return types skipped during the inspection, either because the schema type is not supported, e.g.
    MultiValueMap<graphql.schema.DataFetcher<?>, String>
    unmappedArguments()
    Return a map with DataFetchers and the names of arguments they depend on that don't exist.
    List<graphql.schema.FieldCoordinates>
    unmappedFields()
    Return the coordinates of unmapped fields.
    Map<graphql.schema.FieldCoordinates, graphql.schema.DataFetcher<?>>
    unmappedRegistrations()
    Return the coordinates for invalid DataFetcher registrations referring to fields that don't exist in the schema.

  • Method Details

    • schema

      graphql.schema.GraphQLSchema schema()
      Return the inspected schema with type and field definitions.

    • unmappedFields

      List<graphql.schema.FieldCoordinates> unmappedFields()
      Return the coordinates of unmapped fields. Such fields have neither a DataFetcher registration, such as a @SchemaMapping method, nor a matching Java property in the return type from the parent DataFetcher.

    • unmappedRegistrations

      Map<graphql.schema.FieldCoordinates, graphql.schema.DataFetcher<?>> unmappedRegistrations()
      Return the coordinates for invalid DataFetcher registrations referring to fields that don't exist in the schema.

    • unmappedArguments

      MultiValueMap<graphql.schema.DataFetcher<?>, String> unmappedArguments()
      Return a map with DataFetchers and the names of arguments they depend on that don't exist.
      Since:
      1.3.0

    • skippedTypes

      List<SchemaReport.SkippedType> skippedTypes()
      Return types skipped during the inspection, either because the schema type is not supported, e.g. union, or because there is insufficient Java type information, e.g. controller method that returns Object or wrapper type (collection, reactive, asynchronous) with wildcard generics.

    • dataFetcher

      @Nullable graphql.schema.DataFetcher<?> dataFetcher(graphql.schema.FieldCoordinates coordinates)
      Return the DataFetcher for the given field coordinates, if registered.
      Parameters:
      coordinates - the field coordinates