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.
إضافة Doconut
IServiceCollection AddDoconut(this IServiceCollection services, Action<DoconutOptions>? configure = null)يبني الـ DoconutOptions، يتحقق منها بسرعة الفشل (انظر DoconutOptions → تحقق بدء التشغيل)، ويسجل الرسم البياني الكامل للخدمات:
| الخدمة | مدة الحياة | الدور |
|---|---|---|
DoconutOptions | Singleton | كائن التكوين |
| خدمة ذاكرة التخزين المؤقت للجلسة | Singleton | الرمز → ذاكرة التخزين المؤقت للجلسة (تم تسجيل IMemoryCache أيضًا) |
IDoconutLicenseService | Singleton | الرخصة تُحمَّل مرة واحدة عند بدء التشغيل (الأولوية: LicenseStream → LicenseContent → LicensePath → البحث التلقائي) |
| خط أنابيب صورة الصفحة | Singleton | يقوم بمعالجة الصور للصفحات (علامة مائية، تدوير، تحجيم، تعليقات) |
| أمان المستند (متجر الوصول) | Singleton | منح لربط الرمز بالجلسة |
Viewer | Transient | الواجهة العامة للفتح/الإغلاق |
DocumentConverter | Transient | واجهة التحويل — تتطلب ملحق Converter |
DocumentSigner | Transient | واجهة التوقيع — تتطلب ملحق Signer (انظر Signer Plugin) |
DistributedDocumentPublisher | Transient | ينشر مخرجات المستند إلى التخزين المشترك (انظر Distributed Deployments) |
فحص الصحة "doconut" | — | يبلغ عن حالة الرخصة/انتهاء الصلاحية عبر فحوصات الصحة في ASP.NET |
سلوكان يستحقان المعرفة:
- 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");استخدام Doconut
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());موارد UseDoconut
IApplicationBuilder UseDoconutResources(this IApplicationBuilder app)يخدم ملفات JS و CSS والصور والخطوط المدمجة عند DoconutOptions.ResourcesPath (الافتراضي /doconut-res). هذه هي الملفات التي يولد لها Viewer.ReferenceCss() / ReferenceScripts() وسوم.
دائمًا استدعِه قبل UseDoconut(). إذا ظلت منطقة العارض فارغة وأظهر سجل المتصفح أخطاء 404 لـ /doconut-res/...، فهذا الاستدعاء مفقود أو في غير مكانه.
الخدمة من التخزين المشترك
هناك تسجيلان إضافيان للعمليات التي يُظهر فيها العقدة التي تُنشئ المستند ليست بالضرورة العقدة التي تخدم صفحاته. كلاهما مغطى من البداية إلى النهاية في Distributed Deployments؛ التواقيع هي:
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 : BaseCloudHandlerملخص الترتيب
app.UseRouting();
app.UseSession(); // استدع UseSession() قبل UseDoconut()
app.UseDoconutResources(); // يجب التسجيل قبل UseDoconut()
app.Map("/doconut", branch => branch.UseDoconut()); // أو فرع MapWhenهل كانت هذه الصفحة مفيدة؟