Tworzenie niestandardowych klas DeepLinkMatcher

Jeśli dostępne dopasowania nie są wystarczające w Twoim przypadku, możesz utworzyć własne, rozszerzając klasę DeepLinkMatcher.

Podczas rozszerzania klasy DeepLinkMatcher<T, R> musisz podać 2 argumenty typu: typ klucza nawigacji docelowej (T : Any) i typ wyniku dopasowania (R : DeepLinkMatcher.MatchResult<T>). Jeśli Twój dopasowujący nie potrzebuje niestandardowego rankingu wyników ani dodatkowych metadanych, jako drugi argument typu użyj DeepLinkMatcher.MatchResult<T>.

Oto przykładowa podstawowa implementacja TelDeepLinkMatcher, która obsługuje identyfikatory URI tel (takie jak tel:5550100). Identyfikatory URI tel są nieprzezroczyste, więc UriDeepLinkMatcher ich nie obsługuje:

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

Klasyfikowanie niestandardowych klas (MatchResult)

Jeśli istnieje sensowny sposób porównywania wyników dopasowania z niestandardowego dopasowania, rozszerz klasę DeepLinkMatcher.MatchResult i zastąp metodę compareTo, aby oceniać wyniki.

Gdy tworzysz niestandardową podklasę MatchResult, zaktualizuj deklarację klasy dopasowania, aby określić tę podklasę jako drugi parametr typu R (np. class TelDeepLinkMatcher : DeepLinkMatcher<DialerKey, TelMatchResult>()). Dzięki temu wywołujący będą mogli uzyskać dostęp do niestandardowych właściwości wyników bez niesprawdzonego rzutowania w dół.

Na przykład, aby obsługiwać dopasowywanie wzorców z symbolami wieloznacznymi w TelDeepLinkMatcher, możesz wdrożyć TelMatchResult, aby dopasowania ścisłe miały wyższą pozycję niż dopasowania z symbolami wieloznacznymi. Jeśli dopasowanie jest ujęte w withBackStack, przed porównaniem usuń WrappedMatchResult, aby pierwszeństwo było oceniane na podstawie wyniku dopasowania:

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