/**
 * Factory interface for creating new RequestCache instances.
 * Implementations should handle the creation and configuration of cache instances
 * based on the current Maven session and environment.
 *
 * @since 4.0.0
 * @see RequestCache
 */
@Experimental
public interface RequestCacheFactory {

    /**
     * Creates a new RequestCache instance.

package org.apache.maven.api.services.xml;

import org.apache.maven.api.annotations.Experimental;
import org.apache.maven.api.services.MavenException;

/**
 * An exception thrown while reading an XML file.
 *
 * @since 4.0.0
 */
@Experimental
public class XmlReaderException extends MavenException {

    private final Location location;

    /**
     * @param message the message for the exception

import org.eclipse.sisu.PreDestroy;

import static java.util.Objects.requireNonNull;

/**
 * Maven internal component that bridges container "shut down" to {@link RepositorySystem#shutdown()}.
 *
 * @since 3.9.0
 */
@Named
@EagerSingleton
final class ResolverLifecycle {
    private final Provider<RepositorySystem> repositorySystemProvider;

    @Inject

/**
 * This class models the different Docker base images that are used to build Docker distributions of Elasticsearch.
 */
public enum DockerBase {
    CENTOS("centos:8", ""),

    // "latest" here is intentional, since the image name specifies "8"
    UBI("docker.elastic.co/ubi8/ubi-minimal:latest", "-ubi8"),

    // The Iron Bank base image is UBI (albeit hardened), but we are required to parameterize the Docker build

    - [Source Code](#source-code)
    - [Client Binaries](#client-binaries)
    - [Server Binaries](#server-binaries)
    - [Node Binaries](#node-binaries)
    - [Container Images](#container-images)
  - [Changelog since v1.24.16](#changelog-since-v12416)
  - [Important Security Information](#important-security-information)

 * configuration stored in settings.xml files. These settings control repository access,
 * authentication, proxies, and other Maven runtime behaviors.
 *
 * @since 4.0.0
 */

import org.apache.maven.api.annotations.Experimental;
import org.apache.maven.api.plugin.descriptor.PluginDescriptor;

/**
 * Reads and writes a {@link PluginDescriptor} object to/from XML.
 *
 * @since 4.0.0
 */
@Experimental

package org.apache.maven.api.services.xml;

import org.apache.maven.api.annotations.Experimental;
import org.apache.maven.api.settings.Settings;

/**
 * Reads and writes a {@link Settings} object to/from XML.
 *
 * @since 4.0.0
 */
@Experimental

 * Provides XML-specific services for reading and writing Maven's configuration files
 * and descriptors. These services handle XML parsing, transformation, and serialization
 * while maintaining Maven's model integrity.
 *
 * @since 4.0.0
 */

/**
 * Ensures that expressions referring to URLs evaluate to normalized URLs.
 *
 * @deprecated use {@code org.apache.maven.api.services.ModelBuilder} instead
 */
@Deprecated(since = "4.0.0")
class UrlNormalizingPostProcessor implements InterpolationPostProcessor {

    private static final Set<String> URL_EXPRESSIONS;

    static {
        Set<String> expressions = new HashSet<>();