*/
    String STRICT = "strict";

    /**
     * Locates the pom in the given directory.
     *
     * @param dir the directory to locate the pom for, never {@code null}
     * @return a {@code Source} pointing to the located pom or an empty {@code Optional} if none was found by this parser
     */
    @Nonnull
    Optional<Source> locate(@Nonnull Path dir);

    /**

     * @throws IllegalStateException if multiple versions of the same GA are part of the reactor
     */
    Model getRawModel(Path from, String groupId, String artifactId);

    /**
     * Locate the POM file inside the given directory.
     */
    Path locate(Path path);

 * under the License.
 */
package org.apache.maven.model.locator;

import java.io.File;
import java.nio.file.Path;

/**
 * Locates a POM file within a project base directory.
 *
 * @deprecated use {@link org.apache.maven.api.services.ModelBuilder} instead
 */
@Deprecated(since = "4.0.0")
public interface ModelLocator {

    /**

The [GOROOT] function is now deprecated.
In new code prefer to use the system path to locate the “go” binary,

package org.apache.maven.lifecycle;

/**
 * Signals a failure to locate a lifecycle.
 *
 */
public class LifecycleNotFoundException extends Exception {

    private final String lifecycleId;

    /**
     * Creates a new exception to indicate that the specified lifecycle is unknown.
     *
     * @param lifecycleId The identifier of the lifecycle that could not be located, may be {@code null}.
     */

        DefaultModelProblemCollector problems = (DefaultModelProblemCollector) collector;
        return new TransformerContext() {

            @Override
            public Path locate(Path path) {
                return context.locate(path);
            }

            @Override
            public String getUserProperty(String key) {
                return context.userProperties.computeIfAbsent(

    @Override
    public Model getRawModel(Path from, String groupId, String artifactId) {
        return Holder.deref(modelByGA.get(new GAKey(groupId, artifactId)));
    }

    @Override
    public Path locate(Path path) {
        File file = modelLocator.locateExistingPom(path.toFile());
        return file != null ? file.toPath() : null;
    }

    static class GAKey {
        private final String groupId;

import java.nio.file.Path;

import org.apache.maven.api.annotations.Nonnull;
import org.apache.maven.api.annotations.Nullable;

/**
 * Interface used to locate the root directory for a given project.
 *
 * The root locator is usually looked up from the plexus container.
 * One notable exception is the computation of the early {@code session.rootDirectory}

        // Note that the ModelProcessor#locatePom never returns null
        // while the ModelParser#locatePom needs to return an existing path!
        Path pom = modelParsers.stream()
                .map(m -> m.locate(projectDirectory)
                        .map(org.apache.maven.api.services.Source::getPath)
                        .orElse(null))
                .filter(Objects::nonNull)
                .findFirst()

     * </ul>
     * If the given path points at a directory, the provided {@code ModelLocator} will be used
     * to find the POM file, else if no locator is provided, a file named 'pom.xml' needs to be
     * used by the requested model source.
     *
     * @param locator locator used to locate the pom file
     * @param relPath path of the requested model source relative to this model source POM