DoconutHost

جذر التركيب لـ System.Web

DoconutHost (namespace Doconut) هي فئة ثابتة تمتلك خدمات Doconut لكامل عملية العامل. تطبيقات ASP.NET Core تبني تلك الخدمات داخل حاوية الإطار نفسها؛ ASP.NET الكلاسيكي لا يملك حاوية، لذا DoconutHost يبني واحدة ويحافظ عليها. معالج DocImage.axd ووحدة الموارد تحل كل ما تحتاجه منه، وكذلك شفرتك.

العضوالغرض
static void Initialize(Action<DoconutOptions>? configure = null, Action<IServiceCollection>? configureServices = null)يبني الخدمات — مرة واحدة
static IServiceProvider Services { get; }الحاوية المبنية
static bool IsInitialized { get; }true مرة واحدة بعد تشغيل Initialize
static void Shutdown()يوقف العمل الخلفي ويفرغ الحاوية

التهيئة

استدعها من Application_Start في Global.asax.cs:

csharp
// Global.asax.cs، Application_Start - مرة واحدة لكل عملية عامل. الاستدعاء الثاني لا يفعل شيئًا:
// خيارات الاستدعاء الأول تفوز.
Doconut.DoconutHost.Initialize(
    options =>
    {
        options.LicensePath = HostingEnvironment.MapPath("~/wwwroot/Doconut.Viewer.lic");
    },
    services =>
    {
        // اختياري. يُنفّذ بعد تسجيلات Doconut الخاصة وقبل بناء الحاوية،
        // حتى يتمكن من إضافة خدمات أو استبدال خدمة مسجلة من Doconut.
        services.AddMemoryCache();
    });
  • configure يتلقى خياراتDoconut: الترخيص، مفاتيح الأمان، الإضافات، الودجات.
  • configureServices اختياري. يتم تشغيله بعد أن قامت Doconut بتسجيل خدماتها الخاصة وقبل بناء الحاوية، لذا يمكنه إضافة خدمات — AddDoconutDistributed لمزرعة ويب هو المعتاد — أو استبدال تسجيل قامت Doconut بإنشائه.

النداء الأول هو الفائز. Initialize غير قابل للتكرار: نداء ثاني يُعيد النتيجة فورًا، ولا أحد من المفوضين الخاصين به يُنفّذ. هذا يحافظ على Application_Start مكرر غير ضار، لكنه يعني أيضًا أن الإعداد لا يمكن تغييره باستدعاء Initialize مرة أخرى — أعد تدوير مجموعة التطبيقات بدلاً من ذلك.

استثناء يُرمى هنا — إضافة بدون ترخيص، خيارات غير صالحة، تكوين مزرعة غير مكتمل — يحدث داخل Application_Start. ثم يرد ASP.NET على كل طلب بـ 500 فارغ، ويتم تسجيل الاستثناء فقط في سجل أحداث Windows (سجل التطبيقات، المصدر ASP.NET).

الخدمات و IsInitialized

System.Web لا يدعم حقن البنية للمتحكمات أو الصفحات أو المعالجات، لذا حل خدمات Doconut حيث تستخدمها:

csharp
// System.Web لا يدعم حقن المُنشئ: حل خدمات Doconut حيث تستخدمها.
var viewer = Doconut.DoconutHost.Services.GetRequiredService<Viewer>();

// مسجَّل فقط عندما يكون المكوّن الإضافي Converter (انظر صفحة المكوّن الإضافي).
var converter = Doconut.DoconutHost.Services.GetRequiredService<DocumentConverter>();

Services يرمي InvalidOperationException (DoconutHost.Initialize must be called in Application_Start (Global.asax) before any Doconut request is served.) عند القراءة قبل Initialize. الكود الذي قد يُنفّذ مبكرًا — وحدة، مُنشئ ثابت — يمكنه فحص IsInitialized أولاً.

ما الذي يحله كودك عادةً:

الخدمةمدة الحياةالدور
Viewerمؤقتفتح، إغلاق، تعليقات توضيحية، مساعدي الموارد — انظر عارض
DocumentConverterمؤقتالتحويل — دائمًا مسجل؛ حلّه بدون ملحق Converter يرمي InvalidOperationException يذكر الملحق الذي يجب إضافته
DocumentSignerمؤقتالتوقيع — يتطلب ملحق Signer (انظر ملحق التوقيع)
IDoconutLicenseServiceمفردالترخيص المحمّل وقدراته — انظر الترخيص
DoconutOptionsمفردالخيارات الممررة إلى Initialize
HealthCheckServiceمفردينفّذ فحص الصحة "doconut" (أدناه)

احل من DoconutHost.Services، ولا تستخدم حاوية خاصة بك. تسجيل Doconut في حاوية أخرى يبني مجموعة ثانية منفصلة من الخدمات لا يراها المعالج أو الوحدة: المستندات المفتوحة عبرها غير معروفة لـ DocImage.axd.

الإغلاق

csharp
// Global.asax.cs، Application_End - يوقف العمل في الخلفية ويُفرغ الحاوية.
// آمن للاستدعاء مرتين، وآمن عندما لا يتم تشغيل Initialize أبداً.
Doconut.DoconutHost.Shutdown();

Shutdown يوقف العمل الخلفي لـ Doconut (المستخدم في الوضع الموزع) ويفرغ الحاوية. من الآمن استدعاؤه مرتين، ومن الآمن عندما لم يُنفّذ Initialize أبداً — على سبيل المثال عندما تُعاد تدوير مجموعة التطبيقات قبل الطلب الأول.

فحص الصحة

Doconut يسجل فحص صحة باسم "doconut" يُبلغ عن حالة الترخيص. ASP.NET الكلاسيكي لا يملك نقطة نهاية لفحص الصحة، لذا عرّفه من خلال متحكم:

csharp
// GET /Health - Doconut يسجل فحص صحة "doconut" يُبلغ عن حالة الترخيص:
// صحي (صالح)، متدهور (تجريبي أو لا ملف ترخيص)، غير صحي (مرفوض أو منتهي الصلاحية).
public async Task<ActionResult> Index()
{
    var health = Doconut.DoconutHost.Services.GetRequiredService<HealthCheckService>();
    HealthReport report = await health.CheckHealthAsync();

    Response.StatusCode = report.Status == HealthStatus.Unhealthy ? 503 : 200;
    return Content(report.Status.ToString(), "text/plain");
}
الحالةالمعنى
Healthyتم تحميل ترخيص صالح
Degradedتجربة، أو لم يُعثر على ملف ترخيص
Unhealthyتم رفض الترخيص (مثلاً، ملف مُعدّل) أو انتهت صلاحيته

طرق امتداد ASP.NET Core

الحزمة تحتوي أيضًا على UseDoconut() وUseDoconutResources()، امتدادات خط أنابيب ASP.NET Core، لأنها تشارك شفرتها مع حزم ASP.NET Core. في هذه الحزمة كلاهما مُعلَّم بـ [Obsolete] ولا يُستخدمان: تطبيق System.Web لا يملك خط أنابيب طلب لإضافتهما إليه. بدائلهم هي تسجيلين Web.config من التثبيت:

ASP.NET Core.NET Framework 4.7.2
builder.Services.AddDoconut(...)DoconutHost.Initialize(...) في Application_Start
app.UseDoconut()Doconut.DocImageHandler على DocImage.axd في Web.config
app.UseDoconutResources()Doconut.DoconutResourceModule في Web.config
حقن البنيةDoconutHost.Services.GetRequiredService<T>()
إغلاق المضيفDoconutHost.Shutdown() في Application_End

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