DoconutOptions
กำหนดค่าบริการ Doconut
DoconutOptions (namespace Doconut) เป็นอ็อบเจ็กต์การกำหนดค่าที่ใช้เพียงครั้งเดียวสำหรับ SDK ทั้งหมด คุณกำหนดค่าเพียงครั้งเดียวในคอลแบ็กที่คุณส่งให้กับ DoconutHost.Initialize ใน Application_Start.
Doconut.DoconutHost.Initialize(options =>
{
options.LicensePath = HostingEnvironment.MapPath("~/wwwroot/Doconut.Viewer.lic");
options.UnsafeMode = false;
options.ShowDoconutInfo = false;
options.AddPlugin<Doconut.Plugins.Dicom.DicomPlugin>();
});คุณสมบัติ
| ชนิด | คุณสมบัติ | ค่าเริ่มต้น | คำอธิบาย |
|---|---|---|---|
bool | UnsafeMode | false | เมื่อ false, DocImage.axd ให้บริการหน้าเฉพาะกับเซสชัน ASP.NET ที่เปิดเอกสาร (หรือในฟาร์ม, ให้กับเบราว์เซอร์ที่มีชื่อบัตรเซ็น) เมื่อ true, คำขอใด ๆ ที่มีโทเค็นจะได้รับการให้บริการ ปล่อยไว้เป็น false — ดู เซสชันและความปลอดภัย. |
bool | ShowDoconutInfo | false | เมื่อ true, คำขอ DocImage.axd ที่ไม่มีโทเค็นจะตอบกลับเป็น Doconut <version> is running on <host> แทน 404. มีประโยชน์เป็นการตรวจสอบเบื้องต้น; ปล่อยไว้เป็น false ในการผลิต. |
string | ResourcesPath | "/doconut-res" | คำนำหน้า URL ที่โมดูลทรัพยากรให้บริการสคริปต์, สไตล์, และรูปภาพที่ฝังอยู่ |
string | LicensePath | "" | เส้นทางเต็มไปยังไฟล์ใบอนุญาต. ว่าง → แหล่งใบอนุญาตถัดไป, จากนั้นค้นหาอัตโนมัติ; ไม่พบ → การประเมินที่มีลายน้ำโดยไม่มีความสามารถ |
string | LicenseContent | "" | เนื้อหาใบอนุญาตดิบ (ฐานข้อมูล, ตัวแปรสภาพแวดล้อม, ที่เก็บความลับ). มีลำดับความสำคัญเหนือ LicensePath. |
Stream? | LicenseStream | null | ใบอนุญาตเป็นสตรีม, อ่านครั้งเดียวที่เริ่มต้น. มีลำดับความสำคัญเหนือแหล่งอื่นทั้งสอง. |
string | MiddlewarePath | "/doconut" | ไม่ได้ใช้โดย System.Web. จุดสิ้นสุดของหน้าเป็น always DocImage.axd handler ที่ประกาศใน Web.config. ค่าจะยังคงได้รับการตรวจสอบที่การเริ่มต้น (ดูด้านล่าง). |
bool | ResetLicense | false | ไม่ได้ใช้. ใบอนุญาตอ่านครั้งเดียว, ใน DoconutHost.Initialize; รีไซเคิลพูลแอปพลิเคชันหลังจากเปลี่ยนใบอนุญาต. |
DoconutPluginRegistry | PluginRegistry | — | รีจิสทรีแบบอ่านอย่างเดียวของการสนับสนุนปลั๊กอิน, เติมโดย AddPlugin<T>(). |
ลำดับความสำคัญของใบอนุญาต: LicenseStream → LicenseContent → LicensePath → การค้นหาอัตโนมัติ (ดู การตั้งค่าใบอนุญาต).
วิธีการ
AddPlugin<TPlugin>()
DoconutOptions AddPlugin<TPlugin>() where TPlugin : IDoconutPlugin, new()ลงทะเบียนปลั๊กอิน (Converter, DICOM, Signer). แบบ Fluent — คืนค่าอินสแตนซ์ของ options. Annotation และ Search เป็นฟีเจอร์ที่มาพร้อมใบอนุญาตและไม่ได้ใช้มัน.
หากไม่มีใบอนุญาตที่ใช้งานอยู่ให้สิทธิ์ความสามารถของปลั๊กอิน, DoconutHost.Initialize จะโยน InvalidOperationException จาก Application_Start, และไซต์จะตอบทุกคำขอด้วย 500 ว่างจนกว่าจะได้รับการแก้ไข; ข้อความอยู่ในบันทึกเหตุการณ์ของ Windows (ดู ระบบปลั๊กอิน).
Add…Widget()
DoconutOptions AddConverterWidget(Action<ConverterWidgetOptions>? configure = null)
DoconutOptions AddSignerWidget(Action<SignerWidgetOptions>? configure = null)วิดเจ็ตแบบ drop-in มีค่า ปิดโดยค่าเริ่มต้น. แต่ละการเรียก Add…Widget() จะเปิด endpoint ของวิดเจ็ตนั้นบน DocImage.axd, และต้องการให้ปลั๊กอินที่ตรงกันถูกลงทะเบียน. โมดูลทรัพยากรให้บริการสคริปต์ของวิดเจ็ตไม่ว่าคุณจะเปิดใช้งานหรือไม่, ดังนั้นวิดเจ็ตที่โหลดและวาดแต่ตอบ 404 ในการกระทำแรกของมันแสดงว่าขาดการเรียกนี้. วิดเจ็ต Converter มีเอกสารใน ปลั๊กอิน Converter; วิดเจ็ต Signer, AddSignerWidget(), ใน ปลั๊กอิน Signer.
RegisterViewer(extension, factory, defaultConfig?)
DoconutOptions RegisterViewer(
string extension, // ".myext" — จุดนำเป็นตัวเลือก
Func<IFormatViewer> factory,
Func<BaseConfig>? defaultConfig = null)ลงทะเบียน ตัวดูแบบกำหนดเอง สำหรับส่วนขยายไฟล์. ตัวดูแบบกำหนดเองมีลำดับความสำคัญเหนือตัวดูที่มาพร้อมและตัวดูปลั๊กอินและไม่ได้จำกัดโดยใบอนุญาต. เมื่อ defaultConfig ถูกละเว้นและเอกสารเปิดโดยไม่มีการกำหนดค่าชัดเจน, จะใช้ ImageConfig.
โยน ArgumentException (Extension must be a non-empty file extension.) สำหรับส่วนขยายว่างและ ArgumentNullException สำหรับ factory ที่เป็น null.
การตรวจสอบการเริ่มต้น
DoconutHost.Initialize ตรวจสอบความถูกต้องของ options ก่อนสร้างอะไรเลย:
DoconutOptions.MiddlewarePath must be a non-empty path starting with '/'.
DoconutOptions.ResourcesPath must be a non-empty path starting with '/'.
DoconutOptions.MiddlewarePath and ResourcesPath must be different paths.MiddlewarePath ถูกตรวจสอบแม้ว่า System.Web จะไม่ใช้มัน, ดังนั้นปล่อยไว้ที่ค่าเริ่มต้น. เช่นข้อยกเว้นทุกอย่างที่โยนจาก Application_Start, ความล้มเหลวในการตรวจสอบจะแสดงเป็น 500 ว่างในทุกคำขอ, พร้อมข้อความในบันทึกเหตุการณ์ของ Windows.
การกำหนดค่าทั่วไป
// Production: ใบอนุญาตชัดเจน, ส่วนอื่นทั้งหมดใช้ค่าเริ่มต้นที่ปลอดภัย.
public static void ProductionLicense() =>
Doconut.DoconutHost.Initialize(options =>
{
options.LicenseContent = Environment.GetEnvironmentVariable("DOCONUT_LICENSE") ?? "";
});
// เส้นทางทรัพยากรที่กำหนดเอง (เช่น เพื่อหลีกเลี่ยงความขัดแย้งของเส้นทาง). เก็บ ResPath ของ viewer และ MVC ใด ๆ
// IgnoreRoute ตามขั้นตอนนั้น: "/docs-assets" หมายถึง ResPath: 'docs-assets/images'.
public static void CustomResourcePath() =>
Doconut.DoconutHost.Initialize(options =>
{
options.ResourcesPath = "/docs-assets";
});เมื่อคุณเปลี่ยน ResourcesPath, ให้เปลี่ยนสามอย่างพร้อมกัน: ตัวเลือก, ResPath ของวิดเจ็ต ('docs-assets/images' สำหรับ "/docs-assets"), และใน MVC, IgnoreRoute สำหรับเส้นทางทรัพยากร (routes.IgnoreRoute("docs-assets/{*pathInfo}")). endpoint DocImage.axd ไม่ย้าย: เส้นทางของมันตั้งโดยแอตทริบิวต์ path ของ handler ใน Web.config.
หน้านี้เป็นประโยชน์หรือไม่?