[juniper_rocket] Document GET request syntax

[ysulyma]

I am using the Juniper Rocket example. The POST endpoint and GraphiQL interface work for me, but I can't figure out how to send a GET request. (I'm also new to using Rocket.) I have tried

/graphql?{}
/graphql?request={}
/graphql?query={}

where {} is a URL-encoded version of

{
  __schema {
    types {
      name
    }
  }
}

and none of these work for me.

An explicit example of a GET request that works would be helpful.

[ilslv]

@ysulyma /graphql?query should work, but rocket example is incorrect, as it uses Deserialize impl of GraphQLRequest. We'll address this in 0.16 release.

Until then you have 2 options:

1. Use POST for both mutations and queries. This should be ok.
2. Implement custom structure with right Deserialize impl and convert this struct into a GraphQLRequest.

[tyranron]

@ysulyma /graphql?query should work, but rocket example is incorrect, as it uses Deserialize impl of GraphQLRequest.

This is not true. In the specified example is used juniper_rocket::GraphQLRequest, rather than juniper::http::GraphQLRequest, and it doesn't implement Deserialize at all. In fact, it implements FromForm, which gives it ability to being parsed from URL query strings. So all this works okay. Passing juniper::http::tests confirms it.

The example, however, is really broken. Rather than having

#[rocket::get("/graphql?<request>")]

attribute, it should have

#[rocket::get("/graphql?<request..>")]

[tyranron]

@ysulyma the example was fixed, and now mentions the GET request query format:

juniper/juniper_rocket/examples/simple.rs

Lines 29 to 41 in bd8dc58

	// GET request accepts query parameters like these:
	// ?query=<urlencoded-graphql-query-string>
	// &operationName=<optional-name>
	// &variables=<optional-json-encoded-variables>
	// See details here: https://graphql.org/learn/serving-over-http#get-request
	#[rocket::get("/graphql?<request..>")]
	async fn get_graphql(
	db: &State<Database>,
	request: juniper_rocket::GraphQLRequest,
	schema: &State<Schema>,
	) -> juniper_rocket::GraphQLResponse {
	request.execute(schema, db).await
	}