juniper_iron

This repository contains the Iron web framework integration for Juniper, a GraphQL implementation for Rust.

For documentation, including guides and examples, check out Juniper.

A basic usage example can also be found in the Api documentation.

Examples

Check examples/iron_server.rs for example code of a working Iron server with GraphQL handlers.

Links

• Juniper
• [Api Reference][documetation]
• Iron framework

License

This project is under the BSD-2 license.

Check the LICENSE file for details.

lib.rs:

juniper_iron

This repository contains the Iron web framework integration for Juniper, a GraphQL implementation for Rust.

For documentation, including guides and examples, check out Juniper.

A basic usage example can also be found in the Api documentation.

Links

• Juniper
• Api Reference
• Iron framework

Integrating with Iron

For example, continuing from the schema created above and using Iron to expose the schema on an HTTP endpoint supporting both GET and POST requests:

#
use iron::prelude::*;
use juniper_iron::GraphQLHandler;
use juniper::{Context, EmptyMutation, EmptySubscription};
#
#
#
#
#
#

// This function is executed for every request. Here, we would realistically
// provide a database connection or similar. For this example, we'll be
// creating the database from scratch.
fn context_factory(_: &mut Request) -> IronResult<Database> {
Ok(Database {
users: vec![
( "1000".to_owned(), User {
id: "1000".to_owned(), name: "Robin".to_owned(),
friend_ids: vec!["1001".to_owned()] } ),
( "1001".to_owned(), User {
id: "1001".to_owned(), name: "Max".to_owned(),
friend_ids: vec!["1000".to_owned()] } ),
].into_iter().collect()
})
}

impl Context for Database {}

fn main() {
// GraphQLHandler takes a context factory function, the root object,
// and the mutation object. If we don't have any mutations to expose, we
// can use the empty tuple () to indicate absence.
let graphql_endpoint = GraphQLHandler::new(
context_factory,
QueryRoot,
EmptyMutation::<Database>::new(),
EmptySubscription::<Database>::new(),
);

// Start serving the schema at the root on port 8080.
Iron::new(graphql_endpoint).http("localhost:8080").unwrap();
}

See the the GraphQLHandler documentation for more information on what request methods are supported.