Завантаження та відповіді
Hokusai Vapor завантажує запит у звичайний незмінний конвеєр Hokusai. Перетворюйте його так само, як у будь-якому застосунку Swift, оберіть кодувальник і поверніть потокову HTTP-відповідь.
Необроблене тіло запиту
Section titled “Необроблене тіло запиту”app.post("resize") { req async throws -> Response in try await req.hokusaiImage() .resize(width: 800, height: 600, fit: .cover) .jpeg(quality: 85) .response()}Тіло запиту має містити закодовані байти зображення. Тіло читається в міру надходження й ніколи не понад maximumSize (за замовчуванням 20 МіБ): оголошений Content-Length понад ліміт відхиляється до читання будь-якого байта, а тіло без нього відхиляється, щойно перевищить ліміт, обидва випадки дають 413. Невелике завантаження лишається в пам’яті; більше за memoryLimit (за замовчуванням 1 МіБ) переходить у приватний тимчасовий файл. Відсутнє або нечитабельне тіло повертає 400 Bad Request.
Multipart-завантаження
Section titled “Multipart-завантаження”app.post("upload") { req async throws -> Response in try await req.hokusaiImage(field: "image") .resize(width: 200, height: 200, fit: .cover) .png() .response()}Ім’я поля має збігатися з файловим полем multipart. Відсутні поля та нечитабельні дані файлу повертають 400 Bad Request.
Формати виводу
Section titled “Формати виводу”Оберіть кодувальник на конвеєрі, потім викличте response(). Content-Type береться з формату, який дає кодувальник, а тіло записується в міру кодування, тож повільний клієнт сповільнює кодування замість того, щоб збільшувати пам’ять:
try await image.jpeg(quality: 85).response()try await image.png().response()try await image.webp(quality: 82).response(headers: ["Cache-Control": "public, max-age=3600"])try await image.avif(quality: 50).response()try await image.pdf().response()Відповіді PDF — це односторінкові растрові документи на базі Cairo. Вони підходять для згенерованих звітів із зображень і багатошарових композицій, але не зберігають виділюваний векторний текст.
Необов’язкові приклади маршрутів
Section titled “Необов’язкові приклади маршрутів”Зареєструйте ImageProcessingRoutes для простих прикладів із необробленим тілом:
try ImageProcessingRoutes.register(to: app.grouped("api", "images"))POST /api/images/text?text=Hello&fontSize=48(такожfont,strokeWidth,quality)POST /api/images/convert?format=webp&quality=82(такожcompression)
Обидва приймають вихідне зображення як необроблене тіло запиту.
Помилки
Section titled “Помилки”HokusaiError відображається на статус за своїм випадком: invalidInput і invalidOption дають 400, decode — 422, resource — 413 для байтів, 422 для пікселів або каналів і 503 для черги обчислень, unsupported — 501, а io, transform, encode і runtime — 500. response() і hokusaiImage уже застосовують це відображення; для маршруту, що сам виконує конвеєр через data() або write(to:), додайте HokusaiErrorMiddleware().