refactor: лимит размера входа во всех слоях — MAX_MB (МБ=MiB), байты вычисляются в checkInput
Ядро: WordPdfSettings.MAX_INPUT_MB=5, ConvertOptions.maxMb, WordPdfValidator.checkInput(byte[], long maxMb) — единственная точка пересчёта МБ→байты, сообщение «Файл больше N МБ: X байт > Y байт». Приложение: свойство wordpdf.max-mb (env WORDPDF_MAX_MB, relaxed binding). CI/конфиг/автотесты/доки: WORDPDF_MAX_BYTES → WORDPDF_MAX_MB (значение 5).
This commit is contained in:
@@ -67,7 +67,7 @@ final class ApiExceptionHandler {
|
||||
/**
|
||||
* Контейнерный потолок multipart (100 МБ в application.properties)
|
||||
* сработал раньше ядра: срабатывает только на инфраструктурный лимит,
|
||||
* авторитетный (свойство {@code wordpdf.max-bytes}/env {@code WORDPDF_MAX_BYTES})
|
||||
* авторитетный (свойство {@code wordpdf.max-mb}/env {@code WORDPDF_MAX_MB})
|
||||
* проверяет {@code WordPdfValidator} и отвечает 400 своим текстом.
|
||||
*/
|
||||
@ExceptionHandler(MaxUploadSizeExceededException.class)
|
||||
|
||||
@@ -27,15 +27,15 @@ import java.util.Locale;
|
||||
* {@code Content-Disposition}; проверка содержимого (zip, размер, страницы) —
|
||||
* зона {@link ConversionService#validate}. Ошибки в JSON-ответ переводит
|
||||
* {@link ApiExceptionHandler}. Лимиты входа — только конфигурация сервера
|
||||
* (свойства {@code wordpdf.max-bytes}/{@code wordpdf.max-pages}, env
|
||||
* {@code WORDPDF_MAX_BYTES}/{@code WORDPDF_MAX_PAGES}); параметрами запроса
|
||||
* (свойства {@code wordpdf.max-mb}/{@code wordpdf.max-pages}, env
|
||||
* {@code WORDPDF_MAX_MB}/{@code WORDPDF_MAX_PAGES}); параметрами запроса
|
||||
* они не переопределяются.</p>
|
||||
*/
|
||||
@RestController
|
||||
final class ConvertController {
|
||||
|
||||
private final ConversionService conversionService;
|
||||
private final long maxBytes;
|
||||
private final long maxMb;
|
||||
private final int maxPages;
|
||||
|
||||
/**
|
||||
@@ -45,16 +45,16 @@ final class ConvertController {
|
||||
* отсекается» — худший исход, чем не поднявшийся сервис.
|
||||
*/
|
||||
ConvertController(ConversionService conversionService,
|
||||
@Value("${wordpdf.max-bytes:#{T(ru.pjandro.wordpdf.WordPdfSettings).MAX_INPUT_BYTES}}") long maxBytes,
|
||||
@Value("${wordpdf.max-mb:#{T(ru.pjandro.wordpdf.WordPdfSettings).MAX_INPUT_MB}}") long maxMb,
|
||||
@Value("${wordpdf.max-pages:#{T(ru.pjandro.wordpdf.WordPdfSettings).MAX_PAGES}}") int maxPages) {
|
||||
if (maxBytes <= 0) {
|
||||
throw new IllegalStateException("wordpdf.max-bytes должен быть больше 0: " + maxBytes);
|
||||
if (maxMb <= 0) {
|
||||
throw new IllegalStateException("wordpdf.max-mb должен быть больше 0: " + maxMb);
|
||||
}
|
||||
if (maxPages <= 0) {
|
||||
throw new IllegalStateException("wordpdf.max-pages должен быть больше 0: " + maxPages);
|
||||
}
|
||||
this.conversionService = conversionService;
|
||||
this.maxBytes = maxBytes;
|
||||
this.maxMb = maxMb;
|
||||
this.maxPages = maxPages;
|
||||
}
|
||||
|
||||
@@ -62,7 +62,7 @@ final class ConvertController {
|
||||
description = "renderCharts/renderSmartArt/errorOnCharts/errorOnSmartArt — факультативно, "
|
||||
+ "по умолчанию настройки ядра; render-флаг приоритетнее error-флага. "
|
||||
+ "Лимиты входа (размер/страницы) задаёт только конфигурация сервера "
|
||||
+ "(свойства wordpdf.max-bytes/wordpdf.max-pages), параметрами запроса не переопределяются")
|
||||
+ "(свойства wordpdf.max-mb/wordpdf.max-pages), параметрами запроса не переопределяются")
|
||||
@SecurityRequirement(name = OpenApiConfig.SCHEME)
|
||||
@PostMapping(
|
||||
path = "/api/v1/convert",
|
||||
@@ -93,7 +93,7 @@ final class ConvertController {
|
||||
renderSmartArt != null ? renderSmartArt : WordPdfSettings.RENDER_SMARTART,
|
||||
errorOnCharts != null ? errorOnCharts : WordPdfSettings.ERROR_ON_CHARTS,
|
||||
errorOnSmartArt != null ? errorOnSmartArt : WordPdfSettings.ERROR_ON_SMARTART,
|
||||
maxBytes, maxPages);
|
||||
maxMb, maxPages);
|
||||
byte[] pdf = conversionService.convert(docxBytes, name, options);
|
||||
ContentDisposition disposition = ContentDisposition.attachment()
|
||||
.filename(ConversionService.safeBaseName(name) + ".pdf", StandardCharsets.UTF_8)
|
||||
|
||||
@@ -1,10 +1,10 @@
|
||||
spring.application.name=wordpdf-app
|
||||
# Потолок инфраструктуры — 100 МБ (совпадает с client_max_body_size в
|
||||
# nginx-шлюзах): больше не пропустит ни шлюз, ни контейнер. Авторитетный
|
||||
# лимит — свойство wordpdf.max-bytes (env WORDPDF_MAX_BYTES), по умолчанию
|
||||
# WordPdfSettings.MAX_INPUT_BYTES = 5 MiB; здесь только потолок загрузки.
|
||||
# Лимиты входа: env WORDPDF_MAX_BYTES (байты) / WORDPDF_MAX_PAGES (страницы),
|
||||
# дефолты — константы ядра (5 MiB / 100), задаются ConvertController.
|
||||
# лимит — свойство wordpdf.max-mb (env WORDPDF_MAX_MB, МБ), по умолчанию
|
||||
# WordPdfSettings.MAX_INPUT_MB = 5; здесь только потолок загрузки.
|
||||
# Лимиты входа: env WORDPDF_MAX_MB (МБ) / WORDPDF_MAX_PAGES (страницы),
|
||||
# дефолты — константы ядра (5 / 100), задаются ConvertController.
|
||||
# Значение <= 0 — падение на старте. Сами ключи здесь не объявлены:
|
||||
# пустое значение затенит SpEL-дефолт @Value.
|
||||
# file-size-threshold=100MB держит файл в памяти (ядро и так читает всё в RAM).
|
||||
|
||||
@@ -264,14 +264,14 @@ class ConvertControllerTest {
|
||||
|
||||
/**
|
||||
* Регрессия env-only: лимиты входа параметрами запроса не задаются.
|
||||
* maxBytes/maxPages в multipart-форме игнорируются — маленький
|
||||
* maxMb/maxPages в multipart-форме игнорируются — маленький
|
||||
* документ проходит на серверных лимитах (дефолты ядра).
|
||||
*/
|
||||
@Test
|
||||
void requestLimitParams_areIgnored() throws Exception {
|
||||
mockMvc.perform(multipart("/api/v1/convert")
|
||||
.file(docx("ru-plain.docx", bytes("/samples/ru-plain.docx")))
|
||||
.param("maxBytes", "1000")
|
||||
.param("maxMb", "1000")
|
||||
.param("maxPages", "1"))
|
||||
.andExpect(status().isOk())
|
||||
.andExpect(content().contentType(MediaType.APPLICATION_PDF));
|
||||
|
||||
@@ -22,20 +22,20 @@ import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.
|
||||
import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.status;
|
||||
|
||||
/**
|
||||
* Лимиты входа из конфигурации сервера (свойства {@code wordpdf.max-bytes}/
|
||||
* Лимиты входа из конфигурации сервера (свойства {@code wordpdf.max-mb}/
|
||||
* {@code wordpdf.max-pages}) применяются сквозь HTTP: отдельный контекст с
|
||||
* {@code @TestPropertySource} доказывает, что {@code ConvertController}
|
||||
* читает их из окружения Spring, а не живёт на константах ядра.
|
||||
* Отдельный класс, а не {@code @Nested}: {@code @Nested} +
|
||||
* {@code @TestPropertySource} не даёт отдельного контекста.
|
||||
*
|
||||
* <p>Пара свойств согласована с фикстурами: {@code max-bytes=20000} выше
|
||||
* <p>Пара свойств согласована с фикстурами: {@code max-mb=1} (1 MiB) выше
|
||||
* обеих (2612 и 2887 байт), так что page-отсечка на {@code max-pages=1}
|
||||
* достижима; для byte-отсечки берётся файл заведомо больше 20000.</p>
|
||||
* достижима; для byte-отсечки берётся файл заведомо больше 1 MiB.</p>
|
||||
*/
|
||||
@SpringBootTest
|
||||
@AutoConfigureMockMvc
|
||||
@TestPropertySource(properties = {"wordpdf.max-bytes=20000", "wordpdf.max-pages=1"})
|
||||
@TestPropertySource(properties = {"wordpdf.max-mb=1", "wordpdf.max-pages=1"})
|
||||
class ConvertLimitsTest {
|
||||
|
||||
private static final MediaType DOCX =
|
||||
@@ -55,9 +55,9 @@ class ConvertLimitsTest {
|
||||
return new MockMultipartFile("file", filename, DOCX.toString(), content);
|
||||
}
|
||||
|
||||
/** Zip с ~40 КБ псевдослучайных байтов: больше лимита 20000, не жмётся. */
|
||||
/** Zip с ~1.5 МБ псевдослучайных байтов: больше лимита 1 MiB, не жмётся. */
|
||||
private static byte[] oversizedZip() throws IOException {
|
||||
byte[] payload = new byte[40_000];
|
||||
byte[] payload = new byte[1_500_000];
|
||||
new Random(1).nextBytes(payload);
|
||||
ByteArrayOutputStream bos = new ByteArrayOutputStream();
|
||||
try (ZipOutputStream zout = new ZipOutputStream(bos)) {
|
||||
@@ -68,14 +68,14 @@ class ConvertLimitsTest {
|
||||
return bos.toByteArray();
|
||||
}
|
||||
|
||||
/** Свойство wordpdf.max-bytes отсекает файл до любой другой проверки. */
|
||||
/** Свойство wordpdf.max-mb отсекает файл до любой другой проверки. */
|
||||
@Test
|
||||
void configuredMaxBytes_applies() throws Exception {
|
||||
void configuredMaxMb_applies() throws Exception {
|
||||
mockMvc.perform(multipart("/api/v1/convert")
|
||||
.file(docx("big.docx", oversizedZip())))
|
||||
.andExpect(status().isBadRequest())
|
||||
.andExpect(jsonPath("$.error",
|
||||
org.hamcrest.Matchers.containsString("20000 байт")));
|
||||
org.hamcrest.Matchers.containsString("1048576 байт")));
|
||||
}
|
||||
|
||||
/**
|
||||
|
||||
Reference in New Issue
Block a user