The delivery endpoint requires a YAML configuration or otherwise it cannot deliver content. Version 2.0 of the magnolia-rest-content-delivery module can have only one configuration. Future versions will allow multiple configurations which can be distinguished via a URL parameter. Add the configuration to the restEndpoints folder in a light module or within src/main/resources/<module-name>/restEndpoints in a Magnolia Maven module. Basic configuration Code Pro |
---|
language | yaml |
---|
title | my-lightmodule/restEndpoints /my-endpoint.yaml |
---|
| class: info.magnolia.rest.delivery.jcr.v1.JcrDeliveryEndpointDefinition
implementationClass: info.magnolia.rest.delivery.jcr.v1.JcrDeliveryEndpoint
params:
website:
depth: 3
includeSystemProperties: false
nodeTypes:
- mgnl:page
- mgnl:area
- mgnl:component
rootPath: /
dam:
depth: 1
includeSystemProperties: false
nodeTypes:
- mgnl:asset
rootPath: /travel-demo |
Properties: class | required Must be info.magnolia.rest.delivery.jcr.v1.JcrDeliveryEndpointDefinition or a subclass. | implementationClass | required Must be info.magnolia.rest.delivery.jcr.v1.JcrDeliveryEndpoint or a subclass. | params | required The map defining at least one or more workspaces. | <endpointPrefix>
| required Defines an endpoint prefix where requests will be routed and handled according to the associated workspace parameters below. The value can be an arbitrary name (no special characters!) - or it can be a realworkspace name. If it is not a real workspace name, you must provide the sub property workspace . | workspace
| optional
The name of the JCR workspace to deliver content from. Must be set if the parent <endpointPrefix> is not a real workspace name. | nodeTypes
| optional default=mgnl:content A list of allowed node types for depth-0 nodes. mgnl:folder is ignored deliberately. | childNodeTypes
| optional default=mgnl:contentNode
A list of allowed node types for child nodes. | depth
| optional,default is 0 The depth of subnodes to display in the result. | includeSystemProperties
| optional,default is true Specifies whether the result should show system properties. | rootPath
| optional The root path of this endpoint. The path information when requesting the endpoint is added to this path. | bypassWorkspaceAcls
| optional, default is false Note |
---|
If set to true , JCR security is bypassed. Use this with care and for development reasons only! |
| limit *
| optional, default is 10 The number of nodes (of level 0) in the result. Used only in the queryNodes method. | *) The property can be overridden when calling queryNodes with a request parameter. Anchor |
---|
| reference-resolving-configuration |
---|
| reference-resolving-configuration |
---|
| Reference resolving configurationA node may contain references to other nodes. With the references property you can extend the configuration to force it to resolve the referenced nodes per workspace. Code Pro |
---|
language | yaml |
---|
linenumbers | true |
---|
| class: info.magnolia.rest.delivery.jcr.v1.JcrDeliveryEndpointDefinition
implementationClass: info.magnolia.rest.delivery.jcr.v1.JcrDeliveryEndpoint
params:
tours:
depth: 1
includeSystemProperties: false
nodeTypes:
- mgnl:content
rootPath: /
references:
tour-types:
propertyName: tourTypes
referenceResolver:
implementationClass: info.magnolia.rest.reference.jcr.UuidReferenceResolver
targetWorkspace: category |
Properties of references : references | A map which contains at least one reference definition. | <reference-name>
| An arbitrary name for a Javadoc resource link |
---|
className | info.magnolia.rest.reference.ReferenceDefinition |
---|
renderType | asynchronous |
---|
|
. | propertyName
| The name of the JCR property which stores the reference. It can be a multi-value property. | referenceResolver
| The reference resolver definition for this reference. Its definition class is Javadoc resource link |
---|
className | info.magnolia.rest.reference.ReferenceResolverDefinition |
---|
renderType | asynchronous |
---|
|
. | implementationClass
| A class implementing Javadoc resource link |
---|
className | info.magnolia.rest.reference.ReferenceResolverDefinition |
---|
renderType | asynchronous |
---|
|
. Current implementations: Javadoc resource link |
---|
className | info.magnolia.rest.reference.jcr.UuidReferenceResolver |
---|
renderType | asynchronous |
---|
|
| targetWorkspace
| The name of the workspace where the referenced node resides. |
|