Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions content/documentation/master/data-fetching.md
Original file line number Diff line number Diff line change
Expand Up @@ -183,7 +183,7 @@ the query is executed. The following section explains more on this.
* ``DataFetchingFieldSelectionSet getSelectionSet()`` - the selection set represents the child fields that have been "selected" under neath the
currently executing field. This can be useful to help look ahead to see what sub field information a client wants. The following section explains more on this.

* ```ExecutionId getExecutionId()`` - each query execution is given a unique id. You can use this perhaps on logs to tag each individual
* ``ExecutionId getExecutionId()`` - each query execution is given a unique id. You can use this perhaps on logs to tag each individual
query.


Expand Down Expand Up @@ -223,6 +223,6 @@ The sub fields here of the ``products`` field represent the selection set of tha
so the data fetcher can optimise the data access queries. For example an SQL backed system may be able to use the field sub selection to
only retrieve the columns that have been asked for.

In the example above we have asked for ``selectionLocations`` information and hence we may be able to make an more efficient data access query where
In the example above we have asked for ``sellingLocations`` information and hence we may be able to make an more efficient data access query where
we ask for product information and selling location information at the same time.

4 changes: 2 additions & 2 deletions content/documentation/master/exceptions.md
Original file line number Diff line number Diff line change
Expand Up @@ -28,7 +28,7 @@ These are not graphql errors in execution but rather totally unacceptable condit

- `graphql.execution.UnresolvedTypeException`

is thrown if a graphql.schema.TypeResolver` fails to provide a concrete
is thrown if a `graphql.schema.TypeResolver` fails to provide a concrete
object type given a interface or union type.


Expand All @@ -47,7 +47,7 @@ These are not graphql errors in execution but rather totally unacceptable condit
- `graphql.schema.validation.InvalidSchemaException`

is thrown if the schema is not valid when built via
graphql.schema.GraphQLSchema.Builder#build()`
`graphql.schema.GraphQLSchema.Builder#build()`

- `graphql.execution.UnknownOperationException`

Expand Down
2 changes: 1 addition & 1 deletion content/documentation/master/execution.md
Original file line number Diff line number Diff line change
Expand Up @@ -419,7 +419,7 @@ By default the "query" execution strategy is ``graphql.execution.AsyncExecutionS
each field as ``CompleteableFuture`` objects and not care which ones complete first. This strategy allows for the most
performant execution.

The data fetchers invoked can themselves return `CompletionStage`` values and this will create
The data fetchers invoked can themselves return ``CompletionStage`` values and this will create
fully asynchronous behaviour.

So imagine a query as follows
Expand Down
4 changes: 2 additions & 2 deletions content/documentation/master/scalars.md
Original file line number Diff line number Diff line change
Expand Up @@ -69,12 +69,12 @@ We would create a singleton ``graphql.schema.GraphQLScalarType`` instance for th
The real work in any custom scalar implementation is the ``graphql.schema.Coercing`` implementation. This is responsible for 3 functions

* ``parseValue`` - takes a variable input object and converts into the Java runtime representation
* ``parseLiteral`` - takes an AST literal ``graphql.language.Value` as input and converts into the Java runtime representation
* ``parseLiteral`` - takes an AST literal ``graphql.language.Value`` as input and converts into the Java runtime representation
* ``serialize`` - takes a Java object and converts it into the output shape for that scalar

So your custom scalar code has to handle 2 forms of input (parseValue / parseLiteral) and 1 form of output (serialize).

Imagine this query, which uses variables, AST literals and outputs our scalar type ```email``.
Imagine this query, which uses variables, AST literals and outputs our scalar type ``email``.

{{< highlight graphql "linenos=table" >}}
mutation Contact($mainContact: Email!) {
Expand Down
4 changes: 2 additions & 2 deletions content/documentation/v10/data-fetching.md
Original file line number Diff line number Diff line change
Expand Up @@ -183,7 +183,7 @@ the query is executed. The following section explains more on this.
* ``DataFetchingFieldSelectionSet getSelectionSet()`` - the selection set represents the child fields that have been "selected" under neath the
currently executing field. This can be useful to help look ahead to see what sub field information a client wants. The following section explains more on this.

* ```ExecutionId getExecutionId()`` - each query execution is given a unique id. You can use this perhaps on logs to tag each individual
* ``ExecutionId getExecutionId()`` - each query execution is given a unique id. You can use this perhaps on logs to tag each individual
query.


Expand Down Expand Up @@ -223,6 +223,6 @@ The sub fields here of the ``products`` field represent the selection set of tha
so the data fetcher can optimise the data access queries. For example an SQL backed system may be able to use the field sub selection to
only retrieve the columns that have been asked for.

In the example above we have asked for ``selectionLocations`` information and hence we may be able to make an more efficient data access query where
In the example above we have asked for ``sellingLocations`` information and hence we may be able to make an more efficient data access query where
we ask for product information and selling location information at the same time.

4 changes: 2 additions & 2 deletions content/documentation/v10/exceptions.md
Original file line number Diff line number Diff line change
Expand Up @@ -28,7 +28,7 @@ These are not graphql errors in execution but rather totally unacceptable condit

- `graphql.execution.UnresolvedTypeException`

is thrown if a graphql.schema.TypeResolver` fails to provide a concrete
is thrown if a `graphql.schema.TypeResolver` fails to provide a concrete
object type given a interface or union type.


Expand All @@ -47,7 +47,7 @@ These are not graphql errors in execution but rather totally unacceptable condit
- `graphql.schema.validation.InvalidSchemaException`

is thrown if the schema is not valid when built via
graphql.schema.GraphQLSchema.Builder#build()`
`graphql.schema.GraphQLSchema.Builder#build()`

- `graphql.execution.UnknownOperationException`

Expand Down
2 changes: 1 addition & 1 deletion content/documentation/v10/execution.md
Original file line number Diff line number Diff line change
Expand Up @@ -419,7 +419,7 @@ By default the "query" execution strategy is ``graphql.execution.AsyncExecutionS
each field as ``CompleteableFuture`` objects and not care which ones complete first. This strategy allows for the most
performant execution.

The data fetchers invoked can themselves return `CompletionStage`` values and this will create
The data fetchers invoked can themselves return ``CompletionStage`` values and this will create
fully asynchronous behaviour.

So imagine a query as follows
Expand Down
4 changes: 2 additions & 2 deletions content/documentation/v10/scalars.md
Original file line number Diff line number Diff line change
Expand Up @@ -69,12 +69,12 @@ We would create a singleton ``graphql.schema.GraphQLScalarType`` instance for th
The real work in any custom scalar implementation is the ``graphql.schema.Coercing`` implementation. This is responsible for 3 functions

* ``parseValue`` - takes a variable input object and converts into the Java runtime representation
* ``parseLiteral`` - takes an AST literal ``graphql.language.Value` as input and converts into the Java runtime representation
* ``parseLiteral`` - takes an AST literal ``graphql.language.Value`` as input and converts into the Java runtime representation
* ``serialize`` - takes a Java object and converts it into the output shape for that scalar

So your custom scalar code has to handle 2 forms of input (parseValue / parseLiteral) and 1 form of output (serialize).

Imagine this query, which uses variables, AST literals and outputs our scalar type ```email``.
Imagine this query, which uses variables, AST literals and outputs our scalar type ``email``.

{{< highlight graphql "linenos=table" >}}
mutation Contact($mainContact: Email!) {
Expand Down
4 changes: 2 additions & 2 deletions content/documentation/v11/data-fetching.md
Original file line number Diff line number Diff line change
Expand Up @@ -183,7 +183,7 @@ the query is executed. The following section explains more on this.
* ``DataFetchingFieldSelectionSet getSelectionSet()`` - the selection set represents the child fields that have been "selected" under neath the
currently executing field. This can be useful to help look ahead to see what sub field information a client wants. The following section explains more on this.

* ```ExecutionId getExecutionId()`` - each query execution is given a unique id. You can use this perhaps on logs to tag each individual
* ``ExecutionId getExecutionId()`` - each query execution is given a unique id. You can use this perhaps on logs to tag each individual
query.


Expand Down Expand Up @@ -223,6 +223,6 @@ The sub fields here of the ``products`` field represent the selection set of tha
so the data fetcher can optimise the data access queries. For example an SQL backed system may be able to use the field sub selection to
only retrieve the columns that have been asked for.

In the example above we have asked for ``selectionLocations`` information and hence we may be able to make an more efficient data access query where
In the example above we have asked for ``sellingLocations`` information and hence we may be able to make an more efficient data access query where
we ask for product information and selling location information at the same time.

4 changes: 2 additions & 2 deletions content/documentation/v11/exceptions.md
Original file line number Diff line number Diff line change
Expand Up @@ -28,7 +28,7 @@ These are not graphql errors in execution but rather totally unacceptable condit

- `graphql.execution.UnresolvedTypeException`

is thrown if a graphql.schema.TypeResolver` fails to provide a concrete
is thrown if a `graphql.schema.TypeResolver` fails to provide a concrete
object type given a interface or union type.


Expand All @@ -47,7 +47,7 @@ These are not graphql errors in execution but rather totally unacceptable condit
- `graphql.schema.validation.InvalidSchemaException`

is thrown if the schema is not valid when built via
graphql.schema.GraphQLSchema.Builder#build()`
`graphql.schema.GraphQLSchema.Builder#build()`

- `graphql.execution.UnknownOperationException`

Expand Down
2 changes: 1 addition & 1 deletion content/documentation/v11/execution.md
Original file line number Diff line number Diff line change
Expand Up @@ -419,7 +419,7 @@ By default the "query" execution strategy is ``graphql.execution.AsyncExecutionS
each field as ``CompleteableFuture`` objects and not care which ones complete first. This strategy allows for the most
performant execution.

The data fetchers invoked can themselves return `CompletionStage`` values and this will create
The data fetchers invoked can themselves return ``CompletionStage`` values and this will create
fully asynchronous behaviour.

So imagine a query as follows
Expand Down
4 changes: 2 additions & 2 deletions content/documentation/v11/scalars.md
Original file line number Diff line number Diff line change
Expand Up @@ -69,12 +69,12 @@ We would create a singleton ``graphql.schema.GraphQLScalarType`` instance for th
The real work in any custom scalar implementation is the ``graphql.schema.Coercing`` implementation. This is responsible for 3 functions

* ``parseValue`` - takes a variable input object and converts into the Java runtime representation
* ``parseLiteral`` - takes an AST literal ``graphql.language.Value` as input and converts into the Java runtime representation
* ``parseLiteral`` - takes an AST literal ``graphql.language.Value`` as input and converts into the Java runtime representation
* ``serialize`` - takes a Java object and converts it into the output shape for that scalar

So your custom scalar code has to handle 2 forms of input (parseValue / parseLiteral) and 1 form of output (serialize).

Imagine this query, which uses variables, AST literals and outputs our scalar type ```email``.
Imagine this query, which uses variables, AST literals and outputs our scalar type ``email``.

{{< highlight graphql "linenos=table" >}}
mutation Contact($mainContact: Email!) {
Expand Down
4 changes: 2 additions & 2 deletions content/documentation/v9/data-fetching.md
Original file line number Diff line number Diff line change
Expand Up @@ -183,7 +183,7 @@ the query is executed. The following section explains more on this.
* ``DataFetchingFieldSelectionSet getSelectionSet()`` - the selection set represents the child fields that have been "selected" under neath the
currently executing field. This can be useful to help look ahead to see what sub field information a client wants. The following section explains more on this.

* ```ExecutionId getExecutionId()`` - each query execution is given a unique id. You can use this perhaps on logs to tag each individual
* ``ExecutionId getExecutionId()`` - each query execution is given a unique id. You can use this perhaps on logs to tag each individual
query.


Expand Down Expand Up @@ -223,6 +223,6 @@ The sub fields here of the ``products`` field represent the selection set of tha
so the data fetcher can optimise the data access queries. For example an SQL backed system may be able to use the field sub selection to
only retrieve the columns that have been asked for.

In the example above we have asked for ``selectionLocations`` information and hence we may be able to make an more efficient data access query where
In the example above we have asked for ``sellingLocations`` information and hence we may be able to make an more efficient data access query where
we ask for product information and selling location information at the same time.

4 changes: 2 additions & 2 deletions content/documentation/v9/exceptions.md
Original file line number Diff line number Diff line change
Expand Up @@ -28,7 +28,7 @@ These are not graphql errors in execution but rather totally unacceptable condit

- `graphql.execution.UnresolvedTypeException`

is thrown if a graphql.schema.TypeResolver` fails to provide a concrete
is thrown if a `graphql.schema.TypeResolver` fails to provide a concrete
object type given a interface or union type.


Expand All @@ -47,7 +47,7 @@ These are not graphql errors in execution but rather totally unacceptable condit
- `graphql.schema.validation.InvalidSchemaException`

is thrown if the schema is not valid when built via
graphql.schema.GraphQLSchema.Builder#build()`
`graphql.schema.GraphQLSchema.Builder#build()`

- `graphql.execution.UnknownOperationException`

Expand Down
2 changes: 1 addition & 1 deletion content/documentation/v9/execution.md
Original file line number Diff line number Diff line change
Expand Up @@ -419,7 +419,7 @@ By default the "query" execution strategy is ``graphql.execution.AsyncExecutionS
each field as ``CompleteableFuture`` objects and not care which ones complete first. This strategy allows for the most
performant execution.

The data fetchers invoked can themselves return `CompletionStage`` values and this will create
The data fetchers invoked can themselves return ``CompletionStage`` values and this will create
fully asynchronous behaviour.

So imagine a query as follows
Expand Down
4 changes: 2 additions & 2 deletions content/documentation/v9/scalars.md
Original file line number Diff line number Diff line change
Expand Up @@ -69,12 +69,12 @@ We would create a singleton ``graphql.schema.GraphQLScalarType`` instance for th
The real work in any custom scalar implementation is the ``graphql.schema.Coercing`` implementation. This is responsible for 3 functions

* ``parseValue`` - takes a variable input object and converts into the Java runtime representation
* ``parseLiteral`` - takes an AST literal ``graphql.language.Value` as input and converts into the Java runtime representation
* ``parseLiteral`` - takes an AST literal ``graphql.language.Value`` as input and converts into the Java runtime representation
* ``serialize`` - takes a Java object and converts it into the output shape for that scalar

So your custom scalar code has to handle 2 forms of input (parseValue / parseLiteral) and 1 form of output (serialize).

Imagine this query, which uses variables, AST literals and outputs our scalar type ```email``.
Imagine this query, which uses variables, AST literals and outputs our scalar type ``email``.

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Why do we have 2 `` in these. left over from .rst??

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

yes, I would say not converted yet.

{{< highlight graphql "linenos=table" >}}
mutation Contact($mainContact: Email!) {
Expand Down