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
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
|
/*
* Copyright 2017-2020 JetBrains s.r.o. Use of this source code is governed by the Apache 2.0 license.
*/
package kotlinx.serialization.encoding
import kotlinx.serialization.*
import kotlinx.serialization.descriptors.*
import kotlinx.serialization.modules.*
import kotlinx.serialization.internal.*
/**
* A skeleton implementation of both [Encoder] and [CompositeEncoder] that can be used
* for simple formats and for testability purpose.
* Most of the `encode*` methods have default implementation that delegates `encodeValue(value: Any)`.
* See [Encoder] documentation for information about each particular `encode*` method.
*/
@ExperimentalSerializationApi
public abstract class AbstractEncoder : Encoder, CompositeEncoder {
override fun beginStructure(descriptor: SerialDescriptor): CompositeEncoder = this
override fun endStructure(descriptor: SerialDescriptor) {}
/**
* Invoked before writing an element that is part of the structure to determine whether it should be encoded.
* Element information can be obtained from the [descriptor] by the given [index].
*
* @return `true` if the value should be encoded, false otherwise
*/
public open fun encodeElement(descriptor: SerialDescriptor, index: Int): Boolean = true
/**
* Invoked to encode a value when specialized `encode*` method was not overridden.
*/
public open fun encodeValue(value: Any): Unit =
throw SerializationException("Non-serializable ${value::class} is not supported by ${this::class} encoder")
override fun encodeNull() {
throw SerializationException("'null' is not supported by default")
}
override fun encodeBoolean(value: Boolean): Unit = encodeValue(value)
override fun encodeByte(value: Byte): Unit = encodeValue(value)
override fun encodeShort(value: Short): Unit = encodeValue(value)
override fun encodeInt(value: Int): Unit = encodeValue(value)
override fun encodeLong(value: Long): Unit = encodeValue(value)
override fun encodeFloat(value: Float): Unit = encodeValue(value)
override fun encodeDouble(value: Double): Unit = encodeValue(value)
override fun encodeChar(value: Char): Unit = encodeValue(value)
override fun encodeString(value: String): Unit = encodeValue(value)
override fun encodeEnum(enumDescriptor: SerialDescriptor, index: Int): Unit = encodeValue(index)
override fun encodeInline(inlineDescriptor: SerialDescriptor): Encoder = this
// Delegating implementation of CompositeEncoder
final override fun encodeBooleanElement(descriptor: SerialDescriptor, index: Int, value: Boolean) { if (encodeElement(descriptor, index)) encodeBoolean(value) }
final override fun encodeByteElement(descriptor: SerialDescriptor, index: Int, value: Byte) { if (encodeElement(descriptor, index)) encodeByte(value) }
final override fun encodeShortElement(descriptor: SerialDescriptor, index: Int, value: Short) { if (encodeElement(descriptor, index)) encodeShort(value) }
final override fun encodeIntElement(descriptor: SerialDescriptor, index: Int, value: Int) { if (encodeElement(descriptor, index)) encodeInt(value) }
final override fun encodeLongElement(descriptor: SerialDescriptor, index: Int, value: Long) { if (encodeElement(descriptor, index)) encodeLong(value) }
final override fun encodeFloatElement(descriptor: SerialDescriptor, index: Int, value: Float) { if (encodeElement(descriptor, index)) encodeFloat(value) }
final override fun encodeDoubleElement(descriptor: SerialDescriptor, index: Int, value: Double) { if (encodeElement(descriptor, index)) encodeDouble(value) }
final override fun encodeCharElement(descriptor: SerialDescriptor, index: Int, value: Char) { if (encodeElement(descriptor, index)) encodeChar(value) }
final override fun encodeStringElement(descriptor: SerialDescriptor, index: Int, value: String) { if (encodeElement(descriptor, index)) encodeString(value) }
final override fun encodeInlineElement(
descriptor: SerialDescriptor,
index: Int
): Encoder =
if (encodeElement(descriptor, index)) encodeInline(descriptor.getElementDescriptor(index)) else NoOpEncoder
override fun <T : Any?> encodeSerializableElement(
descriptor: SerialDescriptor,
index: Int,
serializer: SerializationStrategy<T>,
value: T
) {
if (encodeElement(descriptor, index))
encodeSerializableValue(serializer, value)
}
override fun <T : Any> encodeNullableSerializableElement(
descriptor: SerialDescriptor,
index: Int,
serializer: SerializationStrategy<T>,
value: T?
) {
if (encodeElement(descriptor, index))
encodeNullableSerializableValue(serializer, value)
}
}
|