close

Filter

loading table of contents...

Headless Server Developer Manual / Version 2301

Table Of Contents

4.2.4.1 The Query Root: ContentRoot

A query root is the primary object necessary to resolve a GraphQL query. The query root for all content queries is ContentRoot. It is created as a Spring bean in the CaasConfig class and provides access to the content repository. A query root does not obey any interfaces or standards. The GraphQL runtime handles a query root like a POJO using reflection.

At the same time, the Java class ContentRoot reflects the GraphQL root type in the query root of the same name. All fields, defined in the GraphQL type correspond to a getter of the same name, for example the page query, which corresponds to the getter public getPage(DataFetchingEnvironment environment). The result of the getter method is the so called root object (not identical to the query root) on which the following resolving process relies.

On top of the reflection based invocation of the getter methods, CoreMedia added the @fetch directive, which allows to express the data fetching for a property in the GraphQL scheme using the Spring Expression Language (SpEL). The Spring EL allows a less restrictive approach to use the query root or even to invoke completely different objects instead of the ContentRoot, namely most of the adapters, like the SettingsAdapter or the NavigationAdapter.

Search Results

Table Of Contents
warning

Your Internet Explorer is no longer supported.

Please use Mozilla Firefox, Google Chrome, or Microsoft Edge.