import javax.annotation.Nullable;

/**
 * Represents the PMD targetjdk property available for PMD < 5.0
 */
public enum TargetJdk {
    VERSION_1_3,
    VERSION_1_4,
    VERSION_1_5,
    VERSION_1_6,
    VERSION_1_7,
    VERSION_JSP;

    /**
     * Converts the given object into a {@code TargetJdk}.
     *
     * @param value An object whose toString() value is to be converted. May be null.

        TargetJdk.toVersion("1.3") == TargetJdk.VERSION_1_3
        TargetJdk.toVersion("1.4") == TargetJdk.VERSION_1_4
        TargetJdk.toVersion("1.5") == TargetJdk.VERSION_1_5
        TargetJdk.toVersion("1.6") == TargetJdk.VERSION_1_6
        TargetJdk.toVersion("1.7") == TargetJdk.VERSION_1_7
        TargetJdk.toVersion("jsp") == TargetJdk.VERSION_JSP
        TargetJdk.toVersion("JSP") == TargetJdk.VERSION_JSP
    }

     */
    public TargetJdk getTargetJdk() {
        return targetJdk;
    }

    /**
     * Sets the target jdk used with pmd.
     *
     * @param targetJdk The target jdk
     * @since 4.0
     */
    public void setTargetJdk(TargetJdk targetJdk) {
        this.targetJdk = targetJdk;
    }

    /**

            configureJavaPluginToolchainVersion(selectJdk(withJavaExtension))
        }

        def targetJdk = selectJdk(target)

        when:
        withInstallations(currentJdk, otherJdk).run(":test", "--info")

        then:
        executedAndNotSkipped(":test")
        outputContains("Tests running with ${targetJdk.javaHome.absolutePath}")

        where:

            <tr>
                <td>consoleOutput</td>
                <td><literal>project.pmd.consoleOutput</literal></td>
            </tr>
            <tr>
                <td>targetJdk</td>
                <td><literal>project.pmd.targetJdk</literal></td>
            </tr>
            <tr>
                <td>source</td>
                <td><literal><replaceable>sourceSet</replaceable>.allJava</literal></td>
            </tr>

            configureJavaPluginToolchainVersion(selectJdk(withJavaExtension))
        }

        def targetJdk = selectJdk(target)

        when:
        withInstallations(currentJdk, otherJdk).run(":run")

        then:
        executedAndNotSkipped(":run")
        outputContains("App running with ${targetJdk.javaHome.absolutePath}")

        where:

            configureJavaPluginToolchainVersion(selectJdk(withJavaExtension))
        }

        def targetJdk = selectJdk(target)

        when:
        withInstallations(currentJdk, otherJdk).run(":javadoc")

        then:
        executedAndNotSkipped(":javadoc")
        errorOutput.contains(targetJdk.javaVersion.toString())

        where:

import org.gradle.api.plugins.quality.TargetJdk;
import org.gradle.api.provider.ListProperty;
import org.gradle.api.provider.Property;

/**
 * Parameters used to configure a {@link PmdAction}.
 */
public interface PmdActionParameters extends AntWorkParameters {

    ConfigurableFileCollection getPmdClasspath();

    Property<TargetJdk> getTargetJdk();

    ListProperty<String> getRuleSets();

                pmdClasspath = pmdFileCollection
                ruleSetFiles = files()
                ruleSets = ["category/java/errorprone.xml"]
                rulesMinimumPriority = 5
                targetJdk = TargetJdk.VERSION_1_4
                threads = 1
                incrementalAnalysis = false
            }
        """

        when:
        succeeds("myPmd")

        then:

            </tr>
            <tr>
                <td>ruleSetFiles</td>
                <td><literal>[]</literal></td>
            </tr>
            <tr>
                <td>targetJdk</td>
                <td><literal>project.sourceCompatibility</literal></td>
            </tr>
            <tr>
                <td>ignoreFailures</td>
                <td><literal>false</literal></td>
            </tr>