graphql.schema

Class GraphQLArgument

java.lang.Object

graphql.schema.GraphQLArgument

All Implemented Interfaces:

GraphQLDirectiveContainer, GraphQLType

@PublicApi
public class GraphQLArgument
extends java.lang.Object
implements GraphQLDirectiveContainer

This defines an argument that can be supplied to a graphql field (via GraphQLFieldDefinition. Fields can be thought of as "functions" that take arguments and return a value. See http://graphql.org/learn/queries/#arguments for more details on the concept. GraphQLArgument is used in two contexts, one context is graphql queries where it represents the arguments that can be set on a field and the other is in Schema Definition Language (SDL) where it can be used to represent the argument value instances that have been supplied on a GraphQLDirective. The difference is the 'value' and 'defaultValue' properties. In a query argument, the 'value' is never in the GraphQLArgument object but rather in the AST direct or in the query variables map and the 'defaultValue' represents a value to use if both of these are not present. You can think of them like a descriptor of what shape an argument might have. However with directives on SDL elements, the value is specified in AST only and transferred into the GraphQLArgument object and the 'defaultValue' comes instead from the directive definition elsewhere in the SDL. You can think of them as 'instances' of arguments, their shape and their specific value on that directive.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	GraphQLArgument.Builder

Constructor Summary

Constructors

Constructor and Description
GraphQLArgument(java.lang.String name, GraphQLInputType type) Deprecated. use the newArgument() builder pattern instead, as this constructor will be made private in a future version.
GraphQLArgument(java.lang.String name, java.lang.String description, GraphQLInputType type, java.lang.Object defaultValue) Deprecated. use the newArgument() builder pattern instead, as this constructor will be made private in a future version.
GraphQLArgument(java.lang.String name, java.lang.String description, GraphQLInputType type, java.lang.Object defaultValue, InputValueDefinition definition) Deprecated. use the newArgument() 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<GraphQLType> context, GraphQLTypeVisitor visitor) Double-dispatch entry point.
java.util.List<GraphQLType>	getChildren()
java.lang.Object	getDefaultValue() An argument has a default value when it represents the logical argument structure that a GraphQLFieldDefinition can have and it can also have a default value when used in a schema definition language (SDL) where the default value comes via the directive definition.
InputValueDefinition	getDefinition()
java.lang.String	getDescription()
java.util.List<GraphQLDirective>	getDirectives()
java.lang.String	getName()
GraphQLInputType	getType()
java.lang.Object	getValue() An argument ONLY has a value when its used in a schema definition language (SDL) context as the arguments to SDL directives.
static GraphQLArgument.Builder	newArgument()
static GraphQLArgument.Builder	newArgument(GraphQLArgument existing)
java.lang.String	toString()
GraphQLArgument	transform(java.util.function.Consumer<GraphQLArgument.Builder> builderConsumer) This helps you transform the current GraphQLArgument into another one by starting a builder with all the current values and allows you to transform it how you want.

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

Constructor Detail

GraphQLArgument

@Deprecated
public GraphQLArgument(java.lang.String name,
                                   java.lang.String description,
                                   GraphQLInputType type,
                                   java.lang.Object defaultValue)

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

Parameters:

name - the arg name

description - the arg description

type - the arg type

defaultValue - the default value

GraphQLArgument

@Deprecated
public GraphQLArgument(java.lang.String name,
                                   GraphQLInputType type)

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

Parameters:

name - the arg name

type - the arg type

GraphQLArgument

public GraphQLArgument(java.lang.String name,
                       java.lang.String description,
                       GraphQLInputType type,
                       java.lang.Object defaultValue,
                       InputValueDefinition definition)

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

Parameters:

name - the arg name

description - the arg description

type - the arg type

defaultValue - the default value

definition - the AST definition

Method Detail

getName

public java.lang.String getName()

Specified by:

getName in interface GraphQLType

Returns:

the name of the type which MUST fit within the regular expression [_A-Za-z][_0-9A-Za-z]*

getType

public GraphQLInputType getType()

getDefaultValue

public java.lang.Object getDefaultValue()

An argument has a default value when it represents the logical argument structure that a GraphQLFieldDefinition can have and it can also have a default value when used in a schema definition language (SDL) where the default value comes via the directive definition.

Returns:

the default value of an argument

getValue

public java.lang.Object getValue()

An argument ONLY has a value when its used in a schema definition language (SDL) context as the arguments to SDL directives. The method should not be called in a query context, but rather the AST / variables map should be used to obtain an arguments value.

Returns:

the argument value

getDescription

public java.lang.String getDescription()

getDefinition

public InputValueDefinition getDefinition()

getDirectives

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

Specified by:

getDirectives in interface GraphQLDirectiveContainer

Returns:

a list of directives associated with the type or field

transform

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

This helps you transform the current GraphQLArgument 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 field based on calling build on that builder

newArgument

public static GraphQLArgument.Builder newArgument()

newArgument

public static GraphQLArgument.Builder newArgument(GraphQLArgument existing)

accept

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

Description copied from interface: GraphQLType

Double-dispatch entry point. It allows to travers a given non-trivial graphQL type and move from root to nested or enclosed types. This implements similar pattern as Node, see accept(...) for more details about the pattern.

Specified by:

accept in interface GraphQLType

Parameters:

context - TraverserContext bound to this graphQL type object

visitor - Visitor instance that performs actual processing on the types(s)

Returns:

Result of Visitor's operation. Note! Visitor's operation might return special results to control traversal process.

getChildren

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

Specified by:

getChildren in interface GraphQLType

Returns:

returns all types directly associated with this node

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object