Надёжность: ConcurrentHashMap покрытия, volatile cmap, ApiKeyFilter против точечных сегментов, 413/400 из конфигурации, deleteOnExit TTF
This commit is contained in:
@@ -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<ApiError> 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<ApiError> badParam(MethodArgumentTypeMismatchException e) {
|
||||
return ResponseEntity.badRequest()
|
||||
.body(new ApiError("Некорректное значение параметра «" + e.getName() + "»"));
|
||||
}
|
||||
|
||||
/** Прочее — внутренняя ошибка; подробность только в лог, не в ответ. */
|
||||
@ExceptionHandler(Exception.class)
|
||||
ResponseEntity<ApiError> unexpected(Exception e) {
|
||||
|
||||
@@ -24,6 +24,11 @@ import java.security.MessageDigest;
|
||||
*
|
||||
* <p>Регрессии — ApiKeyFilterTest#forwardedPrefix_healthStaysOpen,
|
||||
* ApiKeyFilterTest#docsOpenWithoutKey.</p>
|
||||
*
|
||||
* <p>Путь с точечными сегментами ({@code ..}, {@code %2e}) не считается
|
||||
* открытым: контейнер матчит по сырому URI, а нормализацию {@code /actuator/../api/…}
|
||||
* может выполнить последующий обработчик — ключ спрашиваем всегда.
|
||||
* Регрессия — ApiKeyFilterTest#dotSegmentOpenPrefix_rejected.</p>
|
||||
*/
|
||||
@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;
|
||||
|
||||
@@ -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 с общим текстом; подробность причины — только в лог. */
|
||||
|
||||
@@ -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());
|
||||
}
|
||||
}
|
||||
|
||||
@@ -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,
|
||||
|
||||
@@ -37,7 +37,9 @@ import java.io.OutputStream;
|
||||
* подменяются метрически совместимыми open-source аналогами
|
||||
* (см. {@link BundledFontMapper}).
|
||||
*
|
||||
* Класс stateless, все методы статические.
|
||||
* Класс stateless, все методы статические. Класс НЕ потокобезопасен:
|
||||
* конвертации из нескольких потоков необходимо сериализовать (глобальный
|
||||
* реестр {@code PhysicalFonts}, кэши шрифтов/покрытия).
|
||||
*/
|
||||
public final class WordPdfConverter {
|
||||
|
||||
|
||||
@@ -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);
|
||||
}
|
||||
|
||||
@@ -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;
|
||||
|
||||
@@ -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<String, Coverage> COVERAGE = new HashMap<>();
|
||||
/** Кэш покрытия: семейство -> множества проверенных/покрытых кодов (общий между конвертациями). */
|
||||
private static final Map<String, Coverage> 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;
|
||||
}
|
||||
|
||||
Reference in New Issue
Block a user