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 → التحقق من بدء التشغيل)، ويسجل الرسم البياني الكامل للخدمات:

الخدمةمدة الحياةالدور
DoconutOptionsSingletonكائن التكوين
Session cache serviceSingletonالرمز → ذاكرة التخزين المؤقت للجلسة (IMemoryCache مسجل أيضًا)
IDoconutLicenseServiceSingletonرخصة يتم تحميلها مرة واحدة عند بدء التشغيل (الأولوية: LicenseStream → LicenseContent → LicensePath → البحث التلقائي)
Page-image pipelineSingletonيقوم بمعالجة الصور للصفحات (علامة مائية، تدوير، تحجيم، تعليقات توضيحية)
Document security (access store)Singletonمنح ربط الرمز إلى الجلسة
ViewerTransientالواجهة العامة للفتح/الإغلاق
DocumentConverterTransientواجهة التحويل — تتطلب ملحق Converter
DocumentSignerTransientواجهة التوقيع — تتطلب ملحق Signer (انظر ملحق Signer)
DistributedDocumentPublisherTransientينشر مخرجات المستند إلى التخزين المشترك (انظر النشر الموزع)
Health check "doconut"—يبلغ عن حالة الرخصة/انتهاء الصلاحية عبر فحوصات الصحة في ASP.NET

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

  • المحول يتطلب ملحقه. حل 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، يتم ربط طبقة أمان المستند تلقائيًا قبله.

بديل شائع يحافظ على شكل الطلب التاريخي 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)                     // مخزن داعم مشترك لرفع الأدوات

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

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

Ordering recap

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

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