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.

إضافة Doconut

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

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

الخدمةمدة الحياةالدور
DoconutOptionsSingletonكائن التكوين
خدمة ذاكرة التخزين المؤقت للجلسةSingletonالرمز → ذاكرة التخزين المؤقت للجلسة (تم تسجيل IMemoryCache أيضًا)
IDoconutLicenseServiceSingletonالرخصة تُحمَّل مرة واحدة عند بدء التشغيل (الأولوية: LicenseStream → LicenseContent → LicensePath → البحث التلقائي)
خط أنابيب صورة الصفحةSingletonيقوم بمعالجة الصور للصفحات (علامة مائية، تدوير، تحجيم، تعليقات)
أمان المستند (متجر الوصول)Singletonمنح لربط الرمز بالجلسة
ViewerTransientالواجهة العامة للفتح/الإغلاق
DocumentConverterTransientواجهة التحويل — تتطلب ملحق Converter
DocumentSignerTransientواجهة التوقيع — تتطلب ملحق Signer (انظر Signer Plugin)
DistributedDocumentPublisherTransientينشر مخرجات المستند إلى التخزين المشترك (انظر Distributed Deployments)
فحص الصحة "doconut"—يبلغ عن حالة الرخصة/انتهاء الصلاحية عبر فحوصات الصحة في ASP.NET

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

  • 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");

استخدام Doconut

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());

موارد UseDoconut

text
IApplicationBuilder UseDoconutResources(this IApplicationBuilder app)

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

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

الخدمة من التخزين المشترك

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

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

ملخص الترتيب

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

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