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)
GraphQLArgument(java.lang.String name, java.lang.String description, GraphQLInputType type, java.lang.Object defaultValue)
GraphQLArgument(java.lang.String name, java.lang.String description, GraphQLInputType type, java.lang.Object defaultValue, InputValueDefinition definition)

Method Summary

Modifier and Type	Method and Description
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)
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, toString, wait, wait, wait

Methods inherited from interface graphql.schema.GraphQLDirectiveContainer

getDirective, getDirectivesByName

Constructor Detail

GraphQLArgument

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

GraphQLArgument

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

GraphQLArgument

public GraphQLArgument(java.lang.String name,
                       java.lang.String description,
                       GraphQLInputType type,
                       java.lang.Object defaultValue,
                       InputValueDefinition 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)