core/at.asitplus.awesn1.serialization/Asn1Serializable

Asn1Serializable

interface Asn1Serializable<A : Asn1Element, T : Asn1Encodable<A>> : Asn1Decodable<A, T> , KSerializer<T> (source)

ASN.1-specific serializer providing kotlinx-serialization support. Implement this on companion objects of classes implementing Asn1Encodable and set it as the Asn1Encodable's serializer to get full kotlinx-serialization support!

Inheritors

Companion

Asn1Utf8StringSerializer

Asn1VisibleStringSerializer

Asn1Ia5StringSerializer

Asn1PrintableStringSerializer

Asn1NumericStringSerializer

Asn1Serializer

Properties

descriptor

open override val descriptor: SerialDescriptor

leadingTags

abstract val leadingTags: Set<Asn1Element.Tag>

Leading ASN.1 tags this serializer can decode/encode.

Functions

decodeFromDer

fun <A : Asn1Element, T : Asn1Encodable<A>> Asn1Decodable<A, T>.decodeFromDer(src: ByteArray, limit: Long = src.size.toLong(), assertTag: Asn1Element.Tag? = null): T

Convenience method, directly DER-decoding a byte array to T

fun <A : Asn1Element, T : Asn1Encodable<A>> Asn1Decodable<A, T>.decodeFromDer(src: Source<*>, limit: Long?, assertTag: Asn1Element.Tag? = null): T

Decodes src as DER using this Asn1Decodable.

decodeFromDerOrNull

fun <A : Asn1Element, T : Asn1Encodable<A>> Asn1Decodable<A, T>.decodeFromDerOrNull(src: ByteArray, limit: Long = src.size.toLong(), assertTag: Asn1Element.Tag? = null): T?

Exception-free version of decodeFromDer

decodeFromTlv

open fun decodeFromTlv(src: A, assertTag: Asn1Element.Tag? = null): T

Processes an A, parsing it into an instance of T

decodeFromTlvOrNull

fun <A : Asn1Element, T : Asn1Encodable<A>> Asn1Decodable<A, T>.decodeFromTlvOrNull(src: A, assertTag: Asn1Element.Tag? = null): T?

Exception-free version of Asn1Decodable.decodeFromTlv

deserialize

open override fun deserialize(decoder: Decoder): T

Decodes one ASN.1-backed value via DER bytes.

doDecode

abstract fun doDecode(src: A): T

Actual element-specific decoding function. By default, this is invoked after verifyTag

parseFromDerHexString

fun <A : Asn1Element, T : Asn1Encodable<A>> Asn1Decodable<A, T>.parseFromDerHexString(derEncoded: String): T

fun <A : Asn1Element, T : Asn1Encodable<A>> Asn1Decodable<A, T>.parseFromDerHexString(derEncoded: String, limit: Long): T

Convenience method to directly parse a HEX-string representation of DER-encoded data. Ignores and strips all whitespace.

serialize

open override fun serialize(encoder: Encoder, value: T)

Encodes one ASN.1-backed value via DER bytes.

verifyTag

open fun verifyTag(src: A, assertTag: Asn1Element.Tag?)

Specify assertTag for verifying implicitly tagged elements' tags (and better not override this function).