Network Layer
In order to know how to access your GraphQL server, Relay Modern requires developers to provide an object implementing the NetworkLayer
interface when creating an instance of a Relay Environment. The environment uses this network layer to execute queries, mutations, and (if your server supports them) subscriptions. This allows developers to use whatever transport (HTTP, WebSockets, etc) and authentication is most appropriate for their application, decoupling the environment from the particulars of each application's network configuration.
Currently the easiest way to create a network layer is via a helper from the relay-runtime
package:
Note that this is a basic example to help you get started. This example could be extended with additional features such as request/response caching (enabled e.g. when cacheConfig.force
is false) and uploading form data for mutations (the uploadables
parameter).
#
CachingRelay modern makes no assumptions about what to cache and will garbage collect any data that is no longer referenced.
You have to implement your own cache strategy. A simple solution is to use QueryResponseCache
(an in-memory cache):
#
Custom open-source implementationsreact-relay-network-modern on npm - is a Network Layer for Relay Modern which has built-in highly customizable middlewares for commonly used scenarios: batching query requests, caching, authentication, request retrying, logging. Moreover, you may write your own middlewares with custom logic.