/*
 * Copyright © Red Gate Software Ltd 2010-2020
 *
 * Licensed 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.flywaydb.core.api;

import org.flywaydb.core.api.resource.LoadableResource;

import java.util.Collection;

A facility to obtain loadable resources.
/**
 * A facility to obtain loadable resources.
 */
public interface ResourceProvider {
    
Retrieves the resource with this name.
Params:
name – The name of the resource.
Returns:
The resource or null if not found./**
     * Retrieves the resource with this name.
     *
     * @param name The name of the resource.
     * @return The resource or {@code null} if not found.
     */
    LoadableResource getResource(String name);

    
Retrieve all resources whose name begins with this prefix and ends with any of these suffixes.
Params:
prefix –   The prefix.
suffixes – The suffixes.
Returns:
The matching resources./**
     * Retrieve all resources whose name begins with this prefix and ends with any of these suffixes.
     *
     * @param prefix   The prefix.
     * @param suffixes The suffixes.
     * @return The matching resources.
     */
    Collection<LoadableResource> getResources(String prefix, String[] suffixes);
}