Immediate Mutation Updates
When a user causes mutations like creating, updating, or deleting resources, it's important to have those changed be reflected in the application. A simple publish cache that has no underlying knowledge of the data structures would require a refetch of any endpoints that are changed. This would reduce performance and put extra burden on the backend.
However, like many other cases, a normalized cache - one with underlying knowledge of the relationships between resources - is capable of keeping all data consistent and fresh without any refetches.
Rest Hooks uses your schema definitions to understand how to normalize response data into
entity table and
result table. Of course, this means that there is only ever one copy
of a given
entity. Aside from providing consistency when using different response shapes,
this means that by providing an accurate schema definition, Rest Hooks can automatically keep
all data uses consistent and fresh. The default update shapes Resource.updateShape() and
Resource.partialUpdate() both do this automatically. Read more about defining other
update fetch shapes
Rest Hooks automatically deletes entity entries when any Fetch Shape
delete is resolved. Resource.deleteShape()
provides such a shape.
Like updates, created entities are automatically added to the entities table. This means any components useResource() for just that item will be able to access it immediately and not have to wait for an additional retrieval request. However, often new items are created when viewing an entire list of items, and the create should result in that list - any maybe others - displaying the newly created entry.
In the case list views are expected to include newly created items, a third argument to the fetch function updateParams can be added.
See updateParams for more information, but it essentially specifies which lists to update.