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читає необроблене тіло зmaximumSize5 МіБ. Тіло читається в міру надходження: оголошенийContent-Lengthпонад ліміт відхиляється до читання будь-якого байта, а тіло без нього відхиляється, щойно перевищить ліміт, обидва випадки дають413./uploadчитає полеimageформи multipart, застосовуєautoOrient(), щоб фото з телефона було вертикальним, робить обрізанняattention256 × 256 і відповідає PNG із заголовкомCache-Control./largeвикористовуєbody: .stream, щоб Vapor не збирав тіло, іmaximumSize200 МіБ. Тіло переходить у тимчасовий файл понадmemoryLimit(типово 1 МіБ), тож закодоване завантаження займає щонайбільшеmemoryLimitплюс одну частину пам’яті; декодування обмежує окремоmaxPixels.fit: .insideзwithoutEnlargement— безпечна зміна розміру для невідомих розмірів (чому не.cover).configureфіксуєRuntimeConfigurationдо першого зображення: чотири одночасні обчислення та черга з 64, після чого нові запити завершуються503, а не накопичуються.
Поведінка відповіді
Section titled “Поведінка відповіді”response() записує тіло в міру кодування зі зворотним тиском: повільний клієнт сповільнює кодування замість того, щоб збільшувати пам’ять, а відключення клієнта скасовує завдання запиту, що зупиняє обчислення. Content-Type береться з кодувальника. До фіксації відповіді читається заголовок джерела, тож відсутнє чи нечитабельне зображення — це 4xx, а не зламане 200.
Контрольний список для продакшну
Section titled “Контрольний список для продакшну”- Задайте
maximumSize,InputLimits.maxPixelsіRuntimeConfiguration.maxOutputPixelsза власною політикою. - Задайте
blockUntrustedOperations, якщо завантаження надходять від недовірених користувачів. - Задайте
maxConcurrentEvaluationsіmaxQueuedEvaluationsза ліміти контейнера (Docker). - Не додавайте хук завершення; у Hokusai немає публічного завершення роботи.
- Перевірте обрізаним файлом і величезним
resize(width:), щоб побачити своє відображення помилок (усунення проблем).