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:
@@ -15,19 +15,19 @@ package ru.pjandro.wordpdf;
|
||||
* @param errorOnSmartArt бросать {@link DrawingFoundException} при находке
|
||||
* SmartArt, **только если** {@code renderSmartArt}
|
||||
* выключен (рендер приоритетнее error-флага)
|
||||
* @param maxBytes лимит размера входных байтов на этот вызов;
|
||||
* дефолт — {@link WordPdfSettings#MAX_INPUT_BYTES}
|
||||
* @param maxMb лимит размера входа в МБ (MiB) на этот вызов;
|
||||
* дефолт — {@link WordPdfSettings#MAX_INPUT_MB}
|
||||
* @param maxPages лимит числа страниц на этот вызов;
|
||||
* дефолт — {@link WordPdfSettings#MAX_PAGES}
|
||||
*/
|
||||
public record ConvertOptions(boolean renderCharts, boolean renderSmartArt,
|
||||
boolean errorOnCharts, boolean errorOnSmartArt,
|
||||
long maxBytes, int maxPages) {
|
||||
long maxMb, int maxPages) {
|
||||
|
||||
/** Дефолты ядра из {@link WordPdfSettings}. */
|
||||
public static ConvertOptions defaults() {
|
||||
return new ConvertOptions(WordPdfSettings.RENDER_CHARTS, WordPdfSettings.RENDER_SMARTART,
|
||||
WordPdfSettings.ERROR_ON_CHARTS, WordPdfSettings.ERROR_ON_SMARTART,
|
||||
WordPdfSettings.MAX_INPUT_BYTES, WordPdfSettings.MAX_PAGES);
|
||||
WordPdfSettings.MAX_INPUT_MB, WordPdfSettings.MAX_PAGES);
|
||||
}
|
||||
}
|
||||
|
||||
@@ -58,7 +58,7 @@ public final class WordPdfConverter {
|
||||
* (файловое API было здесь раньше; ядро пути не принимает).
|
||||
*
|
||||
* <p>Вход проверяется {@link WordPdfValidator#validate(byte[], ConvertOptions)} до рендера:
|
||||
* {@code null} / размер больше {@link WordPdfSettings#MAX_INPUT_BYTES} / zip-подпись /
|
||||
* {@code null} / размер больше {@link WordPdfSettings#MAX_INPUT_MB} (МБ) / zip-подпись /
|
||||
* число страниц больше {@link WordPdfSettings#MAX_PAGES} — при отказе байтов результата нет;
|
||||
* страницы дополнительно перепроверяются по нормализованным байтам (шаг 2.5).
|
||||
*
|
||||
@@ -66,7 +66,7 @@ public final class WordPdfConverter {
|
||||
* @param title заголовок PDF (метаданные); {@code null}/пустая — заголовок не задаётся
|
||||
* @return байты готового PDF
|
||||
* @throws ValidationException некорректный вход: {@code null}, размер больше
|
||||
* {@link WordPdfSettings#MAX_INPUT_BYTES}, не zip-архив, документ длиннее
|
||||
* {@link WordPdfSettings#MAX_INPUT_MB} (МБ), не zip-архив, документ длиннее
|
||||
* {@link WordPdfSettings#MAX_PAGES} страниц
|
||||
* @throws ConversionException прочие ошибки (битый .docx, ошибка рендера)
|
||||
*/
|
||||
@@ -79,7 +79,7 @@ public final class WordPdfConverter {
|
||||
* диаграмм/SmartArt и лимиты входа.
|
||||
*
|
||||
* <p>Вход проверяется {@link WordPdfValidator#validate(byte[], ConvertOptions)} до рендера:
|
||||
* {@code null} / размер больше {@code options.maxBytes()} / zip-подпись / число страниц
|
||||
* {@code null} / размер больше {@code options.maxMb()} (МБ) / zip-подпись / число страниц
|
||||
* больше {@code options.maxPages()} — при отказе байтов результата нет; страницы
|
||||
* дополнительно перепроверяются по нормализованным байтам (шаг 2.5).
|
||||
*
|
||||
@@ -89,7 +89,7 @@ public final class WordPdfConverter {
|
||||
* дефолты (константы {@link WordPdfSettings})
|
||||
* @return байты готового PDF
|
||||
* @throws ValidationException некорректный вход: {@code null}, размер больше
|
||||
* {@code options.maxBytes()}, не zip-архив, документ длиннее
|
||||
* {@code options.maxMb()} (МБ), не zip-архив, документ длиннее
|
||||
* {@code options.maxPages()} страниц
|
||||
* @throws ConversionException прочие ошибки (битый .docx, ошибка рендера)
|
||||
*/
|
||||
|
||||
@@ -3,14 +3,14 @@ package ru.pjandro.wordpdf;
|
||||
/**
|
||||
* Единая точка конфигурации ядра: все настройки-дефолты — константы здесь.
|
||||
* Рантайм-конфигурации нет: изменение значения = правка этого файла и пересборка.
|
||||
* Лимиты входа ({@link #MAX_INPUT_BYTES}, {@link #MAX_PAGES}) — дефолты:
|
||||
* Лимиты входа ({@link #MAX_INPUT_MB}, {@link #MAX_PAGES}) — дефолты:
|
||||
* вызывающий может переопределить их на конкретный вызов через
|
||||
* {@link ConvertOptions}.
|
||||
*/
|
||||
public final class WordPdfSettings {
|
||||
|
||||
/** Максимальный размер входного .docx (дефолт). 5 MiB = 5 × 1024 × 1024. */
|
||||
public static final long MAX_INPUT_BYTES = 5L * 1024 * 1024;
|
||||
/** Максимальный размер входного .docx в МБ (дефолт). МБ = MiB = 1024 × 1024 байт. */
|
||||
public static final long MAX_INPUT_MB = 5;
|
||||
|
||||
/** Документ длиннее — ошибка (дефолт). */
|
||||
public static final int MAX_PAGES = 100;
|
||||
|
||||
@@ -26,7 +26,7 @@ import java.util.zip.ZipInputStream;
|
||||
*
|
||||
* <p>Лимиты по умолчанию:
|
||||
* <ul>
|
||||
* <li>{@link WordPdfSettings#MAX_INPUT_BYTES} — максимальный размер входного .docx;</li>
|
||||
* <li>{@link WordPdfSettings#MAX_INPUT_MB} — максимальный размер входного .docx (МБ);</li>
|
||||
* <li>{@link WordPdfSettings#MAX_PAGES} — максимально допустимое число страниц.</li>
|
||||
* </ul>
|
||||
* Оба переопределяются на вызов: перегрузками с явным лимитом или
|
||||
@@ -54,29 +54,26 @@ public final class WordPdfValidator {
|
||||
/**
|
||||
* Проверяет размер байтов входа (для документа, полученного из сети/БД).
|
||||
*
|
||||
* @throws ValidationException при {@code null} или превышении лимита
|
||||
* @throws ValidationException при {@code null} или превышении лимита (МБ)
|
||||
*/
|
||||
public static void checkInput(byte[] docxBytes) throws ValidationException {
|
||||
checkInput(docxBytes, WordPdfSettings.MAX_INPUT_BYTES);
|
||||
checkInput(docxBytes, WordPdfSettings.MAX_INPUT_MB);
|
||||
}
|
||||
|
||||
/**
|
||||
* Проверяет размер байтов входа против явного лимита (переопределение
|
||||
* на вызов, см. {@link ConvertOptions#maxBytes()}).
|
||||
* Проверяет размер байтов входа против явного лимита в МБ (переопределение
|
||||
* на вызов, см. {@link ConvertOptions#maxMb()}). МБ = MiB = 1024 × 1024 байт.
|
||||
*
|
||||
* @throws ValidationException при {@code null} или превышении {@code maxBytes}
|
||||
* @throws ValidationException при {@code null} или превышении {@code maxMb} (МБ)
|
||||
*/
|
||||
public static void checkInput(byte[] docxBytes, long maxBytes) throws ValidationException {
|
||||
public static void checkInput(byte[] docxBytes, long maxMb) throws ValidationException {
|
||||
if (docxBytes == null) {
|
||||
throw new ValidationException("Не указаны байты входного файла");
|
||||
}
|
||||
long maxBytes = maxMb * 1024 * 1024;
|
||||
if (docxBytes.length > maxBytes) {
|
||||
// дефолтный лимит кратен MiB — сообщение остаётся «... 5 МБ ...»
|
||||
String limit = maxBytes % (1024 * 1024) == 0
|
||||
? (maxBytes / (1024 * 1024)) + " МБ"
|
||||
: maxBytes + " байт";
|
||||
throw new ValidationException("Файл больше " + limit
|
||||
+ ": " + docxBytes.length + " байт > " + maxBytes + " байт");
|
||||
throw new ValidationException("Файл больше " + maxMb + " МБ: "
|
||||
+ docxBytes.length + " байт > " + maxBytes + " байт");
|
||||
}
|
||||
}
|
||||
|
||||
@@ -155,7 +152,7 @@ public final class WordPdfValidator {
|
||||
* Полная проверка входа: размер → zip-подпись → число страниц. Порядок
|
||||
* значим: размер — дешёвая, разбор zip без подписи бессмысленен. Лимиты
|
||||
* берутся из {@link ConvertOptions} (переопределение на вызов, см.
|
||||
* {@link ConvertOptions#maxBytes()}, {@link ConvertOptions#maxPages()}).
|
||||
* {@link ConvertOptions#maxMb()}, {@link ConvertOptions#maxPages()}).
|
||||
*
|
||||
* <p>Проверка zip-подписи отдельным шагом обязательна:
|
||||
* {@code ZipInputStream.getNextEntry()} на не-zip-потоке возвращает
|
||||
@@ -164,11 +161,11 @@ public final class WordPdfValidator {
|
||||
* {@code WordPdfValidatorTest#validate_notAZip} (на HTTP-границе —
|
||||
* {@code ConvertControllerTest#corruptNotAZip_rejected}).</p>
|
||||
*
|
||||
* @throws ValidationException при {@code null}, превышении {@code options.maxBytes()},
|
||||
* @throws ValidationException при {@code null}, превышении {@code options.maxMb()},
|
||||
* отсутствии zip-подписи, ошибке разбора zip или превышении {@code options.maxPages()}
|
||||
*/
|
||||
public static void validate(byte[] docxBytes, ConvertOptions options) throws ValidationException {
|
||||
checkInput(docxBytes, options.maxBytes());
|
||||
checkInput(docxBytes, options.maxMb());
|
||||
if (docxBytes.length < 4 || docxBytes[0] != 'P' || docxBytes[1] != 'K'
|
||||
|| (docxBytes[2] & 0xFF) != 0x03 || (docxBytes[3] & 0xFF) != 0x04) {
|
||||
throw new ValidationException("Содержимое не похоже на .docx (не zip-архив)");
|
||||
|
||||
Reference in New Issue
Block a user