Package graphql.schema.idl

Class TypeDefinitionRegistry

java.lang.Object

graphql.schema.idl.TypeDefinitionRegistry

All Implemented Interfaces:

Serializable

@PublicApi
public class TypeDefinitionRegistry
extends Object
implements Serializable

A TypeDefinitionRegistry contains the set of type definitions that come from compiling a graphql schema definition file via SchemaParser.parse(String)

See Also:

• Serialized Form

Field Summary

Fields

Modifier and Type	Field	Description
private final Map<String,DirectiveDefinition>	directiveDefinitions
private final Map<String,List<EnumTypeExtensionDefinition>>	enumTypeExtensions
private final Map<String,List<InputObjectTypeExtensionDefinition>>	inputObjectTypeExtensions
private final Map<String,List<InterfaceTypeExtensionDefinition>>	interfaceTypeExtensions
private final Map<String,List<ObjectTypeExtensionDefinition>>	objectTypeExtensions
private final Map<String,List<ScalarTypeExtensionDefinition>>	scalarTypeExtensions
private final Map<String,ScalarTypeDefinition>	scalarTypes
private SchemaDefinition	schema
private final List<SchemaExtensionDefinition>	schemaExtensionDefinitions
private final SchemaParseOrder	schemaParseOrder
private final Map<String,TypeDefinition>	types
private final Map<String,List<UnionTypeExtensionDefinition>>	unionTypeExtensions

Constructor Summary

Constructors

Constructor	Description
TypeDefinitionRegistry()

Method Summary

Modifier and Type	Method	Description
Optional<GraphQLError>	add(SDLDefinition definition)	Adds a definition to the registry
Optional<GraphQLError>	addAll(Collection<SDLDefinition> definitions)	Adds a a collections of definitions to the registry
private Optional<GraphQLError>	checkAddOperationDefs()
private Map<String,OperationTypeDefinition>	checkMergeSchemaDefs(TypeDefinitionRegistry toBeMergedTypeRegistry, List<GraphQLError> errors)
private <T extends TypeDefinition> Optional<GraphQLError>	define(Map<String,T> source, Map<String,T> target, T newEntry)
private <T extends TypeDefinition> Optional<GraphQLError>	defineExt(Map<String,List<T>> typeExtensions, T newEntry, Function<T,String> namerFunc)
Map<String,List<EnumTypeExtensionDefinition>>	enumTypeExtensions()
List<ImplementingTypeDefinition>	getAllImplementationsOf(InterfaceTypeDefinition targetInterface)	Returns the list of object and interface types that implement the given interface type
Optional<DirectiveDefinition>	getDirectiveDefinition(String directiveName)
Map<String,DirectiveDefinition>	getDirectiveDefinitions()
List<ObjectTypeDefinition>	getImplementationsOf(InterfaceTypeDefinition targetInterface)	Returns the list of object interface types that implement the given interface type
SchemaParseOrder	getParseOrder()
List<SchemaExtensionDefinition>	getSchemaExtensionDefinitions()
Optional<TypeDefinition>	getType(Type type)
<T extends TypeDefinition> Optional<T>	getType(Type type, Class<T> ofType)
Optional<TypeDefinition>	getType(String typeName)
<T extends TypeDefinition> Optional<T>	getType(String typeName, Class<T> ofType)
<T extends TypeDefinition> List<T>	getTypes(Class<T> targetClass)	Returns a list of types in the registry of that specified class
<T extends TypeDefinition> Map<String,T>	getTypesMap(Class<T> targetClass)	Returns a map of types in the registry of that specified class keyed by name
private GraphQLError	handleReDefinition(DirectiveDefinition oldEntry, DirectiveDefinition newEntry)
private GraphQLError	handleReDefinition(TypeDefinition oldEntry, TypeDefinition newEntry)
boolean	hasType(TypeName typeName)
Map<String,List<InputObjectTypeExtensionDefinition>>	inputObjectTypeExtensions()
Map<String,List<InterfaceTypeExtensionDefinition>>	interfaceTypeExtensions()
boolean	isInterfaceOrUnion(Type type)	Returns true if the specified type exists in the registry and is an abstract (Interface or Union) type
boolean	isObjectType(Type type)	Returns true if the specified type exists in the registry and is an object type
boolean	isObjectTypeOrInterface(Type type)	Returns true if the specified type exists in the registry and is an object type or interface
boolean	isPossibleType(Type abstractType, Type possibleType)	Returns true of the abstract type is in implemented by the object type or interface
boolean	isSubTypeOf(Type maybeSubType, Type superType)	Returns true if the maybe type is either equal or a subset of the second super type (covariant).
TypeDefinitionRegistry	merge(TypeDefinitionRegistry typeRegistry)	This will merge these type registries together and return this one
Map<String,List<ObjectTypeExtensionDefinition>>	objectTypeExtensions()
void	remove(SDLDefinition definition)	Removes a SDLDefinition from the definition list.
void	remove(String key, SDLDefinition definition)	Removes a SDLDefinition from a map.
private void	removeFromList(Map source, TypeDefinition value)
private void	removeFromMap(Map source, String key)
Map<String,ScalarTypeDefinition>	scalars()
Map<String,List<ScalarTypeExtensionDefinition>>	scalarTypeExtensions()
Optional<SchemaDefinition>	schemaDefinition()
Map<String,TypeDefinition>	types()
Map<String,List<UnionTypeExtensionDefinition>>	unionTypeExtensions()

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details

objectTypeExtensions

private final Map<String,List<ObjectTypeExtensionDefinition>> objectTypeExtensions

interfaceTypeExtensions

private final Map<String,List<InterfaceTypeExtensionDefinition>> interfaceTypeExtensions

unionTypeExtensions

private final Map<String,List<UnionTypeExtensionDefinition>> unionTypeExtensions

enumTypeExtensions

private final Map<String,List<EnumTypeExtensionDefinition>> enumTypeExtensions

scalarTypeExtensions

private final Map<String,List<ScalarTypeExtensionDefinition>> scalarTypeExtensions

inputObjectTypeExtensions

private final Map<String,List<InputObjectTypeExtensionDefinition>> inputObjectTypeExtensions

types

private final Map<String,TypeDefinition> types

scalarTypes

private final Map<String,ScalarTypeDefinition> scalarTypes

directiveDefinitions

private final Map<String,DirectiveDefinition> directiveDefinitions

schema

private SchemaDefinition schema

schemaExtensionDefinitions

private final List<SchemaExtensionDefinition> schemaExtensionDefinitions

schemaParseOrder

private final SchemaParseOrder schemaParseOrder

Constructor Details

TypeDefinitionRegistry

public TypeDefinitionRegistry()

Method Details

getParseOrder

public SchemaParseOrder getParseOrder()

Returns:

the order in which SDLDefinitions were parsed

merge

public TypeDefinitionRegistry merge(TypeDefinitionRegistry typeRegistry)
                             throws SchemaProblem

This will merge these type registries together and return this one

Parameters:

typeRegistry - the registry to be merged into this one

Returns:

this registry

Throws:

SchemaProblem - if there are problems merging the types such as redefinitions

checkMergeSchemaDefs

private Map<String,OperationTypeDefinition> checkMergeSchemaDefs(TypeDefinitionRegistry toBeMergedTypeRegistry,
 List<GraphQLError> errors)

checkAddOperationDefs

private Optional<GraphQLError> checkAddOperationDefs()

addAll

public Optional<GraphQLError> addAll(Collection<SDLDefinition> definitions)

Adds a a collections of definitions to the registry

Parameters:

definitions - the definitions to add

Returns:

an optional error for the first problem, typically type redefinition

add

public Optional<GraphQLError> add(SDLDefinition definition)

Adds a definition to the registry

Parameters:

definition - the definition to add

Returns:

an optional error

remove

public void remove(SDLDefinition definition)

Removes a SDLDefinition from the definition list.

Parameters:

definition - the definition to remove

removeFromList

private void removeFromList(Map source,
 TypeDefinition value)

remove

public void remove(String key,
 SDLDefinition definition)

Removes a SDLDefinition from a map.

Parameters:

key - the key to remove

definition - the definition to remove

removeFromMap

private void removeFromMap(Map source,
 String key)

define

private <T extends TypeDefinition>
Optional<GraphQLError> define(Map<String,T> source,
 Map<String,T> target,
 T newEntry)

define

private <T extends DirectiveDefinition>
Optional<GraphQLError> define(Map<String,T> source,
 Map<String,T> target,
 T newEntry)

defineExt

private <T extends TypeDefinition>
Optional<GraphQLError> defineExt(Map<String,List<T>> typeExtensions,
 T newEntry,
 Function<T,String> namerFunc)

types

public Map<String,TypeDefinition> types()

scalars

public Map<String,ScalarTypeDefinition> scalars()

objectTypeExtensions

public Map<String,List<ObjectTypeExtensionDefinition>> objectTypeExtensions()

interfaceTypeExtensions

public Map<String,List<InterfaceTypeExtensionDefinition>> interfaceTypeExtensions()

unionTypeExtensions

public Map<String,List<UnionTypeExtensionDefinition>> unionTypeExtensions()

enumTypeExtensions

public Map<String,List<EnumTypeExtensionDefinition>> enumTypeExtensions()

scalarTypeExtensions

public Map<String,List<ScalarTypeExtensionDefinition>> scalarTypeExtensions()

inputObjectTypeExtensions

public Map<String,List<InputObjectTypeExtensionDefinition>> inputObjectTypeExtensions()

schemaDefinition

public Optional<SchemaDefinition> schemaDefinition()

getSchemaExtensionDefinitions

public List<SchemaExtensionDefinition> getSchemaExtensionDefinitions()

handleReDefinition

private GraphQLError handleReDefinition(TypeDefinition oldEntry,
 TypeDefinition newEntry)

handleReDefinition

private GraphQLError handleReDefinition(DirectiveDefinition oldEntry,
 DirectiveDefinition newEntry)

getDirectiveDefinition

public Optional<DirectiveDefinition> getDirectiveDefinition(String directiveName)

getDirectiveDefinitions

public Map<String,DirectiveDefinition> getDirectiveDefinitions()

hasType

public boolean hasType(TypeName typeName)

getType

public Optional<TypeDefinition> getType(Type type)

getType

public <T extends TypeDefinition> Optional<T> getType(Type type,
 Class<T> ofType)

getType

public Optional<TypeDefinition> getType(String typeName)

getType

public <T extends TypeDefinition> Optional<T> getType(String typeName,
 Class<T> ofType)

isInterfaceOrUnion

public boolean isInterfaceOrUnion(Type type)

Returns true if the specified type exists in the registry and is an abstract (Interface or Union) type

Parameters:

type - the type to check

Returns:

true if its abstract

isObjectTypeOrInterface

public boolean isObjectTypeOrInterface(Type type)

Returns true if the specified type exists in the registry and is an object type or interface

Parameters:

type - the type to check

Returns:

true if its an object type or interface

isObjectType

public boolean isObjectType(Type type)

Returns true if the specified type exists in the registry and is an object type

Parameters:

type - the type to check

Returns:

true if its an object type

getTypes

public <T extends TypeDefinition> List<T> getTypes(Class<T> targetClass)

Returns a list of types in the registry of that specified class

Type Parameters:

T - must extend TypeDefinition

Parameters:

targetClass - the class to search for

Returns:

a list of types of the target class

getTypesMap

public <T extends TypeDefinition> Map<String,T> getTypesMap(Class<T> targetClass)

Returns a map of types in the registry of that specified class keyed by name

Type Parameters:

T - must extend TypeDefinition

Parameters:

targetClass - the class to search for

Returns:

a map of types

getAllImplementationsOf

public List<ImplementingTypeDefinition> getAllImplementationsOf(InterfaceTypeDefinition targetInterface)

Returns the list of object and interface types that implement the given interface type

Parameters:

targetInterface - the target to search for

Returns:

the list of object types that implement the given interface type

See Also:

• getImplementationsOf(InterfaceTypeDefinition)

getImplementationsOf

public List<ObjectTypeDefinition> getImplementationsOf(InterfaceTypeDefinition targetInterface)

Returns the list of object interface types that implement the given interface type

Parameters:

targetInterface - the target to search for

Returns:

the list of object types that implement the given interface type

See Also:

• getAllImplementationsOf(InterfaceTypeDefinition)

isPossibleType

public boolean isPossibleType(Type abstractType,
 Type possibleType)

Returns true of the abstract type is in implemented by the object type or interface

Parameters:

abstractType - the abstract type to check (interface or union)

possibleType - the object type or interface to check

Returns:

true if the object type or interface implements the abstract type

isSubTypeOf

public boolean isSubTypeOf(Type maybeSubType,
 Type superType)

Returns true if the maybe type is either equal or a subset of the second super type (covariant).

Parameters:

maybeSubType - the type to check

superType - the equality checked type

Returns:

true if maybeSubType is covariant or equal to superType