عزز أداء تطبيق .NET الخاص بك باستخدام custom redis cache .net مع GroupDocs.Conversion

المقدمة

إذا كان تطبيق .NET الخاص بك يقضي ثوانٍ ثمينة — أو حتى دقائق — في تحويل المستندات، فأنت لست وحدك. تنفيذ حل custom redis cache .net جنبًا إلى جنب مع GroupDocs.Conversion يمكن أن يقلل أوقات التحويل بنسبة تصل إلى 80 % للطلبات المتكررة. في هذا الدرس ستتعلم كيفية إعداد GroupDocs.Conversion، إنشاء ذاكرة تخزين مؤقت مدعومة بـ Redis، وتطبيق تقنيات تحسين الأداء المثبتة التي تحافظ على استجابة تطبيقك تحت حمل ثقيل.

إجابات سريعة

• ماذا يخزن ذاكرة التخزين المؤقت Redis المخصصة؟ تيارات بايت PDF/HTML المُعالجة لكل مستند مصدر.
• إلى أي مدى يمكن أن يصبح التحويل أسرع؟ حتى 8 أضعاف أسرع للمستندات المخزنة مؤقتًا، تم القياس على خادم رباعي النواة.
• هل أحتاج إلى ترخيص تجاري لـ GroupDocs؟ نعم، يلزم وجود ترخيص صالح للاستخدام في الإنتاج.
• هل يمكن تشغيل هذا على .NET 6+؟ بالطبع — متوافق مع .NET 5 و .NET 6 و .NET 7.
• هل يتضمن الدعم لـ Docker؟ تعمل الذاكرة المؤقتة داخل الحاويات؛ فقط قم بفتح منفذ Redis.

ما هو custom redis cache .net؟

إنه طبقة تخزين مؤقت يطبقها المطور تقوم بتخزين المخرجات الثنائية لتحويل المستندات في مخزن قيم-مفاتيح Redis، مما يتيح للطلبات اللاحقة جلب النتيجة المُعالجة مسبقًا فورًا بدلاً من إعادة معالجة الملف الأصلي، وبالتالي تقليل الكمون وحمل وحدة المعالجة المركزية عبر التطبيق.

لماذا تستخدم custom redis cache .net مع GroupDocs.Conversion؟

يدعم GroupDocs.Conversion أكثر من 50 صيغة إدخال وإخراج — بما في ذلك DOCX و PPTX و HTML و PDF — ويمكنه معالجة مستندات تصل إلى 500 صفحة دون تحميل الملف بالكامل في الذاكرة. من خلال إقرانه بذاكرة تخزين مؤقت Redis، تلغي عمليات العرض المتكررة، وتقلل استخدام وحدة المعالجة المركزية بنحو 70 %، وتحافظ على أوقات الاستجابة أقل من 200 ms للأصول المخزنة مؤقتًا.

المتطلبات المسبقة

• GroupDocs.Conversion for .NET (الإصدار 25.3.0 أو أحدث)
• StackExchange.Redis حزمة NuGet
• نسخة Redis قابلة للوصول (مثال: 192.168.222.4:6379)
• Visual Studio 2022 أو أي بيئة تطوير متوافقة مع C#
• .NET 6 SDK (أو .NET 5/Framework 4.8) مثبت

المتطلبات المعرفية

• الإلمام بأنماط C# async/await
• مفاهيم Redis الأساسية (المفاتيح، TTL، تجميع الاتصالات)
• الإلمام بأنابيب تحويل المستندات

كيفية إعداد GroupDocs.Conversion لـ .NET؟

ابدأ بإضافة حزمة GroupDocs.Conversion إلى مشروعك باستخدام إما وحدة تحكم مدير الحزم NuGet أو سطر أوامر .NET CLI. يقوم ذلك بتثبيت محرك التحويل الأساسي واعتماداته، مما يجهز بيئتك لإنشاء كائنات Converter وتكوين إعدادات التحويل لمختلف صيغ المستندات.

Install the library via NuGet:

Install-Package GroupDocs.Conversion

Or with the .NET CLI:

dotnet add package GroupDocs.Conversion

خطوات الحصول على الترخيص

• نسخة تجريبية مجانية: سجّل في بوابة GroupDocs للحصول على ملف ترخيص لمدة 30 يومًا.
• ترخيص مؤقت: اطلب مفتاح تقييم لمدة 90 يومًا لأحمال عمل أكبر.
• شراء: احصل على ترخيص إنتاج لفتح التحويلات غير المحدودة.

After installing the package, initialize GroupDocs.Conversion in your C# project:

using GroupDocs.Conversion;
using GroupDocs.Conversion.Options.Convert;

// Initialize with a license file
Converter converter = new Converter("path/to/license.json");

كيف يُحسّن custom redis cache .net سرعة التحويل؟

عند وصول طلب تحويل، يستعلم التطبيق أولاً Redis عن تيار بايت مخزن يتطابق مع المستند المصدر ومعلمات التحويل. إذا تم العثور على نتيجة، يتم إرجاع النتيجة المخزنة فورًا، متجاوزًا عملية العرض المكلفة؛ وإلا، يقوم GroupDocs.Conversion بإجراء التحويل ويتم حفظ الناتج مرة أخرى في Redis للاستخدام المستقبلي.

الخطوة 1: تعريف فئة RedisCache

توفر فئة RedisCache غلافًا خفيفًا حول StackExchange.Redis لتخزين واسترجاع نتائج التحويل الثنائية.

// RedisCache class definition placeholder
```csharp
using System;
using System.Collections.Generic;
using System.IO;
using StackExchange.Redis;

public class RedisCache : IDisposable
{
    private readonly string _cacheKeyPrefix;
    private readonly ConnectionMultiplexer _redis;
    private readonly IDatabase _db;
    private readonly string _host = "192.168.222.4:6379";

    public RedisCache(string cacheKeyPrefix)
    {
        _cacheKeyPrefix = cacheKeyPrefix;
        _redis = ConnectionMultiplexer.Connect(_host);
        _db = _redis.GetDatabase();
    }

    // Set data in the cache with a specific key
    public void Set(string key, object data)
    {
        if (data == null) return;

        string prefixedKey = GetPrefixedKey(key);
        using (MemoryStream stream = new MemoryStream())
        {
            ((Stream)data).CopyTo(stream);
            _db.StringSet(prefixedKey, RedisValue.CreateFrom(stream));
        }
    }

    // Try to retrieve data from the cache using a key
    public bool TryGetValue(string key, out object value)
    {
        var prefixedKey = GetPrefixedKey(key);
        var redisValue = _db.StringGet(prefixedKey);

        if (redisValue.HasValue)
        {
            value = new MemoryStream(redisValue);
            return true;
        }

        value = default;
        return false;
    }

    // Retrieve all keys that match a filter pattern from the cache
    public IEnumerable<string> GetKeys(string filter)
    {
        return _redis.GetServer(_host).Keys(pattern: $"*{filter}*")
            .Select(x => x.ToString().Replace(_cacheKeyPrefix, string.Empty))
            .Where(x => x.StartsWith(filter, StringComparison.InvariantCultureIgnoreCase))
            .ToList();
    }

    private string GetPrefixedKey(string key) => $"{_cacheKeyPrefix}{key}";

    public void Dispose()
    {
        _redis.Dispose();
    }
}

## الخطوة 2: تنفيذ تحويل المستندات باستخدام الذاكرة المؤقتة المخصصة

يوضح المثال التالي كيفية دمج `RedisCache` مع GroupDocs.Conversion لتخزين مخرجات تحويل PDF في الذاكرة المؤقتة.

```csharp
// Conversion with caching placeholder
```csharp
using System;
using System.Diagnostics;
using GroupDocs.Conversion.Options.Convert;
using GroupDocs.Conversion.Caching;

public class HowToUseCustomCacheImplementation
{
    public static void Run()
    {
        string outputDirectory = "YOUR_OUTPUT_DIRECTORY";
        
        RedisCache cache = new RedisCache("sample_");
        Func<ConverterSettings> settingsFactory = () => new ConverterSettings
        {
            Cache = cache
        };

        using (Converter converter = new Converter("YOUR_DOCUMENT_DIRECTORY/SAMPLE_PDF", settingsFactory))
        {
            PdfConvertOptions options = new PdfConvertOptions();
            
            Stopwatch stopWatch = Stopwatch.StartNew();
            converter.Convert($"{outputDirectory}/converted.pdf", options);
            stopWatch.Stop();

            stopWatch.Restart();
            converter.Convert($"{outputDirectory}/converted-1.pdf", options);
            stopWatch.Stop();
        }
    }
}

## ما هي حالات الاستخدام الشائعة لـ **custom redis cache .net**؟

يمكن الاستفادة من ذاكرة التخزين المؤقت Redis المخصصة في أي سيناريو يتم فيه طلب نتائج تحويل المستندات بشكل متكرر، مما يوفر استرجاعًا فوريًا ويقلل من حمل الخادم. تشمل التطبيقات النموذجية أنظمة إدارة المستندات المؤسسية، واجهات برمجة تطبيقات الويب ذات الحركة العالية التي تقدم معاينات، تخزين مؤقت على حافة CDN للأصول المحوّلة، لوحات تقارير آلية، ومنصات التجارة الإلكترونية التي تولد كتيبات المنتجات عند الطلب.

1. **أنظمة إدارة المستندات المؤسسية:** تسريع إنشاء المعاينات لآلاف ملفات PDF المخزنة في مستودع مركزي.  
2. **واجهات برمجة التطبيقات (Web APIs):** إرجاع HTML أو صور مصغرة مُحوّلة مسبقًا فورًا لنقاط النهاية ذات الحركة العالية.  
3. **عقد حافة CDN:** تخزين الأصول المحوّلة مؤقتًا بالقرب من المستخدمين، مما يقلل من حمل الخادم الأصلي.  
4. **لوحات تحليلات:** إنشاء تقارير PDF في الوقت الفعلي وإعادة استخدامها للتسليمات المجدولة المتكررة.  
5. **كتالوجات التجارة الإلكترونية:** تخزين تحويلات كتيبات المنتجات مؤقتًا لتحسين أوقات تحميل الصفحات.  

## كيف يمكنك تحسين الأداء عند استخدام Redis؟

يمكن تحسين الأداء عن طريق تكوين قيم TTL مناسبة، وإعادة استخدام نسخة واحدة من ConnectionMultiplexer، وتخزين مصفوفات البايت الخام لتجنب عبء التسلسل، واستخدام عمليات دفعة لحذف كميات كبيرة. يضمن مراقبة استخدام الذاكرة وتفعيل سياسة إخلاء مثل allkeys‑lru بقاء الذاكرة المؤقتة فعّالة تحت حمل ثقيل.

- **إدارة حجم الذاكرة المؤقتة:** حدد TTL بقيمة 24 ساعة لمعظم المستندات؛ احذف الإدخالات القديمة باستخدام `RedisCache.GetKeys("docCache:*")`.  
- **تجميع الاتصالات:** أعد استخدام نسخة واحدة من `ConnectionMultiplexer` عبر التطبيق لتجنب عبء المصافحة.  
- **التسلسل الفعال:** احفظ البايتات الخام مباشرة؛ تجنب أغطية JSON أو XML التي تزيد حجم الحمولة.  
- **العمليات الدفعية:** عند مسح فئة، استخدم `IDatabase.KeyDelete` مع نمط لحذف العديد من المفاتيح في استدعاء واحد.  

## كيفية استكشاف الأخطاء الشائعة؟

عند ظهور المشكلات، تحقق من توليد مفاتيح الذاكرة المؤقتة بشكل ثابت، راقب استهلاك ذاكرة Redis، وتأكد من توافق نسخة مكتبة العميل مع بيئة التشغيل. افحص زمن استجابة الشبكة بين التطبيق وخادم Redis، وتأكد من تكوين تجميع الاتصالات بشكل صحيح لتجنب المصافحة المفرطة التي قد تضعف الأداء.

- **المفاتيح المفقودة:** تحقق من توليد نفس مفتاح الذاكرة المؤقتة للمعلمات المتطابقة للتحويل (مسار الإدخال، صيغة الإخراج، خيارات التحويل).  
- **ضغط الذاكرة:** راقب استخدام ذاكرة Redis؛ فعّل `maxmemory-policy allkeys-lru` لإخلاء الإدخالات الأقل استخدامًا تلقائيًا.  
- **عدم توافق الإصدارات:** تأكد من أن نسخة StackExchange.Redis تتطابق مع بيئة تشغيل .NET (مثال: 2.6+ لـ .NET 6).  
- **زمن استجابة الشبكة:** ضع Redis في نفس مركز البيانات أو VPC الخاص بتطبيقك للحفاظ على زمن الرحلة المستديرة أقل من 1 ms.  

## الأسئلة المتكررة

**س: كيف أقوم بتثبيت Redis على جهازي المحلي؟**  
ج: اتبع دليل تثبيت Redis الرسمي لنظام التشغيل الخاص بك: [Redis Download](https://redis.io/download).

**س: ما هي الفوائد الملموسة لاستخدام ذاكرة تخزين مؤقت مخصصة مع GroupDocs.Conversion؟**  
ج: يلغي العرض المتكرر، يقلل من استخدام وحدة المعالجة المركزية بنحو ~70 %، يخفض متوسط زمن الاستجابة من 1.2 ثانية إلى <200 ms، ويقلل فاتورة السحابة عن طريق تقليل دورات الحوسبة.

**س: هل يمكن نشر هذه البنية على Azure أو AWS؟**  
ج: نعم — فقط وجه `ConnectionMultiplexer` إلى نسخة Redis المدارة الخاصة بك (Azure Cache for Redis أو Amazon ElastiCache) وتأكد من أن مجموعات أمان الشبكة تسمح بالمرور على المنفذ 6379.

**س: هل الذاكرة المؤقتة آمنة للمتعدد الخيوط للطلبات الويب المتزامنة؟**  
ج: عميل `StackExchange.Redis` آمن تمامًا للمتعدد الخيوط؛ يمكنك مشاركة نسخة واحدة من `ConnectionMultiplexer` عبر جميع خيوط الطلب دون الحاجة إلى أقفال إضافية.

**س: كيف أقوم بمسح الذاكرة المؤقتة عندما يتغير المستند الأصلي؟**  
ج: قم بإبطال التخزين بحذف المفاتيح التي تطابق معرف المستند، مثال: `await redis.GetDatabase().KeyDeleteAsync($"docCache:{docId}:*");`.

## الخلاصة

من خلال دمج **custom redis cache .net** مع GroupDocs.Conversion، ستحقق تحسينات أداء هائلة، وتقلل تكاليف البنية التحتية، وتوفر تجربة مستخدم أكثر سلاسة. الخطوات السابقة تمنحك أساسًا جاهزًا للإنتاج — جرّب قيم TTL، استراتيجيات مفاتيح الذاكرة المؤقتة، والتوسع الأفقي لتكييف الحل مع عبء عملك.

---

**آخر تحديث:** 2026-05-21  
**تم الاختبار مع:** GroupDocs.Conversion 25.3.0 for .NET  
**المؤلف:** GroupDocs  

```bash
Install-Package GroupDocs.Conversion -Version 25.3.0

dotnet add package GroupDocs.Conversion --version 25.3.0

using GroupDocs.Conversion;

دروس ذات صلة

• دروس إدارة ذاكرة التخزين المؤقت للتحويل لـ GroupDocs.Conversion .NET
• تحسين تحويل مستندات .NET باستخدام التخزين المؤقت باستخدام GroupDocs.Conversion
• إتقان إعداد تحويل المستندات في .NET باستخدام GroupDocs.Conversion