* <p>
 * Usage of invalid instances of {@code JavaToolchainSpec} is deprecated and will be removed in the future versions of Gradle.
 *
 * @since 6.7
 */
@HasInternalProtocol
public interface JavaToolchainSpec extends Describable {

    /**
     * The exact version of the Java language that the toolchain is required to support.
     */

     *
     * @param spec The {@code JavaToolchainSpec}
     * @return A {@code Provider<JavaLauncher>}
     */
    Provider<JavaLauncher> launcherFor(JavaToolchainSpec spec);

    /**
     * Obtain a {@link JavadocTool} matching the {@link JavaToolchainSpec}, as configured by the provided action.
     *
     * @param config The configuration of the {@code JavaToolchainSpec}

        cache.getDownloadLocation() >> temporaryFolder
        cache.provisionFromArchive(_ as JavaToolchainSpec, _ as File, _ as URI) >> new File(temporaryFolder, "install_dir")
    }

    def "cache is properly locked around provisioning a jdk"() {
        def spec = Mock(JavaToolchainSpec)

        def providerFactory = createProviderFactory("true")


        given:

        this.eventEmitter = eventEmitter;
    }

    @Override
    public Provider<JavaCompiler> compilerFor(Action<? super JavaToolchainSpec> config) {
        return compilerFor(configureToolchainSpec(config));
    }

    @Override
    public Provider<JavaCompiler> compilerFor(JavaToolchainSpec spec) {
        return queryService.findMatchingToolchain(spec)

 */

package org.gradle.jvm.toolchain.internal.install;

import org.gradle.jvm.toolchain.JavaToolchainSpec;
import org.gradle.jvm.toolchain.internal.ToolchainDownloadFailedException;

import java.io.File;

public interface JavaToolchainProvisioningService {

    File tryInstall(JavaToolchainSpec spec) throws ToolchainDownloadFailedException;

    boolean isAutoDownloadEnabled();

import org.gradle.api.GradleException;
import org.gradle.internal.exceptions.Contextual;
import org.gradle.jvm.toolchain.JavaToolchainSpec;
import org.gradle.platform.BuildPlatform;

@Contextual
public class NoToolchainAvailableException extends GradleException {

    public NoToolchainAvailableException(
        JavaToolchainSpec specification,
        BuildPlatform buildPlatform,
        ToolchainDownloadFailedException cause
    ) {

import org.gradle.jvm.toolchain.JavaToolchainRequest;
import org.gradle.jvm.toolchain.JavaToolchainSpec;

public class DefaultJavaToolchainRequest implements JavaToolchainRequest {

    private final JavaToolchainSpec spec;

    private final BuildPlatform buildPlatform;

    public DefaultJavaToolchainRequest(JavaToolchainSpec spec, BuildPlatform buildPlatform) {
        this.spec = spec;

import org.gradle.jvm.toolchain.JavaLanguageVersion;
import org.gradle.jvm.toolchain.JavaToolchainSpec;

public class JavaToolchainInput {

    private final JavaLanguageVersion javaLanguageVersion;
    private final String vendor;
    private final String implementation;

    public JavaToolchainInput(JavaToolchainSpec spec) {
        this.javaLanguageVersion = spec.getLanguageVersion().getOrNull();

import org.gradle.internal.jvm.inspection.JvmMetadataDetector;
import org.gradle.internal.service.scopes.Scope;
import org.gradle.internal.service.scopes.ServiceScope;
import org.gradle.jvm.toolchain.JavaToolchainSpec;
import org.gradle.jvm.toolchain.internal.install.JavaToolchainProvisioningService;
import org.gradle.platform.BuildPlatform;

import javax.inject.Inject;
import java.io.File;
import java.util.Comparator;

        implementationProperty.get() >> JvmImplementation.J9

        Property<JvmVendorSpec> vendorProperty = Mock(Property.class)
        vendorProperty.get() >> JvmVendorSpec.IBM

        JavaToolchainSpec spec = Mock(JavaToolchainSpec)
        spec.getLanguageVersion() >> javaLanguageVersionProperty
        spec.getImplementation() >> implementationProperty
        spec.getVendor() >> vendorProperty