Graphiti::Rails

Graphiti::Rails provides robust Rails integration for Graphiti, following standard Rails conventions.

Out of the box, Graphiti::Rails requires no configuration!

Add this line to your application's Gemfile:

gem 'graphiti-rails'

If you're already running Rails in API-only mode, there's no additional setup. Otherwise, we recommend the following in config/application.rb:

config.debug_exception_response_format = :api

This will cause the ActionDispatch::DebugExceptions middleware to generate debug information in the requested content-type instead of as HTML only. In turn, this allows graphti-rails to generate more specific error messages for JSON API requests.

Since Rails doesn't correctly format exceptions for JSON:API requests, graphiti-rails intercepts these requests for proper rendering. If you'd like to use the GraphitiError handlers for other response types as well, you can add them in config/application.rb:

config.graphiti.handled_exception_formats += [:xml]

By default, Rails does a few things to handle exceptions. We integrate into this handling to ensure behavior as close to the Rails defaults while still adding important conventions and additional information provide by Graphiti.

At the highest level, is rescue_from which allows you to handle an error at the controller level. This bypasses all default error handling in Rails, leaving it up to the developer to account for all scenarios. In the future, we would like to provide some APIs for default handling in these cases.

Next is ActionDispatch::DebugExceptions. This middleware logs exceptions and renders debugging information for local requests. We hook in here to log information in a proper format for JSON:API.

Last is ActionDispatch::ShowExceptions. This middleware rescues any exception returned by the application and calls an exceptions app that will wrap it in a format for the end user. We wrap the exceptions app to ensure that JSON:API errors are always rendered in the standard format.

We wrap all requests in a Graphiti context pointing to the current controller instance. If you'd like to use a different context, overwrite the graphiti_context method in your controller.

For more information about Graphiti context, see the Graphiti docs.

We also provide hooks for Graphiti's built-in debugger. For more information see the Graphiti docs.

We'd love to have your help improving graphiti-rails. To chat with the team and other users, join the #rails channel on Slack.

The gem is available as open source under the terms of the MIT License.