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;
|
||||
|
||||
Reference in New Issue
Block a user