Parcelable 實作產生器

kotlin-parcelize 外掛程式 提供了 Parcelable 實作產生器。

如要納入 Parcelable 支援功能,請將 Gradle 外掛程式加入應用程式的 build.gradle 檔案:

Groovy

plugins {
    id 'kotlin-parcelize'
}

Kotlin

plugins {
    id("kotlin-parcelize")
}

使用 @Parcelize 為類別加註時,系統會自動產生 Parcelable 實作項目,如以下範例所示:

import kotlinx.parcelize.Parcelize

@Parcelize
class User(val firstName: String, val lastName: String, val age: Int): Parcelable

@Parcelize 要求在主要建構函式中宣告所有序列化後的屬性。外掛程式會針對每項屬性發出警示,並在類別主體中宣告支援欄位。如果某些主要建構函式參數不是屬性,則無法套用 @Parcelize

如果您的類別需要更進階的序列化邏輯,請將它寫入夥伴類別:

@Parcelize
data class User(val firstName: String, val lastName: String, val age: Int) : Parcelable {
    private companion object : Parceler<User> {
        override fun User.write(parcel: Parcel, flags: Int) {
            // Custom write implementation
        }

        override fun create(parcel: Parcel): User {
            // Custom read implementation
        }
    }
}

支援的類型

@Parcelize 支援眾多類型:

  • 原始類型 (及其方塊化版本)
  • 物件和列舉
  • StringCharSequence
  • Duration
  • Exception
  • SizeSizeFBundleIBinderIInterfaceFileDescriptor
  • SparseArraySparseIntArraySparseLongArraySparseBooleanArray
  • 所有 Serializable (包括Date) 和Parcelable實作項目
  • 所有支援類型的集合:List (對應至 ArrayList)、Set (對應至 LinkedHashSet)、Map (對應至 LinkedHashMap)
    • 還有許多具體實作項目:ArrayListLinkedListSortedSetNavigableSetHashSetLinkedHashSetTreeSetSortedMapNavigableMapHashMapLinkedHashMapTreeMapConcurrentHashMap
  • 所有支援類型的陣列
  • 所有支援類型的可為空值版本

自訂 Parceler

如果系統未直接支援您的類型,您可以為該類型編寫 Parceler 對應物件。

class ExternalClass(val value: Int)

object ExternalClassParceler : Parceler<ExternalClass> {
    override fun create(parcel: Parcel) = ExternalClass(parcel.readInt())

    override fun ExternalClass.write(parcel: Parcel, flags: Int) {
        parcel.writeInt(value)
    }
}

您可以使用 @TypeParceler@WriteWith 註解來套用外部 parceler:

// Class-local parceler
@Parcelize
@TypeParceler<ExternalClass, ExternalClassParceler>()
class MyClass(val external: ExternalClass) : Parcelable

// Property-local parceler
@Parcelize
class MyClass(@TypeParceler<ExternalClass, ExternalClassParceler>() val external: ExternalClass) : Parcelable

// Type-local parceler
@Parcelize
class MyClass(val external: @WriteWith<ExternalClassParceler>() ExternalClass) : Parcelable

略過序列化屬性

如果您想略過某些屬性,使其略過 parcel 處理,請使用 @IgnoredOnParcel 註解。也可以用在 類別的主體,以便忽略屬性未序列化的警告。 使用 @IgnoredOnParcel 註解的建構函式屬性必須具有預設值 值。

@Parcelize
class MyClass(
    val include: String,
    // Don't serialize this property
    @IgnoredOnParcel val ignore: String = "default"
): Parcelable {
    // Silence a warning
    @IgnoredOnParcel
    val computed: String = include + ignore
}

使用 android.os.Parcel.writeValue 序列化屬性

您可以使用 @RawValue 為類型加上註解,以使用 Parcelize 該資源的 Parcel.writeValue

@Parcelize
class MyClass(val external: @RawValue ExternalClass): Parcelable

如果屬性的值並非屬性值,則在執行階段可能會失敗

在沒有其他註解的情況下,Parcelize 可能也需要您使用 將屬性序列化。

運用密封類別和密封介面進行剖析

Parcelize 需要一個類別以包裹處理,而非抽象。這項限制 不會保留密封類別在 @Parcelize 註解上使用 密封類別,不需要針對衍生類別重複上述步驟。

@Parcelize
sealed class SealedClass: Parcelable {
    class A(val a: String): SealedClass()
    class B(val b: Int): SealedClass()
}

@Parcelize
class MyClass(val a: SealedClass.A, val b: SealedClass.B, val c: SealedClass): Parcelable

意見回饋

如果您在使用 kotlin-parcelize Gradle 外掛程式時遇到任何問題,可以回報錯誤