Mojolicious::Plugin::GraphQL - a plugin for adding GraphQL route handlers
my $schema = GraphQL::Schema->from_doc(<<'EOF');
schema {
query: QueryRoot
}
type QueryRoot {
helloWorld: String
}
EOF
# for Mojolicious substitute "plugin" with $app->plugin(...
# Mojolicious::Lite (with endpoint under "/graphql")
plugin GraphQL => {
schema => $schema, root_value => { helloWorld => 'Hello, world!' }
};
# OR, equivalently:
plugin GraphQL => {handler => sub {
my ($c, $body, $execute) = @_;
# returns JSON-able Perl data
$execute->(
$schema,
$body->{query},
{ helloWorld => 'Hello, world!' }, # $root_value
$c->req->headers,
$body->{variables},
$body->{operationName},
undef, # $field_resolver
);
}};
# OR, with bespoke user-lookup and caching:
plugin GraphQL => {handler => sub {
my ($c, $body, $execute) = @_;
my $user = MyStuff::User->lookup($app->request->headers->header('X-Token'));
die "Invalid user\n" if !$user; # turned into GraphQL { errors => [ ... ] }
my $cached_result = MyStuff::RequestCache->lookup($user, $body->{query});
return $cached_result if $cached_result;
MyStuff::RequestCache->cache_and_return($execute->(
$schema,
$body->{query},
undef, # $root_value
$user, # per-request info
$body->{variables},
$body->{operationName},
undef, # $field_resolver
));
};
# With GraphiQL, on /graphql
plugin GraphQL => {schema => $schema, graphiql => 1};
This plugin allows you to easily define a route handler implementing a GraphQL endpoint.
As of version 0.09, it will supply the necessary promise_code
parameter to "execute" in GraphQL::Execution. This means your resolvers
can (and indeed should) return Promise objects to function
asynchronously. Notice not necessarily "Promises/A+" - all that's needed
is a two-arg then
to work fine with GraphQL.
The route handler code will be compiled to behave like the following:
- Passes to the GraphQL execute, possibly via your supplied handler,
the given schema,
$root_value
and$field_resolver
. Note as above that the wrapper used in this plugin will supply the hash-ref matching "PromiseCode" in GraphQL::Type::Library. - The action built matches POST / GET requests.
- Returns GraphQL results in JSON form.
Mojolicious::Plugin::GraphQL supports the following options.
Array-ref. First element is a classname-part, which will be prepended with
"GraphQL::Plugin::Convert::". The other values will be passed
to that class's "to_graphql" in GraphQL::Plugin::Convert method. The
returned hash-ref will be used to set options, particularly schema
,
and probably at least one of resolver
and root_value
.
String. Defaults to /graphql
.
A GraphQL::Schema object. If not supplied, your handler
will need
to be a closure that will pass a schema on to GraphQL.
An optional root value, passed to top-level resolvers.
An optional field resolver, replacing the GraphQL default.
An optional route-handler, replacing the plugin's default - see example above for possibilities.
It must return JSON-able Perl data in the GraphQL format, which is a hash
with at least one of a data
key and/or an errors
key.
If it throws an exception, that will be turned into a GraphQL-formatted error.
Boolean controlling whether requesting the endpoint with Accept: text/html
will return the GraphiQL user interface. Defaults to false.
# Mojolicious::Lite
plugin GraphQL => {schema => $schema, graphiql => 1};
Mojolicious::Plugin::GraphQL inherits all methods from Mojolicious::Plugin and implements the following new ones.
my $route = $plugin->register(Mojolicious->new, {schema => $schema});
Register renderer in Mojolicious application.
Exportable is the function promise_code
, which returns a hash-ref
suitable for passing as the 8th argument to "execute" in GraphQL::Execution.
Ed J
Based heavily on Mojolicious::Plugin::PODRenderer.
This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.