utilities.json.kt Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of dokka-core Show documentation

Dokka is an API documentation engine for Kotlin and Java, performing the same function as Javadoc for Java

There is a newer version: 2.0.0

package org.jetbrains.dokka.utilities

import com.fasterxml.jackson.core.JsonGenerator
import com.fasterxml.jackson.databind.DeserializationFeature
import com.fasterxml.jackson.databind.SerializerProvider
import com.fasterxml.jackson.databind.module.SimpleModule
import com.fasterxml.jackson.databind.ser.std.StdScalarSerializer
import com.fasterxml.jackson.module.kotlin.jacksonObjectMapper
import com.fasterxml.jackson.module.kotlin.jacksonTypeRef
import java.io.File
import com.fasterxml.jackson.core.type.TypeReference as JacksonTypeReference

private val objectMapper = run {
    val module = SimpleModule().apply {
        addSerializer(FileSerializer)
    }
    jacksonObjectMapper()
        .registerModule(module)
        .configure(DeserializationFeature.FAIL_ON_UNKNOWN_PROPERTIES, false)
}

@PublishedApi
internal class TypeReference @PublishedApi internal constructor(
    internal val jackson: JacksonTypeReference
) {
    companion object {
        @PublishedApi
        internal inline operator fun  invoke(): TypeReference = TypeReference(jacksonTypeRef())
    }
}

// not used anywhere since at least 1.7.20, but might still be referenced in previously compiled
// inline functions. should be safe to remove after a few major releases.
@PublishedApi
@Deprecated(
    "Left for previously compiled public inline classes, not for use",
    ReplaceWith("serializeAsCompactJson(value)"),
    level = DeprecationLevel.ERROR
)
internal fun toJsonString(value: Any): String = serializeAsCompactJson(value)

internal fun serializeAsCompactJson(value: Any): String =
    objectMapper.writeValueAsString(value)

internal fun serializeAsPrettyJson(value: Any): String =
    objectMapper.writerWithDefaultPrettyPrinter().writeValueAsString(value)

@PublishedApi
internal inline fun  parseJson(json: String): T = parseJson(json, TypeReference())

@PublishedApi
internal fun  parseJson(json: String, typeReference: TypeReference): T =
    objectMapper.readValue(json, typeReference.jackson)


private object FileSerializer : StdScalarSerializer(File::class.java) {
    override fun serialize(value: File, g: JsonGenerator, provider: SerializerProvider) {
        g.writeString(value.path)
    }
}