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

Vapor: повний сервіс

Ця сторінка збирає частини Hokusai Vapor в один невеликий сервіс: три маршрути завантаження, відображення помилок і конфігурація під час запуску. Код компілюється в CI проти hokusai-vapor 2.1.0 (examples/integrations/vapor-app), тож відповідає випущеному API.

func routes(_ app: Application) throws {
// Map HokusaiError to HTTP statuses for any route that evaluates a pipeline itself.
let images = app.grouped(HokusaiErrorMiddleware())
// Raw body: POST /resize --data-binary @photo.jpg
images.post("resize") { req async throws -> Response in
try await req.hokusaiImage(maximumSize: 5 * 1024 * 1024) // 413 above 5 MiB
.resize(width: 800, height: 600, fit: .cover)
.webp(quality: 82)
.response() // Content-Type: image/webp, streamed
}
// Multipart: POST /upload with an "image" file field
images.post("upload") { req async throws -> Response in
try await req.hokusaiImage(field: "image")
.autoOrient()
.resize(width: 256, height: 256, fit: .cover, position: .attention)
.png()
.response(headers: ["Cache-Control": "public, max-age=3600"])
}
// A large body, streamed to a temporary file instead of held in memory
images.on(.POST, "large", body: .stream) { req async throws -> Response in
try await req.hokusaiImage(
options: InputOptions(limits: InputLimits(maxPixels: 50_000_000)),
maximumSize: 200 * 1024 * 1024
)
.resize(width: 1600, height: 1600, fit: .inside, withoutEnlargement: true)
.jpeg(quality: 85)
.response()
}
}
func configure(_ app: Application) throws {
// Optional: freeze Hokusai's process-level settings before the first image.
try app.hokusai.configure(.init(maxConcurrentEvaluations: .fixed(4), maxQueuedEvaluations: 64))
try routes(app)
}

Що робить кожна частина

Section titled “Що робить кожна частина”
  • HokusaiErrorMiddleware відображає HokusaiError, викинуту маршрутом, на статус HTTP за її випадком: invalidInput / invalidOption — 400, decode — 422, resource — 413 для байтів, 422 для пікселів чи каналів, 503 для повної черги обчислень, unsupported — 501, а io / transform / encode / runtime — 500. req.hokusaiImage і response() уже застосовують відображення до того, що виконують; middleware покриває маршрути, які самі викликають data() або write(to:).
  • /resize читає необроблене тіло з maximumSize 5 МіБ. Тіло читається в міру надходження: оголошений Content-Length понад ліміт відхиляється до читання будь-якого байта, а тіло без нього відхиляється, щойно перевищить ліміт, обидва випадки дають 413.
  • /upload читає поле image форми multipart, застосовує autoOrient(), щоб фото з телефона було вертикальним, робить обрізання attention 256 × 256 і відповідає PNG із заголовком Cache-Control.
  • /large використовує body: .stream, щоб Vapor не збирав тіло, і maximumSize 200 МіБ. Тіло переходить у тимчасовий файл понад memoryLimit (типово 1 МіБ), тож закодоване завантаження займає щонайбільше memoryLimit плюс одну частину пам’яті; декодування обмежує окремо maxPixels. fit: .inside з withoutEnlargement — безпечна зміна розміру для невідомих розмірів (чому не .cover).
  • configure фіксує RuntimeConfiguration до першого зображення: чотири одночасні обчислення та черга з 64, після чого нові запити завершуються 503, а не накопичуються.

response() записує тіло в міру кодування зі зворотним тиском: повільний клієнт сповільнює кодування замість того, щоб збільшувати пам’ять, а відключення клієнта скасовує завдання запиту, що зупиняє обчислення. Content-Type береться з кодувальника. До фіксації відповіді читається заголовок джерела, тож відсутнє чи нечитабельне зображення — це 4xx, а не зламане 200.

Контрольний список для продакшну

Section titled “Контрольний список для продакшну”
  • Задайте maximumSize, InputLimits.maxPixels і RuntimeConfiguration.maxOutputPixels за власною політикою.
  • Задайте blockUntrustedOperations, якщо завантаження надходять від недовірених користувачів.
  • Задайте maxConcurrentEvaluations і maxQueuedEvaluations за ліміти контейнера (Docker).
  • Не додавайте хук завершення; у Hokusai немає публічного завершення роботи.
  • Перевірте обрізаним файлом і величезним resize(width:), щоб побачити своє відображення помилок (усунення проблем).