#ذاكرة التخزين المؤقت

// تعيين قيمة في ذاكرة التخزين المؤقت
await app.cache.set('key', 'value', { ttl: 3600 }); // وحدة TTL: ثوانٍ

// استرداد قيمة من ذاكرة التخزين المؤقت
const value = await app.cache.get('key');

// حذف قيمة من ذاكرة التخزين المؤقت
await this.app.cache.del('key');

async (ctx, next) => {
  let data = await ctx.cache.get('custom:data');
  if (!data) {
    // لم يتم العثور على البيانات في ذاكرة التخزين المؤقت، يتم جلبها من قاعدة البيانات
    data = await this.getDataFromDatabase();
    // تخزين البيانات في ذاكرة التخزين المؤقت، صالحة لمدة ساعة واحدة
    await ctx.cache.set('custom:data', data, { ttl: 3600 });
  }
  await next();
}

import { Plugin } from '@nocobase/server';

export default class PluginCacheDemo extends Plugin {
  async load() {
    // إنشاء مثيل ذاكرة تخزين مؤقت مع بادئة
    const myCache = await this.app.cacheManager.createCache({
      name: 'myPlugin',
      prefix: 'plugin:cache:', // ستتم إضافة هذه البادئة تلقائيًا إلى جميع المفاتيح
      store: 'memory', // استخدام مخزن الذاكرة المؤقتة (memory cache)، اختياري، يستخدم defaultStore افتراضيًا
      max: 1000, // الحد الأقصى لعدد عناصر ذاكرة التخزين المؤقت
    });

    await myCache.set('user:1', { name: 'John' });
    const user = await myCache.get('user:1');
  }
}

const myCache = this.app.cacheManager.getCache('myPlugin');

// تعيين قيمة في ذاكرة التخزين المؤقت مع وقت انتهاء صلاحية (الوحدة: ثوانٍ)
await cache.set('key', 'value', { ttl: 3600 });

// استرداد قيمة من ذاكرة التخزين المؤقت
const value = await cache.get('key');

// حذف مفتاح واحد
await cache.del('key');

// مسح جميع عناصر ذاكرة التخزين المؤقت
await cache.reset();

const data = await cache.wrap('user:1', async () => {
  // تُنفذ هذه الدالة فقط في حال عدم وجود البيانات في ذاكرة التخزين المؤقت
  return await this.fetchUserFromDatabase(1);
}, { ttl: 3600 });

// تعيين دفعي
await cache.mset([
  ['key1', 'value1'],
  ['key2', 'value2'],
  ['key3', 'value3'],
], { ttl: 3600 });

// استرداد دفعي
const values = await cache.mget(['key1', 'key2', 'key3']);

// حذف دفعي
await cache.mdel(['key1', 'key2', 'key3']);

// استرداد جميع المفاتيح (ملاحظة: قد لا تدعم بعض المخازن هذه العملية)
const allKeys = await cache.keys();

// استرداد مدة البقاء المتبقية للمفتاح (الوحدة: ثوانٍ)
const remainingTTL = await cache.ttl('key');

const data = await cache.wrapWithCondition(
  'user:1',
  async () => {
    return await this.fetchUserFromDatabase(1);
  },
  {
    // تتحكم المعاملات الخارجية فيما إذا كان سيتم استخدام نتيجة ذاكرة التخزين المؤقت
    useCache: true, // إذا تم تعيينها إلى false، فسيتم إعادة تنفيذ الدالة حتى لو كانت البيانات موجودة في ذاكرة التخزين المؤقت

    // تحديد ما إذا كان سيتم التخزين المؤقت بناءً على نتيجة البيانات
    isCacheable: (value) => {
      // على سبيل المثال: تخزين النتائج الناجحة فقط
      return value && !value.error;
    },

    ttl: 3600,
  },
);

// تعيين خاصية معينة لكائن
await cache.setValueInObject('user:1', 'name', 'John');
await cache.setValueInObject('user:1', 'age', 30);

// استرداد خاصية معينة لكائن
const name = await cache.getValueInObject('user:1', 'name');

// حذف خاصية معينة لكائن
await cache.delValueInObject('user:1', 'age');

import { Plugin } from '@nocobase/server';
import { redisStore, RedisStore } from 'cache-manager-redis-yet';

export default class PluginCacheDemo extends Plugin {
  async load() {
    // تسجيل مخزن Redis (إذا لم يكن النظام قد سجله بالفعل)
    this.app.cacheManager.registerStore({
      name: 'redis',
      store: redisStore,
      close: async (redis: RedisStore) => {
        await redis.client.quit();
      },
      // إعدادات اتصال Redis
      url: 'redis://localhost:6379',
    });

    // إنشاء ذاكرة تخزين مؤقت باستخدام المخزن المسجل حديثًا
    const redisCache = await this.app.createCache({
      name: 'redisCache',
      store: 'redis',
      prefix: 'app:',
    });
  }
}