blob: b5dc47a3bdb33cfdfe367b8166fb9693255246a8 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
|
package org.jetbrains.dokka
import com.google.inject.Inject
import com.intellij.psi.JavaPsiFacade
import com.intellij.psi.PsiClass
import com.intellij.psi.PsiNamedElement
import org.jetbrains.dokka.Kotlin.DescriptorDocumentationParser
import org.jetbrains.kotlin.asJava.KotlinLightElement
import org.jetbrains.kotlin.descriptors.DeclarationDescriptor
import org.jetbrains.kotlin.lexer.KtTokens
import org.jetbrains.kotlin.name.FqName
import org.jetbrains.kotlin.psi.KtDeclaration
import org.jetbrains.kotlin.psi.KtParameter
import org.jetbrains.kotlin.psi.KtPropertyAccessor
class KotlinAsJavaDocumentationBuilder
@Inject constructor(val kotlinAsJavaDocumentationParser: KotlinAsJavaDocumentationParser) : PackageDocumentationBuilder
{
override fun buildPackageDocumentation(documentationBuilder: DocumentationBuilder,
packageName: FqName,
packageNode: DocumentationNode,
declarations: List<DeclarationDescriptor>) {
val project = documentationBuilder.resolutionFacade.project
val psiPackage = JavaPsiFacade.getInstance(project).findPackage(packageName.asString())
if (psiPackage == null) {
documentationBuilder.logger.error("Cannot find Java package by qualified name: ${packageName.asString()}")
return
}
val javaDocumentationBuilder = JavaPsiDocumentationBuilder(documentationBuilder.options,
documentationBuilder.refGraph,
kotlinAsJavaDocumentationParser)
psiPackage.classes.filter { it is KotlinLightElement<*, *> }.filter { it.isVisibleInDocumentation() }.forEach {
javaDocumentationBuilder.appendClasses(packageNode, arrayOf(it))
}
}
fun PsiClass.isVisibleInDocumentation() : Boolean {
val origin: KtDeclaration? = (this as KotlinLightElement<*, *>).getOrigin()
return origin?.hasModifier(KtTokens.INTERNAL_KEYWORD) != true &&
origin?.hasModifier(KtTokens.PRIVATE_KEYWORD) != true
}
}
class KotlinAsJavaDocumentationParser
@Inject constructor(val resolutionFacade: DokkaResolutionFacade,
val descriptorDocumentationParser: DescriptorDocumentationParser) : JavaDocumentationParser
{
override fun parseDocumentation(element: PsiNamedElement): JavadocParseResult {
val kotlinLightElement = element as? KotlinLightElement<*, *> ?: return JavadocParseResult.Empty
val origin = kotlinLightElement.getOrigin() ?: return JavadocParseResult.Empty
if (origin is KtParameter) {
// LazyDeclarationResolver does not support setter parameters
val grandFather = origin.parent?.parent
if (grandFather is KtPropertyAccessor) {
return JavadocParseResult.Empty
}
}
val descriptor = resolutionFacade.resolveToDescriptor(origin)
val content = descriptorDocumentationParser.parseDocumentation(descriptor)
return JavadocParseResult(content, null)
}
}
|
