DoconutExtensions

DoconutExtensions (namespace Doconut.Middleware) là lớp tĩnh chứa ba lời gọi mà mọi máy chủ Doconut thực hiện: một đăng ký dịch vụ và hai đăng ký middleware.

builder.Services.AddDoconut(options => { /* … */ });
// …
app.UseDoconutResources(); // TRƯỚC UseDoconut()
app.UseDoconut();

AddDoconut

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

Xây dựng DoconutOptions, xác thực chúng nhanh chóng (xem DoconutOptions → Startup validation), và đăng ký toàn bộ đồ thị dịch vụ:

Không có lời gọi tương đương trong thư viện .NET Standard trước đây. Nó đã tạo new Viewer(cache, accessor) cho mỗi yêu cầu và truyền các tùy chọn tới middleware; cả hai đều được thay thế bằng đăng ký duy nhất này.

Hai hành vi đáng lưu ý:

• Converter yêu cầu plugin của nó. Việc giải quyết DocumentConverter mà không có options.AddPlugin<ConverterPlugin>() sẽ ném ngoại lệ:

InvalidOperationException: No IDocumentConverter is registered. Add the converter plugin: options.AddPlugin<Doconut.Plugins.Converter.ConverterPlugin>().

• Quyền plugin được xác thực khi khởi động. Một giấy phép thiếu, tệp legacy TRIAL, hoặc giấy phép trả phí mà không có khả năng plugin đã đăng ký sẽ thất bại vào thời điểm AddDoconut(). Các đăng ký tạm thời/Demo tồn tại qua ngày hết hạn, trong khi các cổng runtime thu hồi các khả năng đã hết hạn.

Kiểm tra sức khỏe tích hợp với cơ chế chuẩn của ASP.NET Core — ánh xạ nó nếu bạn muốn trạng thái giấy phép trên endpoint sức khỏe của mình:

app.MapHealthChecks("/health");

UseDoconut

IApplicationBuilder UseDoconut(this IApplicationBuilder app)

Thêm middleware page-image của Doconut. Nó trả lời mọi yêu cầu mang tham số truy vấn ?token= — các trang, hình thu nhỏ, tìm kiếm, chú thích, hành động trang (bảng yêu cầu đầy đủ nằm trong Core Concepts → How the Viewer Works). Khi UnsafeMode là false, lớp bảo mật tài liệu sẽ được tự động kết nối trước nó.

Nó không nhận bất kỳ đối số nào. Việc truyền một instance DoconutOptions ở đây là cách của thư viện trước và hiện không còn biên dịch được.

Mẫu tham chiếu định tuyến các yêu cầu của widget qua một nhánh đường dẫn, giữ nguyên dạng yêu cầu lịch sử:

app.MapWhen(
    ctx => ctx.Request.Path.Value?.EndsWith("DocImage.axd", StringComparison.OrdinalIgnoreCase) == true,
    branch => branch.UseDoconut());

UseDoconutResources

IApplicationBuilder UseDoconutResources(this IApplicationBuilder app)

Cung cấp các tệp JS, CSS, hình ảnh và phông chữ nhúng tại DoconutOptions.ResourcesPath (mặc định /doconut-res). Đây là các tệp mà Viewer.ReferenceCss() / ReferenceScripts() phát ra thẻ cho.

Luôn gọi nó trước UseDoconut(). Nếu khu vực viewer trống và console trình duyệt hiển thị lỗi 404 cho /doconut-res/..., lời gọi này bị thiếu hoặc đặt sai vị trí.

Đây là sự thay thế được hỗ trợ cho việc kết nối middleware xử lý tài nguyên nhúng một cách thủ công.

Phục vụ từ lưu trữ chia sẻ

Hai đăng ký bổ sung tồn tại cho các triển khai nơi nút render tài liệu không nhất thiết là nút phục vụ các trang của nó. Cả hai đều được bao quát từ đầu đến cuối trong Triển khai phân tán; các chữ ký là:

IServiceCollection AddDoconutDistributedAsyncPublish(...)   // hàng đợi xuất bản nền cho phép đăng ký
IServiceCollection AddDoconutDistributedWidgets(...)        // kho lưu trữ hỗ trợ chia sẻ cho việc tải lên widget

Phần đọc là một middleware riêng biệt từ gói Doconut.Clouds:

IApplicationBuilder UseDoconutCloud<THandler>(
    this IApplicationBuilder app,
    Action<CloudOptions>? configure = null,
    string pathPrefix = "/doconut-cloud")
    where THandler : BaseCloudHandler

UseDoconutWebFarm(...) và WebFarmOptions không tồn tại trong phiên bản này. Xem hướng dẫn di chuyển để biết ánh xạ từng cài đặt.

Tóm tắt thứ tự

app.UseRouting();
app.UseSession();          // cần thiết khi UnsafeMode = false
app.UseDoconutResources(); // Lần gọi Doconut đầu tiên
app.UseDoconut();          // Lần gọi Doconut thứ hai (hoặc qua một nhánh MapWhen)