कैश

परिचय

Nylo Website v7 डेटा को कुशलता से संग्रहीत और पुनर्प्राप्त करने के लिए एक फ़ाइल-आधारित कैश सिस्टम प्रदान करता है। कैशिंग महंगे डेटा जैसे API रिस्पॉन्स या कंप्यूटेड रिजल्ट्स को संग्रहीत करने के लिए उपयोगी है।

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");

एक्सपायरेशन के साथ सेव करें

एक्सपायरेशन टाइम के साथ वैल्यू कैश करने के लिए saveRemember का उपयोग करें:

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());
});

एक्सपायरेशन विंडो के भीतर बाद की कॉल पर, कॉलबैक निष्पादित किए बिना कैश्ड वैल्यू रिटर्न होती है।

हमेशा के लिए सेव करें

डेटा को अनिश्चित काल के लिए कैश करने के लिए saveForever का उपयोग करें:

String key = "app_config";

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

डेटा तब तक कैश्ड रहता है जब तक इसे स्पष्ट रूप से हटाया न जाए या ऐप का कैश क्लियर न हो।

डेटा प्राप्त करें

कैश्ड वैल्यू सीधे प्राप्त करें:

// 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");
}

यदि कैश्ड आइटम एक्सपायर हो गया है, तो get() स्वचालित रूप से इसे हटा देता है और null रिटर्न करता है।

डेटा सीधे स्टोर करें

कॉलबैक के बिना सीधे वैल्यू स्टोर करने के लिए put का उपयोग करें:

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

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

डेटा हटाएँ

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

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

कैश जाँचें

// 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");

API रिस्पॉन्स कैश करना

api() हेल्पर का उपयोग करना

API रिस्पॉन्स को सीधे कैश करें:

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);

NyApiService का उपयोग करना

अपने API सर्विस मेथड्स में कैशिंग डिफ़ाइन करें:

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),
    );
  }
}

फिर मेथड कॉल करें:

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

प्लेटफ़ॉर्म सपोर्ट

Nylo Website का कैश फ़ाइल-आधारित स्टोरेज का उपयोग करता है और इसका प्लेटफ़ॉर्म सपोर्ट निम्नलिखित है:

वेब प्लेटफ़ॉर्म पर, कैश ग्रेसफुली डिग्रेड होता है - कॉलबैक हमेशा निष्पादित होते हैं और कैशिंग बायपास होती है।

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

API रेफरेंस

मेथड्स

प्रॉपर्टीज़