Untuk menjalankan operasi jaringan di aplikasi Anda, manifes Anda harus menyertakan izin berikut:
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
Praktik terbaik untuk komunikasi jaringan yang aman
Sebelum menambahkan fungsionalitas jaringan ke aplikasi Anda, Anda perlu memastikan bahwa data dan informasi dalam aplikasi tetap aman saat mengirimkannya melalui jaringan. Untuk melakukannya, ikuti praktik terbaik keamanan jaringan ini:
- Minimalkan jumlah data pengguna yang bersifat sensitif atau pribadi yang Anda kirimkan melalui jaringan.
- Kirim semua traffic jaringan dari aplikasi Anda melalui SSL.
- Pertimbangkan untuk membuat konfigurasi keamanan jaringan, yang memungkinkan aplikasi Anda memercayai otoritas sertifikat khusus (CA) atau membatasi kumpulan CA sistem yang dipercaya untuk komunikasi aman.
Untuk informasi selengkapnya tentang cara menerapkan prinsip jaringan aman, lihat tips keamanan jaringan.
Memilih klien HTTP
Sebagian besar aplikasi yang terhubung ke jaringan menggunakan HTTP untuk mengirim dan menerima data. Platform
Android mencakup
klien HttpsURLConnection
,
yang mendukung TLS, upload dan download streaming, waktu tunggu yang dapat dikonfigurasi,
IPv6, serta penggabungan koneksi. Dalam topik ini, kami menggunakan
library klien HTTP Retrofit,
yang memungkinkan Anda membuat klien HTTP secara deklaratif. Retrofit juga mendukung
serialisasi otomatis atas isi permintaan dan deserialisasi isi
respons.
Menyelesaikan kueri DNS
Perangkat yang menjalankan Android 10 (API level 29) dan yang lebih tinggi memiliki dukungan native untuk
pencarian DNS khusus melalui pencarian cleartext dan mode DNS-over-TLS.
API DnsResolver
menyediakan resolusi
asinkron dan generik, yang memungkinkan Anda mencari SRV
, NAPTR
, dan jenis data
lainnya. Perhatikan bahwa penguraian respons diserahkan ke aplikasi.
Pada perangkat yang menjalankan Android 9 (API level 28) dan yang lebih rendah, DNS
resolver platform hanya mendukung data A
dan AAAA
. Hal ini memungkinkan Anda mencari alamat IP
yang berkaitan dengan nama, namun tidak mendukung jenis data lain.
Untuk aplikasi berbasis NDK, lihat android_res_nsend
.
Mengenkapsulasi operasi jaringan dengan repositori
Untuk memudahkan proses penerapan operasi jaringan dan mengurangi duplikasi kode di berbagai bagian aplikasi, Anda dapat menggunakan pola desain repositori. Repositori adalah class yang menangani operasi data dan menyediakan abstraksi API yang bersih atas beberapa data atau resource tertentu.
Anda dapat menggunakan Retrofit untuk mendeklarasikan antarmuka yang menentukan metode HTTP, URL, argumen, dan jenis respons untuk operasi jaringan, seperti contoh berikut:
Kotlin
interface UserService { @GET("/users/{id}") suspend fun getUser(@Path("id") id: String): User }
Java
public interface UserService { @GET("/user/{id}") Call<User> getUserById(@Path("id") String id); }
Dalam class repositori, fungsi dapat mengenkapsulasi operasi jaringan dan menampilkan hasilnya. Enkapsulasi ini memastikan bahwa komponen yang memanggil repositori tidak perlu mengetahui cara data disimpan. Setiap perubahan mendatang pada cara data disimpan juga dipisahkan ke class repositori.
Kotlin
class UserRepository constructor( private val userService: UserService ) { suspend fun getUserById(id: String): User { return userService.getUser(id) } }
Java
class UserRepository { private UserService userService; public UserRepository( UserService userService ) { this.userService = userService; } public Call<User> getUserById(String id) { return userService.getUser(id); } }
Untuk menghindari pembuatan UI yang tidak responsif, jangan menjalankan operasi jaringan pada
thread utama. Secara default, Android mengharuskan Anda melakukan operasi jaringan pada
thread selain thread UI utama; jika tidak,
NetworkOnMainThreadException
akan ditampilkan. Di class UserRepository
yang ditampilkan pada contoh kode sebelumnya,
operasi jaringan sebenarnya tidak terpicu. Pemanggil UserRepository
harus mengimplementasikan thread menggunakan coroutine atau fungsi
enqueue()
.
Mempertahankan perubahan konfigurasi
Saat terjadi perubahan konfigurasi, seperti rotasi layar, fragmen atau aktivitas Anda akan dihancurkan dan dibuat ulang. Data yang tidak disimpan di status instance untuk fragmen atau aktivitas Anda, yang harus memiliki sejumlah kecil data, akan hilang dan Anda mungkin harus membuat permintaan jaringan lagi.
Anda dapat menggunakan ViewModel
untuk memastikan
data Anda bertahan dari perubahan konfigurasi. ViewModel
merupakan komponen
yang dirancang untuk menyimpan dan mengelola data terkait UI dengan cara yang mempertimbangkan
siklus proses. Menggunakan UserRepository
yang dibuat sebelumnya,ViewModel
dapat membuat
permintaan jaringan yang penting dan memberikan hasil untuk fragmen atau aktivitas Anda
menggunakan LiveData
:
Kotlin
class MainViewModel constructor( savedStateHandle: SavedStateHandle, userRepository: UserRepository ) : ViewModel() { private val userId: String = savedStateHandle["uid"] ?: throw IllegalArgumentException("Missing user ID") private val _user = MutableLiveData<User>() val user = _user as LiveData<User> init { viewModelScope.launch { try { // Calling the repository is safe as it will move execution off // the main thread val user = userRepository.getUserById(userId) _user.value = user } catch (error: Exception) { // show error message to user } } } }
Java
class MainViewModel extends ViewModel { private final MutableLiveData<User> _user = new MutableLiveData<>(); LiveData<User> user = (LiveData<User>) _user; public MainViewModel( SavedStateHandle savedStateHandle, UserRepository userRepository ) { String userId = savedStateHandle.get("uid"); Call<User> userCall = userRepository.getUserById(userId); userCall.enqueue(new Callback<User>() { @Override public void onResponse(Call<User> call, Response<User> response) { if (response.isSuccessful()) { _user.setValue(response.body()); } } @Override public void onFailure(Call<User> call, Throwable t) { // show error message to user } }); } }
Membaca panduan terkait
Untuk mempelajari topik ini lebih lanjut, lihat panduan terkait berikut: