Konfigurasi Remote Service Di Al-Quran Dengan Flutter — Part 4

Panduan praktis dan terstruktur mengenai panduan al-quran dengan flutter: konfigurasi remote service (part 4) berstandar enterprise. Pelajari konsep, implementasi kode modern, dan tips arsitektur enterprise siap produksi.

Selamat datang di seri tutorial engineering SiHubung! Pada artikel ini, kita akan membedah secara komprehensif implementasi Panduan Al-Quran Dengan Flutter: Konfigurasi Remote Service (Part 4) Berstandar Enterprise dengan standar kode bersih (clean code), performa tinggi, dan arsitektur siap produksi.

Membangun aplikasi web di era modern memerlukan pondasi yang kokoh. Framework modern memberikan fleksibilitas luar biasa bagi developer untuk menghadirkan fitur kompleks secara cepat tanpa mengabaikan aspek keamanan dan keandalan sistem.

Tahapan Implementasi & Walkthrough Kode

Berikut adalah langkah demi langkah teknis yang dapat Anda ikuti langsung pada codebase Anda:

Tahap 1: Penulisan Kode & Konfigurasi

import 'dart:convert';

class SurahModel {
  final int? nomor;
  final String? nama;
  final String? namaLatin;
  final int? jumlahAyat;
  final String? tempatTurun;
  final String? arti;
  final String? deskripsi;
  final String? audio;

  SurahModel({
    this.nomor,
    this.nama,
    this.namaLatin,
    this.jumlahAyat,
    this.tempatTurun,
    this.arti,
    this.deskripsi,
    this.audio,
  });

  factory SurahModel.fromJson(String str) =>
      SurahModel.fromMap(json.decode(str));

  String toJson() => json.encode(toMap());

  factory SurahModel.fromMap(Map<String, dynamic> json) => SurahModel(
    nomor: json["nomor"],
    nama: json["nama"],
    namaLatin: json["nama_latin"],
    jumlahAyat: json["jumlah_ayat"],
    tempatTurun: json["tempat_turun"],
    arti: json["arti"],
    deskripsi: json["deskripsi"],
    audio: json["audio"],
  );

  Map<String, dynamic> toMap() => {
    "nomor": nomor,
    "nama": nama,
    "nama_latin": namaLatin,
    "jumlah_ayat": jumlahAyat,
    "tempat_turun": tempatTurun,
    "arti": arti,
    "deskripsi": deskripsi,
    "audio": audio,
  };
}

Tahap 2: Penulisan Kode & Konfigurasi

import 'dart:convert';

class DetailSurahModel {
  final bool? status;
  final int? nomor;
  final String? nama;
  final String? namaLatin;
  final int? jumlahAyat;
  final String? tempatTurun;
  final String? arti;
  final String? deskripsi;
  final String? audio;
  final List<Ayat>? ayat;
  final bool? suratSebelumnya;

  DetailSurahModel({
    this.status,
    this.nomor,
    this.nama,
    this.namaLatin,
    this.jumlahAyat,
    this.tempatTurun,
    this.arti,
    this.deskripsi,
    this.audio,
    this.ayat,
    this.suratSebelumnya,
  });

  factory DetailSurahModel.fromJson(String str) =>
      DetailSurahModel.fromMap(json.decode(str));

  String toJson() => json.encode(toMap());

  factory DetailSurahModel.fromMap(Map<String, dynamic> json) =>
      DetailSurahModel(
        status: json["status"],
        nomor: json["nomor"],
        nama: json["nama"],
        namaLatin: json["nama_latin"],
        jumlahAyat: json["jumlah_ayat"],
        tempatTurun: json["tempat_turun"],
        arti: json["arti"],
        deskripsi: json["deskripsi"],
        audio: json["audio"],
        ayat:
            json["ayat"] == null
                ? []
                : List<Ayat>.from(json["ayat"]!.map((x) => Ayat.fromMap(x))),
      );

  Map<String, dynamic> toMap() => {
    "status": status,
    "nomor": nomor,
    "nama": nama,
    "nama_latin": namaLatin,
    "jumlah_ayat": jumlahAyat,
    "tempat_turun": tempatTurun,
    "arti": arti,
    "deskripsi": deskripsi,
    "audio": audio,
    "ayat": ayat == null ? [] : List<dynamic>.from(ayat!.map((x) => x.toMap())),
  };
}

class Ayat {
  final int? id;
  final int? surah;
  final int? nomor;
  final String? ar;
  final String? tr;
  final String? idn;

  Ayat({this.id, this.surah, this.nomor, this.ar, this.tr, this.idn});

  factory Ayat.fromJson(String str) => Ayat.fromMap(json.decode(str));

  String toJson() => json.encode(toMap());

  factory Ayat.fromMap(Map<String, dynamic> json) => Ayat(
    id: json["id"],
    surah: json["surah"],
    nomor: json["nomor"],
    ar: json["ar"],
    tr: json["tr"],
    idn: json["idn"],
  );

  Map<String, dynamic> toMap() => {
    "id": id,
    "surah": surah,
    "nomor": nomor,
    "ar": ar,
    "tr": tr,
    "idn": idn,
  };
}

class SuratSelanjutnya {
  final int? id;
  final int? nomor;
  final String? nama;
  final String? namaLatin;
  final int? jumlahAyat;
  final String? tempatTurun;
  final String? arti;
  final String? deskripsi;
  final String? audio;

  SuratSelanjutnya({
    this.id,
    this.nomor,
    this.nama,
    this.namaLatin,
    this.jumlahAyat,
    this.tempatTurun,
    this.arti,
    this.deskripsi,
    this.audio,
  });

  factory SuratSelanjutnya.fromJson(String str) =>
      SuratSelanjutnya.fromMap(json.decode(str));

  String toJson() => json.encode(toMap());

  factory SuratSelanjutnya.fromMap(Map<String, dynamic> json) =>
      SuratSelanjutnya(
        id: json["id"],
        nomor: json["nomor"],
        nama: json["nama"],
        namaLatin: json["nama_latin"],
        jumlahAyat: json["jumlah_ayat"],
        tempatTurun: json["tempat_turun"],
        arti: json["arti"],
        deskripsi: json["deskripsi"],
        audio: json["audio"],
      );

  Map<String, dynamic> toMap() => {
    "id": id,
    "nomor": nomor,
    "nama": nama,
    "nama_latin": namaLatin,
    "jumlah_ayat": jumlahAyat,
    "tempat_turun": tempatTurun,
    "arti": arti,
    "deskripsi": deskripsi,
    "audio": audio,
  };
}

Tahap 3: Penulisan Kode & Konfigurasi

import 'dart:convert';

import 'package:alquran_flutter/detail_surah_model.dart';
import 'package:alquran_flutter/surah_model.dart';
import 'package:dio/dio.dart';
import 'package:either_dart/either.dart';

class RemoteResource {
  final dio = Dio();

  RemoteResource() {
    dio.options.baseUrl = 'https://open-api.my.id/api/';
    dio.options.headers['Accept'] = 'application/json';
    dio.options.headers['Accept-Charset'] = 'utf-8';
    // Tambahkan interceptor untuk handle encoding
    dio.interceptors.add(
      InterceptorsWrapper(
        onResponse: (response, handler) {
          // Decode manual jika diperlukan
          if (response.data is String) {
            response.data = json.decode(utf8.decode(response.data.codeUnits));
          }
          return handler.next(response);
        },
      ),
    );
  }

  Future<Either<String, List<SurahModel>>> fetchQuran() async {
    try {
      final response = await dio.get('quran/surah');
      if (response.statusCode == 200) {
        List<dynamic> data = response.data;
        List<SurahModel> surahList =
            data.map((json) {
              return SurahModel.fromMap(json);
            }).toList();
        return Right(surahList);
      } else {
        return Left('Error: ${response.statusCode}');
      }
    } on DioException catch (e) {
      return Left('DioException: ${e.message}');
    }
  }

  Future<Either<String, DetailSurahModel>> detailSurah(int id) async {
    try {
      final response = await dio.get('quran/surah/$id');
      if (response.statusCode == 200) {
        DetailSurahModel detailSurah = DetailSurahModel.fromMap(response.data);
        return Right(detailSurah);
      } else {
        return Left('Error: ${response.statusCode}');
      }
    } on DioException catch (e) {
      return Left('DioException: ${e.message}');
    }
  }
}

Tahap 4: Penulisan Kode & Konfigurasi

import 'dart:convert';

import 'package:alquran_flutter/detail_surah_model.dart';
import 'package:alquran_flutter/surah_model.dart';
import 'package:dio/dio.dart';
import 'package:either_dart/either.dart';

Tahap 5: Penulisan Kode & Konfigurasi

final dio = Dio();

RemoteResource() {
 dio.options.baseUrl = 'https://open-api.my.id/api/';
 dio.options.headers['Accept'] = 'application/json';
 dio.options.headers['Accept-Charset'] = 'utf-8';
    // Tambahkan interceptor untuk handle encoding
 dio.interceptors.add(
  InterceptorsWrapper(
  	onResponse: (response, handler) {
    // Decode manual jika diperlukan
    	if (response.data is String) {
      	response.data = json.decode(utf8.decode(response.data.codeUnits));
    	}
    return handler.next(response);
   },
  ),
 );
}

Tahap 6: Penulisan Kode & Konfigurasi

Future<Either<String, List<SurahModel>>> fetchQuran() async {
    try {
      final response = await dio.get('quran/surah');
      if (response.statusCode == 200) {
        List<dynamic> data = response.data;
        List<SurahModel> surahList =
            data.map((json) {
              return SurahModel.fromMap(json);
            }).toList();
        return Right(surahList);
      } else {
        return Left('Error: ${response.statusCode}');
      }
    } on DioException catch (e) {
      return Left('DioException: ${e.message}');
    }
  }

Tahap 7: Penulisan Kode & Konfigurasi

Future<Either<String, DetailSurahModel>> detailSurah(int id) async {
    try {
      final response = await dio.get('quran/surah/$id');
      if (response.statusCode == 200) {
        DetailSurahModel detailSurah = DetailSurahModel.fromMap(response.data);
        return Right(detailSurah);
      } else {
        return Left('Error: ${response.statusCode}');
      }
    } on DioException catch (e) {
      return Left('DioException: ${e.message}');
    }
  }

💡 Tips Rekayasa Perangkat Lunak (SiHubung Engineering Best Practice)

Selalu gunakan pendekatan deklaratif, validasi input seawal mungkin di boundary layer, dan lakukan logging terstruktur untuk memudahkan observability ketika sistem dijalankan di lingkungan cloud produksi.

Kesimpulan

Dengan mengikuti langkah-langkah terstruktur di atas, implementasi modul Anda akan jauh lebih rapi, aman dari bug umum, serta siap diskalakan ke lingkungan produksi.

Nantikan artikel tutorial praktis lainnya seputar fullstack development, microservices, dan otomasi AI di Blog Engineering SiHubung. Selamat mencoba!