Jetpack Compose Academy · Pelajaran

Mentakrifkan Antara Muka API Retrofit

Isytiharkan titik akhir dengan anotasi.

Pelajaran 1 daripada 413 langkah

Mentakrifkan Antara Muka API Retrofit ialah pelajaran Jetpack Compose Academy percuma di CoddyKit. Ini ialah pelajaran 1 daripada 4. Anda boleh membaca keseluruhan pelajaran di bawah secara percuma — kemudian berlatih secara praktikal dalam pelayar menggunakan penyunting kod terbina dalam dan tutor kecerdasan buatan 24/7. Pelajaran ini merupakan sebahagian daripada laluan pembelajaran Jetpack Compose Academy, dan kemajuan anda disegerakkan merentas web serta aplikasi CoddyKit. Kursus Jetpack Compose Academy merangkumi sejumlah 4 pelajaran.

Fungsi Retrofit

Retrofit menukar antara muka Kotlin biasa menjadi klien HTTP yang berfungsi, jadi anda hanya menerangkan API dan ia menulis kod rangkaian untuk anda.

Ia Bermula dengan Antara Muka

Anda mengisytiharkan setiap titik akhir sebagai fungsi di dalam antara muka Kotlin. Retrofit membaca anotasi tersebut dan membina pelaksanaan sebenar semasa masa jalan.

interface UserApi {
    // endpoint functions go here
}

Tandakan Permintaan GET

Anotasi @GET memberitahu Retrofit bahawa fungsi ini mengambil data. Anda memberikan laluan yang terletak selepas URL asas anda. 🌐

@GET("users")
fun getUsers(): Call<List<User>>

POST, PUT dan DELETE Juga

Selain GET, Retrofit menyediakan @POST, @PUT dan @DELETE supaya satu antara muka boleh membaca dan menulis data pada pelayan anda.

@POST("users")
fun createUser(@Body user: User): Call<User>

Parameter Laluan

Gunakan @Path untuk memasukkan nilai ke dalam URL. Retrofit menggantikan ruang letak bernama dalam pendakap dengan argumen yang anda berikan.

@GET("users/{id}")
fun getUser(@Path("id") id: Int): Call<User>

Parameter Pertanyaan

Tambah @Query untuk nilai selepas tanda soal, seperti istilah carian atau nombor halaman. Retrofit menambahkannya pada URL untuk anda.

@GET("search")
fun search(@Query("q") term: String): Call<Result>

Jenis Pulangan

Jenis pulangan fungsi memberitahu Retrofit bentuk data yang dijangka diterima. Kelas data di sini dipetakan terus kepada respons JSON.

@GET("users/{id}")
fun getUser(@Path("id") id: Int): Call<User>

Tetapkan URL Asas

Anda membina satu tika Retrofit dengan URL asas. Setiap laluan titik akhir yang diisytiharkan akan digabungkan dengannya secara automatik.

val retrofit = Retrofit.Builder()
    .baseUrl("https://api.example.com/")
    .build()

Cipta Pelaksanaan

Panggil create dengan kelas antara muka anda dan Retrofit mengembalikan objek yang sedia digunakan. Anda tidak perlu menulis kod permintaan itu sendiri.

val api = retrofit.create(UserApi::class.java)

Tambah Kilang Penukar

Kilang penukar mengajar Retrofit cara menukar JSON kepada kelas data anda. Anda menambahnya sekali semasa membina tika tersebut.

.addConverterFactory(MoshiConverterFactory.create())

Jangan Lupa Kebenaran

Untuk mengakses rangkaian, isytiharkan kebenaran INTERNET dalam manifes anda. Tanpanya, setiap permintaan gagal sebelum sempat bermula.

<uses-permission android:name="android.permission.INTERNET" />

Semakan Pantas

Anotasi manakah yang memasukkan nilai terus ke dalam laluan URL?

Jawab dalam pelajaran interaktif

Imbas Kembali: Antara Muka API Anda

Anda menerangkan titik akhir sebagai fungsi antara muka beranotasi, menetapkan URL asas, menambah penukar dan membiarkan Retrofit membina klien. Seterusnya, anda akan menghuraikan JSON yang dikembalikannya.

Percuma untuk bermula

Pelajari Kotlin dengan tutor kecerdasan buatan — percuma

Tulis dan jalankan kod sebenar dalam pelayar anda, dapatkan bantuan segera daripada tutor kecerdasan buatan yang tersedia 24/7, dan sambung semula dari tempat anda berhenti di web atau dalam aplikasi.

Kursus: 30
Pelajaran: 120

Mula belajar secara percuma Lihat kursus penuh

Soalan Lazim

Adakah pelajaran “Mentakrifkan Antara Muka API Retrofit” percuma?

Ya — teks penuh “Mentakrifkan Antara Muka API Retrofit” boleh dibaca secara percuma di web ini. Untuk berlatih secara interaktif menggunakan penyunting kod terbina dalam dan tutor kecerdasan buatan 24/7, serta membuka kunci baki kursus Jetpack Compose Academy, tingkat taraf kepada CoddyKit PRO. Kursus Jetpack Compose Academy merangkumi sejumlah 4 pelajaran.

Apakah yang akan saya pelajari dalam “Mentakrifkan Antara Muka API Retrofit”?

Isytiharkan titik akhir dengan anotasi. Anda berlatih Jetpack Compose Academy menggunakan kod praktikal yang dijalankan terus dalam pelayar, manakala tutor kecerdasan buatan 24/7 menjawab soalan anda semasa anda mengikuti pelajaran.

Adakah saya memerlukan pengalaman untuk memulakan Jetpack Compose Academy?

Tiada pengalaman terdahulu diperlukan. Pembelajaran Jetpack Compose Academy di CoddyKit disusun untuk pelajar daripada peringkat pemula hingga lanjutan, jadi anda boleh bermula di sini atau dari awal dan belajar mengikut kadar anda sendiri. Ini ialah pelajaran 1 daripada 4.

Berapa lamakah pelajaran “Mentakrifkan Antara Muka API Retrofit” diambil?

Kebanyakan pelajaran CoddyKit mengambil masa kira-kira 5–10 minit. Setiap pelajaran ringkas dan interaktif, jadi anda boleh membuat kemajuan secara berterusan dan menyambung tepat dari tempat anda berhenti di web atau aplikasi.

Bolehkah saya menulis dan menjalankan kod dalam pelajaran Jetpack Compose Academy ini?

Ya. Setiap pelajaran Jetpack Compose Academy menyertakan penyunting kod terbina dalam, jadi anda boleh menulis dan menjalankan kod sebenar terus dalam pelayar serta menerima maklum balas kecerdasan buatan serta-merta — tanpa memerlukan persediaan setempat.

Semua pelajaran dalam kursus ini

← Kembali ke Jetpack Compose Academy