com.graphql.spring.boot.test

Class GraphQLTestTemplate

java.lang.Object

com.graphql.spring.boot.test.GraphQLTestTemplate

public class GraphQLTestTemplate
extends java.lang.Object

Helper class to test GraphQL queries and mutations.

Constructor Summary

Constructors

Constructor and Description
GraphQLTestTemplate(org.springframework.core.io.ResourceLoader resourceLoader, org.springframework.boot.test.web.client.TestRestTemplate restTemplate, java.lang.String graphqlMapping, com.fasterxml.jackson.databind.ObjectMapper objectMapper)

Method Summary

Modifier and Type	Method and Description
GraphQLResponse	perform(java.lang.String graphqlResource, com.fasterxml.jackson.databind.node.ObjectNode variables) Loads a GraphQL query or mutation from the given classpath resource and sends it to the GraphQL server.
GraphQLResponse	perform(java.lang.String graphqlResource, com.fasterxml.jackson.databind.node.ObjectNode variables, java.util.List<java.lang.String> fragmentResources) Loads a GraphQL query or mutation from the given classpath resource and sends it to the GraphQL server.
GraphQLResponse	perform(java.lang.String graphqlResource, java.lang.String operationName) Loads a GraphQL query or mutation from the given classpath resource and sends it to the GraphQL server.
GraphQLResponse	perform(java.lang.String graphqlResource, java.lang.String operation, com.fasterxml.jackson.databind.node.ObjectNode variables) Loads a GraphQL query or mutation from the given classpath resource and sends it to the GraphQL server.
GraphQLResponse	perform(java.lang.String graphqlResource, java.lang.String operationName, com.fasterxml.jackson.databind.node.ObjectNode variables, java.util.List<java.lang.String> fragmentResources) Loads a GraphQL query or mutation from the given classpath resource and sends it to the GraphQL server.
GraphQLResponse	post(java.lang.String payload) Performs a GraphQL request with the provided payload.
GraphQLResponse	postForResource(java.lang.String graphqlResource) Loads a GraphQL query or mutation from the given classpath resource and sends it to the GraphQL server.
GraphQLResponse	postForResource(java.lang.String graphqlResource, java.util.List<java.lang.String> fragmentResources) Loads a GraphQL query or mutation from the given classpath resource, appending any graphql fragment resources provided and sends it to the GraphQL server.
GraphQLResponse	postMultipart(java.lang.String query, java.lang.String variables)
GraphQLTestTemplate	withAdditionalHeader(java.lang.String name, java.lang.String... value) Add an HTTP header that will be sent with each request this sends.
GraphQLTestTemplate	withAdditionalHeaders(org.springframework.util.MultiValueMap<java.lang.String,java.lang.String> additionalHeaders) Add multiple HTTP header that will be sent with each request this sends.
GraphQLTestTemplate	withBasicAuth(@NonNull java.lang.String encodedCredentials) Adds basic authentication to the authorization header.
GraphQLTestTemplate	withBasicAuth(@NonNull java.lang.String username, @NonNull java.lang.String password) Adds basic authentication to the authorization header.
GraphQLTestTemplate	withBasicAuth(@NonNull java.lang.String username, @NonNull java.lang.String password, java.nio.charset.Charset charset) Adds basic authentication to the authorization header.
GraphQLTestTemplate	withBearerAuth(@NonNull java.lang.String token) Adds a bearer token to the authorization header.
GraphQLTestTemplate	withClearHeaders() Clear all associated HTTP headers.
GraphQLTestTemplate	withHeaders(org.springframework.http.HttpHeaders newHeaders) Replace any associated HTTP headers with the provided headers.

Methods inherited from class java.lang.Object

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

Constructor Detail

GraphQLTestTemplate

public GraphQLTestTemplate(org.springframework.core.io.ResourceLoader resourceLoader,
                           org.springframework.boot.test.web.client.TestRestTemplate restTemplate,
                           @Value(value="${graphql.servlet.mapping:/graphql}")
                           java.lang.String graphqlMapping,
                           com.fasterxml.jackson.databind.ObjectMapper objectMapper)

Method Detail

withAdditionalHeader

public GraphQLTestTemplate withAdditionalHeader(java.lang.String name,
                                                java.lang.String... value)

Add an HTTP header that will be sent with each request this sends.

Parameters:

name - Name (key) of HTTP header to add.

value - Value(s) of HTTP header to add.

Returns:

self

withAdditionalHeaders

public GraphQLTestTemplate withAdditionalHeaders(org.springframework.util.MultiValueMap<java.lang.String,java.lang.String> additionalHeaders)

Add multiple HTTP header that will be sent with each request this sends.

Parameters:

additionalHeaders - additional headers to add

Returns:

self

withBearerAuth

public GraphQLTestTemplate withBearerAuth(@NonNull
                                          @NonNull java.lang.String token)

Adds a bearer token to the authorization header.

Parameters:

token - the bearer token

Returns:

self

withBasicAuth

public GraphQLTestTemplate withBasicAuth(@NonNull
                                         @NonNull java.lang.String username,
                                         @NonNull
                                         @NonNull java.lang.String password,
                                         @Nullable
                                         java.nio.charset.Charset charset)

Adds basic authentication to the authorization header.

Parameters:

username - the username

password - the password

charset - the charset used by the credentials

Returns:

self

withBasicAuth

public GraphQLTestTemplate withBasicAuth(@NonNull
                                         @NonNull java.lang.String username,
                                         @NonNull
                                         @NonNull java.lang.String password)

Adds basic authentication to the authorization header.

Parameters:

username - the username

password - the password

Returns:

self

withBasicAuth

public GraphQLTestTemplate withBasicAuth(@NonNull
                                         @NonNull java.lang.String encodedCredentials)

Adds basic authentication to the authorization header.

Parameters:

encodedCredentials - the encoded credentials

Returns:

self

withHeaders

public GraphQLTestTemplate withHeaders(org.springframework.http.HttpHeaders newHeaders)

Replace any associated HTTP headers with the provided headers.

Parameters:

newHeaders - Headers to use.

Returns:

self

withClearHeaders

public GraphQLTestTemplate withClearHeaders()

Clear all associated HTTP headers.

Returns:

self

perform

public GraphQLResponse perform(java.lang.String graphqlResource,
                               com.fasterxml.jackson.databind.node.ObjectNode variables)
                        throws java.io.IOException

Loads a GraphQL query or mutation from the given classpath resource and sends it to the GraphQL server.

Parameters:

graphqlResource - path to the classpath resource containing the GraphQL query

variables - the input variables for the GraphQL query

Returns:

GraphQLResponse containing the result of query execution

Throws:

java.io.IOException - if the resource cannot be loaded from the classpath

perform

public GraphQLResponse perform(java.lang.String graphqlResource,
                               java.lang.String operationName)
                        throws java.io.IOException

Loads a GraphQL query or mutation from the given classpath resource and sends it to the GraphQL server.

Parameters:

graphqlResource - path to the classpath resource containing the GraphQL query

operationName - the name of the GraphQL operation to be executed

Returns:

GraphQLResponse containing the result of query execution

Throws:

java.io.IOException - if the resource cannot be loaded from the classpath

perform

public GraphQLResponse perform(java.lang.String graphqlResource,
                               java.lang.String operation,
                               com.fasterxml.jackson.databind.node.ObjectNode variables)
                        throws java.io.IOException

Loads a GraphQL query or mutation from the given classpath resource and sends it to the GraphQL server.

Parameters:

graphqlResource - path to the classpath resource containing the GraphQL query

operation - the name of the GraphQL operation to be executed

variables - the input variables for the GraphQL query

Returns:

GraphQLResponse containing the result of query execution

Throws:

java.io.IOException - if the resource cannot be loaded from the classpath

perform

public GraphQLResponse perform(java.lang.String graphqlResource,
                               com.fasterxml.jackson.databind.node.ObjectNode variables,
                               java.util.List<java.lang.String> fragmentResources)
                        throws java.io.IOException

Loads a GraphQL query or mutation from the given classpath resource and sends it to the GraphQL server.

Parameters:

graphqlResource - path to the classpath resource containing the GraphQL query

variables - the input variables for the GraphQL query

fragmentResources - an ordered list of classpath resources containing GraphQL fragment definitions.

Returns:

GraphQLResponse containing the result of query execution

Throws:

java.io.IOException - if the resource cannot be loaded from the classpath

perform

public GraphQLResponse perform(java.lang.String graphqlResource,
                               java.lang.String operationName,
                               com.fasterxml.jackson.databind.node.ObjectNode variables,
                               java.util.List<java.lang.String> fragmentResources)
                        throws java.io.IOException

Loads a GraphQL query or mutation from the given classpath resource and sends it to the GraphQL server.

Parameters:

graphqlResource - path to the classpath resource containing the GraphQL query

variables - the input variables for the GraphQL query

fragmentResources - an ordered list of classpath resources containing GraphQL fragment definitions.

Returns:

GraphQLResponse containing the result of query execution

Throws:

java.io.IOException - if the resource cannot be loaded from the classpath

postForResource

public GraphQLResponse postForResource(java.lang.String graphqlResource)
                                throws java.io.IOException

Loads a GraphQL query or mutation from the given classpath resource and sends it to the GraphQL server.

Parameters:

graphqlResource - path to the classpath resource containing the GraphQL query

Returns:

GraphQLResponse containing the result of query execution

Throws:

java.io.IOException - if the resource cannot be loaded from the classpath

postForResource

public GraphQLResponse postForResource(java.lang.String graphqlResource,
                                       java.util.List<java.lang.String> fragmentResources)
                                throws java.io.IOException

Loads a GraphQL query or mutation from the given classpath resource, appending any graphql fragment resources provided and sends it to the GraphQL server.

Parameters:

graphqlResource - path to the classpath resource containing the GraphQL query

fragmentResources - an ordered list of classpath resources containing GraphQL fragment definitions.

Returns:

GraphQLResponse containing the result of query execution

Throws:

java.io.IOException - if the resource cannot be loaded from the classpath

postMultipart

public GraphQLResponse postMultipart(java.lang.String query,
                                     java.lang.String variables)

post

public GraphQLResponse post(java.lang.String payload)

Performs a GraphQL request with the provided payload.

Parameters:

payload - the GraphQL payload

Returns:

@return GraphQLResponse containing the result of query execution