org.apache.sling.resourcemerger.api.ResourceMergerService Maven / Gradle / Ivy
/*
* Licensed to the Apache Software Foundation (ASF) under one
* or more contributor license agreements. See the NOTICE file
* distributed with this work for additional information
* regarding copyright ownership. The ASF licenses this file
* to you under the Apache License, Version 2.0 (the
* "License"); you may not use this file except in compliance
* with the License. You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing,
* software distributed under the License is distributed on an
* "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
* KIND, either express or implied. See the License for the
* specific language governing permissions and limitations
* under the License.
*/
package org.apache.sling.resourcemerger.api;
import org.apache.sling.api.resource.Resource;
import aQute.bnd.annotation.ProviderType;
/**
* Service to handle merged resources.
* @deprecated
*/
@Deprecated
@ProviderType
public interface ResourceMergerService {
/**
* Returns the absolute path for the provided relative path.
*
* @param relativePath The relative path
* @return Returns the merged resource path
* @throws IllegalArgumentException if relativePath is null
or absolute
*/
String getMergedResourcePath(String relativePath);
/**
* Returns a merged resource if the provided resource is from one of the search paths
* and the resource is not hidden.
* If the resource is null
, null
is returned.
*
* @param resource The resource
* @return Returns the merged resource or null
*/
Resource getMergedResource(Resource resource);
/**
* Returns true
if the provided {@link Resource} is a merged resource.
* If the resource is null
, false
is returned.
* @param resource The resource
* @return Returns true
if the provided {@link Resource} is a merged resource.
*/
boolean isMergedResource(Resource resource);
/**
* Return a resource path by taking the path of the merged resource, removing
* the mount point and replacing it with the search path.
*
* For example, if the provided search path is "/apps/" and the merged resource
* path is "/mnt/overlay/my/resource", the result will be "/apps/my/resource".
*
* @param searchPath The search path, this is an absolute path ending with a slash
* as returned by the resource resolver
* @param mergedResourcePath An absolute path to a merged resource
* @return The path to the resource
* @throws IllegalArgumentException If search path is not absolute or does not end
* with a slash or if the merged resource path
* is not within the space of the merged resources.
* @since 1.1
*/
String getResourcePath(String searchPath, String mergedResourcePath);
}