diff --git a/wordpdf-app/src/main/java/ru/pjandro/wordpdf/app/ApiExceptionHandler.java b/wordpdf-app/src/main/java/ru/pjandro/wordpdf/app/ApiExceptionHandler.java index 57e0c98..8a2bc14 100644 --- a/wordpdf-app/src/main/java/ru/pjandro/wordpdf/app/ApiExceptionHandler.java +++ b/wordpdf-app/src/main/java/ru/pjandro/wordpdf/app/ApiExceptionHandler.java @@ -2,6 +2,7 @@ package ru.pjandro.wordpdf.app; import org.slf4j.Logger; import org.slf4j.LoggerFactory; +import org.springframework.beans.factory.annotation.Value; import org.springframework.http.HttpStatus; import org.springframework.http.ResponseEntity; import org.springframework.web.bind.MissingServletRequestParameterException; @@ -9,6 +10,7 @@ import org.springframework.web.bind.annotation.ExceptionHandler; import org.springframework.web.bind.annotation.RestControllerAdvice; import org.springframework.web.multipart.MaxUploadSizeExceededException; import org.springframework.web.multipart.support.MissingServletRequestPartException; +import org.springframework.web.method.annotation.MethodArgumentTypeMismatchException; import org.springframework.web.servlet.resource.NoResourceFoundException; import ru.pjandro.wordpdf.ValidationException; @@ -26,6 +28,13 @@ final class ApiExceptionHandler { private static final Logger LOG = LoggerFactory.getLogger(ApiExceptionHandler.class); + /** Значение {@code spring.servlet.multipart.max-file-size} — для текста 413. */ + private final String maxFileSize; + + ApiExceptionHandler(@Value("${spring.servlet.multipart.max-file-size:100MB}") String maxFileSize) { + this.maxFileSize = maxFileSize; + } + /** Тело ответа ошибки; Jackson сериализует record как есть. */ record ApiError(String error) { } @@ -65,15 +74,16 @@ final class ApiExceptionHandler { } /** - * Контейнерный потолок multipart (100 МБ в application.properties) + * Контейнерный потолок multipart ({@code spring.servlet.multipart.max-file-size}) * сработал раньше ядра: срабатывает только на инфраструктурный лимит, * авторитетный (свойство {@code wordpdf.max-mb}/env {@code WORDPDF_MAX_MB}) * проверяет {@code WordPdfValidator} и отвечает 400 своим текстом. + * Текст берётся из свойства — не расходится с реальной конфигурацией сервера. */ @ExceptionHandler(MaxUploadSizeExceededException.class) ResponseEntity tooLarge(MaxUploadSizeExceededException e) { return ResponseEntity.status(HttpStatus.PAYLOAD_TOO_LARGE) - .body(new ApiError("Файл больше 100 МБ")); + .body(new ApiError("Файл больше " + maxFileSize + " — лимит multipart сервера")); } /** Партита {@code file} нет в запросе — обе формы исключения возможны. */ @@ -96,6 +106,13 @@ final class ApiExceptionHandler { .body(new ApiError("Не найдено")); } + /** Битое значение факультативного параметра (errorOnCharts=tru3) — ошибка клиента. */ + @ExceptionHandler(MethodArgumentTypeMismatchException.class) + ResponseEntity badParam(MethodArgumentTypeMismatchException e) { + return ResponseEntity.badRequest() + .body(new ApiError("Некорректное значение параметра «" + e.getName() + "»")); + } + /** Прочее — внутренняя ошибка; подробность только в лог, не в ответ. */ @ExceptionHandler(Exception.class) ResponseEntity unexpected(Exception e) { diff --git a/wordpdf-app/src/main/java/ru/pjandro/wordpdf/app/ApiKeyFilter.java b/wordpdf-app/src/main/java/ru/pjandro/wordpdf/app/ApiKeyFilter.java index 5c269fc..0b3a845 100644 --- a/wordpdf-app/src/main/java/ru/pjandro/wordpdf/app/ApiKeyFilter.java +++ b/wordpdf-app/src/main/java/ru/pjandro/wordpdf/app/ApiKeyFilter.java @@ -24,6 +24,11 @@ import java.security.MessageDigest; * *

Регрессии — ApiKeyFilterTest#forwardedPrefix_healthStaysOpen, * ApiKeyFilterTest#docsOpenWithoutKey.

+ * + *

Путь с точечными сегментами ({@code ..}, {@code %2e}) не считается + * открытым: контейнер матчит по сырому URI, а нормализацию {@code /actuator/../api/…} + * может выполнить последующий обработчик — ключ спрашиваем всегда. + * Регрессия — ApiKeyFilterTest#dotSegmentOpenPrefix_rejected.

*/ @Component final class ApiKeyFilter extends OncePerRequestFilter { @@ -33,6 +38,10 @@ final class ApiKeyFilter extends OncePerRequestFilter { /** Открытые пути без ключа: actuator (HEALTHCHECK контейнера) и springdoc-документация. */ private static final String[] OPEN_PREFIXES = {"/actuator/", "/swagger-ui", "/v3/api-docs"}; + /** Точечные сегменты в сыром URI — не «открытый» путь (см. javadoc класса). */ + private static final String DOT_SEGMENT = ".."; + private static final String ENCODED_DOT = "%2e"; + /** null — аутентификация выключена. */ private final byte[] expected; @@ -73,6 +82,10 @@ final class ApiKeyFilter extends OncePerRequestFilter { } private static boolean isOpen(String path) { + if (path.contains(DOT_SEGMENT) + || path.toLowerCase(java.util.Locale.ROOT).contains(ENCODED_DOT)) { + return false; + } for (String prefix : OPEN_PREFIXES) { if (path.startsWith(prefix)) { return true; diff --git a/wordpdf-app/src/test/java/ru/pjandro/wordpdf/app/ApiExceptionHandlerTest.java b/wordpdf-app/src/test/java/ru/pjandro/wordpdf/app/ApiExceptionHandlerTest.java index a824e6e..4134bf3 100644 --- a/wordpdf-app/src/test/java/ru/pjandro/wordpdf/app/ApiExceptionHandlerTest.java +++ b/wordpdf-app/src/test/java/ru/pjandro/wordpdf/app/ApiExceptionHandlerTest.java @@ -17,7 +17,7 @@ import static org.junit.jupiter.api.Assertions.assertFalse; */ class ApiExceptionHandlerTest { - private final ApiExceptionHandler handler = new ApiExceptionHandler(); + private final ApiExceptionHandler handler = new ApiExceptionHandler("100MB"); /** Занятая очередь — 503 с подсказкой «повторите», текст — контракт. */ @Test @@ -42,7 +42,7 @@ class ApiExceptionHandlerTest { void tooLarge_returns413ContainerLimit() { var response = handler.tooLarge(new MaxUploadSizeExceededException(100L * 1024 * 1024)); assertEquals(HttpStatus.PAYLOAD_TOO_LARGE, response.getStatusCode()); - assertEquals("Файл больше 100 МБ", response.getBody().error()); + assertEquals("Файл больше 100MB — лимит multipart сервера", response.getBody().error()); } /** Прочее исключение — 500 с общим текстом; подробность причины — только в лог. */ diff --git a/wordpdf-app/src/test/java/ru/pjandro/wordpdf/app/ApiKeyFilterTest.java b/wordpdf-app/src/test/java/ru/pjandro/wordpdf/app/ApiKeyFilterTest.java index 4652276..0354e86 100644 --- a/wordpdf-app/src/test/java/ru/pjandro/wordpdf/app/ApiKeyFilterTest.java +++ b/wordpdf-app/src/test/java/ru/pjandro/wordpdf/app/ApiKeyFilterTest.java @@ -113,4 +113,18 @@ class ApiKeyFilterTest { mockMvc.perform(get("/v3/api-docs").header("X-Forwarded-Prefix", "/pdf-converter")) .andExpect(status().isOk()); } + + /** + * {@code /actuator/../api/v1/convert}: фильтр матчает по сырому URI, но + * нормализацию может выполнить последующий обработчик — путь с точечными + * сегментами не «открытый», ключ спрашивается всегда. + * Регрессия — ApiKeyFilterTest#dotSegmentOpenPrefix_rejected. + */ + @Test + void dotSegmentOpenPrefix_rejected() throws Exception { + mockMvc.perform(get("/actuator/../api/v1/convert")) + .andExpect(status().isUnauthorized()); + mockMvc.perform(get(java.net.URI.create("/actuator/%2e%2e/api/v1/convert"))) + .andExpect(status().isUnauthorized()); + } } diff --git a/wordpdf-app/src/test/java/ru/pjandro/wordpdf/app/ConvertControllerTest.java b/wordpdf-app/src/test/java/ru/pjandro/wordpdf/app/ConvertControllerTest.java index 279c8f5..65a542b 100644 --- a/wordpdf-app/src/test/java/ru/pjandro/wordpdf/app/ConvertControllerTest.java +++ b/wordpdf-app/src/test/java/ru/pjandro/wordpdf/app/ConvertControllerTest.java @@ -218,6 +218,21 @@ class ConvertControllerTest { org.hamcrest.Matchers.containsString("OLE-объект"))); } + /** + * errorOnCharts=tru3 — некорректное значение факультативного параметра: + * 400 с именем параметра (не 500 от catch-all). + * Регрессия — ConvertControllerTest#errorFlagNotBoolean_rejected. + */ + @Test + void errorFlagNotBoolean_rejected() throws Exception { + mockMvc.perform(multipart("/api/v1/convert") + .file(docx("ru-plain.docx", bytes("/samples/ru-plain.docx"))) + .param("errorOnCharts", "tru3")) + .andExpect(status().isBadRequest()) + .andExpect(jsonPath("$.error", + org.hamcrest.Matchers.containsString("errorOnCharts"))); + } + /** * Без параметров OLE-объекты тихо удаляются: 200, PDF. * Регрессия — WordPdfConverterTest#oleObjects_removedAndConverted, diff --git a/wordpdf-core/src/main/java/ru/pjandro/wordpdf/WordPdfConverter.java b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/WordPdfConverter.java index 0ff0867..2cf25f4 100644 --- a/wordpdf-core/src/main/java/ru/pjandro/wordpdf/WordPdfConverter.java +++ b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/WordPdfConverter.java @@ -37,7 +37,9 @@ import java.io.OutputStream; * подменяются метрически совместимыми open-source аналогами * (см. {@link BundledFontMapper}). * - * Класс stateless, все методы статические. + * Класс stateless, все методы статические. Класс НЕ потокобезопасен: + * конвертации из нескольких потоков необходимо сериализовать (глобальный + * реестр {@code PhysicalFonts}, кэши шрифтов/покрытия). */ public final class WordPdfConverter { diff --git a/wordpdf-core/src/main/java/ru/pjandro/wordpdf/fonts/BundledFonts.java b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/fonts/BundledFonts.java index 8e05620..c6506d7 100644 --- a/wordpdf-core/src/main/java/ru/pjandro/wordpdf/fonts/BundledFonts.java +++ b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/fonts/BundledFonts.java @@ -146,6 +146,9 @@ public final class BundledFonts { "Шрифт не найден в jar: " + CLASSPATH_DIR + "/" + entry.file()); } Files.copy(in, target, StandardCopyOption.REPLACE_EXISTING); + // deleteOnExit не рекурсивен: каталог удалится только пустым, + // поэтому регистрируем каждый выгруженный TTF. + target.toFile().deleteOnExit(); } catch (IOException e) { throw new IllegalStateException("Не удалось выгрузить шрифт " + entry.file(), e); } diff --git a/wordpdf-core/src/main/java/ru/pjandro/wordpdf/fonts/GlyphFont.java b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/fonts/GlyphFont.java index defa85a..30a2b07 100644 --- a/wordpdf-core/src/main/java/ru/pjandro/wordpdf/fonts/GlyphFont.java +++ b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/fonts/GlyphFont.java @@ -46,7 +46,7 @@ public final class GlyphFont { private final String key; private final TrueTypeFont ttf; - private CmapLookup cmap; + private volatile CmapLookup cmap; private GlyphFont(String key, TrueTypeFont ttf) { this.key = key; diff --git a/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/GlyphCoverageNormalizer.java b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/GlyphCoverageNormalizer.java index d912190..0ecc9b0 100644 --- a/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/GlyphCoverageNormalizer.java +++ b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/GlyphCoverageNormalizer.java @@ -75,8 +75,8 @@ public final class GlyphCoverageNormalizer { private static final Pattern NUMERIC_ENTITY = Pattern.compile( "&#(x?)([0-9A-Fa-f]+);"); - /** Кэш покрытия: семейство -> множества проверенных/покрытых кодов. */ - private static final Map COVERAGE = new HashMap<>(); + /** Кэш покрытия: семейство -> множества проверенных/покрытых кодов (общий между конвертациями). */ + private static final Map COVERAGE = new java.util.concurrent.ConcurrentHashMap<>(); private GlyphCoverageNormalizer() { } @@ -337,12 +337,8 @@ public final class GlyphCoverageNormalizer { } private static Coverage coverage(String family) { - Coverage c = COVERAGE.get(family); - if (c == null) { - c = new Coverage(GlyphFont.of(family, BundledFonts.V_REGULAR)); - COVERAGE.put(family, c); - } - return c; + return COVERAGE.computeIfAbsent(family, + f -> new Coverage(GlyphFont.of(f, BundledFonts.V_REGULAR))); } /** @@ -362,7 +358,9 @@ public final class GlyphCoverageNormalizer { this.font = font; } - boolean covers(int cp) { + // synchronized: BitSet не потокобезопасен (рост words[] и порядок + // checked/covered под гонкой дают ложное «не покрыт»). + synchronized boolean covers(int cp) { if (font == null || cp < 0) { return false; }