Перейти до вмісту
Hokusai2.2.2
ivantokar.com

Буфери SwiftNIO

HokusaiNIO — це необов’язковий продукт, що поєднує Hokusai з ByteBuffer SwiftNIO. Саме його всередині використовують Hokusai Vapor і Hokusai Hummingbird, і він корисний безпосередньо в будь-якому сервері на NIO.

Package.swift
.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 = 0
let 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 (завершальні операції).