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 | Singleton | كائن التكوين |
| Session cache service | Singleton | الرمز → ذاكرة التخزين المؤقت للجلسة (IMemoryCache مسجل أيضًا) |
IDoconutLicenseService | Singleton | رخصة يتم تحميلها مرة واحدة عند بدء التشغيل (الأولوية: LicenseStream → LicenseContent → LicensePath → البحث التلقائي) |
| Page-image pipeline | Singleton | يقوم بمعالجة الصور للصفحات (علامة مائية، تدوير، تحجيم، تعليقات توضيحية) |
| Document security (access store) | Singleton | منح ربط الرمز إلى الجلسة |
Viewer | Transient | الواجهة العامة للفتح/الإغلاق |
DocumentConverter | Transient | واجهة التحويل — تتطلب ملحق Converter |
DocumentSigner | Transient | واجهة التوقيع — تتطلب ملحق Signer (انظر ملحق Signer) |
DistributedDocumentPublisher | Transient | ينشر مخرجات المستند إلى التخزين المشترك (انظر النشر الموزع) |
Health check "doconut" | — | يبلغ عن حالة الرخصة/انتهاء الصلاحية عبر فحوصات الصحة في ASP.NET |
سلوكان يستحقان المعرفة:
- المحول يتطلب ملحقه. حل
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، يتم ربط طبقة أمان المستند تلقائيًا قبله.
بديل شائع يحافظ على شكل الطلب التاريخي 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) // مخزن داعم مشترك لرفع الأدواتجانب القراءة هو وسطية منفصلة من تجميع Doconut.Clouds، الذي يُشحن في نفس الحزمة:
IApplicationBuilder UseDoconutCloud<THandler>(
this IApplicationBuilder app,
Action<CloudOptions>? configure = null,
string pathPrefix = "/doconut-cloud")
where THandler : BaseCloudHandlerOrdering recap
app.UseRouting();
app.UseSession(); // استدعِ UseSession() قبل UseDoconut()
app.UseDoconutResources(); // يجب أن يتم التسجيل قبل UseDoconut()
app.Map("/doconut", branch => branch.UseDoconut()); // أو فرع MapWhenهل كانت هذه الصفحة مفيدة؟