kotlin 的官方序列化庫,通過自動(dòng)生成代碼來避免反射。只需要在 kotlin 類上標(biāo)記 @serializable注解就可以,內(nèi)置標(biāo)準(zhǔn)集合的序列化方法。 支持 JSON,CBOR, Protobuf格式
提供的注解
-
@Serializable注解 用于標(biāo)記kotlin的類,為類生成序列化serializer方法。 -
@Optional注解 用于標(biāo)記屬性參數(shù),被標(biāo)記的屬性需要提供默認(rèn)數(shù)據(jù)??蛇x參數(shù),如果序列化數(shù)據(jù)中有就使用數(shù)據(jù)提供的,沒用就使用默認(rèn)的 -
@Serialname注解 用于標(biāo)記屬性參數(shù),重新定義序列化時(shí)的參數(shù)名 -
@Transient注解 用于標(biāo)記屬性參數(shù), 被標(biāo)記的參數(shù)不參與序列化
JSON 參數(shù)
JSON 類的定義:
class JSON(
private val unquoted: Boolean = false,
private val indented: Boolean = false,
private val indent: String = " ",
internal val strictMode: Boolean = true,
val updateMode: UpdateMode = UpdateMode.OVERWRITE,
val encodeDefaults: Boolean = true
): ......
- unquoted 參數(shù): 無引號(hào)模式,無符號(hào)模式下 序列化過程中key值和value值是沒有引號(hào)包圍的如:
"{a:1}"[一般用于測(cè)試] - indented 是否縮進(jìn): 用于多行 JSON 輸出模式
- indent 縮進(jìn)字符: 換行縮進(jìn)字符
- strictMode 參數(shù): 嚴(yán)格模式下, JSON 轉(zhuǎn)化過程不允許有類中沒有規(guī)定的key值,類序列化過程不允許 NaN 和 無盡浮點(diǎn)數(shù)
- updateMode 參數(shù): 更新模式[針對(duì)集合],
BANNED禁止出現(xiàn)重復(fù),OVERWRITE覆蓋數(shù)據(jù),UPDATE合并
內(nèi)置對(duì)象 JSON.plain, JSON.indented, JSON.nonstrict ,JSON.unquoted
val plain = JSON()
val unquoted = JSON(unquoted = true)
val indented = JSON(indented = true)
val nonstrict = JSON(strictMode = false)
使用方式
import kotlinx.serialization.Optional
import kotlinx.serialization.SerialName
import kotlinx.serialization.Serializable
import kotlinx.serialization.Transient
import kotlinx.serialization.json.JSON
import kotlinx.serialization.list
import org.junit.Test
class SerializeTest {
@Serializable
data class Data(val a: Int, @Optional val b: String = "er", @Transient val c: Int = 5, @SerialName("d") val dd: Float = 7.1f)
@Test fun testSerialize(){
System.out.println(JSON.stringify(Data.serializer(), Data(42)))
System.out.println(JSON.indented.stringify(Data.serializer().list, listOf(Data(42))))
val obj = JSON.unquoted.parse(Data.serializer(), "{a:2, d: 3.4}")
System.out.print(obj)
/*
{"a":42,"b":"er","d":7.1} // 默認(rèn)格式
[
{
"a": 42,
"b": "er",
"d": 7.1
}
]// 縮進(jìn)格式
Data(a=2, b=er, c=5, dd=3.4)
*/
}
}