Kotlin Multiplatform Academy · Lekcja

Ukrywanie API za repozytorium

Ukrywanie Ktor i serializacji przed kodem wywołującym

Lekcja 2 z 413 kroki

Ukrywanie API za repozytorium to bezpłatna lekcja Kotlin Multiplatform Academy na CoddyKit. To lekcja 2 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 Kotlin Multiplatform Academy, a Twój postęp synchronizuje się między webem a aplikacją CoddyKit. Kurs Kotlin Multiplatform Academy zawiera 4 lekcji w sumie.

Teraz zbuduj właściwą implementację

Po przygotowaniu interfejsu należy napisać konkretną implementation, która w tle rzeczywiście pobiera dane.

Zaimplementuj interfejs

Należy utworzyć klasę, która używa implements repository interface i zobowiązuje się zrealizować każdą zadeklarowaną przez niego metodę.

class UserRepositoryImpl : UserRepository

Wstrzyknij klienta Ktor

Należy przekazać HttpClient do konstruktora zamiast tworzyć go wewnątrz klasy, aby można było go współdzielić i zastępować podczas testów.

class UserRepositoryImpl(private val client: HttpClient) : UserRepository

Ukryj wywołanie sieciowe

W każdej metodzie należy wykonać żądanie Ktor i zwrócić wynik. Kod wywołujący widzi czyste dane, a nie samo request.

override suspend fun getUsers() = client.get(url).body<List<User>>()

Trzymaj adresy URL wewnątrz

Adresy bazowe i ścieżki należy przechowywać w implementacji. Reszta aplikacji może pozostać całkowicie nieświadoma istnienia jakiegokolwiek endpoint.

Jedno miejsce do zmiany

Jeśli ścieżka API się zmieni, edytują Państwo tylko tę klasę. Interfejs i wszyscy wywołujący pozostają untouched.

Serialization pozostaje ukryte

Wywołanie body zamienia tutaj JSON na modele, dzięki czemu serialization nigdy nie przedostaje się do warstwy interfejsu użytkownika.

val user: User = client.get(url).body()

Ten sam kod w obu aplikacjach

Ta implementacja znajduje się w commonMain, więc same code obsługuje pobieranie danych w Androidzie i iOS w identyczny sposób.

Zamieniaj bez naruszania kodu wywołującego

Ponieważ implementacja spełnia wymagania interfejsu, można później zastąpić ją wersją z cache’em, a żaden kod wywołujący nie wymaga changes.

Połącz za pomocą DI

Konfiguracja dependency injection przekazuje kodowi wywołującemu tę implementację za pośrednictwem typu interface, utrzymując luźne powiązanie elementów.

single<UserRepository> { UserRepositoryImpl(get()) }

Pełna warstwa pośrednia

Oto kompletny wrapper: przyjmuje klienta, ukrywa żądanie i zwraca zwykłe modele domenowe.

class UserRepositoryImpl(
    private val client: HttpClient
) : UserRepository {
    override suspend fun getUsers() =
        client.get("/users").body<List<User>>()
}

Szybkie sprawdzenie

Jakie jest główne zadanie implementacji repository?

Podsumowanie

Implementation przyjmuje HttpClient, wykonuje żądanie i zwraca modele domenowe, całkowicie odgradzając kod wywołujący od obsługi sieci.

Bezpłatny start

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 „Ukrywanie API za repozytorium” jest bezpłatna?

Tak — pełny tekst „Ukrywanie API za repozytorium” 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 Kotlin Multiplatform Academy, przejdź na CoddyKit PRO. Kurs Kotlin Multiplatform Academy zawiera 4 lekcji w sumie.

Co nauczysz się w „Ukrywanie API za repozytorium”?

Ukrywanie Ktor i serializacji przed kodem wywołującym Ćwiczysz Kotlin Multiplatform 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ąć Kotlin Multiplatform Academy?

Nie wymagamy żadnego doświadczenia. Kotlin Multiplatform 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 2 z 4.

Ile czasu zajmuje lekcja „Ukrywanie API za repozytorium”?

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 Kotlin Multiplatform Academy?

Tak. Każda lekcja Kotlin Multiplatform 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

  1. Definiowanie interfejsu repozytorium
  2. Ukrywanie API za repozytorium
  3. Mapowanie DTO na modele domenowe
  4. Udostępnianie wyników jako Flow
← Powrót do Kotlin Multiplatform Academy