com.netflix.graphql.dgs.reactive

Interface DgsReactiveQueryExecutor

public interface DgsReactiveQueryExecutor

Represents the core query executing capability of the framework. This is the reactive version of the interface, using Mono for its results. See DgsQueryExecutor for the blocking version of this interface. Use this interface to easily execute GraphQL queries, without using the HTTP endpoint. This is meant to be used in tests, and is also used internally in the framework.

The executeAnd* methods use the JsonPath library library to easily get specific fields out of a nested Json structure. The executeAndGetDocumentContext(String) method sets up a DocumentContext, which can then be reused to get multiple fields.

See Also:

Query Execution Testing docs

Method Summary

Modifier and Type	Method and Description
default reactor.core.publisher.Mono<graphql.ExecutionResult>	execute(java.lang.String query)
default reactor.core.publisher.Mono<graphql.ExecutionResult>	execute(java.lang.String query, java.util.Map<java.lang.String,java.lang.Object> variables)
default reactor.core.publisher.Mono<graphql.ExecutionResult>	execute(java.lang.String query, java.util.Map<java.lang.String,java.lang.Object> variables, java.util.Map<java.lang.String,java.lang.Object> extensions, org.springframework.http.HttpHeaders headers)
reactor.core.publisher.Mono<graphql.ExecutionResult>	execute(java.lang.String query, java.util.Map<java.lang.String,java.lang.Object> variables, java.util.Map<java.lang.String,java.lang.Object> extensions, org.springframework.http.HttpHeaders headers, java.lang.String operationName, org.springframework.web.reactive.function.server.ServerRequest serverRequest) Executes a GraphQL query.
default reactor.core.publisher.Mono<graphql.ExecutionResult>	execute(java.lang.String query, java.util.Map<java.lang.String,java.lang.Object> variables, java.lang.String operationName)
default <T> reactor.core.publisher.Mono<T>	executeAndExtractJsonPath(java.lang.String query, java.lang.String jsonPath) Executes a GraphQL query, parses the returned data, and uses a Json Path to extract specific elements out of the data.
default <T> reactor.core.publisher.Mono<T>	executeAndExtractJsonPath(java.lang.String query, java.lang.String jsonPath, java.util.Map<java.lang.String,java.lang.Object> variables) Executes a GraphQL query, parses the returned data, and uses a Json Path to extract specific elements out of the data.
<T> reactor.core.publisher.Mono<T>	executeAndExtractJsonPath(java.lang.String query, java.lang.String jsonPath, java.util.Map<java.lang.String,java.lang.Object> variables, org.springframework.web.reactive.function.server.ServerRequest serverRequest) Executes a GraphQL query, parses the returned data, and uses a Json Path to extract specific elements out of the data.
default <T> reactor.core.publisher.Mono<T>	executeAndExtractJsonPath(java.lang.String query, java.lang.String jsonPath, org.springframework.web.reactive.function.server.ServerRequest serverRequest) Executes a GraphQL query, parses the returned data, and uses a Json Path to extract specific elements out of the data.
default <T> reactor.core.publisher.Mono<T>	executeAndExtractJsonPathAsObject(java.lang.String query, java.lang.String jsonPath, java.lang.Class<T> clazz) Executes a GraphQL query, parses the returned data, extracts a value using JsonPath, and converts that value into the given type.
<T> reactor.core.publisher.Mono<T>	executeAndExtractJsonPathAsObject(java.lang.String query, java.lang.String jsonPath, java.util.Map<java.lang.String,java.lang.Object> variables, java.lang.Class<T> clazz) Executes a GraphQL query, parses the returned data, extracts a value using JsonPath, and converts that value into the given type.
<T> reactor.core.publisher.Mono<T>	executeAndExtractJsonPathAsObject(java.lang.String query, java.lang.String jsonPath, java.util.Map<java.lang.String,java.lang.Object> variables, com.jayway.jsonpath.TypeRef<T> typeRef) Executes a GraphQL query, parses the returned data, extracts a value using JsonPath, and converts that value into the given type.
default <T> reactor.core.publisher.Mono<T>	executeAndExtractJsonPathAsObject(java.lang.String query, java.lang.String jsonPath, com.jayway.jsonpath.TypeRef<T> typeRef) Executes a GraphQL query, parses the returned data, extracts a value using JsonPath, and converts that value into the given type.
default reactor.core.publisher.Mono<com.jayway.jsonpath.DocumentContext>	executeAndGetDocumentContext(java.lang.String query) Executes a GraphQL query, parses the returned data, and return a DocumentContext.
reactor.core.publisher.Mono<com.jayway.jsonpath.DocumentContext>	executeAndGetDocumentContext(java.lang.String query, java.util.Map<java.lang.String,java.lang.Object> variables) Executes a GraphQL query, parses the returned data, and return a DocumentContext.

Method Detail

execute

default reactor.core.publisher.Mono<graphql.ExecutionResult> execute(java.lang.String query)

Parameters:

query - The query string

Returns:

Returns a GraphQL ExecutionResult. This includes data and errors.

execute

default reactor.core.publisher.Mono<graphql.ExecutionResult> execute(java.lang.String query,
                                                                     java.util.Map<java.lang.String,java.lang.Object> variables)

Parameters:

query - The query string

variables - A map of variables

Returns:

Returns a GraphQL ExecutionResult. This includes data and errors.

See Also:

Query Variables

execute

default reactor.core.publisher.Mono<graphql.ExecutionResult> execute(java.lang.String query,
                                                                     java.util.Map<java.lang.String,java.lang.Object> variables,
                                                                     java.lang.String operationName)

Parameters:

query - The query string

variables - A map of variables

operationName - The operation name

Returns:

Returns a GraphQL ExecutionResult. This includes data and errors.

See Also:

Query Variables, Operation name

execute

default reactor.core.publisher.Mono<graphql.ExecutionResult> execute(java.lang.String query,
                                                                     java.util.Map<java.lang.String,java.lang.Object> variables,
                                                                     java.util.Map<java.lang.String,java.lang.Object> extensions,
                                                                     org.springframework.http.HttpHeaders headers)

Parameters:

query - The query string

variables - A map of variables

extensions - A map representing GraphQL extensions. This is made available in the DgsRequestData object on DgsContext.

headers - Request headers represented as a Spring Framework HttpHeaders

Returns:

Returns a GraphQL ExecutionResult. This includes data and errors.

See Also:

Query Variables

execute

reactor.core.publisher.Mono<graphql.ExecutionResult> execute(java.lang.String query,
                                                             java.util.Map<java.lang.String,java.lang.Object> variables,
                                                             java.util.Map<java.lang.String,java.lang.Object> extensions,
                                                             org.springframework.http.HttpHeaders headers,
                                                             java.lang.String operationName,
                                                             org.springframework.web.reactive.function.server.ServerRequest serverRequest)

Executes a GraphQL query. This method is used internally by all other methods in this interface.

Parameters:

query - The query string

variables - A map of variables

extensions - A map representing GraphQL extensions. This is made available in the DgsRequestData object on DgsContext.

headers - Request headers represented as a Spring Framework HttpHeaders

operationName - Operation name

serverRequest - A Spring ServerRequest giving access to request details.

Returns:

Returns a GraphQL ExecutionResult. This includes data and errors.

See Also:

Query Variables, Operation name

executeAndExtractJsonPath

default <T> reactor.core.publisher.Mono<T> executeAndExtractJsonPath(java.lang.String query,
                                                                     java.lang.String jsonPath)

Executes a GraphQL query, parses the returned data, and uses a Json Path to extract specific elements out of the data. The method is generic, and tries to cast the result into the type you specify. This does NOT work on Lists. Use executeAndExtractJsonPathAsObject(String, String, TypeRef) instead.

This only works for primitive types and map representations. Use executeAndExtractJsonPathAsObject(String, String, Class) for complex types and lists.

Type Parameters:

T - The type of primitive or map representation that should be returned.

Parameters:

query - Query string

jsonPath - JsonPath expression.

Returns:

A Mono that might contain the resolved type.

See Also:

JsonPath syntax docs

executeAndExtractJsonPath

<T> reactor.core.publisher.Mono<T> executeAndExtractJsonPath(java.lang.String query,
                                                             java.lang.String jsonPath,
                                                             java.util.Map<java.lang.String,java.lang.Object> variables,
                                                             org.springframework.web.reactive.function.server.ServerRequest serverRequest)

Executes a GraphQL query, parses the returned data, and uses a Json Path to extract specific elements out of the data. The method is generic, and tries to cast the result into the type you specify. This does NOT work on Lists. Use executeAndExtractJsonPathAsObject(String, String, TypeRef)instead.

This only works for primitive types and map representations. Use executeAndExtractJsonPathAsObject(String, String, Class) for complex types and lists.*

Type Parameters:

T - The type of primitive or map representation that should be returned.

Parameters:

query - Query string

jsonPath - JsonPath expression.

variables - A Map of variables

serverRequest - A Spring ServerRequest giving access to request details. *

Returns:

A Mono that might contain the resolved type.

See Also:

Query Variables, JsonPath syntax docs

executeAndExtractJsonPath

default <T> reactor.core.publisher.Mono<T> executeAndExtractJsonPath(java.lang.String query,
                                                                     java.lang.String jsonPath,
                                                                     java.util.Map<java.lang.String,java.lang.Object> variables)

Executes a GraphQL query, parses the returned data, and uses a Json Path to extract specific elements out of the data. The method is generic, and tries to cast the result into the type you specify. This does NOT work on Lists. Use executeAndExtractJsonPathAsObject(String, String, TypeRef)instead.

This only works for primitive types and map representations. Use executeAndExtractJsonPathAsObject(String, String, Class) for complex types and lists.*

Type Parameters:

T - The type of primitive or map representation that should be returned.

Parameters:

query - Query string

jsonPath - JsonPath expression.

variables - A Map of variables

Returns:

A Mono that might contain the resolved type.

See Also:

Query Variables, JsonPath syntax docs

executeAndExtractJsonPath

default <T> reactor.core.publisher.Mono<T> executeAndExtractJsonPath(java.lang.String query,
                                                                     java.lang.String jsonPath,
                                                                     org.springframework.web.reactive.function.server.ServerRequest serverRequest)

Executes a GraphQL query, parses the returned data, and uses a Json Path to extract specific elements out of the data. The method is generic, and tries to cast the result into the type you specify. This does NOT work on Lists. Use executeAndExtractJsonPathAsObject(String, String, TypeRef)instead.

This only works for primitive types and map representations. Use executeAndExtractJsonPathAsObject(String, String, Class) for complex types and lists.*

Type Parameters:

T - The type of primitive or map representation that should be returned.

Parameters:

query - Query string

jsonPath - JsonPath expression.

serverRequest - A Spring ServerRequest giving access to request details.

Returns:

A Mono that might contain the resolved type.

See Also:

Query Variables, JsonPath syntax docs

executeAndGetDocumentContext

default reactor.core.publisher.Mono<com.jayway.jsonpath.DocumentContext> executeAndGetDocumentContext(java.lang.String query)

Executes a GraphQL query, parses the returned data, and return a DocumentContext. A DocumentContext can be used to extract multiple values using JsonPath, without re-executing the query.

Parameters:

query - GraphQL query string

Returns:

DocumentContext is a JsonPath type used to extract values from.

executeAndGetDocumentContext

reactor.core.publisher.Mono<com.jayway.jsonpath.DocumentContext> executeAndGetDocumentContext(java.lang.String query,
                                                                                              java.util.Map<java.lang.String,java.lang.Object> variables)

Executes a GraphQL query, parses the returned data, and return a DocumentContext. A DocumentContext can be used to extract multiple values using JsonPath, without re-executing the query.

Parameters:

query - GraphQL query string

variables - A Map of variables

Returns:

DocumentContext is a JsonPath type used to extract values from.

See Also:

Query Variables

executeAndExtractJsonPathAsObject

default <T> reactor.core.publisher.Mono<T> executeAndExtractJsonPathAsObject(java.lang.String query,
                                                                             java.lang.String jsonPath,
                                                                             java.lang.Class<T> clazz)

Executes a GraphQL query, parses the returned data, extracts a value using JsonPath, and converts that value into the given type. Be aware that this method can't guarantee type safety.

Type Parameters:

T - The type that the extracted value should be converted to.

Parameters:

query - GraphQL query string

jsonPath - JsonPath expression.

clazz - The type to convert the extracted value to.

Returns:

The extracted value from the result, converted to type T

See Also:

JsonPath syntax docs

executeAndExtractJsonPathAsObject

<T> reactor.core.publisher.Mono<T> executeAndExtractJsonPathAsObject(java.lang.String query,
                                                                     java.lang.String jsonPath,
                                                                     java.util.Map<java.lang.String,java.lang.Object> variables,
                                                                     java.lang.Class<T> clazz)

Executes a GraphQL query, parses the returned data, extracts a value using JsonPath, and converts that value into the given type. Be aware that this method can't guarantee type safety.

Type Parameters:

T - The type that the extracted value should be converted to.

Parameters:

query - GraphQL query string

jsonPath - JsonPath expression.

variables - A Map of variables

clazz - The type to convert the extracted value to.

Returns:

The extracted value from the result, converted to type T

See Also:

JsonPath syntax docs, Query Variables

executeAndExtractJsonPathAsObject

default <T> reactor.core.publisher.Mono<T> executeAndExtractJsonPathAsObject(java.lang.String query,
                                                                             java.lang.String jsonPath,
                                                                             com.jayway.jsonpath.TypeRef<T> typeRef)

Executes a GraphQL query, parses the returned data, extracts a value using JsonPath, and converts that value into the given type. Uses a TypeRef to specify the expected type, which is useful for Lists and Maps. Be aware that this method can't guarantee type safety.

Type Parameters:

T - The type that the extracted value should be converted to.

Parameters:

query - Query string

jsonPath - JsonPath expression.

typeRef - A JsonPath [TypeRef] representing the expected result type.

Returns:

The extracted value from the result, converted to type T

See Also:

JsonPath syntax docs, Using TypeRef

executeAndExtractJsonPathAsObject

<T> reactor.core.publisher.Mono<T> executeAndExtractJsonPathAsObject(java.lang.String query,
                                                                     java.lang.String jsonPath,
                                                                     java.util.Map<java.lang.String,java.lang.Object> variables,
                                                                     com.jayway.jsonpath.TypeRef<T> typeRef)

Executes a GraphQL query, parses the returned data, extracts a value using JsonPath, and converts that value into the given type. Uses a TypeRef to specify the expected type, which is useful for Lists and Maps. Be aware that this method can't guarantee type safety.

Type Parameters:

T - The type that the extracted value should be converted to.

Parameters:

query - Query string

jsonPath - JsonPath expression.

variables - A Map of variables

typeRef - A JsonPath TypeRef representing the expected result type.

Returns:

The extracted value from the result, converted to type T

See Also:

JsonPath syntax docs, Query Variables, Using TypeRef