graphql.schema

Class GraphQLScalarType

java.lang.Object

graphql.schema.GraphQLScalarType

All Implemented Interfaces:

GraphQLDirectiveContainer, GraphQLInputType, GraphQLNamedInputType, GraphQLNamedOutputType, GraphQLNamedSchemaElement, GraphQLNamedType, GraphQLNullableType, GraphQLOutputType, GraphQLSchemaElement, GraphQLType, GraphQLUnmodifiedType

public class GraphQLScalarType
extends java.lang.Object
implements GraphQLNamedInputType, GraphQLNamedOutputType, GraphQLUnmodifiedType, GraphQLNullableType, GraphQLDirectiveContainer

A scalar type is a leaf node in the graphql tree of types. This class allows you to define new scalar types.

GraphQL provides a number of built‐in scalars, but type systems can add additional scalars with semantic meaning, for example, a GraphQL system could define a scalar called Time which, while serialized as a string, promises to conform to ISO‐8601. When querying a field of type Time, you can then rely on the ability to parse the result with an ISO‐8601 parser and use a client‐specific primitive for time. From the spec : http://facebook.github.io/graphql/#sec-Scalars

graphql-java ships with a set of predefined scalar types via Scalars

See Also:

Scalars

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	GraphQLScalarType.Builder

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	CHILD_DIRECTIVES

Constructor Summary

Constructors

Constructor and Description
GraphQLScalarType(java.lang.String name, java.lang.String description, Coercing coercing) Deprecated. use the newScalar() builder pattern instead, as this constructor will be made private in a future version.
GraphQLScalarType(java.lang.String name, java.lang.String description, Coercing coercing, java.util.List<GraphQLDirective> directives, ScalarTypeDefinition definition) Deprecated. use the newScalar() builder pattern instead, as this constructor will be made private in a future version.

Method Summary

Modifier and Type	Method and Description
TraversalControl	accept(TraverserContext<GraphQLSchemaElement> context, GraphQLTypeVisitor visitor)
java.util.List<GraphQLSchemaElement>	getChildren()
SchemaElementChildrenContainer	getChildrenWithTypeReferences()
Coercing	getCoercing()
ScalarTypeDefinition	getDefinition() The AST Node this schema element is based on.
java.lang.String	getDescription()
java.util.List<GraphQLDirective>	getDirectives()
java.util.List<ScalarTypeExtensionDefinition>	getExtensionDefinitions()
java.lang.String	getName()
static GraphQLScalarType.Builder	newScalar()
static GraphQLScalarType.Builder	newScalar(GraphQLScalarType existing)
java.lang.String	toString()
GraphQLScalarType	transform(java.util.function.Consumer<GraphQLScalarType.Builder> builderConsumer) This helps you transform the current GraphQLObjectType into another one by starting a builder with all the current values and allows you to transform it how you want.
GraphQLScalarType	withNewChildren(SchemaElementChildrenContainer newChildren)

Methods inherited from class java.lang.Object

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

Methods inherited from interface graphql.schema.GraphQLDirectiveContainer

getDirective, getDirectivesByName

Field Detail

CHILD_DIRECTIVES

public static final java.lang.String CHILD_DIRECTIVES

See Also:

Constant Field Values

Constructor Detail

GraphQLScalarType

@Deprecated
public GraphQLScalarType(java.lang.String name,
                                     java.lang.String description,
                                     Coercing coercing)

Deprecated. use the newScalar() builder pattern instead, as this constructor will be made private in a future version.

Parameters:

name - the name

description - the description

coercing - the coercing function

GraphQLScalarType

@Deprecated
public GraphQLScalarType(java.lang.String name,
                                     java.lang.String description,
                                     Coercing coercing,
                                     java.util.List<GraphQLDirective> directives,
                                     ScalarTypeDefinition definition)

Deprecated. use the newScalar() builder pattern instead, as this constructor will be made private in a future version.

Parameters:

name - the name

description - the description

coercing - the coercing function

directives - the directives on this type element

definition - the AST definition

Method Detail

getName

public java.lang.String getName()

Specified by:

getName in interface GraphQLNamedSchemaElement

getDescription

public java.lang.String getDescription()

Specified by:

getDescription in interface GraphQLNamedSchemaElement

getCoercing

public Coercing getCoercing()

getDefinition

public ScalarTypeDefinition getDefinition()

Description copied from interface: GraphQLNamedSchemaElement

The AST Node this schema element is based on. Is null if the GraphQLSchema is not based on a SDL document. Some elements also have additional extension Nodes. See for example GraphQLObjectType.getExtensionDefinitions()

Specified by:

getDefinition in interface GraphQLNamedSchemaElement

Returns:

Node which this element is based on. Can be null.

getExtensionDefinitions

public java.util.List<ScalarTypeExtensionDefinition> getExtensionDefinitions()

getDirectives

public java.util.List<GraphQLDirective> getDirectives()

Specified by:

getDirectives in interface GraphQLDirectiveContainer

Returns:

a list of directives associated with the type or field

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object

transform

public GraphQLScalarType transform(java.util.function.Consumer<GraphQLScalarType.Builder> builderConsumer)

This helps you transform the current GraphQLObjectType into another one by starting a builder with all the current values and allows you to transform it how you want.

Parameters:

builderConsumer - the consumer code that will be given a builder to transform

Returns:

a new object based on calling build on that builder

accept

public TraversalControl accept(TraverserContext<GraphQLSchemaElement> context,
                               GraphQLTypeVisitor visitor)

Specified by:

accept in interface GraphQLSchemaElement

getChildren

public java.util.List<GraphQLSchemaElement> getChildren()

Specified by:

getChildren in interface GraphQLSchemaElement

getChildrenWithTypeReferences

public SchemaElementChildrenContainer getChildrenWithTypeReferences()

Specified by:

getChildrenWithTypeReferences in interface GraphQLSchemaElement

withNewChildren

public GraphQLScalarType withNewChildren(SchemaElementChildrenContainer newChildren)

Specified by:

withNewChildren in interface GraphQLSchemaElement

newScalar

public static GraphQLScalarType.Builder newScalar()

newScalar

public static GraphQLScalarType.Builder newScalar(GraphQLScalarType existing)