core: перенос валидации входа из ConversionService в WordPdfValidator.validate
This commit is contained in:
@@ -57,16 +57,16 @@ public final class WordPdfConverter {
|
||||
* Конвертирует байты .docx в PDF. Работа с файлами — забота вызывающего
|
||||
* (файловое API было здесь раньше; ядро пути не принимает).
|
||||
*
|
||||
* <p>Вход проверяется валидатором до рендера: {@link WordPdfValidator#checkInput(byte[])}
|
||||
* (null / больше {@link WordPdfSettings#MAX_INPUT_BYTES}), затем число страниц
|
||||
* ({@link WordPdfValidator#checkPageCount(byte[])}, лимит
|
||||
* {@link WordPdfSettings#MAX_PAGES}) — при отказе байтов результата нет.
|
||||
* <p>Вход проверяется {@link WordPdfValidator#validate(byte[], ConvertOptions)} до рендера:
|
||||
* {@code null} / размер больше {@link WordPdfSettings#MAX_INPUT_BYTES} / zip-подпись /
|
||||
* число страниц больше {@link WordPdfSettings#MAX_PAGES} — при отказе байтов результата нет;
|
||||
* страницы дополнительно перепроверяются по нормализованным байтам (шаг 2.5).
|
||||
*
|
||||
* @param docxBytes байты .docx
|
||||
* @param title заголовок PDF (метаданные); {@code null}/пустая — заголовок не задаётся
|
||||
* @return байты готового PDF
|
||||
* @throws ValidationException некорректный вход: {@code null}, размер больше
|
||||
* {@link WordPdfSettings#MAX_INPUT_BYTES}, документ длиннее
|
||||
* {@link WordPdfSettings#MAX_INPUT_BYTES}, не zip-архив, документ длиннее
|
||||
* {@link WordPdfSettings#MAX_PAGES} страниц
|
||||
* @throws ConversionException прочие ошибки (битый .docx, ошибка рендера)
|
||||
*/
|
||||
@@ -78,10 +78,10 @@ public final class WordPdfConverter {
|
||||
* Конвертирует байты .docx в PDF с настройками на вызов: рисование
|
||||
* диаграмм/SmartArt и лимиты входа.
|
||||
*
|
||||
* <p>Вход проверяется валидатором до рендера: {@link WordPdfValidator#checkInput(byte[], long)}
|
||||
* (null / больше {@code options.maxBytes()}), затем число страниц
|
||||
* ({@link WordPdfValidator#checkPageCount(byte[], int)}, лимит
|
||||
* {@code options.maxPages()}) — при отказе байтов результата нет.
|
||||
* <p>Вход проверяется {@link WordPdfValidator#validate(byte[], ConvertOptions)} до рендера:
|
||||
* {@code null} / размер больше {@code options.maxBytes()} / zip-подпись / число страниц
|
||||
* больше {@code options.maxPages()} — при отказе байтов результата нет; страницы
|
||||
* дополнительно перепроверяются по нормализованным байтам (шаг 2.5).
|
||||
*
|
||||
* @param docxBytes байты .docx
|
||||
* @param title заголовок PDF (метаданные); {@code null}/пустая — заголовок не задаётся
|
||||
@@ -89,13 +89,13 @@ public final class WordPdfConverter {
|
||||
* дефолты (константы {@link WordPdfSettings})
|
||||
* @return байты готового PDF
|
||||
* @throws ValidationException некорректный вход: {@code null}, размер больше
|
||||
* {@code options.maxBytes()}, документ длиннее {@code options.maxPages()}
|
||||
* страниц
|
||||
* {@code options.maxBytes()}, не zip-архив, документ длиннее
|
||||
* {@code options.maxPages()} страниц
|
||||
* @throws ConversionException прочие ошибки (битый .docx, ошибка рендера)
|
||||
*/
|
||||
public static byte[] convert(byte[] docxBytes, String title, ConvertOptions options) throws ConversionException {
|
||||
ConvertOptions opts = options == null ? ConvertOptions.defaults() : options;
|
||||
WordPdfValidator.checkInput(docxBytes, opts.maxBytes());
|
||||
WordPdfValidator.validate(docxBytes, opts);
|
||||
ByteArrayOutputStream bos = new ByteArrayOutputStream();
|
||||
try {
|
||||
convertToStream(docxBytes, title, opts, bos);
|
||||
|
||||
@@ -105,8 +105,8 @@ public final class WordPdfValidator {
|
||||
*
|
||||
* <p>Не-zip байты не отвергаются: {@code ZipInputStream} доходит до EOF
|
||||
* без единой записи — молча, оценка «1 страница». Корректность контейнера
|
||||
* проверяет вызывающий по zip-подписи ({@code ConversionService.validate}
|
||||
* в приложении; регрессия — {@code ConvertControllerTest#corruptNotAZip_rejected}).
|
||||
* по zip-подписи проверяет {@link #validate(byte[], ConvertOptions)}
|
||||
* (регрессия — {@code WordPdfValidatorTest#validate_notAZip}).
|
||||
* @throws ValidationException при {@code null}, ошибке разбора zip или превышении {@link WordPdfSettings#MAX_PAGES}
|
||||
*/
|
||||
public static void checkPageCount(byte[] docxBytes) throws ValidationException {
|
||||
@@ -151,6 +151,31 @@ public final class WordPdfValidator {
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Полная проверка входа: размер → zip-подпись → число страниц. Порядок
|
||||
* значим: размер — дешёвая, разбор zip без подписи бессмысленен. Лимиты
|
||||
* берутся из {@link ConvertOptions} (переопределение на вызов, см.
|
||||
* {@link ConvertOptions#maxBytes()}, {@link ConvertOptions#maxPages()}).
|
||||
*
|
||||
* <p>Проверка zip-подписи отдельным шагом обязательна:
|
||||
* {@code ZipInputStream.getNextEntry()} на не-zip-потоке возвращает
|
||||
* {@code null} молча, и {@link #checkPageCount(byte[], int)} такой вход
|
||||
* не отверг бы (оценка «1 страница»). Регрессия —
|
||||
* {@code WordPdfValidatorTest#validate_notAZip} (на HTTP-границе —
|
||||
* {@code ConvertControllerTest#corruptNotAZip_rejected}).</p>
|
||||
*
|
||||
* @throws ValidationException при {@code null}, превышении {@code options.maxBytes()},
|
||||
* отсутствии zip-подписи, ошибке разбора zip или превышении {@code options.maxPages()}
|
||||
*/
|
||||
public static void validate(byte[] docxBytes, ConvertOptions options) throws ValidationException {
|
||||
checkInput(docxBytes, options.maxBytes());
|
||||
if (docxBytes.length < 4 || docxBytes[0] != 'P' || docxBytes[1] != 'K'
|
||||
|| (docxBytes[2] & 0xFF) != 0x03 || (docxBytes[3] & 0xFF) != 0x04) {
|
||||
throw new ValidationException("Содержимое не похоже на .docx (не zip-архив)");
|
||||
}
|
||||
checkPageCount(docxBytes, options.maxPages());
|
||||
}
|
||||
|
||||
/** Поставщик потока по имени части zip; null — части нет. */
|
||||
private interface PartStream {
|
||||
InputStream open(String name) throws IOException;
|
||||
|
||||
@@ -448,6 +448,21 @@ class WordPdfConverterTest {
|
||||
"сообщение должно упоминать лимит: " + ex.getMessage());
|
||||
}
|
||||
|
||||
/**
|
||||
* Вход без zip-подписи — отказ как некорректный вход (ValidationException),
|
||||
* а не ошибка рендера: вход конвертера прогоняет тот же
|
||||
* {@link WordPdfValidator#validate(byte[], ConvertOptions)}, что и приложение до очереди.
|
||||
* Регрессия — WordPdfValidatorTest#validate_notAZip.
|
||||
*/
|
||||
@Test
|
||||
void inputNotAZip_rejectedBeforeRender() {
|
||||
byte[] junk = new byte[]{1, 2, 3, 4, 5, 6, 7, 8};
|
||||
ValidationException ex = assertThrows(ValidationException.class, () ->
|
||||
WordPdfConverter.convert(junk, "junk"));
|
||||
assertTrue(ex.getMessage().contains("не zip-архив"),
|
||||
"сообщение должно упоминать zip-подпись: " + ex.getMessage());
|
||||
}
|
||||
|
||||
/**
|
||||
* Лимит размера переопределяется {@link ConvertOptions} на вызов:
|
||||
* maxBytes=1000 отсекает даже маленький документ до рендера, сообщение
|
||||
|
||||
@@ -254,6 +254,52 @@ class WordPdfValidatorTest {
|
||||
() -> WordPdfValidator.checkPageCount((byte[]) null));
|
||||
}
|
||||
|
||||
// ===== validate(byte[], ConvertOptions) =====
|
||||
|
||||
private static ConvertOptions options(long maxBytes, int maxPages) {
|
||||
return new ConvertOptions(true, true, false, false, maxBytes, maxPages);
|
||||
}
|
||||
|
||||
@Test
|
||||
void validate_withinLimits() throws Exception {
|
||||
assertDoesNotThrow(() -> WordPdfValidator.validate(
|
||||
docxWithPageBreaks(5), ConvertOptions.defaults()));
|
||||
}
|
||||
|
||||
@Test
|
||||
void validate_bytesOverLimit() {
|
||||
byte[] big = new byte[(int) WordPdfSettings.MAX_INPUT_BYTES + 1];
|
||||
ValidationException ex = assertThrows(ValidationException.class,
|
||||
() -> WordPdfValidator.validate(big, ConvertOptions.defaults()));
|
||||
assertTrue(ex.getMessage().contains("5 МБ"),
|
||||
"размер проверяется первым: " + ex.getMessage());
|
||||
}
|
||||
|
||||
@Test
|
||||
void validate_notAZip() {
|
||||
byte[] junk = new byte[]{1, 2, 3, 4, 5};
|
||||
ValidationException ex = assertThrows(ValidationException.class,
|
||||
() -> WordPdfValidator.validate(junk, ConvertOptions.defaults()));
|
||||
assertTrue(ex.getMessage().contains("не zip-архив"),
|
||||
"сообщение должно упоминать zip-подпись: " + ex.getMessage());
|
||||
}
|
||||
|
||||
@Test
|
||||
void validate_tooManyPages() throws Exception {
|
||||
byte[] bytes = docxWithPageBreaks(120);
|
||||
ValidationException ex = assertThrows(ValidationException.class,
|
||||
() -> WordPdfValidator.validate(bytes,
|
||||
options(WordPdfSettings.MAX_INPUT_BYTES, 100)));
|
||||
assertTrue(ex.getMessage().contains("не менее 121"),
|
||||
"оценка = 1 + 120 разрывов: " + ex.getMessage());
|
||||
}
|
||||
|
||||
@Test
|
||||
void validate_nullBytes() {
|
||||
assertThrows(ValidationException.class,
|
||||
() -> WordPdfValidator.validate(null, ConvertOptions.defaults()));
|
||||
}
|
||||
|
||||
/**
|
||||
* Lightweight-путь читает сырые байты до нормализации и обязан видеть
|
||||
* разрывы {@code w:br w:type="page"} в strict-namespace'ах
|
||||
|
||||
Reference in New Issue
Block a user