Membuat class DeepLinkMatcher kustom

Jika pencocok yang disediakan tidak memadai untuk kasus penggunaan Anda, Anda dapat membuat pencocok sendiri dengan memperluas class DeepLinkMatcher.

Saat memperluas DeepLinkMatcher<T, R>, Anda harus menentukan dua argumen jenis: jenis kunci navigasi tujuan (T : Any) dan jenis hasil pencocokan (R : DeepLinkMatcher.MatchResult<T>). Jika pencocok Anda tidak memerlukan peringkat hasil kustom atau metadata tambahan, gunakan DeepLinkMatcher.MatchResult<T> sebagai argumen jenis kedua.

Misalnya, berikut adalah implementasi dasar TelDeepLinkMatcher yang mendukung URI tel (seperti tel:5550100). Karena URI tel bersifat buram, UriDeepLinkMatcher tidak mendukungnya:

class TelDeepLinkMatcher : DeepLinkMatcher<DialerKey, DeepLinkMatcher.MatchResult<DialerKey>>() {
    override fun matchRequest(request: DeepLinkRequest): MatchResult<DialerKey>? {
        val uri = request.uri ?: return null
        if (uri.scheme != "tel") return null

        // Note: schemeSpecificPart is only available on Android
        val phoneNumber = uri.schemeSpecificPart ?: return null
        return MatchResult(DialerKey(phoneNumber = phoneNumber))
    }
}
CustomMatchersSnippets.kt

Menentukan peringkat class MatchResult kustom

Jika ada cara yang bermakna untuk membandingkan hasil pencocokan dari pencocok kustom, Anda harus memperluas DeepLinkMatcher.MatchResult dan mengganti metode compareTo untuk menentukan peringkat hasil.

Saat membuat subclass MatchResult kustom, perbarui deklarasi class pencocok untuk menentukan subclass tersebut sebagai parameter jenis kedua R (seperti class TelDeepLinkMatcher : DeepLinkMatcher<DialerKey, TelMatchResult>()). Hal ini memungkinkan pemanggil mengakses properti hasil kustom tanpa downcasting yang tidak dicentang.

Misalnya, untuk mendukung pencocokan pola karakter pengganti di TelDeepLinkMatcher, Anda dapat menerapkan TelMatchResult untuk memastikan pencocokan persis diberi peringkat lebih tinggi daripada pencocokan karakter pengganti. Jika pencocok dienkapsulasi dalam withBackStack, hapus enkapsulasi WrappedMatchResult sebelum membandingkan sehingga prioritas dievaluasi terhadap hasil pencocokan yang mendasarinya:

class TelMatchResult(
    key: DialerKey,
    val isExactMatch: Boolean,
    val patternLength: Int
) : DeepLinkMatcher.MatchResult<DialerKey>(key) {
    override fun compareTo(other: DeepLinkMatcher.MatchResult<DialerKey>): Int {
        // Unwrap if the other result is wrapped in a BackStackMatchResult or custom WrappedMatchResult
        val target = if (other is WrappedMatchResult<*>) other.matchResult else other
        if (target !is TelMatchResult) {
            // Determine precedence relative to other MatchResult types (e.g. UriMatchResult)
            return 1
        }

        // An exact match wins over a wildcard/prefix match
        if (isExactMatch && !target.isExactMatch) return 1
        if (!isExactMatch && target.isExactMatch) return -1

        // The more specific (longer) pattern wins (e.g., tel:1800* versus tel:*)
        val lengthDiff = this.patternLength - target.patternLength
        if (lengthDiff != 0) {
            return lengthDiff
        }

        return 0
    }
}
CustomMatchersSnippets.kt