Tùy chọn Directive Guard

Không gian tên: Nalix.Runtime.Options
Assembly: Nalix.Runtime

DirectiveGuardOptions (public sealed partial class DirectiveGuardOptions : ConfigurationLoader, IValidatableConfiguration) cấu hình thời gian chờ theo từng kết nối mà DirectiveGuard áp dụng trước khi gửi lại các directive thất bại đầu vào lặp lại (UNAUTHORIZED, RATE_LIMITED và TIMEOUT).

Ánh xạ mã nguồn#

• src/Nalix.Runtime/Options/DirectiveGuardOptions.cs
• src/Nalix.Runtime/Internal/RateLimiting/DirectiveGuard.cs
• src/Nalix.Runtime/Internal/RuntimeConnectionState.cs
• src/Nalix.Runtime/Extensions/ConnectionExtensions.cs
• src/Nalix.Runtime/Middleware/Standard/PermissionMiddleware.cs
• src/Nalix.Runtime/Middleware/Standard/RateLimitMiddleware.cs
• src/Nalix.Runtime/Middleware/Standard/TimeoutMiddleware.cs

Tham chiếu thuộc tính#

Được nạp từ mục [DirectiveGuard] của default.ini thông qua ConfigurationManager.Instance.Get<DirectiveGuardOptions>():

Cách DirectiveGuard hoạt động#

Khi một middleware đầu vào từ chối hoặc hết thời gian chờ một gói tin, nó gọi:

DirectiveGuard.TryAcquire(
    IConnection connection,
    Func<RuntimeConnectionState, long> stateSelector,
    Action<RuntimeConnectionState, long> stateUpdater,
    int? cooldownMs = null)

flowchart LR
    A["Middleware Denies Packet"] --> B["DirectiveGuard.TryAcquire(...)"]
    B --> C{"resolvedCooldownMs <= 0?"}
    C -->|Yes| Allow["Return true (Send Directive)"]
    C -->|No| D["Get connection.GetRuntimeState()"]
    D --> E["lock (state.DirectiveGuardLock)"]
    E --> F{"lastSent == 0 || (nowMs - lastSent) >= resolvedCooldownMs?"}
    F -->|Yes| G["stateUpdater(state, nowMs) -> Return true"]
    F -->|No| H["Return false (Suppress Duplicate Directive)"]

Dấu thời gian theo từng loại trên RuntimeConnectionState#

DirectiveGuard theo dõi ba dấu thời gian Environment.TickCount64 độc lập trên RuntimeConnectionState của mỗi kết nối (được bảo vệ bởi state.DirectiveGuardLock):

Việc chặn một Directive trùng lặp chỉ ngăn khuếch đại phản hồi đi ra ngoài — gói bị từ chối vẫn bị loại bỏ và không bao giờ đến được handler.

API liên quan#

• Permission Middleware
• Policy Rate Limiter
• Timeout Middleware
• Tùy chọn Token Bucket