Experimental Java analysis using SymbolsTranslator

[yuriioliinyk4]

Partially implements #4246

New experimental flag org.jetbrains.dokka.analysis.enableExperimentalSymbolsJavaAnalysis is introduced to analyze java using SymbolsTranslator instead of PsiTranslator.

There are ~60 unit tests left that are failing under new experimental flag. Most of them are related to problems with annotations, type conversion in AA (e.g. java's Object become kotlin's Any, int[] into IntArray, etc), modifiers.

[whyoleg]

BTW, @AbdullinAM, I think it might make sense to convert the current logic regarding new KDoc resolution based on org.jetbrains.dokka.analysis.enableExperimentalKDocResolution to also use this approach, to check all tests with new resolution, and not just some of them, to be sure, that we will be able to safely enable the flag by default (#4425)

---

Also, for both those flags, we might want to support enabling them for IT, like we do for K2 -

dokka/build-logic/src/main/kotlin/dokkabuild.test-integration.gradle.kts

Lines 38 to 43 in c4a33d3

	val useK2 = dokkaBuild.integrationTestUseK2
	systemProperty.inputProperty("org.jetbrains.dokka.experimental.tryK2", useK2)
	.optional(true)
	useJUnitPlatform {
	if (useK2.get()) excludeTags("onlyDescriptors", "onlyDescriptorsMPP")
	}

[AbdullinAM]

Makes sense, I will create a PR

[whyoleg]

Nice!
Now, we need to rebase it and support a lot of tests :)

SO MUCH CODE we will be able to remove after this and K1 removal...

[vmishenev]

@yuriioliinyk4 Could you resolve merge conflicts, please?

[yuriioliinyk4]

I resolved conflicts, review pls last 3 commits.

Note that there are few failing tests outside the plugin-base ( @OnlyJavaPsi cant be applied to those tests because it is defined in the plugin-base)

> Task :dokka-subprojects:plugin-javadoc:testJavaSymbols

JavadocDeprecatedTest > should be sorted by position() FAILED
    org.opentest4j.AssertionFailedError at JavadocDeprecatedTest.kt:181

JavadocDeprecatedTest > finds correct number of element for removal() FAILED
    java.util.NoSuchElementException at JavadocDeprecatedTest.kt:195

JavadocDeprecatedTest > generates correct number of sections() FAILED
    org.opentest4j.AssertionFailedError at JavadocDeprecatedTest.kt:181

JavadocClasslikeTemplateMapTest > documented function parameters() FAILED
    java.lang.AssertionError at JavadocClasslikeTemplateMapTest.kt:242
        Caused by: org.opentest4j.AssertionFailedError at JavadocClasslikeTemplateMapTest.kt:476
        
> Task :dokka-subprojects:plugin-kotlin-as-java:testJavaSymbols

KotlinAsJavaPluginTest > Java function should keep its access modifier() FAILED
    java.lang.AssertionError at KotlinAsJavaPluginTest.kt:506

KotlinAsJavaPluginTest > java properties should keep its modifiers() FAILED
    java.lang.AssertionError at KotlinAsJavaPluginTest.kt:215

[vmishenev]

@OnlyJavaPsi cant be applied to those tests because it is defined in the plugin-base

Can you duplicate this annotation in kotlin-as-java and other plugins?