graphql.parser

Class Parser

java.lang.Object

graphql.parser.Parser

@PublicApi
public class Parser
extends java.lang.Object

This can parse graphql syntax, both Query syntax and Schema Definition Language (SDL) syntax, into an Abstract Syntax Tree (AST) represented by a Document

You should not generally need to call this class as the GraphQL code sets this up for you but if you are doing specific graphql utilities this class is essential. Graphql syntax has a series of characters, such as spaces, new lines and commas that are not considered relevant to the syntax. However they can be captured and associated with the AST elements they belong to. This costs more memory but for certain use cases (like editors) this maybe be useful. We have chosen to no capture ignored characters by default but you can turn this on, either per parse or statically for the whole JVM via ParserOptions.setDefaultParserOptions(ParserOptions) ()}}

See Also:

IgnoredChar

Constructor Summary

Constructors

Constructor and Description
Parser()

Method Summary

Modifier and Type	Method and Description
protected GraphqlAntlrToLanguage	getAntlrToLanguage(org.antlr.v4.runtime.CommonTokenStream tokens, MultiSourceReader multiSourceReader) Deprecated. - really should use getAntlrToLanguage(CommonTokenStream, MultiSourceReader, ParserOptions)
protected GraphqlAntlrToLanguage	getAntlrToLanguage(org.antlr.v4.runtime.CommonTokenStream tokens, MultiSourceReader multiSourceReader, ParserOptions parserOptions) Allows you to override the ANTLR to AST code.
static Document	parse(java.lang.String input) Parses a string input into a graphql AST Document
Document	parseDocument(java.io.Reader reader) Parses reader input into a graphql AST Document
Document	parseDocument(java.io.Reader reader, ParserOptions parserOptions) Parses reader input into a graphql AST Document
Document	parseDocument(java.lang.String input) Parses a string input into a graphql AST Document
Document	parseDocument(java.lang.String input, ParserOptions parserOptions) Parses a string input into a graphql AST Document
Document	parseDocument(java.lang.String input, java.lang.String sourceName) Parses a string input into a graphql AST Document
static Value<?>	parseValue(java.lang.String input) Parses a string input into a graphql AST Value

Methods inherited from class java.lang.Object

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

Constructor Detail

Parser

public Parser()

Method Detail

parse

public static Document parse(java.lang.String input)
                      throws InvalidSyntaxException

Parses a string input into a graphql AST Document

Parameters:

input - the input to parse

Returns:

an AST Document

Throws:

InvalidSyntaxException - if the input is not valid graphql syntax

parseValue

public static Value<?> parseValue(java.lang.String input)
                           throws InvalidSyntaxException

Parses a string input into a graphql AST Value

Parameters:

input - the input to parse

Returns:

an AST Value

Throws:

InvalidSyntaxException - if the input is not valid graphql syntax

parseDocument

public Document parseDocument(java.lang.String input)
                       throws InvalidSyntaxException

Parses a string input into a graphql AST Document

Parameters:

input - the input to parse

Returns:

an AST Document

Throws:

InvalidSyntaxException - if the input is not valid graphql syntax

parseDocument

public Document parseDocument(java.lang.String input,
                              java.lang.String sourceName)
                       throws InvalidSyntaxException

Parses a string input into a graphql AST Document

Parameters:

input - the input to parse

sourceName - - the name to attribute to the input text in SourceLocation.getSourceName()

Returns:

an AST Document

Throws:

InvalidSyntaxException - if the input is not valid graphql syntax

parseDocument

public Document parseDocument(java.lang.String input,
                              ParserOptions parserOptions)
                       throws InvalidSyntaxException

Parses a string input into a graphql AST Document

Parameters:

input - the input to parse

parserOptions - the parser options

Returns:

an AST Document

Throws:

InvalidSyntaxException - if the input is not valid graphql syntax

parseDocument

public Document parseDocument(java.io.Reader reader)
                       throws InvalidSyntaxException

Parses reader input into a graphql AST Document

Parameters:

reader - the reader input to parse

Returns:

an AST Document

Throws:

InvalidSyntaxException - if the input is not valid graphql syntax

parseDocument

public Document parseDocument(java.io.Reader reader,
                              ParserOptions parserOptions)
                       throws InvalidSyntaxException

Parses reader input into a graphql AST Document

Parameters:

reader - the reader input to parse

parserOptions - the parser options

Returns:

an AST Document

Throws:

InvalidSyntaxException - if the input is not valid graphql syntax

getAntlrToLanguage

@Deprecated
protected GraphqlAntlrToLanguage getAntlrToLanguage(org.antlr.v4.runtime.CommonTokenStream tokens,
                                                                MultiSourceReader multiSourceReader)

Deprecated. - really should use getAntlrToLanguage(CommonTokenStream, MultiSourceReader, ParserOptions)

Allows you to override the ANTLR to AST code.

Parameters:

tokens - the token stream

multiSourceReader - the source of the query document

Returns:

a new GraphqlAntlrToLanguage instance

getAntlrToLanguage

protected GraphqlAntlrToLanguage getAntlrToLanguage(org.antlr.v4.runtime.CommonTokenStream tokens,
                                                    MultiSourceReader multiSourceReader,
                                                    ParserOptions parserOptions)

Allows you to override the ANTLR to AST code.

Parameters:

tokens - the token stream

multiSourceReader - the source of the query document

parserOptions - - the parser options

Returns:

a new GraphqlAntlrToLanguage instance