DoconutExtensions
تسجيل الخدمة والوسطية
DoconutExtensions (namespace Doconut.Middleware) هي الفئة الثابتة التي تحتوي على الثلاث استدعاءات التي يقوم بها كل مضيف Doconut: تسجيل خدمة واحدة وتسجيلين للوسطية.
builder.Services.AddDoconut(options => { /* … */ });
// …
app.UseSession(); // استدعِ UseSession() قبل UseDoconut()
app.UseDoconutResources(); // يجب أن يتم تسجيله قبل UseDoconut()
app.Map("/doconut", branch => branch.UseDoconut());UseDoconut() يجيب على كل طلب يصل إليه، لذا قم بتركيبه على فرع خاص به باستخدام app.Map.
AddDoconut (إضافة)
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>()يسبب استثناء:
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 القياسية — قم بربطه إذا كنت تريد حالة الرخصة على نقطة صحة التطبيق الخاصة بك:
app.MapHealthChecks("/health");UseDoconut (استخدام)
IApplicationBuilder UseDoconut(this IApplicationBuilder app)يضيف وسطية Doconut لمعالجة صور الصفحات. يخدم كل طلب يحمل معامل استعلام ?token= — الصفحات، المصغرات، البحث، التعليقات، إجراءات الصفحات (جدول الطلب الكامل موجود في المفاهيم الأساسية → كيف يعمل العارض) — ويجيب على أي طلب آخر بنفسه باستخدام 404 (أو بانر ShowDoconutInfo): لا يمرر الطلب أبداً إلى بقية خط الأنابيب. قم بتركيبه على فرع خاص به، كما في الأمثلة على هذه الصفحة. عندما يكون UnsafeMode هو false، يتم ربط طبقة أمان المستند تلقائيًا قبله.
لا يأخذ أي معطيات. تمرير مثيل DoconutOptions هنا كان شكل المكتبة السابقة ولم يعد يُترجم.
إعداد شائع يحافظ على شكل طلب DocImage.axd التاريخي مع فرع MapWhen (ثم يستخدم العميل BasePath: '/'):
app.MapWhen(
ctx => ctx.Request.Path.Value?.EndsWith("DocImage.axd", StringComparison.OrdinalIgnoreCase) == true,
branch => branch.UseDoconut());UseDoconutResources (موارد)
IApplicationBuilder UseDoconutResources(this IApplicationBuilder app)يخدم ملفات JS و CSS والصور والخطوط المدمجة عند DoconutOptions.ResourcesPath (الافتراضي /doconut-res). هذه هي الملفات التي تُصدر لها وسوم Viewer.ReferenceCss() / ReferenceScripts().
دائمًا استدعِه قبل UseDoconut(). إذا بقيت منطقة العارض فارغة وأظهر وحدة تحكم المتصفح أخطاء 404 لـ /doconut-res/...، فإن هذا الاستدعاء مفقود أو في غير مكانه.
هذا هو البديل المدعوم لتوصيل وسطية معالجة الموارد المدمجة يدويًا.
Serving from shared storage (الخدمة من التخزين المشترك)
هناك تسجيلان إضافيان للعمليات التي يتم فيها عرض المستند على عقدة ليست بالضرورة هي العقدة التي تخدم صفحاته. كلاهما مغطى من البداية إلى النهاية في النشر الموزع؛ التواقيع هي:
IServiceCollection AddDoconutDistributedAsyncPublish(this IServiceCollection services, Action<DistributedAsyncPublishOptions>? configure = null) // قائمة انتظار النشر الخلفية بنظام الاشتراك الاختياري
IServiceCollection AddDoconutDistributedWidgets(this IServiceCollection services, Action<DistributedWidgetsOptions> configure) // مخزن خلفي مشترك لتحميلات widgetجانب القراءة هو وسطية منفصلة من تجميع Doconut.Clouds، الذي يُضمّن في نفس الحزمة:
IApplicationBuilder UseDoconutCloud<THandler>(
this IApplicationBuilder app,
Action<CloudOptions>? configure = null,
string pathPrefix = "/doconut-cloud")
where THandler : BaseCloudHandlerUseDoconutWebFarm(...) و WebFarmOptions غير موجودين في هذا الإصدار. راجع دليل الترحيل للحصول على خريطة الإعدادات خطوة بخطوة.
Ordering recap (ملخص الترتيب)
app.UseRouting();
app.UseSession(); // استدعِ UseSession() قبل UseDoconut()
app.UseDoconutResources(); // يجب أن يتم تسجيله قبل UseDoconut()
app.Map("/doconut", branch => branch.UseDoconut()); // أو فرع MapWhenهل كانت هذه الصفحة مفيدة؟