manifold.graphql.request

Class Executor<T>

java.lang.Object

manifold.graphql.request.Executor<T>

Type Parameters:

T -

public class Executor<T>
extends Object

Based on: "How to make GraphQL HTTP request using cUrl"

Based on the GET/POST and the Content-Type header, it expects the input params differently. This behaviour was ported from express-graphql.

So given the following operation:

 mutation M {
   newTodo: createTodo(text: "This is a mutation example") {
     text
     done
   }
 }
 

 using GET
 $ curl -g -GET 'http://localhost:8080/graphql?query=mutation+M{newTodo:createTodo(text:"This+is+a+mutation+example"){text+done}}'
 using POST + Content-Type: application/graphql
 $ curl -XPOST http://localhost:8080/graphql -H 'Content-Type: application/graphql' -d 'mutation M { newTodo: createTodo(text: "This is a mutation example") { text done } }'
 using POST + Content-Type: application/json
 $ curl -XPOST http://localhost:8080/graphql -H 'Content-Type: application/json' -d '{"query": "mutation M { newTodo: createTodo(text: \"This is a mutation example\") { text done } }"}'
 

Constructor Summary

Constructors

Constructor and Description
Executor(String url, String operation, String query, Bindings variables)

Method Summary

Modifier and Type	Method and Description
T	get() Make an HTTP GET request to url.
T	get(Requester.Format format) Make an HTTP GET request to url.
T	post() Make an HTTP POST request to url.
T	post(Requester.Format format) Make an HTTP POST request to url.
Executor<T>	withAuthorization(String tokenType, String accessToken)
Executor<T>	withBasicAuthorization(String username, String password) Set the Basic Authorization header using the provided username and password
Executor<T>	withBearerAuthorization(String accessToken) Set the Bearer Authorization header using the provided accessToken.
Executor<T>	withHeader(String name, String value) Set an HTTP request header name : value pair See HTTP header fields
Executor<T>	withParam(String name, String value) Add a name=value parameter to the request URL.
Executor<T>	withTimeout(int timeout) The connection timeout setting in milliseconds.

Methods inherited from class java.lang.Object

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

Constructor Detail

Executor

public Executor(String url,
                String operation,
                String query,
                Bindings variables)

Method Detail

withHeader

public Executor<T> withHeader(String name,
                              String value)

Set an HTTP request header name : value pair See HTTP header fields

withParam

public Executor<T> withParam(String name,
                             String value)

Add a name=value parameter to the request URL.

withBasicAuthorization

public Executor<T> withBasicAuthorization(String username,
                                          String password)

Set the Basic Authorization header using the provided username and password

withBearerAuthorization

public Executor<T> withBearerAuthorization(String accessToken)

Set the Bearer Authorization header using the provided accessToken. For instance, if using OAuth, accessToken is the token response from:

 curl -d "grant_type=password&client_id=[...]&client_secret=[...]&username=[...]&password=[...]"
   https://[domain]/[oauth-service]
 

withAuthorization

public Executor<T> withAuthorization(String tokenType,
                                     String accessToken)

withTimeout

public Executor<T> withTimeout(int timeout)

The connection timeout setting in milliseconds. If the timeout expires before the connection can be established, a {@link java.net.SocketTimeoutException) is thrown. A value of zero is interpreted as an infinite timeout, this is the default setting.

post

public T post()
       throws GqlRequestException

Make an HTTP POST request to url. The payload, if non-null, is sent as JSON encoded text in the request's message body.

Returns:

A JSON value parsed from the format specified encoded response (primitive/boxed type, String, List of JSON values, or Bindings of String/JSON value)

Throws:

GqlRequestException - If the response contains errors, wraps them in a list of GqlError and throws

post

public T post(Requester.Format format)
       throws GqlRequestException

Make an HTTP POST request to url. The payload, if non-null, is sent as JSON encoded text in the request's message body.

Parameters:

format - The expected format of the response. One of: Json, Yaml, or Plain

Returns:

A JSON value parsed from the format specified encoded response (primitive/boxed type, String, List of JSON values, or Bindings of String/JSON value)

Throws:

GqlRequestException - If the response contains errors, wraps them in a list of GqlError and throws

get

public T get()
      throws GqlRequestException

Make an HTTP GET request to url. The payload, if non-null, is sent as JSON encoded text in the request's message body.

Returns:

A JSON value parsed from the format specified encoded response (primitive/boxed type, String, List of JSON values, or Bindings of String/JSON value)

Throws:

GqlRequestException - If the response contains errors, wraps them in a list of GqlError and throws

get

public T get(Requester.Format format)
      throws GqlRequestException

Make an HTTP GET request to url. The payload, if non-null, is sent as JSON encoded text in the request's message body.

Parameters:

format - The expected format of the response. One of: Json, Yaml, or Plain

Returns:

A JSON value parsed from the format specified encoded response (primitive/boxed type, String, List of JSON values, or Bindings of String/JSON value)

Throws:

GqlRequestException - If the response contains errors, wraps them in a list of GqlError and throws