Cache

Pengantar

Nylo Website v7 menyediakan sistem cache berbasis file untuk menyimpan dan mengambil data secara efisien. Caching berguna untuk menyimpan data yang mahal seperti respons API atau hasil komputasi.

import 'package:nylo_framework/nylo_framework.dart';

// Cache a value for 60 seconds
String? value = await cache().saveRemember("my_key", 60, () {
  return "Hello World";
});

// Retrieve the cached value
String? cached = await cache().get("my_key");

// Remove from cache
await cache().clear("my_key");

Simpan dengan Kedaluwarsa

Gunakan saveRemember untuk meng-cache nilai dengan waktu kedaluwarsa:

String key = "user_profile";
int seconds = 300; // 5 minutes

Map<String, dynamic>? profile = await cache().saveRemember(key, seconds, () async {
  // This callback only runs on cache miss
  printInfo("Fetching from API...");
  return await api<UserApiService>((request) => request.getProfile());
});

Pada pemanggilan berikutnya dalam jendela kedaluwarsa, nilai yang di-cache dikembalikan tanpa mengeksekusi callback.

Simpan Selamanya

Gunakan saveForever untuk meng-cache data tanpa batas waktu:

String key = "app_config";

Map<String, dynamic>? config = await cache().saveForever(key, () async {
  return await api<ConfigApiService>((request) => request.getConfig());
});

Data tetap di-cache sampai dihapus secara eksplisit atau cache aplikasi dibersihkan.

Mengambil Data

Ambil nilai yang di-cache secara langsung:

// Retrieve cached value
String? value = await cache().get<String>("my_key");

// With type casting
Map<String, dynamic>? data = await cache().get<Map<String, dynamic>>("user_data");

// Returns null if not found or expired
if (value == null) {
  print("Cache miss or expired");
}

Jika item yang di-cache telah kedaluwarsa, get() secara otomatis menghapusnya dan mengembalikan null.

Menyimpan Data Langsung

Gunakan put untuk menyimpan nilai secara langsung tanpa callback:

// Store with expiration
await cache().put("session_token", "abc123", seconds: 3600);

// Store forever (no seconds parameter)
await cache().put("device_id", "xyz789");

Menghapus Data

// Remove a single item
await cache().clear("my_key");

// Remove all cached items
await cache().flush();

Memeriksa Cache

// Check if a key exists
bool exists = await cache().has("my_key");

// Get all cached keys
List<String> keys = await cache().documents();

// Get total cache size in bytes
int sizeInBytes = await cache().size();
print("Cache size: ${sizeInBytes / 1024} KB");

Meng-cache Respons API

Menggunakan Helper api()

Cache respons API secara langsung:

Map<String, dynamic>? response = await api<ApiService>(
  (request) => request.get("https://api.github.com/repos/nylo-core/nylo"),
  cacheDuration: const Duration(minutes: 5),
  cacheKey: "github_repo_info",
);

printInfo(response);

Menggunakan NyApiService

Tentukan caching di method API service Anda:

class ApiService extends NyApiService {

  Future<Map<String, dynamic>?> getRepoInfo() async {
    return await network(
      request: (request) => request.get("https://api.github.com/repos/nylo-core/nylo"),
      cacheKey: "github_repo_info",
      cacheDuration: const Duration(hours: 1),
    );
  }

  Future<List<User>?> getUsers() async {
    return await network<List<User>>(
      request: (request) => request.get("/users"),
      cacheKey: "users_list",
      cacheDuration: const Duration(minutes: 10),
    );
  }
}

Kemudian panggil method tersebut:

Map<String, dynamic>? repoInfo = await api<ApiService>(
  (request) => request.getRepoInfo()
);

Dukungan Platform

Cache Nylo Website menggunakan penyimpanan berbasis file dan memiliki dukungan platform berikut:

Pada platform web, cache menurun secara halus - callback selalu dieksekusi dan caching dilewati.

// Check if cache is available
if (cache().isAvailable) {
  // Use caching
} else {
  // Web platform - cache not available
}

Referensi API

Method

Properti