DoconutExtensions

تسجيل الخدمة والوسطية

DoconutExtensions (namespace Doconut.Middleware) هي الفئة الثابتة التي تحتوي على الثلاث استدعاءات التي يقوم بها كل مضيف Doconut: تسجيل خدمة واحدة وتسجيلين للوسطية.

csharp
builder.Services.AddDoconut(options => { /* … */ });
// …
app.UseSession();          // استدعِ UseSession() قبل UseDoconut()
app.UseDoconutResources(); // يجب أن يتم تسجيله قبل UseDoconut()
app.Map("/doconut", branch => branch.UseDoconut());

UseDoconut() يجيب على كل طلب يصل إليه، لذا قم بتركيبه على فرع خاص به باستخدام app.Map.

AddDoconut (إضافة)

text
IServiceCollection AddDoconut(this IServiceCollection services, Action<DoconutOptions>? configure = null)

يبني DoconutOptions، يتحقق منها بسرعة الفشل (انظر DoconutOptions → التحقق من بدء التشغيل)، ويسجل الرسم البياني الكامل للخدمات:

الخدمةمدة الحياةالدور
DoconutOptionsفرديكائن التكوين
خدمة ذاكرة التخزين المؤقت للجلسةفرديToken → ذاكرة التخزين المؤقت للجلسة (تم تسجيل IMemoryCache أيضًا)
IDoconutLicenseServiceفرديرخصة تُحمَّل مرة واحدة عند بدء التشغيل (الأولوية: LicenseStream → LicenseContent → LicensePath → البحث التلقائي)
خط أنابيب صورة الصفحةفرديينفّذ معالجة الصور للصفحات (علامة مائية، تدوير، تحجيم، تعليقات)
أمان المستند (متجر الوصول)فردييمنح ربط الرمز بالجلسة
Viewerمؤقتالواجهة العامة للفتح/الإغلاق
DocumentConverterمؤقتواجهة التحويل — تتطلب ملحق Converter
DocumentSignerمؤقتواجهة التوقيع — تتطلب ملحق Signer (انظر ملحق الموقّع)
DistributedDocumentPublisherمؤقتينشر مخرجات المستند إلى التخزين المشترك
فحص الصحة "doconut"—يبلّغ عن حالة الرخصة/انتهاء الصلاحية عبر فحوصات الصحة في ASP.NET

لا توجد مكالمة مكافئة في مكتبة .NET Standard السابقة. كانت تُنشئ new Viewer(cache, accessor) لكل طلب وتُمرّر الخيارات إلى الوسطية؛ كلاهما تم استبدالهما بهذا التسجيل الواحد.

سلوكان يستحقان المعرفة:

  • يتطلب Converter ملحقه. حل DocumentConverter بدون options.AddPlugin<ConverterPlugin>() يسبب استثناء:
text
InvalidOperationException: No IDocumentConverter is registered. Add the converter plugin: options.AddPlugin<Doconut.Plugins.Converter.ConverterPlugin>().

DocumentSigner يتبع القاعدة نفسها: بدون options.AddPlugin<SignerPlugin>() يسبب استثناء No IDocumentSigner is registered. Add the signing plugin: options.AddPlugin<Doconut.Plugins.Signer.SignerPlugin>().

  • تم التحقق من استحقاق الملحق عند بدء التشغيل. رخصة مفقودة، ملف TRIAL قديم، أو رخصة مدفوعة بدون قدرة ملحق مسجلة يؤدي إلى الفشل في وقت AddDoconut(). التسجيلات المؤقتة/التجريبية تبقى صالحة بعد تاريخ انتهاء الصلاحية، بينما البوابات أثناء التشغيل تُلغي القدرات المنتهية.

يتكامل فحص الصحة مع آلية ASP.NET Core القياسية — قم بربطه إذا كنت تريد حالة الرخصة على نقطة صحة التطبيق الخاصة بك:

csharp
app.MapHealthChecks("/health");

UseDoconut (استخدام)

text
IApplicationBuilder UseDoconut(this IApplicationBuilder app)

يضيف وسطية Doconut لمعالجة صور الصفحات. يخدم كل طلب يحمل معامل استعلام ?token= — الصفحات، المصغرات، البحث، التعليقات، إجراءات الصفحات (جدول الطلب الكامل موجود في المفاهيم الأساسية → كيف يعمل العارض) — ويجيب على أي طلب آخر بنفسه باستخدام 404 (أو بانر ShowDoconutInfo): لا يمرر الطلب أبداً إلى بقية خط الأنابيب. قم بتركيبه على فرع خاص به، كما في الأمثلة على هذه الصفحة. عندما يكون UnsafeMode هو false، يتم ربط طبقة أمان المستند تلقائيًا قبله.

لا يأخذ أي معطيات. تمرير مثيل DoconutOptions هنا كان شكل المكتبة السابقة ولم يعد يُترجم.

إعداد شائع يحافظ على شكل طلب DocImage.axd التاريخي مع فرع MapWhen (ثم يستخدم العميل BasePath: '/'):

csharp
app.MapWhen(
    ctx => ctx.Request.Path.Value?.EndsWith("DocImage.axd", StringComparison.OrdinalIgnoreCase) == true,
    branch => branch.UseDoconut());

UseDoconutResources (موارد)

text
IApplicationBuilder UseDoconutResources(this IApplicationBuilder app)

يخدم ملفات JS و CSS والصور والخطوط المدمجة عند DoconutOptions.ResourcesPath (الافتراضي /doconut-res). هذه هي الملفات التي تُصدر لها وسوم Viewer.ReferenceCss() / ReferenceScripts().

دائمًا استدعِه قبل UseDoconut(). إذا بقيت منطقة العارض فارغة وأظهر وحدة تحكم المتصفح أخطاء 404 لـ /doconut-res/...، فإن هذا الاستدعاء مفقود أو في غير مكانه.

هذا هو البديل المدعوم لتوصيل وسطية معالجة الموارد المدمجة يدويًا.

Serving from shared storage (الخدمة من التخزين المشترك)

هناك تسجيلان إضافيان للعمليات التي يتم فيها عرض المستند على عقدة ليست بالضرورة هي العقدة التي تخدم صفحاته. كلاهما مغطى من البداية إلى النهاية في النشر الموزع؛ التواقيع هي:

text
IServiceCollection AddDoconutDistributedAsyncPublish(this IServiceCollection services, Action<DistributedAsyncPublishOptions>? configure = null)   // قائمة انتظار النشر الخلفية بنظام الاشتراك الاختياري
IServiceCollection AddDoconutDistributedWidgets(this IServiceCollection services, Action<DistributedWidgetsOptions> configure)                     // مخزن خلفي مشترك لتحميلات widget

جانب القراءة هو وسطية منفصلة من تجميع Doconut.Clouds، الذي يُضمّن في نفس الحزمة:

text
IApplicationBuilder UseDoconutCloud<THandler>(
    this IApplicationBuilder app,
    Action<CloudOptions>? configure = null,
    string pathPrefix = "/doconut-cloud")
    where THandler : BaseCloudHandler

UseDoconutWebFarm(...) و WebFarmOptions غير موجودين في هذا الإصدار. راجع دليل الترحيل للحصول على خريطة الإعدادات خطوة بخطوة.

Ordering recap (ملخص الترتيب)

csharp
app.UseRouting();
app.UseSession();          // استدعِ UseSession() قبل UseDoconut()
app.UseDoconutResources(); // يجب أن يتم تسجيله قبل UseDoconut()
app.Map("/doconut", branch => branch.UseDoconut()); // أو فرع MapWhen

هل كانت هذه الصفحة مفيدة؟