Interfejs wczytywania, powodzenia i błędu
Przejrzyście obsługuj każdy wynik operacji sieciowej
Interfejs wczytywania, powodzenia i błędu to bezpłatna lekcja Jetpack Compose Academy na CoddyKit. To lekcja 4 z 4. Możesz przeczytać całą lekcję poniżej za darmo — a potem ćwiczyć ją interaktywnie w przeglądarce z wbudowanym edytorem kodu i tutorem AI dostępnym 24/7. To część ścieżki edukacyjnej Jetpack Compose Academy, a Twój postęp synchronizuje się między webem a aplikacją CoddyKit. Kurs Jetpack Compose Academy zawiera 4 lekcji w sumie.
Każde żądanie ma trzy wyniki
Wywołanie sieciowe jest nadal w trakcie loading, zakończyło się danymi albo zakończyło się niepowodzeniem. Dobry ekran pokazuje użytkownikowi rzetelny stan w każdej z tych sytuacji.
Modeluj stan za pomocą sealed class
sealed class przedstawia te wyniki jako odrębne typy, dzięki czemu kompilator wymusza obsługę każdego przypadku w interfejsie.
sealed class UiState {
object Loading : UiState()
data class Success(val users: List<User>) : UiState()
data class Error(val message: String) : UiState()
}Rozpocznij od stanu Loading
Zainicjalizuj stan jako Loading, aby ekran wyświetlił wskaźnik ładowania natychmiast po pojawieniu się, jeszcze zanim nadejdą dane.
var state by mutableStateOf<UiState>(UiState.Loading)Aktualizuj stan po powodzeniu
Gdy wywołanie się zakończy, zmień stan na Success i przekaż pobraną listę. Compose wykona rekompozycję i wyświetli zawartość.
state = UiState.Success(api.getUsers())Aktualizuj stan po błędzie
W bloku catch przejdź do stanu Error i wyświetl przyjazny komunikat, zamiast pozostawiać użytkownika przy samym wskaźniku ładowania.
catch (e: Exception) {
state = UiState.Error("Couldn't load users")
}Rozgałęziaj za pomocą when
W elemencie Composable użyj wyrażenia when dla stanu. Każda gałąź renderuje dokładnie ten interfejs, który odpowiada danemu wynikowi.
when (val s = state) {
is UiState.Loading -> { }
is UiState.Success -> { }
is UiState.Error -> { }
}Pokaż wskaźnik podczas ładowania
W gałęzi ładowania wyśrodkowany CircularProgressIndicator informuje użytkownika, że coś się dzieje. ⏳
is UiState.Loading -> CircularProgressIndicator()Wyświetl dane po powodzeniu
Gałąź powodzenia odczytuje listę i ją wyświetla, zwykle za pomocą LazyColumn, aby długie wyniki można było płynnie przewijać.
is UiState.Success -> UserList(s.users)Zaoferuj ponowienie po błędzie
Gałąź obsługi błędu powinna wyświetlać komunikat oraz przycisk Retry, który ponownie uruchamia funkcję ładowania. Błędy nie powinny prowadzić donikąd.
is UiState.Error -> RetryView(s.message, ::loadUsers)Obsługa pustego przypadku
Pomyślne zakończenie nie zawsze oznacza obecność elementów. Gdy lista jest pusta, należy wyświetlić spokojny stan pusty, a nie pusty ekran.
Jeden stan steruje całym ekranem
Ponieważ jeden obiekt stanu decyduje o wszystkim, interfejs nigdy nie wyświetli jednocześnie wskaźnika ładowania i danych. Dzięki temu pozostaje przewidywalny.
Szybkie sprawdzenie
Dlaczego stan ładowania, powodzenia i błędu warto modelować jako klasę sealed?
Podsumowanie: renderowanie każdego wyniku
Stan został zamodelowany jako klasa sealed, użyto rozgałęzienia with when oraz wyświetlono ładowanie, dane, błędy i puste wyniki. Można teraz wdrożyć solidny ekran korzystający z sieci.
Ucz się Kotlin dzięki korepetycjom AI — za darmo
Pisz i uruchamiaj kod w przeglądarce, otrzymuj natychmiastową pomoc od korepetytora AI dostępnego 24/7 i kontynuuj naukę w sieci lub w aplikacji.
- Kursy
- 30
- Lekcje
- 120
Często zadawane pytania
Czy lekcja „Interfejs wczytywania, powodzenia i błędu” jest bezpłatna?
Tak — pełny tekst „Interfejs wczytywania, powodzenia i błędu” jest dostępny za darmo tutaj w sieci. Aby ćwiczyć ją interaktywnie (wbudowany edytor kodu i tutor AI dostępny 24/7) i odblokować resztę kursu Jetpack Compose Academy, przejdź na CoddyKit PRO. Kurs Jetpack Compose Academy zawiera 4 lekcji w sumie.
Co nauczysz się w „Interfejs wczytywania, powodzenia i błędu”?
Przejrzyście obsługuj każdy wynik operacji sieciowej Ćwiczysz Jetpack Compose Academy z praktycznym kodem, który uruchamiasz bezpośrednio w przeglądarce, a tutor AI dostępny 24/7 odpowiada na Twoje pytania podczas pracy nad lekcją.
Czy potrzebuję doświadczenia, aby zacząć Jetpack Compose Academy?
Nie wymagamy żadnego doświadczenia. Jetpack Compose Academy w CoddyKit jest strukturyzowany dla początkujących i zaawansowanych użytkowników, więc możesz zacząć tutaj lub od początku i uczyć się w swoim tempie. To lekcja 4 z 4.
Ile czasu zajmuje lekcja „Interfejs wczytywania, powodzenia i błędu”?
Większość lekcji CoddyKit trwa około 5–10 minut. Każda lekcja to mały, interaktywny krok, dzięki czemu robisz systematyczne postępy i zawsze wracasz dokładnie do tego samego miejsca — na webie i w aplikacji.
Czy mogę pisać i uruchamiać kod w tej lekcji Jetpack Compose Academy?
Tak. Każda lekcja Jetpack Compose Academy zawiera wbudowany edytor kodu, więc piszesz i uruchamiasz prawdziwy kod bezpośrednio w przeglądarce i od razu otrzymujesz sprzężenie zwrotne od AI — bez konfiguracji na komputerze.
Wszystkie lekcje w tym kursie
- Definiowanie interfejsu API Retrofit
- Parsowanie JSON za pomocą Moshi
- Wywołania suspend w ViewModelu
- Interfejs wczytywania, powodzenia i błędu