TPdfRangeRequestScheduler - PDFium Delphi Component

Unit: PDFium

Penjadwalan yang thread-safe dan netral transport untuk request byte-range PDF sparse

Syntax

type TPdfRangeRequestScheduler = class ... end;

Methods

Method	Description
`Create`	Membuat scheduler kosong dengan dua retry dan tanpa batas ukuran request
`Destroy`	Melepaskan status scheduler dan primitif sinkronisasinya
`Reset(AFileSize)`	Membatalkan pekerjaan transport aktif, memulai generasi baru, mengosongkan penghitung, dan secara opsional menegakkan batas file logis
`Cancel`	Mengosongkan pekerjaan yang diantrekan, membatalkan generasi request yang sedang berjalan, dan memicu `OnCancelRequest` di luar lock scheduler
`MarkAvailable(Offset, Size)`	Mencatat byte yang disuplai eksternal, menghapus tumpang-tindih yang tertunda, dan membatalkan transfer aktif yang redundan
`EnqueueHints(Hints, Priority)`	Menambahkan interval yang belum ada, mempertahankan batas prioritas dan retry yang persis, serta menganulir transfer berprioritas lebih rendah yang tumpang-tindih
`TryDequeue(out Request)`	Mengembalikan request berbatas dengan prioritas tertinggi dan offset terendah lalu menandainya sedang berjalan
`CompleteRequest(Request)`	Menandai respons lengkap sebagai tersedia setelah host menyimpan byte-nya
`CompleteRequest(Request, BytesReceived)`	Mengomitmen prefiks respons yang pendek lalu mengantre ulang atau mengabaikan sisanya di bawah batas retry
`FailRequest(Request)`	Mengulang atau mengabaikan request yang sedang berjalan sesuai `MaxRetryCount`
`IsRangeAvailable(Offset, Size)`	Menguji apakah interval yang selesai sepenuhnya menutupi sebuah rentang
`DataAvailable`	Mengadaptasi pencarian rentang selesai ke `TPdfDataAvailableEvent`
`CopyCompletedRanges`	Mengembalikan snapshot stabil interval tersedia yang sudah digabung
`CopyStatistics`	Menyalin penghitung melalui metode yang ramah C++Builder

Properties and events

Member	Type	Description
`Cancelled`	Boolean	Apakah generasi aktif telah dibatalkan
`FileSize`	UInt64	Batas request logis, atau nol untuk scheduler standalone tanpa batas
`MergeGap`	UInt64	Celah maksimum tak tertutup yang memenuhi syarat untuk digabung ketika tidak melintasi byte yang tersedia maupun sedang berjalan
`MaxRequestSize`	UInt64	Ukuran maksimum yang dikembalikan satu panggilan `TryDequeue`
`MaxRetryCount`	Integer	Jumlah retry setelah percobaan transport awal
`Statistics`	TPdfRangeRequestStatistics	Snapshot atomik yang mencakup `PendingRequestCount`, `InFlightRequestCount`, `AvailableRangeCount`, penghitung byte `PendingBytes`, `InFlightBytes`, `CompletedBytes`, dan `TransferredBytes`, serta total `FailedAttemptCount`, `RetriedRequestCount`, `AbandonedRequestCount`, `DequeuedRequestCount`, `CompletedRequestCount`, `PartialRequestCount`, `CancelledRequestCount`, dan `SupersededRequestCount`
`OnCancelRequest`	TPdfRangeRequestCancelEvent	Meminta pembatalan satu operasi transport aktif berdasarkan ID request dan percobaan

Scheduling rules

rrpImmediate dideque sebelum rrpNormal, lalu rrpBackground
Petunjuk berprioritas lebih tinggi yang tumpang-tindih hanya mempromosikan bagian tumpang-tindihnya, bukan ekor bersebelahan dari request background
Petunjuk berprioritas lebih tinggi yang tumpang-tindih membatalkan transport berprioritas lebih rendah yang aktif sebelum interval persisnya diantrekan
Promosi tidak memindahkan hitungan retry berprioritas rendah ke pekerjaan interaktif yang baru
Byte yang selesai dan sedang berjalan tidak pernah dijembatani oleh MergeGap, sehingga transfer ganda dicegah
ID request hanya dibuat ketika pekerjaan dideque; sebuah retry menerima ID baru dan Attempt berbasis satu yang bertambah
Penyelesaian dari request yang dibatalkan, di-reset, disuperseedasi, atau sudah selesai mengembalikan False tanpa memutasi cakupan saat ini

Example

var
  Request: TPdfRangeRequest;
begin
  while Scheduler.TryDequeue(Request) do
  begin
    try
      WriteRangeResponse(Request.Offset, Request.Size);
      Scheduler.CompleteRequest(Request);
    except
      Scheduler.FailRequest(Request);
    end;
  end;
end;

Threading and transport contract

Semua metode scheduler menserialisasi status scheduler, termasuk statistik dan snapshot rentang selesai
Scheduler tidak melakukan I/O jaringan, tidak mengalokasikan worker thread, dan tidak menunda retry
Tulis byte respons ke penyimpanan random-access di belakang sebelum memanggil CompleteRequest
TStream.Position bersama tetap menjadi tanggung jawab sinkronisasi host; gunakan I/O berposisi atau lock stream eksternal
OnCancelRequest berjalan di luar lock internal untuk pembatalan sesi, preempsi prioritas, dan pembatalan transfer redundan

Related types

TPdfRangeRequest, TPdfRangeRequests, TPdfRangeRequestPriority, TPdfRangeRequestStatistics, TPdfRangeRequestCancelEvent, TPdfProgressiveDocument

Kelas TPdfRangeRequestScheduler