Буфери SwiftNIO
HokusaiNIO — це необов’язковий продукт, що поєднує Hokusai з ByteBuffer SwiftNIO. Саме його всередині використовують Hokusai Vapor і Hokusai Hummingbird, і він корисний безпосередньо в будь-якому сервері на NIO.
.product(name: "HokusaiNIO", package: "hokusai")let bytes = try Data(contentsOf: URL(fileURLWithPath: "scene.png"))var buffer = ByteBuffer(bytes: bytes)
// A ByteBuffer in: the readable bytes are adopted, so the buffer may be reused or released at once.let image = try Hokusai(buffer: buffer)buffer.clear()
// A ByteBuffer out, all at once...let whole = try await image.resize(width: 400).webp().byteBuffer()print("byteBuffer:", whole.buffer.readableBytes, "bytes,", whole.info.width, "×", whole.info.height)
// ...or streamed, one buffer at a time, with the backpressure of writeChunks.var received = 0, count = 0let info = try await image.resize(width: 400).jpeg().writeByteBuffers(chunkSize: 4096) { chunk in received += chunk.readableBytes count += 1}print("writeByteBuffers:", count, "buffers,", received, "bytes; info says", info.byteCount)
// Output.byteBuffer wraps bytes you already have in a fresh buffer.let output = try await image.resize(width: 100).png().data()print("Output.byteBuffer:", output.byteBuffer.readableBytes, "bytes")| API | Що робить |
|---|---|
Hokusai(buffer:options:byteTransferStrategy:) |
Приймає читабельні байти ByteBuffer як незмінний вхід, тож буфер можна вивільнити, повторно використати чи змінити до асинхронного виконання. |
byteBuffer(allocator:) |
Виконує й кодує в буфер з allocator; повертає NIOOutput (buffer, info). Увесь результат тримається в пам’яті: це зручність, а не потоковий шлях. Закодовані байти копіюються один раз, просто в буфер алокатора. |
writeByteBuffers(allocator:chunkSize:_:) |
Основний writeChunks, де кожна частина копіюється в буфер з allocator. Власної черги немає: наступний буфер не створюється, доки consume не повернеться, і саме так повільний ResponseBodyWriter чи канал сповільнює кодування. Той самий виклик працює для PDF. |
Hokusai(spooling:options:memoryLimit:spoolDirectory:) із ByteBuffer |
Ініціалізатор завантаження через проміжний файл для типу тіла серверів NIO (Великі завантаження); кожен буфер копіюється один раз, тимчасово, у Data. |
Output.byteBuffer |
Власні байти виводу у свіжому буфері. |
Програма вивела: byteBuffer дав 5 036 байтів (400 × 250); writeByteBuffers доставив 9 660 байтів у 3 буферах не більше ніж по 4 096 байтів, і OutputInfo.byteCount збігся; Output.byteBuffer обгорнув PNG на 7 072 байти. Помилки, скасування й поведінка часткових потоків — як у writeChunks (завершальні операції).