DoconutOptions
Konfigurasikan layanan Doconut
DoconutOptions (namespace Doconut) adalah objek konfigurasi tunggal untuk seluruh SDK. Anda mengkonfigurasinya sekali, di dalam AddDoconut(), dan itu didaftarkan sebagai singleton.
builder.Services.AddDoconut(options =>
{
options.LicensePath = "Doconut.Viewer.lic";
options.UnsafeMode = false;
options.ShowDoconutInfo = false;
options.AddPlugin<Doconut.Plugins.Dicom.DicomPlugin>();
});Properti
| Tipe | Properti | Default | Deskripsi |
|---|---|---|---|
bool | ShowDoconutInfo | false | Ketika true, permintaan middleware tanpa token mengembalikan banner versi (Doconut <version> is running on <host>) alih-alih 404. Berguna sebagai pemeriksaan cepat; biarkan false di produksi. |
bool | UnsafeMode | false | Ketika true, melewati pemeriksaan keamanan sesi ASP.NET pada permintaan halaman. Biarkan false di produksi (lihat Konsep Inti → Sesi & Keamanan). |
string | MiddlewarePath | "/doconut" | Nilai koordinasi untuk endpoint page-image. Nilai ini divalidasi, tetapi tidak memasang cabang pipeline; pertahankan agar selaras dengan pemetaan UseDoconut() yang sebenarnya dan klien BasePath. |
string | ResourcesPath | "/doconut-res" | Awalan jalur URL untuk sumber daya JS/CSS/gambar/font yang disematkan. |
string | LicensePath | "" | Jalur ke file lisensi. Kosong → sumber lisensi berikutnya, lalu penemuan otomatis; tidak ada yang ditemukan → status evaluasi berwatermark tanpa kemampuan. |
string | LicenseContent | "" | Konten lisensi XML mentah (basis data, variabel lingkungan, manajer rahasia). Memiliki prioritas lebih tinggi daripada LicensePath. |
Stream? | LicenseStream | null | Lisensi sebagai aliran, dibaca sekali saat startup. Memiliki prioritas lebih tinggi daripada kedua sumber lainnya. |
bool | ResetLicense | false | Bendera kompatibilitas yang disiapkan. Implementasi .NET 8 saat ini tidak menggunakannya; restart aplikasi setelah mengganti lisensi. |
DoconutPluginRegistry | PluginRegistry | — | Registri hanya-baca yang mengumpulkan kontribusi plugin; dikonsumsi oleh pabrik penampil. Isi melalui AddPlugin<T>(). |
Prioritas lisensi (ditegakkan saat pendaftaran layanan): LicenseStream → LicenseContent → LicensePath → penemuan otomatis (lihat Memulai → Penyiapan Lisensi).
Metode
AddPlugin<TPlugin>()
DoconutOptions AddPlugin<TPlugin>() where TPlugin : IDoconutPlugin, new()Gunakan metode ini untuk paket Converter, DICOM, dan Signer yang dirilis dengan opt-in. Anotasi dan pencarian normal adalah fitur berlisensi bawaan dan tidak menggunakan AddPlugin<TPlugin>().
Mendaftarkan plugin pihak pertama (Converter, DICOM, Signer). Fluent — mengembalikan instance opsi. AddDoconut() melempar InvalidOperationException untuk lisensi yang hilang, file legacy TRIAL, atau lisensi berbayar yang tidak memberikan kemampuan plugin. Pendaftaran Temporary/Demo dipertahankan melewati kedaluwarsa dan menjadi subjek gerbang runtime (lihat Konsep Inti → Sistem Plugin).
Widget Converter opt-in diaktifkan dengan AddConverterWidget() dan ditampilkan melalui properti read-only ConverterWidget; opsinya didokumentasikan pada halaman Plugin Converter (Plugin → Plugin Converter). Widget Signer opt-in diaktifkan dengan cara yang sama, dengan AddSignerWidget(), dan ditampilkan melalui properti read-only SignerWidget; lihat Plugin Penandatangan.
RegisterViewer(extension, factory, defaultConfig?)
DoconutOptions RegisterViewer(
string extension, // ".myext" — titik depan opsional
Func<IFormatViewer> factory,
Func<BaseConfig>? defaultConfig = null)Mendaftarkan penampil khusus untuk ekstensi file. Penampil khusus memiliki prioritas lebih tinggi daripada penampil bawaan dan penampil plugin serta tidak dibatasi lisensi. Ketika defaultConfig dihilangkan dan dokumen dibuka tanpa konfigurasi eksplisit, sebuah ImageConfig digunakan.
Melempar ArgumentException (Extension must be a non-empty file extension.) untuk ekstensi kosong dan ArgumentNullException untuk factory null.
Validasi Startup
AddDoconut() memvalidasi opsi fail-fast, sehingga miskonfigurasi muncul sebagai pengecualian yang jelas saat startup alih-alih 404 yang membingungkan pada waktu permintaan:
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.Konfigurasi Umum
// Produksi: lisensi eksplisit, semua terkunci (semua default keamanan)
builder.Services.AddDoconut(options =>
{
options.LicenseContent = builder.Configuration["Doconut:License"] ?? "";
});
// Jalur khusus (mis. untuk menghindari konflik rute)
builder.Services.AddDoconut(options =>
{
options.MiddlewarePath = "/docs-engine";
options.ResourcesPath = "/docs-assets";
});Ketika Anda mengubah ResourcesPath, pertahankan ResPath widget klien tetap sinkron (lihat ViewerConfig).
MiddlewarePath bukan pemetaan rute ASP.NET Core otomatis. Jika Doconut harus menjawab hanya di bawah awalan khusus, pasang UseDoconut() pada cabang itu (misalnya dengan app.Map("/docs-engine", branch => branch.UseDoconut())) dan atur client BasePath ke awalan itu tanpa / yang terdepan ('docs-engine').
Apakah halaman ini membantu?