Package org.apache.sling.resourcemerger.spi

Interface MergedResourcePicker2

@ConsumerType
public interface MergedResourcePicker2

Service interface which can be implemented to define an algorithm used to pick resources to be merged. For each picker service, a separate ResourceProvider will be exposed at the MERGE_ROOT of the picker.

Since:

1.2

Field Summary

Fields

Modifier and Type	Field	Description
static final String	MERGE_ROOT	Service property name identifying the root path for the merged resources.
static final String	READ_ONLY	Service property name specifying whether the resources are read-only or support CRUD operations.
static final String	TRAVERSE_PARENT	Service property name specifying whether the parent hierarchy is traversed to check for hiding properties.

Method Summary

Modifier and Type	Method	Description
@NotNull List<@NotNull Resource>	pickResources(@NotNull ResourceResolver resolver, @NotNull String relativePath, Resource relatedResource)	Method invoked by the MergingResourceProvider to identify the resources to be merged for a given relative path.

Field Details

MERGE_ROOT

static final String MERGE_ROOT

Service property name identifying the root path for the merged resources. By convention, starts, with /mnt, although this is by no means required. The value of this service property must be of type String and must not end in a slash.

See Also:

• Constant Field Values

READ_ONLY

static final String READ_ONLY

Service property name specifying whether the resources are read-only or support CRUD operations. If not specified this property defaults to true. The value of this property must be of type Boolean.

See Also:

• Constant Field Values

TRAVERSE_PARENT

static final String TRAVERSE_PARENT

Service property name specifying whether the parent hierarchy is traversed to check for hiding properties. If not specified this property defaults to false. The value of this property must be of type Boolean.

See Also:

• Constant Field Values

Method Details

pickResources

@NotNull
@NotNull List<@NotNull Resource> pickResources(@NotNull
 @NotNull ResourceResolver resolver,
 @NotNull
 @NotNull String relativePath,
 Resource relatedResource)

Method invoked by the MergingResourceProvider to identify the resources to be merged for a given relative path. The resources returned may be either resources returned from the ResourceResolver directory or an instance of NonExistingResource. Returning an empty list will cause the resource to not exist for consumers (resolver.getResource(path) will return null).

Parameters:

resolver - the ResourceResolver

relativePath - the path relative to the merge root

relatedResource - an optional resource which is related to the given path (always the parent resource or null)

Returns:

a List of Resource objects