core: ValidationException вместо ConversionException; удаление pkg-API и переименование checkPageCountLightweight в checkPageCount
This commit is contained in:
@@ -10,14 +10,16 @@ import org.springframework.web.bind.annotation.RestControllerAdvice;
|
|||||||
import org.springframework.web.multipart.MaxUploadSizeExceededException;
|
import org.springframework.web.multipart.MaxUploadSizeExceededException;
|
||||||
import org.springframework.web.multipart.support.MissingServletRequestPartException;
|
import org.springframework.web.multipart.support.MissingServletRequestPartException;
|
||||||
import org.springframework.web.servlet.resource.NoResourceFoundException;
|
import org.springframework.web.servlet.resource.NoResourceFoundException;
|
||||||
|
import ru.pjandro.wordpdf.ValidationException;
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Единый перевод исключений в JSON {@code {"error": "..."}} с кодом по смыслу.
|
* Единый перевод исключений в JSON {@code {"error": "..."}} с кодом по смыслу.
|
||||||
*
|
*
|
||||||
* <p>Голый {@code ru.pjandro.wordpdf.ConversionException} ядра сюда не доходит:
|
* <p>{@link ValidationException} ядра доходит сюда напрямую — валидатор
|
||||||
* контроллер и {@link ConversionService} превращают его на границе в
|
* бросает его сам; в {@link ConversionFailedException} превращается только
|
||||||
* {@link ValidationException}/{@link ConversionFailedException}; случайная
|
* прочий {@code ru.pjandro.wordpdf.ConversionException} рендер-стадии.
|
||||||
* утечка попадёт в обработчик {@link Exception} (500).</p>
|
* Случайная утечка прочего исключения попадёт в обработчик {@link Exception}
|
||||||
|
* (500).</p>
|
||||||
*/
|
*/
|
||||||
@RestControllerAdvice
|
@RestControllerAdvice
|
||||||
final class ApiExceptionHandler {
|
final class ApiExceptionHandler {
|
||||||
|
|||||||
@@ -4,8 +4,9 @@ package ru.pjandro.wordpdf.app;
|
|||||||
* Ошибка преобразования: контейнер .docx принят валидацией, но упал сам
|
* Ошибка преобразования: контейнер .docx принят валидацией, но упал сам
|
||||||
* рендер (ядро, FOP, повреждённое содержимое внутри валидного zip).
|
* рендер (ядро, FOP, повреждённое содержимое внутри валидного zip).
|
||||||
*
|
*
|
||||||
* <p>Смысл отличается от {@link ValidationException}: вход формально корректен,
|
* <p>Смысл отличается от {@code ru.pjandro.wordpdf.ValidationException}:
|
||||||
* отказал движок конвертации. Маппится в HTTP 500 ({@link ApiExceptionHandler}).</p>
|
* вход формально корректен, отказал движок конвертации.
|
||||||
|
* Маппится в HTTP 500 ({@link ApiExceptionHandler}).</p>
|
||||||
*
|
*
|
||||||
* <p>Регрессия — ConvertControllerTest#junkInsideValidZip_conversionError.</p>
|
* <p>Регрессия — ConvertControllerTest#junkInsideValidZip_conversionError.</p>
|
||||||
*/
|
*/
|
||||||
|
|||||||
@@ -8,6 +8,7 @@ import ru.pjandro.wordpdf.ConversionException;
|
|||||||
import ru.pjandro.wordpdf.DrawingFoundException;
|
import ru.pjandro.wordpdf.DrawingFoundException;
|
||||||
import ru.pjandro.wordpdf.WordPdfConverter;
|
import ru.pjandro.wordpdf.WordPdfConverter;
|
||||||
import ru.pjandro.wordpdf.WordPdfValidator;
|
import ru.pjandro.wordpdf.WordPdfValidator;
|
||||||
|
import ru.pjandro.wordpdf.ValidationException;
|
||||||
|
|
||||||
import java.time.Duration;
|
import java.time.Duration;
|
||||||
import java.util.Locale;
|
import java.util.Locale;
|
||||||
@@ -34,9 +35,10 @@ import java.util.concurrent.TimeoutException;
|
|||||||
* {@link ValidationException} (400), ошибка рендер-стадии →
|
* {@link ValidationException} (400), ошибка рендер-стадии →
|
||||||
* {@link ConversionFailedException} (500). Граница: сломанный контейнер
|
* {@link ConversionFailedException} (500). Граница: сломанный контейнер
|
||||||
* (не zip / битый zip / слишком большой / слишком длинный) — 400; валидный
|
* (не zip / битый zip / слишком большой / слишком длинный) — 400; валидный
|
||||||
* zip с мусором внутри (нет {@code word/document.xml}) — 500: lightweight-
|
* zip с мусором внутри (нет {@code word/document.xml}) — 500: до очереди и
|
||||||
* подсчёт страниц согласован с JAXB-путём ядра (может только завышать),
|
* в конвейере ядра страницы проверяются одним и тем же lightweight-путём
|
||||||
* поэтому уже принятый запрос внутренняя проверка ядра в ошибку не превратит.</p>
|
* ({@link WordPdfValidator#checkPageCount}), поэтому уже принятый
|
||||||
|
* запрос внутренняя проверка ядра в ошибку не превратит.</p>
|
||||||
*/
|
*/
|
||||||
@Service
|
@Service
|
||||||
final class ConversionService {
|
final class ConversionService {
|
||||||
@@ -111,7 +113,8 @@ final class ConversionService {
|
|||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Валидация байтов переиспользует публичные byte-API ядра. Порядок значим:
|
* Валидация байтов переиспользует публичные byte-API ядра; ядро бросает
|
||||||
|
* {@link ValidationException} само — оборачивать нечего. Порядок значим:
|
||||||
* размер (дешёвая) → magic bytes → lightweight-разбор zip. Лимиты
|
* размер (дешёвая) → magic bytes → lightweight-разбор zip. Лимиты
|
||||||
* размера/страниц берутся из {@code options} (контроллер подставляет их
|
* размера/страниц берутся из {@code options} (контроллер подставляет их
|
||||||
* из конфигурации сервера: свойства {@code wordpdf.max-bytes}/
|
* из конфигурации сервера: свойства {@code wordpdf.max-bytes}/
|
||||||
@@ -119,25 +122,17 @@ final class ConversionService {
|
|||||||
*
|
*
|
||||||
* <p>Проверка zip-подписи отдельным шагом обязательна:
|
* <p>Проверка zip-подписи отдельным шагом обязательна:
|
||||||
* {@code ZipInputStream.getNextEntry()} на не-zip-потоке возвращает
|
* {@code ZipInputStream.getNextEntry()} на не-zip-потоке возвращает
|
||||||
* {@code null} молча, и {@link WordPdfValidator#checkPageCountLightweight(byte[])}
|
* {@code null} молча, и {@link WordPdfValidator#checkPageCount(byte[])}
|
||||||
* такой вход не отверг бы (0 страниц). Регрессия —
|
* такой вход не отверг бы (0 страниц). Регрессия —
|
||||||
* ConvertControllerTest#corruptNotAZip_rejected.</p>
|
* ConvertControllerTest#corruptNotAZip_rejected.</p>
|
||||||
*/
|
*/
|
||||||
void validate(byte[] docxBytes, ConvertOptions options) {
|
void validate(byte[] docxBytes, ConvertOptions options) {
|
||||||
try {
|
|
||||||
WordPdfValidator.checkInput(docxBytes, options.maxBytes());
|
WordPdfValidator.checkInput(docxBytes, options.maxBytes());
|
||||||
} catch (ConversionException e) {
|
|
||||||
throw new ValidationException(e.getMessage(), e);
|
|
||||||
}
|
|
||||||
if (docxBytes.length < 4 || docxBytes[0] != 'P' || docxBytes[1] != 'K'
|
if (docxBytes.length < 4 || docxBytes[0] != 'P' || docxBytes[1] != 'K'
|
||||||
|| (docxBytes[2] & 0xFF) != 0x03 || (docxBytes[3] & 0xFF) != 0x04) {
|
|| (docxBytes[2] & 0xFF) != 0x03 || (docxBytes[3] & 0xFF) != 0x04) {
|
||||||
throw new ValidationException("Содержимое не похоже на .docx (не zip-архив)");
|
throw new ValidationException("Содержимое не похоже на .docx (не zip-архив)");
|
||||||
}
|
}
|
||||||
try {
|
WordPdfValidator.checkPageCount(docxBytes, options.maxPages());
|
||||||
WordPdfValidator.checkPageCountLightweight(docxBytes, options.maxPages());
|
|
||||||
} catch (ConversionException e) {
|
|
||||||
throw new ValidationException(e.getMessage(), e);
|
|
||||||
}
|
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -149,6 +144,10 @@ final class ConversionService {
|
|||||||
try {
|
try {
|
||||||
// заголовок PDF — санитизированный base исходного имени
|
// заголовок PDF — санитизированный base исходного имени
|
||||||
return WordPdfConverter.convert(docxBytes, safeBaseName(originalFilename), options);
|
return WordPdfConverter.convert(docxBytes, safeBaseName(originalFilename), options);
|
||||||
|
} catch (ValidationException e) {
|
||||||
|
// отказ проверки страниц внутри конвейера ядра — некорректный
|
||||||
|
// вход (400), а не ошибка рендера: без этого утонул бы в 500
|
||||||
|
throw e;
|
||||||
} catch (DrawingFoundException e) {
|
} catch (DrawingFoundException e) {
|
||||||
// отказ по настройке запроса (error-флаг) — не ошибка рендера: 422,
|
// отказ по настройке запроса (error-флаг) — не ошибка рендера: 422,
|
||||||
// иначе утонет в общем catch ниже как 500
|
// иначе утонет в общем catch ниже как 500
|
||||||
|
|||||||
@@ -13,6 +13,7 @@ import org.springframework.beans.factory.annotation.Value;
|
|||||||
import org.springframework.web.multipart.MultipartFile;
|
import org.springframework.web.multipart.MultipartFile;
|
||||||
import ru.pjandro.wordpdf.ConvertOptions;
|
import ru.pjandro.wordpdf.ConvertOptions;
|
||||||
import ru.pjandro.wordpdf.WordPdfSettings;
|
import ru.pjandro.wordpdf.WordPdfSettings;
|
||||||
|
import ru.pjandro.wordpdf.ValidationException;
|
||||||
|
|
||||||
import java.io.IOException;
|
import java.io.IOException;
|
||||||
import java.nio.charset.StandardCharsets;
|
import java.nio.charset.StandardCharsets;
|
||||||
|
|||||||
@@ -1,23 +0,0 @@
|
|||||||
package ru.pjandro.wordpdf.app;
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Некорректный вход: пустой файл, не .docx, не zip-архив, размер или число
|
|
||||||
* страниц сверх переданных в запросе (или дефолтных) лимитов.
|
|
||||||
*
|
|
||||||
* <p>Отличается от {@link ConversionFailedException} смыслом: запрос
|
|
||||||
* некорректен сам по себе, повтор его же ничего не изменит. Маппится в HTTP 400
|
|
||||||
* ({@link ApiExceptionHandler}).</p>
|
|
||||||
*
|
|
||||||
* <p>Регрессия — ConvertControllerTest#nonDocxFilename_rejected,
|
|
||||||
* #oversizedOverCoreLimit_rejected, #corruptNotAZip_rejected.</p>
|
|
||||||
*/
|
|
||||||
class ValidationException extends RuntimeException {
|
|
||||||
|
|
||||||
ValidationException(String message) {
|
|
||||||
super(message);
|
|
||||||
}
|
|
||||||
|
|
||||||
ValidationException(String message, Throwable cause) {
|
|
||||||
super(message, cause);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@@ -252,14 +252,14 @@ class ConvertControllerTest {
|
|||||||
|
|
||||||
@Test
|
@Test
|
||||||
void oversizedOverCoreLimit_rejected() throws Exception {
|
void oversizedOverCoreLimit_rejected() throws Exception {
|
||||||
// 20 MiB + 1 байт: проходит контейнерный multipart-лимит (100 МБ)
|
// 5 MiB + 1 байт: проходит контейнерный multipart-лимит (100 МБ)
|
||||||
// и отсекается валидацией ядра до очереди (дефолт ядра цел —
|
// и отсекается валидацией ядра до очереди (дефолт ядра цел —
|
||||||
// лимит задаёт только конфигурация сервера)
|
// лимит задаёт только конфигурация сервера)
|
||||||
byte[] big = new byte[20 * 1024 * 1024 + 1];
|
byte[] big = new byte[5 * 1024 * 1024 + 1];
|
||||||
mockMvc.perform(multipart("/api/v1/convert").file(docx("big.docx", big)))
|
mockMvc.perform(multipart("/api/v1/convert").file(docx("big.docx", big)))
|
||||||
.andExpect(status().isBadRequest())
|
.andExpect(status().isBadRequest())
|
||||||
.andExpect(jsonPath("$.error",
|
.andExpect(jsonPath("$.error",
|
||||||
org.hamcrest.Matchers.containsString("больше 20 МБ")));
|
org.hamcrest.Matchers.containsString("больше 5 МБ")));
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
|
|||||||
@@ -0,0 +1,22 @@
|
|||||||
|
package ru.pjandro.wordpdf;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Некорректный вход: {@code null}-байты, размер или число страниц сверх
|
||||||
|
* лимитов, неразбираемый .docx-контейнер (не zip / битый XML).
|
||||||
|
*
|
||||||
|
* <p>Отличается от прочего {@link ConversionException} смыслом: вход плох сам
|
||||||
|
* по себе, повтор с теми же байтами ничего не изменит. Наследник
|
||||||
|
* {@code ConversionException} — наружу по-прежнему ловится только он
|
||||||
|
* (в т.ч. из {@link WordPdfConverter}, который вызывает валидатор сам).
|
||||||
|
* Регрессия — WordPdfValidatorTest, ConvertControllerTest#corruptNotAZip_rejected.</p>
|
||||||
|
*/
|
||||||
|
public class ValidationException extends ConversionException {
|
||||||
|
|
||||||
|
public ValidationException(String message) {
|
||||||
|
super(message);
|
||||||
|
}
|
||||||
|
|
||||||
|
public ValidationException(String message, Throwable cause) {
|
||||||
|
super(message, cause);
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -59,14 +59,16 @@ public final class WordPdfConverter {
|
|||||||
*
|
*
|
||||||
* <p>Вход проверяется валидатором до рендера: {@link WordPdfValidator#checkInput(byte[])}
|
* <p>Вход проверяется валидатором до рендера: {@link WordPdfValidator#checkInput(byte[])}
|
||||||
* (null / больше {@link WordPdfSettings#MAX_INPUT_BYTES}), затем число страниц
|
* (null / больше {@link WordPdfSettings#MAX_INPUT_BYTES}), затем число страниц
|
||||||
* ({@link WordPdfSettings#MAX_PAGES}) — при отказе байтов результата нет.
|
* ({@link WordPdfValidator#checkPageCount(byte[])}, лимит
|
||||||
|
* {@link WordPdfSettings#MAX_PAGES}) — при отказе байтов результата нет.
|
||||||
*
|
*
|
||||||
* @param docxBytes байты .docx
|
* @param docxBytes байты .docx
|
||||||
* @param title заголовок PDF (метаданные); {@code null}/пустая — заголовок не задаётся
|
* @param title заголовок PDF (метаданные); {@code null}/пустая — заголовок не задаётся
|
||||||
* @return байты готового PDF
|
* @return байты готового PDF
|
||||||
* @throws ConversionException при ошибке (битый .docx, размер больше
|
* @throws ValidationException некорректный вход: {@code null}, размер больше
|
||||||
* {@link WordPdfSettings#MAX_INPUT_BYTES}, результат длиннее
|
* {@link WordPdfSettings#MAX_INPUT_BYTES}, документ длиннее
|
||||||
* {@link WordPdfSettings#MAX_PAGES} страниц и т.п.)
|
* {@link WordPdfSettings#MAX_PAGES} страниц
|
||||||
|
* @throws ConversionException прочие ошибки (битый .docx, ошибка рендера)
|
||||||
*/
|
*/
|
||||||
public static byte[] convert(byte[] docxBytes, String title) throws ConversionException {
|
public static byte[] convert(byte[] docxBytes, String title) throws ConversionException {
|
||||||
return convert(docxBytes, title, ConvertOptions.defaults());
|
return convert(docxBytes, title, ConvertOptions.defaults());
|
||||||
@@ -78,16 +80,18 @@ public final class WordPdfConverter {
|
|||||||
*
|
*
|
||||||
* <p>Вход проверяется валидатором до рендера: {@link WordPdfValidator#checkInput(byte[], long)}
|
* <p>Вход проверяется валидатором до рендера: {@link WordPdfValidator#checkInput(byte[], long)}
|
||||||
* (null / больше {@code options.maxBytes()}), затем число страниц
|
* (null / больше {@code options.maxBytes()}), затем число страниц
|
||||||
* ({@code options.maxPages()}) — при отказе байтов результата нет.
|
* ({@link WordPdfValidator#checkPageCount(byte[], int)}, лимит
|
||||||
|
* {@code options.maxPages()}) — при отказе байтов результата нет.
|
||||||
*
|
*
|
||||||
* @param docxBytes байты .docx
|
* @param docxBytes байты .docx
|
||||||
* @param title заголовок PDF (метаданные); {@code null}/пустая — заголовок не задаётся
|
* @param title заголовок PDF (метаданные); {@code null}/пустая — заголовок не задаётся
|
||||||
* @param options рисование и лимиты входа на этот вызов; {@code null} —
|
* @param options рисование и лимиты входа на этот вызов; {@code null} —
|
||||||
* дефолты (константы {@link WordPdfSettings})
|
* дефолты (константы {@link WordPdfSettings})
|
||||||
* @return байты готового PDF
|
* @return байты готового PDF
|
||||||
* @throws ConversionException при ошибке (битый .docx, размер больше
|
* @throws ValidationException некорректный вход: {@code null}, размер больше
|
||||||
* {@code options.maxBytes()}, результат длиннее
|
* {@code options.maxBytes()}, документ длиннее {@code options.maxPages()}
|
||||||
* {@code options.maxPages()} страниц и т.п.)
|
* страниц
|
||||||
|
* @throws ConversionException прочие ошибки (битый .docx, ошибка рендера)
|
||||||
*/
|
*/
|
||||||
public static byte[] convert(byte[] docxBytes, String title, ConvertOptions options) throws ConversionException {
|
public static byte[] convert(byte[] docxBytes, String title, ConvertOptions options) throws ConversionException {
|
||||||
ConvertOptions opts = options == null ? ConvertOptions.defaults() : options;
|
ConvertOptions opts = options == null ? ConvertOptions.defaults() : options;
|
||||||
@@ -96,6 +100,8 @@ public final class WordPdfConverter {
|
|||||||
try {
|
try {
|
||||||
convertToStream(docxBytes, title, opts, bos);
|
convertToStream(docxBytes, title, opts, bos);
|
||||||
} catch (ConversionException e) {
|
} catch (ConversionException e) {
|
||||||
|
// ValidationException (отказ валидации входа) — подтип, уходит
|
||||||
|
// вызывающему без обёртки
|
||||||
throw e;
|
throw e;
|
||||||
} catch (Exception e) {
|
} catch (Exception e) {
|
||||||
throw new ConversionException("Не удалось конвертировать документ", e);
|
throw new ConversionException("Не удалось конвертировать документ", e);
|
||||||
@@ -139,12 +145,13 @@ public final class WordPdfConverter {
|
|||||||
WordprocessingMLPackage pkg = WordprocessingMLPackage.load(
|
WordprocessingMLPackage pkg = WordprocessingMLPackage.load(
|
||||||
new ByteArrayInputStream(docxBytes));
|
new ByteArrayInputStream(docxBytes));
|
||||||
try {
|
try {
|
||||||
// 2.5 Проверка числа страниц по самому .docx: кэш Word
|
// 2.5 Проверка числа страниц по самому .docx: lightweight-оценка
|
||||||
// (docProps/app.xml <Pages>) или нижняя оценка по явным
|
// по zip (кэш docProps/app.xml <Pages>, явные разрывы, маркеры
|
||||||
// разрывам. Делается до рендера, чтобы не тратить время на
|
// w:lastRenderedPageBreak, включая колонтитулы) — без JAXB-модели.
|
||||||
// заведомо длинный документ; внутри try — чтобы и на отказе
|
// Делается до рендера, чтобы не тратить время на заведомо
|
||||||
// отработал finally с чисткой temp-файлов встроенных шрифтов.
|
// длинный документ; внутри try — чтобы и на отказе отработал
|
||||||
WordPdfValidator.checkPageCount(pkg, options.maxPages());
|
// finally с чисткой temp-файлов встроенных шрифтов.
|
||||||
|
WordPdfValidator.checkPageCount(docxBytes, options.maxPages());
|
||||||
// 3. Привязка маппера: docx4j сопоставляет шрифты документа
|
// 3. Привязка маппера: docx4j сопоставляет шрифты документа
|
||||||
// с физическими TTF (учитывая и шрифты, встроенные в docx)
|
// с физическими TTF (учитывая и шрифты, встроенные в docx)
|
||||||
pkg.setFontMapper(mapper);
|
pkg.setFontMapper(mapper);
|
||||||
|
|||||||
@@ -1,15 +1,5 @@
|
|||||||
package ru.pjandro.wordpdf;
|
package ru.pjandro.wordpdf;
|
||||||
|
|
||||||
import org.docx4j.openpackaging.packages.WordprocessingMLPackage;
|
|
||||||
import org.docx4j.wml.Br;
|
|
||||||
import org.docx4j.wml.ContentAccessor;
|
|
||||||
import org.docx4j.wml.P;
|
|
||||||
import org.docx4j.wml.R;
|
|
||||||
import org.docx4j.wml.SectPr;
|
|
||||||
import org.docx4j.wml.STBrType;
|
|
||||||
|
|
||||||
import jakarta.xml.bind.JAXBElement;
|
|
||||||
|
|
||||||
import javax.xml.stream.XMLInputFactory;
|
import javax.xml.stream.XMLInputFactory;
|
||||||
import javax.xml.stream.XMLStreamException;
|
import javax.xml.stream.XMLStreamException;
|
||||||
import javax.xml.stream.XMLStreamReader;
|
import javax.xml.stream.XMLStreamReader;
|
||||||
@@ -27,9 +17,8 @@ import java.util.zip.ZipInputStream;
|
|||||||
* Валидатор ограничений на входной .docx:
|
* Валидатор ограничений на входной .docx:
|
||||||
* размер входа и число страниц.
|
* размер входа и число страниц.
|
||||||
*
|
*
|
||||||
* <p>Вход валидатора — только {@code byte[]} (или уже загруженный
|
* <p>Вход валидатора — только {@code byte[]}: файловых проверок нет,
|
||||||
* {@link WordprocessingMLPackage}): файловых проверок нет, работа с
|
* работа с файлами — забота вызывающего (приложения).
|
||||||
* файлами — забота вызывающего (приложения).
|
|
||||||
*
|
*
|
||||||
* <p>Конвертер {@link WordPdfConverter} вызывает валидатор автоматически,
|
* <p>Конвертер {@link WordPdfConverter} вызывает валидатор автоматически,
|
||||||
* но им можно пользоваться и напрямую — например, проверить байты
|
* но им можно пользоваться и напрямую — например, проверить байты
|
||||||
@@ -55,7 +44,7 @@ import java.util.zip.ZipInputStream;
|
|||||||
* <p>Проверка делается <b>до</b> рендера — это позволяет отсекать слишком
|
* <p>Проверка делается <b>до</b> рендера — это позволяет отсекать слишком
|
||||||
* длинные документы, не тратя время на конвертацию.
|
* длинные документы, не тратя время на конвертацию.
|
||||||
*
|
*
|
||||||
* <p>Все ошибки — {@link ConversionException}.
|
* <p>Все ошибки — {@link ValidationException} (наследник {@link ConversionException}).
|
||||||
*/
|
*/
|
||||||
public final class WordPdfValidator {
|
public final class WordPdfValidator {
|
||||||
|
|
||||||
@@ -65,9 +54,9 @@ public final class WordPdfValidator {
|
|||||||
/**
|
/**
|
||||||
* Проверяет размер байтов входа (для документа, полученного из сети/БД).
|
* Проверяет размер байтов входа (для документа, полученного из сети/БД).
|
||||||
*
|
*
|
||||||
* @throws ConversionException при {@code null} или превышении лимита
|
* @throws ValidationException при {@code null} или превышении лимита
|
||||||
*/
|
*/
|
||||||
public static void checkInput(byte[] docxBytes) throws ConversionException {
|
public static void checkInput(byte[] docxBytes) throws ValidationException {
|
||||||
checkInput(docxBytes, WordPdfSettings.MAX_INPUT_BYTES);
|
checkInput(docxBytes, WordPdfSettings.MAX_INPUT_BYTES);
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -75,18 +64,18 @@ public final class WordPdfValidator {
|
|||||||
* Проверяет размер байтов входа против явного лимита (переопределение
|
* Проверяет размер байтов входа против явного лимита (переопределение
|
||||||
* на вызов, см. {@link ConvertOptions#maxBytes()}).
|
* на вызов, см. {@link ConvertOptions#maxBytes()}).
|
||||||
*
|
*
|
||||||
* @throws ConversionException при {@code null} или превышении {@code maxBytes}
|
* @throws ValidationException при {@code null} или превышении {@code maxBytes}
|
||||||
*/
|
*/
|
||||||
public static void checkInput(byte[] docxBytes, long maxBytes) throws ConversionException {
|
public static void checkInput(byte[] docxBytes, long maxBytes) throws ValidationException {
|
||||||
if (docxBytes == null) {
|
if (docxBytes == null) {
|
||||||
throw new ConversionException("Не указаны байты входного файла");
|
throw new ValidationException("Не указаны байты входного файла");
|
||||||
}
|
}
|
||||||
if (docxBytes.length > maxBytes) {
|
if (docxBytes.length > maxBytes) {
|
||||||
// дефолтный лимит кратен MiB — сообщение остаётся «... 20 МБ ...»
|
// дефолтный лимит кратен MiB — сообщение остаётся «... 5 МБ ...»
|
||||||
String limit = maxBytes % (1024 * 1024) == 0
|
String limit = maxBytes % (1024 * 1024) == 0
|
||||||
? (maxBytes / (1024 * 1024)) + " МБ"
|
? (maxBytes / (1024 * 1024)) + " МБ"
|
||||||
: maxBytes + " байт";
|
: maxBytes + " байт";
|
||||||
throw new ConversionException("Файл больше " + limit
|
throw new ValidationException("Файл больше " + limit
|
||||||
+ ": " + docxBytes.length + " байт > " + maxBytes + " байт");
|
+ ": " + docxBytes.length + " байт > " + maxBytes + " байт");
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
@@ -98,32 +87,41 @@ public final class WordPdfValidator {
|
|||||||
* {@code docProps/app.xml}). Дешёвый путь для проверки байтов из
|
* {@code docProps/app.xml}). Дешёвый путь для проверки байтов из
|
||||||
* сети/БД до любой работы с библиотекой.
|
* сети/БД до любой работы с библиотекой.
|
||||||
*
|
*
|
||||||
* <p>Оценка согласована с {@link #checkPageCount(WordprocessingMLPackage)}
|
* <p>Оценка — максимум трёх нижних оценок: кэша Word в
|
||||||
* по всем источникам; на границе лимита оба пути дают одинаковый ответ
|
* {@code docProps/app.xml} ({@code <Pages>}; сам по себе недостоверен —
|
||||||
* (регрессия — {@code checkPageCountLightweight_agreesWithJaxbPath},
|
* в регрессной фикстуре {@code stale-cache.docx} равен 1 при 110
|
||||||
* включая 99/100/101 разрывов). Lightweight-путь дополнительно считает
|
* границах страниц), явных разрывов ({@code w:br type="page"},
|
||||||
* разрывы в колонтитулах — он консервативнее, расхождение возможно
|
* {@code w:pageBreakBefore}, межсекционные {@code w:sectPr} — абзацы
|
||||||
|
* ищутся рекурсивно, включая ячейки таблиц и контентные контролы
|
||||||
|
* {@code w:sdt}) и маркеров {@code w:lastRenderedPageBreak} — границ
|
||||||
|
* страниц, которые Word записал при последнем рендере. Оценка нижняя:
|
||||||
|
* документ без явных разрывов и без маркеров (никогда не открывался в
|
||||||
|
* Word) оценивается в 1 страницу независимо от фактической длины —
|
||||||
|
* такие документы лимит не отсекают. На границе лимита оценка точна
|
||||||
|
* (регрессия — {@code checkPageCount_limitBoundary},
|
||||||
|
* включая 99/100/101 разрывов); путь дополнительно считает разрывы в
|
||||||
|
* колонтитулах — консервативная нижняя оценка, расхождение возможно
|
||||||
* только в сторону завышения.
|
* только в сторону завышения.
|
||||||
*
|
*
|
||||||
* <p>Не-zip байты не отвергаются: {@code ZipInputStream} доходит до EOF
|
* <p>Не-zip байты не отвергаются: {@code ZipInputStream} доходит до EOF
|
||||||
* без единой записи — молча, оценка «1 страница». Корректность контейнера
|
* без единой записи — молча, оценка «1 страница». Корректность контейнера
|
||||||
* проверяет вызывающий по zip-подписи ({@code ConversionService.validate}
|
* проверяет вызывающий по zip-подписи ({@code ConversionService.validate}
|
||||||
* в приложении; регрессия — {@code ConvertControllerTest#corruptNotAZip_rejected}).
|
* в приложении; регрессия — {@code ConvertControllerTest#corruptNotAZip_rejected}).
|
||||||
* @throws ConversionException при {@code null}, ошибке разбора zip или превышении {@link WordPdfSettings#MAX_PAGES}
|
* @throws ValidationException при {@code null}, ошибке разбора zip или превышении {@link WordPdfSettings#MAX_PAGES}
|
||||||
*/
|
*/
|
||||||
public static void checkPageCountLightweight(byte[] docxBytes) throws ConversionException {
|
public static void checkPageCount(byte[] docxBytes) throws ValidationException {
|
||||||
checkPageCountLightweight(docxBytes, WordPdfSettings.MAX_PAGES);
|
checkPageCount(docxBytes, WordPdfSettings.MAX_PAGES);
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* То же, что {@link #checkPageCountLightweight(byte[])}, с явным лимитом
|
* То же, что {@link #checkPageCount(byte[])}, с явным лимитом
|
||||||
* страниц (переопределение на вызов, см. {@link ConvertOptions#maxPages()}).
|
* страниц (переопределение на вызов, см. {@link ConvertOptions#maxPages()}).
|
||||||
*
|
*
|
||||||
* @throws ConversionException при {@code null}, ошибке разбора zip или превышении {@code maxPages}
|
* @throws ValidationException при {@code null}, ошибке разбора zip или превышении {@code maxPages}
|
||||||
*/
|
*/
|
||||||
public static void checkPageCountLightweight(byte[] docxBytes, int maxPages) throws ConversionException {
|
public static void checkPageCount(byte[] docxBytes, int maxPages) throws ValidationException {
|
||||||
if (docxBytes == null) {
|
if (docxBytes == null) {
|
||||||
throw new ConversionException("Не указаны байты входного .docx");
|
throw new ValidationException("Не указаны байты входного .docx");
|
||||||
}
|
}
|
||||||
int pages;
|
int pages;
|
||||||
try (ZipInputStream zip = new ZipInputStream(new ByteArrayInputStream(docxBytes))) {
|
try (ZipInputStream zip = new ZipInputStream(new ByteArrayInputStream(docxBytes))) {
|
||||||
@@ -145,196 +143,14 @@ public final class WordPdfValidator {
|
|||||||
return b == null ? null : new ByteArrayInputStream(b);
|
return b == null ? null : new ByteArrayInputStream(b);
|
||||||
}, headerFooter);
|
}, headerFooter);
|
||||||
} catch (IOException | RuntimeException e) {
|
} catch (IOException | RuntimeException e) {
|
||||||
throw new ConversionException("Не удалось разобрать байты .docx", e);
|
throw new ValidationException("Не удалось разобрать байты .docx", e);
|
||||||
}
|
}
|
||||||
if (pages > maxPages) {
|
if (pages > maxPages) {
|
||||||
throw new ConversionException("Документ длиннее " + maxPages
|
throw new ValidationException("Документ длиннее " + maxPages
|
||||||
+ " страниц: получено не менее " + pages);
|
+ " страниц: получено не менее " + pages);
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
|
||||||
* Считает страницы .docx в байтах и проверяет лимит.
|
|
||||||
*
|
|
||||||
* @throws ConversionException при {@code null}, ошибке загрузки или превышении лимита
|
|
||||||
*/
|
|
||||||
public static void checkPageCount(byte[] docxBytes) throws ConversionException {
|
|
||||||
checkPageCount(docxBytes, WordPdfSettings.MAX_PAGES);
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* То же, что {@link #checkPageCount(byte[])}, с явным лимитом страниц
|
|
||||||
* (переопределение на вызов, см. {@link ConvertOptions#maxPages()}).
|
|
||||||
*
|
|
||||||
* @throws ConversionException при {@code null}, ошибке загрузки или
|
|
||||||
* превышении {@code maxPages}
|
|
||||||
*/
|
|
||||||
public static void checkPageCount(byte[] docxBytes, int maxPages) throws ConversionException {
|
|
||||||
if (docxBytes == null) {
|
|
||||||
throw new ConversionException("Не указаны байты входного .docx");
|
|
||||||
}
|
|
||||||
WordprocessingMLPackage pkg;
|
|
||||||
try {
|
|
||||||
pkg = WordprocessingMLPackage.load(new ByteArrayInputStream(docxBytes));
|
|
||||||
} catch (Exception e) {
|
|
||||||
throw new ConversionException("Не удалось разобрать байты .docx", e);
|
|
||||||
}
|
|
||||||
checkPageCount(pkg, maxPages);
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Считает страницы уже загруженного .docx и проверяет лимит.
|
|
||||||
*
|
|
||||||
* <p>Число страниц — максимум трёх нижних оценок:
|
|
||||||
* <ol>
|
|
||||||
* <li>Кэш Word в {@code docProps/app.xml} ({@code <Pages>}).
|
|
||||||
* Сам по себе недостоверен: Word может сохранить устаревшее
|
|
||||||
* значение (в регрессной фикстуре {@code stale-cache.docx}
|
|
||||||
* кэш равен 1 при 110 границах страниц).</li>
|
|
||||||
* <li>Явные разрывы: {@code w:br[@w:type='page']},
|
|
||||||
* {@code w:pageBreakBefore} и {@code w:sectPr} прямо в
|
|
||||||
* {@code w:body}. Абзацы ищутся не только прямо в {@code w:body},
|
|
||||||
* но и внутри таблиц, контентных контролов {@code w:sdt}
|
|
||||||
* (Word держит нумерацию именно в контентном контроле) и
|
|
||||||
* прочего содержимого, реализующего {@link ContentAccessor}.</li>
|
|
||||||
* <li>Маркеры {@code w:lastRenderedPageBreak} — границы страниц,
|
|
||||||
* которые Word записал при последнем рендере. Единственный
|
|
||||||
* источник оценки для документов без явных разрывов, порванных
|
|
||||||
* по заполнению.</li>
|
|
||||||
* </ol>
|
|
||||||
*
|
|
||||||
* <p>Оценка остаётся нижней: документ без явных разрывов и без
|
|
||||||
* маркеров (никогда не открывался в Word) оценивается в 1 страницу
|
|
||||||
* независимо от фактической длины — такие документы лимит не отсекают.
|
|
||||||
* @throws ConversionException при превышении {@link WordPdfSettings#MAX_PAGES}
|
|
||||||
*/
|
|
||||||
public static void checkPageCount(WordprocessingMLPackage pkg) throws ConversionException {
|
|
||||||
checkPageCount(pkg, WordPdfSettings.MAX_PAGES);
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* То же, что {@link #checkPageCount(WordprocessingMLPackage)}, с явным
|
|
||||||
* лимитом страниц (переопределение на вызов, см. {@link ConvertOptions#maxPages()}).
|
|
||||||
*
|
|
||||||
* @throws ConversionException при превышении {@code maxPages}
|
|
||||||
*/
|
|
||||||
public static void checkPageCount(WordprocessingMLPackage pkg, int maxPages) throws ConversionException {
|
|
||||||
if (pkg == null) {
|
|
||||||
throw new ConversionException("Не указан загруженный .docx");
|
|
||||||
}
|
|
||||||
int pages = pageCountOf(pkg);
|
|
||||||
if (pages > maxPages) {
|
|
||||||
throw new ConversionException("Документ длиннее " + maxPages
|
|
||||||
+ " страниц: получено не менее " + pages);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Возвращает число страниц: максимум кэша {@code <Pages>}, оценки по
|
|
||||||
* явным разрывам и оценки по {@code w:lastRenderedPageBreak}.
|
|
||||||
* Виден только из тестов и пакета.
|
|
||||||
*/
|
|
||||||
static int pageCountOf(WordprocessingMLPackage pkg) {
|
|
||||||
int cached = 0;
|
|
||||||
try {
|
|
||||||
if (pkg.getDocPropsExtendedPart() != null) {
|
|
||||||
org.docx4j.docProps.extended.Properties ext =
|
|
||||||
pkg.getDocPropsExtendedPart().getContents();
|
|
||||||
if (ext != null && ext.getPages() != null && ext.getPages() > 0) {
|
|
||||||
cached = ext.getPages();
|
|
||||||
}
|
|
||||||
}
|
|
||||||
} catch (Exception ignored) {
|
|
||||||
// docPropsExtended может быть не полностью инициализирован —
|
|
||||||
// тогда остаётся оценка по разрывам.
|
|
||||||
}
|
|
||||||
// getJaxbElement() возвращает null, когда JAXB-разбор части провалился
|
|
||||||
// (docx4j пишет в лог «Problem with part» и «gives up») — без проверки
|
|
||||||
// здесь была бы NPE вместо внятной ошибки.
|
|
||||||
var document = pkg.getMainDocumentPart() == null
|
|
||||||
? null : pkg.getMainDocumentPart().getJaxbElement();
|
|
||||||
if (document == null || document.getBody() == null) {
|
|
||||||
throw new ConversionException("Не удалось разобрать word/document.xml");
|
|
||||||
}
|
|
||||||
var body = document.getBody();
|
|
||||||
var content = body.getContent();
|
|
||||||
int explicit = 1; // сам документ — минимум одна страница
|
|
||||||
for (Object child : content) {
|
|
||||||
// В JAXB-модели в body.getContent() лежат только межсекционные
|
|
||||||
// sectPr; финальная секция — в body.getSectPr(), её здесь нет.
|
|
||||||
if (child instanceof SectPr sect && startsNewPage(sect)) {
|
|
||||||
explicit++;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
explicit += walkForPageBreaks(content);
|
|
||||||
int lastRendered = countLastRendered(content);
|
|
||||||
return Math.max(Math.max(cached, explicit), lastRendered + 1);
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Обход содержимого на явные разрывы: абзацы ищутся рекурсивно —
|
|
||||||
* прямо в {@code w:body}, в ячейках таблиц, в контентных контролах
|
|
||||||
* {@code w:sdt} и прочем содержимом, реализующем {@link ContentAccessor}.
|
|
||||||
* Элементы модели приходят и напрямую, и обёрнутыми в
|
|
||||||
* {@link JAXBElement} (например {@code w:tbl} в {@code w:body}) —
|
|
||||||
* обёртка раскрывается через {@link #unwrap}.
|
|
||||||
* Считаются {@code w:br type="page"} и {@code pageBreakBefore}
|
|
||||||
* (по одному на абзац), как и в lightweight-пути.
|
|
||||||
*/
|
|
||||||
private static int walkForPageBreaks(List<?> content) {
|
|
||||||
int count = 0;
|
|
||||||
for (Object raw : content) {
|
|
||||||
Object item = unwrap(raw);
|
|
||||||
if (item instanceof P p) {
|
|
||||||
if (p.getPPr() != null
|
|
||||||
&& p.getPPr().getPageBreakBefore() != null
|
|
||||||
&& p.getPPr().getPageBreakBefore().isVal()) {
|
|
||||||
count++;
|
|
||||||
}
|
|
||||||
for (Object runChild : p.getContent()) {
|
|
||||||
if (unwrap(runChild) instanceof org.docx4j.wml.R r) {
|
|
||||||
for (Object innerRaw : r.getContent()) {
|
|
||||||
if (unwrap(innerRaw) instanceof Br br
|
|
||||||
&& br.getType() == STBrType.PAGE) {
|
|
||||||
count++;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
} else if (item instanceof ContentAccessor ca) {
|
|
||||||
// w:tbl / w:tr / w:tc / w:sdt / w:sdtContent и т.п.
|
|
||||||
count += walkForPageBreaks(ca.getContent());
|
|
||||||
}
|
|
||||||
}
|
|
||||||
return count;
|
|
||||||
}
|
|
||||||
|
|
||||||
/** Подсчёт маркеров {@code w:lastRenderedPageBreak} в содержимом. */
|
|
||||||
private static int countLastRendered(List<?> content) {
|
|
||||||
int count = 0;
|
|
||||||
for (Object raw : content) {
|
|
||||||
Object item = unwrap(raw);
|
|
||||||
if (item instanceof R.LastRenderedPageBreak) {
|
|
||||||
count++;
|
|
||||||
} else if (item instanceof ContentAccessor ca) {
|
|
||||||
count += countLastRendered(ca.getContent());
|
|
||||||
}
|
|
||||||
}
|
|
||||||
return count;
|
|
||||||
}
|
|
||||||
|
|
||||||
/** Раскрывает обёртку {@link JAXBElement} (docx4j так отдаёт tbl и часть содержимого). */
|
|
||||||
private static Object unwrap(Object item) {
|
|
||||||
return item instanceof JAXBElement<?> je ? je.getValue() : item;
|
|
||||||
}
|
|
||||||
|
|
||||||
/** Секция, начинающая новую страницу (continuous — нет). */
|
|
||||||
private static boolean startsNewPage(SectPr sect) {
|
|
||||||
return sect.getType() == null
|
|
||||||
|| sect.getType().getVal() == null
|
|
||||||
|| !sect.getType().getVal().equals("continuous");
|
|
||||||
}
|
|
||||||
|
|
||||||
/** Поставщик потока по имени части zip; null — части нет. */
|
/** Поставщик потока по имени части zip; null — части нет. */
|
||||||
private interface PartStream {
|
private interface PartStream {
|
||||||
InputStream open(String name) throws IOException;
|
InputStream open(String name) throws IOException;
|
||||||
@@ -348,8 +164,7 @@ public final class WordPdfValidator {
|
|||||||
|
|
||||||
/**
|
/**
|
||||||
* Лёгкий расчёт числа страниц прямо по zip-пакету .docx, без docx4j.
|
* Лёгкий расчёт числа страниц прямо по zip-пакету .docx, без docx4j.
|
||||||
* Та же логика, что у {@link #pageCountOf(WordprocessingMLPackage)}:
|
* Максимум кэша {@code docProps/app.xml <Pages>}, явных разрывов и
|
||||||
* максимум кэша {@code docProps/app.xml <Pages>}, явных разрывов и
|
|
||||||
* {@code w:lastRenderedPageBreak}. Считаются все колонтитулы
|
* {@code w:lastRenderedPageBreak}. Считаются все колонтитулы
|
||||||
* ({@code word/header*.xml}, {@code word/footer*.xml}) — там Word тоже
|
* ({@code word/header*.xml}, {@code word/footer*.xml}) — там Word тоже
|
||||||
* держит {@code w:br type="page"}.
|
* держит {@code w:br type="page"}.
|
||||||
|
|||||||
@@ -432,19 +432,19 @@ class WordPdfConverterTest {
|
|||||||
|
|
||||||
@Test
|
@Test
|
||||||
void invalidInputRejected() {
|
void invalidInputRejected() {
|
||||||
assertThrows(ConversionException.class, () ->
|
assertThrows(ValidationException.class, () ->
|
||||||
WordPdfConverter.convert(null, "x"));
|
WordPdfConverter.convert(null, "x"));
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Лимит на размер входа: больше 20 MiB — отказ до рендера.
|
* Лимит на размер входа: больше 5 MiB — отказ до рендера.
|
||||||
*/
|
*/
|
||||||
@Test
|
@Test
|
||||||
void inputTooLarge() {
|
void inputTooLarge() {
|
||||||
byte[] tooBig = new byte[(int) WordPdfSettings.MAX_INPUT_BYTES + 1];
|
byte[] tooBig = new byte[(int) WordPdfSettings.MAX_INPUT_BYTES + 1];
|
||||||
ConversionException ex = assertThrows(ConversionException.class, () ->
|
ValidationException ex = assertThrows(ValidationException.class, () ->
|
||||||
WordPdfConverter.convert(tooBig, "too-big"));
|
WordPdfConverter.convert(tooBig, "too-big"));
|
||||||
assertTrue(ex.getMessage().contains("20 МБ"),
|
assertTrue(ex.getMessage().contains("5 МБ"),
|
||||||
"сообщение должно упоминать лимит: " + ex.getMessage());
|
"сообщение должно упоминать лимит: " + ex.getMessage());
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -455,7 +455,7 @@ class WordPdfConverterTest {
|
|||||||
*/
|
*/
|
||||||
@Test
|
@Test
|
||||||
void limitsOverriddenByOptions() throws Exception {
|
void limitsOverriddenByOptions() throws Exception {
|
||||||
ConversionException ex = assertThrows(ConversionException.class, () ->
|
ValidationException ex = assertThrows(ValidationException.class, () ->
|
||||||
WordPdfConverter.convert(sampleBytes("ru-plain.docx"), "x",
|
WordPdfConverter.convert(sampleBytes("ru-plain.docx"), "x",
|
||||||
new ConvertOptions(true, true, false, false, 1000, WordPdfSettings.MAX_PAGES)));
|
new ConvertOptions(true, true, false, false, 1000, WordPdfSettings.MAX_PAGES)));
|
||||||
assertTrue(ex.getMessage().contains("1000 байт"),
|
assertTrue(ex.getMessage().contains("1000 байт"),
|
||||||
@@ -469,7 +469,7 @@ class WordPdfConverterTest {
|
|||||||
*/
|
*/
|
||||||
@Test
|
@Test
|
||||||
void tooManyPages() {
|
void tooManyPages() {
|
||||||
ConversionException ex = assertThrows(ConversionException.class, () ->
|
ValidationException ex = assertThrows(ValidationException.class, () ->
|
||||||
WordPdfConverter.convert(
|
WordPdfConverter.convert(
|
||||||
sampleBytes("too-many-pages.docx"), "too-many-pages",
|
sampleBytes("too-many-pages.docx"), "too-many-pages",
|
||||||
new ConvertOptions(true, true, false, false, WordPdfSettings.MAX_INPUT_BYTES, 100)));
|
new ConvertOptions(true, true, false, false, WordPdfSettings.MAX_INPUT_BYTES, 100)));
|
||||||
@@ -486,7 +486,7 @@ class WordPdfConverterTest {
|
|||||||
*/
|
*/
|
||||||
@Test
|
@Test
|
||||||
void staleCachePageCountRejectedBeforeRender() {
|
void staleCachePageCountRejectedBeforeRender() {
|
||||||
ConversionException ex = assertThrows(ConversionException.class, () ->
|
ValidationException ex = assertThrows(ValidationException.class, () ->
|
||||||
WordPdfConverter.convert(sampleBytes("stale-cache.docx"), "stale-cache",
|
WordPdfConverter.convert(sampleBytes("stale-cache.docx"), "stale-cache",
|
||||||
new ConvertOptions(true, true, false, false, WordPdfSettings.MAX_INPUT_BYTES, 100)));
|
new ConvertOptions(true, true, false, false, WordPdfSettings.MAX_INPUT_BYTES, 100)));
|
||||||
assertTrue(ex.getMessage().contains("100"),
|
assertTrue(ex.getMessage().contains("100"),
|
||||||
|
|||||||
@@ -4,7 +4,6 @@ import org.apache.poi.xwpf.usermodel.BreakType;
|
|||||||
import org.apache.poi.xwpf.usermodel.XWPFDocument;
|
import org.apache.poi.xwpf.usermodel.XWPFDocument;
|
||||||
import org.apache.poi.xwpf.usermodel.XWPFParagraph;
|
import org.apache.poi.xwpf.usermodel.XWPFParagraph;
|
||||||
import org.apache.poi.xwpf.usermodel.XWPFTable;
|
import org.apache.poi.xwpf.usermodel.XWPFTable;
|
||||||
import org.docx4j.openpackaging.packages.WordprocessingMLPackage;
|
|
||||||
import org.junit.jupiter.api.Test;
|
import org.junit.jupiter.api.Test;
|
||||||
|
|
||||||
import java.io.ByteArrayOutputStream;
|
import java.io.ByteArrayOutputStream;
|
||||||
@@ -16,7 +15,7 @@ import static org.junit.jupiter.api.Assertions.*;
|
|||||||
|
|
||||||
/**
|
/**
|
||||||
* Юнит-тесты валидатора: размер и число страниц
|
* Юнит-тесты валидатора: размер и число страниц
|
||||||
* (byte[] и уже загруженный пакет).
|
* (byte[], lightweight-путь zip/StAX).
|
||||||
*/
|
*/
|
||||||
class WordPdfValidatorTest {
|
class WordPdfValidatorTest {
|
||||||
|
|
||||||
@@ -42,15 +41,15 @@ class WordPdfValidatorTest {
|
|||||||
@Test
|
@Test
|
||||||
void checkInput_bytesOverLimit() {
|
void checkInput_bytesOverLimit() {
|
||||||
byte[] big = new byte[(int) WordPdfSettings.MAX_INPUT_BYTES + 1];
|
byte[] big = new byte[(int) WordPdfSettings.MAX_INPUT_BYTES + 1];
|
||||||
ConversionException ex = assertThrows(ConversionException.class,
|
ValidationException ex = assertThrows(ValidationException.class,
|
||||||
() -> WordPdfValidator.checkInput(big));
|
() -> WordPdfValidator.checkInput(big));
|
||||||
assertTrue(ex.getMessage().contains("20 МБ"),
|
assertTrue(ex.getMessage().contains("5 МБ"),
|
||||||
"сообщение должно упоминать лимит: " + ex.getMessage());
|
"сообщение должно упоминать лимит: " + ex.getMessage());
|
||||||
}
|
}
|
||||||
|
|
||||||
@Test
|
@Test
|
||||||
void checkInput_bytesNull() {
|
void checkInput_bytesNull() {
|
||||||
assertThrows(ConversionException.class,
|
assertThrows(ValidationException.class,
|
||||||
() -> WordPdfValidator.checkInput((byte[]) null));
|
() -> WordPdfValidator.checkInput((byte[]) null));
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -61,119 +60,58 @@ class WordPdfValidatorTest {
|
|||||||
@Test
|
@Test
|
||||||
void checkInput_customLimit() {
|
void checkInput_customLimit() {
|
||||||
assertDoesNotThrow(() -> WordPdfValidator.checkInput(new byte[10], 100));
|
assertDoesNotThrow(() -> WordPdfValidator.checkInput(new byte[10], 100));
|
||||||
ConversionException ex = assertThrows(ConversionException.class,
|
ValidationException ex = assertThrows(ValidationException.class,
|
||||||
() -> WordPdfValidator.checkInput(new byte[11], 10));
|
() -> WordPdfValidator.checkInput(new byte[11], 10));
|
||||||
assertTrue(ex.getMessage().contains("10 байт"),
|
assertTrue(ex.getMessage().contains("10 байт"),
|
||||||
"сообщение должно упоминать переданный лимит: " + ex.getMessage());
|
"сообщение должно упоминать переданный лимит: " + ex.getMessage());
|
||||||
}
|
}
|
||||||
|
|
||||||
@Test
|
// ---- lightweight (zip/StAX, без docx4j) ----
|
||||||
void checkPageCount_pkgWithinLimit() throws Exception {
|
|
||||||
byte[] bytes = docxWithPageBreaks(5); // 1 + 5 = 6 страниц по оценке
|
|
||||||
WordprocessingMLPackage pkg = WordprocessingMLPackage.load(
|
|
||||||
new java.io.ByteArrayInputStream(bytes));
|
|
||||||
assertDoesNotThrow(() -> WordPdfValidator.checkPageCount(pkg));
|
|
||||||
}
|
|
||||||
|
|
||||||
@Test
|
@Test
|
||||||
void checkPageCount_pkgOverLimit() throws Exception {
|
void checkPageCount_bytesWithinLimit() throws Exception {
|
||||||
byte[] bytes = docxWithPageBreaks(120); // 1 + 120 = 121
|
byte[] bytes = docxWithPageBreaks(5);
|
||||||
WordprocessingMLPackage pkg = WordprocessingMLPackage.load(
|
assertDoesNotThrow(() -> WordPdfValidator.checkPageCount(bytes));
|
||||||
new java.io.ByteArrayInputStream(bytes));
|
|
||||||
ConversionException ex = assertThrows(ConversionException.class,
|
|
||||||
() -> WordPdfValidator.checkPageCount(pkg, 100));
|
|
||||||
assertTrue(ex.getMessage().contains("100"),
|
|
||||||
"сообщение должно упоминать лимит: " + ex.getMessage());
|
|
||||||
}
|
}
|
||||||
|
|
||||||
@Test
|
@Test
|
||||||
void checkPageCount_bytesOverLimit() throws Exception {
|
void checkPageCount_bytesOverLimit() throws Exception {
|
||||||
byte[] bytes = docxWithPageBreaks(120);
|
byte[] bytes = docxWithPageBreaks(120);
|
||||||
ConversionException ex = assertThrows(ConversionException.class,
|
ValidationException ex = assertThrows(ValidationException.class,
|
||||||
() -> WordPdfValidator.checkPageCount(bytes, 100));
|
() -> WordPdfValidator.checkPageCount(bytes, 100));
|
||||||
assertTrue(ex.getMessage().contains("100"),
|
assertTrue(ex.getMessage().contains("100"),
|
||||||
"сообщение должно упоминать лимит: " + ex.getMessage());
|
"сообщение должно упоминать лимит: " + ex.getMessage());
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
|
||||||
* Явный лимит страниц для загруженного пакета: docx с 2 разрывами
|
|
||||||
* (оценка 3) отсекается maxPages=1 и проходит при maxPages=1000.
|
|
||||||
*/
|
|
||||||
@Test
|
|
||||||
void checkPageCount_pkg_customLimit() throws Exception {
|
|
||||||
byte[] bytes = docxWithPageBreaks(2);
|
|
||||||
WordprocessingMLPackage pkg = WordprocessingMLPackage.load(
|
|
||||||
new java.io.ByteArrayInputStream(bytes));
|
|
||||||
ConversionException ex = assertThrows(ConversionException.class,
|
|
||||||
() -> WordPdfValidator.checkPageCount(pkg, 1));
|
|
||||||
assertTrue(ex.getMessage().contains("длиннее 1 страниц"),
|
|
||||||
"сообщение должно упоминать переданный лимит: " + ex.getMessage());
|
|
||||||
assertDoesNotThrow(() -> WordPdfValidator.checkPageCount(pkg, 1000));
|
|
||||||
}
|
|
||||||
|
|
||||||
@Test
|
|
||||||
void checkPageCount_bytesNull() {
|
|
||||||
assertThrows(ConversionException.class,
|
|
||||||
() -> WordPdfValidator.checkPageCount((byte[]) null));
|
|
||||||
}
|
|
||||||
|
|
||||||
@Test
|
|
||||||
void checkPageCount_pkgNull() {
|
|
||||||
assertThrows(ConversionException.class,
|
|
||||||
() -> WordPdfValidator.checkPageCount((WordprocessingMLPackage) null));
|
|
||||||
}
|
|
||||||
|
|
||||||
// ---- lightweight (zip/StAX, без docx4j) ----
|
|
||||||
|
|
||||||
@Test
|
|
||||||
void checkPageCountLightweight_bytesWithinLimit() throws Exception {
|
|
||||||
byte[] bytes = docxWithPageBreaks(5);
|
|
||||||
assertDoesNotThrow(() -> WordPdfValidator.checkPageCountLightweight(bytes));
|
|
||||||
}
|
|
||||||
|
|
||||||
@Test
|
|
||||||
void checkPageCountLightweight_bytesOverLimit() throws Exception {
|
|
||||||
byte[] bytes = docxWithPageBreaks(120);
|
|
||||||
ConversionException ex = assertThrows(ConversionException.class,
|
|
||||||
() -> WordPdfValidator.checkPageCountLightweight(bytes, 100));
|
|
||||||
assertTrue(ex.getMessage().contains("100"),
|
|
||||||
"сообщение должно упоминать лимит: " + ex.getMessage());
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Явный лимит страниц lightweight-пути: те же 3 страницы
|
* Явный лимит страниц lightweight-пути: те же 3 страницы
|
||||||
* (2 разрыва) отсекаются maxPages=1 и проходят при maxPages=1000.
|
* (2 разрыва) отсекаются maxPages=1 и проходят при maxPages=1000.
|
||||||
*/
|
*/
|
||||||
@Test
|
@Test
|
||||||
void checkPageCountLightweight_customLimit() throws Exception {
|
void checkPageCount_customLimit() throws Exception {
|
||||||
byte[] bytes = docxWithPageBreaks(2);
|
byte[] bytes = docxWithPageBreaks(2);
|
||||||
ConversionException ex = assertThrows(ConversionException.class,
|
ValidationException ex = assertThrows(ValidationException.class,
|
||||||
() -> WordPdfValidator.checkPageCountLightweight(bytes, 1));
|
() -> WordPdfValidator.checkPageCount(bytes, 1));
|
||||||
assertTrue(ex.getMessage().contains("длиннее 1 страниц"),
|
assertTrue(ex.getMessage().contains("длиннее 1 страниц"),
|
||||||
"сообщение должно упоминать переданный лимит: " + ex.getMessage());
|
"сообщение должно упоминать переданный лимит: " + ex.getMessage());
|
||||||
assertDoesNotThrow(() -> WordPdfValidator.checkPageCountLightweight(bytes, 1000));
|
assertDoesNotThrow(() -> WordPdfValidator.checkPageCount(bytes, 1000));
|
||||||
}
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Точная граница лимита lightweight-пути: 99 разрывов = 100 страниц
|
||||||
|
* (проходит), 100/101 = 101/102 (отказ с оценкой «не менее 1+breaks»).
|
||||||
|
*/
|
||||||
@Test
|
@Test
|
||||||
void checkPageCountLightweight_agreesWithJaxbPath() throws Exception {
|
void checkPageCount_limitBoundary() throws Exception {
|
||||||
// на фикстурах без кэша Pages оба пути обязаны совпадать,
|
|
||||||
// включая границу лимита: 99 разрывов = 100 страниц (проходит),
|
|
||||||
// 100/101 = 101/102 (отказ)
|
|
||||||
for (int breaks : new int[]{0, 3, 99, 100, 101}) {
|
for (int breaks : new int[]{0, 3, 99, 100, 101}) {
|
||||||
byte[] bytes = docxWithPageBreaks(breaks);
|
byte[] bytes = docxWithPageBreaks(breaks);
|
||||||
WordprocessingMLPackage pkg = WordprocessingMLPackage.load(
|
|
||||||
new java.io.ByteArrayInputStream(bytes));
|
|
||||||
int jaxb = WordPdfValidator.pageCountOf(pkg);
|
|
||||||
// lightweight-путь приватный; проверяем через границу лимита:
|
|
||||||
// 1+breaks совпадает с оценкой JAXB
|
|
||||||
assertEquals(1 + breaks, jaxb, "JAXB-оценка для " + breaks + " разрывов");
|
|
||||||
if (breaks < 100) {
|
if (breaks < 100) {
|
||||||
assertDoesNotThrow(() -> WordPdfValidator.checkPageCountLightweight(bytes, 100));
|
assertDoesNotThrow(() -> WordPdfValidator.checkPageCount(bytes, 100));
|
||||||
} else {
|
} else {
|
||||||
ConversionException ex = assertThrows(ConversionException.class,
|
ValidationException ex = assertThrows(ValidationException.class,
|
||||||
() -> WordPdfValidator.checkPageCountLightweight(bytes, 100));
|
() -> WordPdfValidator.checkPageCount(bytes, 100));
|
||||||
assertTrue(ex.getMessage().contains("не менее " + (1 + breaks)),
|
assertTrue(ex.getMessage().contains("не менее " + (1 + breaks)),
|
||||||
"оценка lightweight должна совпадать с JAXB: " + ex.getMessage());
|
"оценка = 1 + число разрывов: " + ex.getMessage());
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
@@ -186,10 +124,9 @@ class WordPdfValidatorTest {
|
|||||||
* 101 страница, отказ (старый код считал «все минус одна» без
|
* 101 страница, отказ (старый код считал «все минус одна» без
|
||||||
* учёта типа: 101−1=100 и пропускал). Случай B: 101
|
* учёта типа: 101−1=100 и пропускал). Случай B: 101
|
||||||
* {@code continuous} + финальная {@code nextPage} — 1 страница,
|
* {@code continuous} + финальная {@code nextPage} — 1 страница,
|
||||||
* проходит (старый код раздувал до 102 и отвергал). В JAXB-модели
|
* проходит (старый код раздувал до 102 и отвергал); разрывы в
|
||||||
* body-direct sectPr не видны (docx4j оставляет только финальную
|
* колонтитулах только усиливают нижнюю оценку — расхождение с
|
||||||
* в {@code body.getSectPr()}, {@code getContent()} пуст), поэтому
|
* точным числом страниц здесь — допустимое завышение.
|
||||||
* расхождение lightweight здесь — допустимое завышение.
|
|
||||||
* Регрессия — WordPdfValidator#scanDocument.
|
* Регрессия — WordPdfValidator#scanDocument.
|
||||||
*/
|
*/
|
||||||
@Test
|
@Test
|
||||||
@@ -200,8 +137,8 @@ class WordPdfValidatorTest {
|
|||||||
}
|
}
|
||||||
typesA.add("continuous"); // финальная секция — непрерывная
|
typesA.add("continuous"); // финальная секция — непрерывная
|
||||||
byte[] overLimit = docxWithBodySections(typesA);
|
byte[] overLimit = docxWithBodySections(typesA);
|
||||||
ConversionException exLwA = assertThrows(ConversionException.class,
|
ValidationException exLwA = assertThrows(ValidationException.class,
|
||||||
() -> WordPdfValidator.checkPageCountLightweight(overLimit, 100));
|
() -> WordPdfValidator.checkPageCount(overLimit, 100));
|
||||||
assertTrue(exLwA.getMessage().contains("не менее 101"),
|
assertTrue(exLwA.getMessage().contains("не менее 101"),
|
||||||
"оценка = 1 + 100 межсекционных nextPage: " + exLwA.getMessage());
|
"оценка = 1 + 100 межсекционных nextPage: " + exLwA.getMessage());
|
||||||
|
|
||||||
@@ -211,7 +148,7 @@ class WordPdfValidatorTest {
|
|||||||
}
|
}
|
||||||
typesB.add("nextPage"); // финальная секция
|
typesB.add("nextPage"); // финальная секция
|
||||||
byte[] ok = docxWithBodySections(typesB);
|
byte[] ok = docxWithBodySections(typesB);
|
||||||
assertDoesNotThrow(() -> WordPdfValidator.checkPageCountLightweight(ok, 100),
|
assertDoesNotThrow(() -> WordPdfValidator.checkPageCount(ok, 100),
|
||||||
"continuous-границы не страницы");
|
"continuous-границы не страницы");
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -280,16 +217,10 @@ class WordPdfValidatorTest {
|
|||||||
@Test
|
@Test
|
||||||
void pageCount_staleCacheLosesToLastRenderedMarkers() throws Exception {
|
void pageCount_staleCacheLosesToLastRenderedMarkers() throws Exception {
|
||||||
byte[] bytes = staleCacheFixture();
|
byte[] bytes = staleCacheFixture();
|
||||||
WordprocessingMLPackage pkg = WordprocessingMLPackage.load(
|
ValidationException ex = assertThrows(ValidationException.class,
|
||||||
new java.io.ByteArrayInputStream(bytes));
|
() -> WordPdfValidator.checkPageCount(bytes, 100));
|
||||||
assertEquals(111, WordPdfValidator.pageCountOf(pkg),
|
assertTrue(ex.getMessage().contains("не менее 111"),
|
||||||
"оценка = max(кэш 1, разрывы 1, маркеры 110+1)");
|
"оценка = max(кэш 1, разрывы 1, маркеры 110+1): " + ex.getMessage());
|
||||||
ConversionException ex = assertThrows(ConversionException.class,
|
|
||||||
() -> WordPdfValidator.checkPageCount(pkg, 100));
|
|
||||||
assertTrue(ex.getMessage().contains("100"), ex.getMessage());
|
|
||||||
// lightweight-путь обязан согласовать тот же отказ
|
|
||||||
assertThrows(ConversionException.class,
|
|
||||||
() -> WordPdfValidator.checkPageCountLightweight(bytes, 100));
|
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -311,20 +242,16 @@ class WordPdfValidatorTest {
|
|||||||
doc.write(bos);
|
doc.write(bos);
|
||||||
bytes = bos.toByteArray();
|
bytes = bos.toByteArray();
|
||||||
}
|
}
|
||||||
WordprocessingMLPackage pkg = WordprocessingMLPackage.load(
|
ValidationException ex = assertThrows(ValidationException.class,
|
||||||
new java.io.ByteArrayInputStream(bytes));
|
|
||||||
assertEquals(121, WordPdfValidator.pageCountOf(pkg),
|
|
||||||
"разрывы в ячейке таблицы должны считаться");
|
|
||||||
assertThrows(ConversionException.class,
|
|
||||||
() -> WordPdfValidator.checkPageCount(bytes, 100));
|
() -> WordPdfValidator.checkPageCount(bytes, 100));
|
||||||
assertThrows(ConversionException.class,
|
assertTrue(ex.getMessage().contains("не менее 121"),
|
||||||
() -> WordPdfValidator.checkPageCountLightweight(bytes, 100));
|
"120 разрывов в ячейке таблицы + первая страница: " + ex.getMessage());
|
||||||
}
|
}
|
||||||
|
|
||||||
@Test
|
@Test
|
||||||
void checkPageCountLightweight_bytesNull() {
|
void checkPageCount_bytesNull() {
|
||||||
assertThrows(ConversionException.class,
|
assertThrows(ValidationException.class,
|
||||||
() -> WordPdfValidator.checkPageCountLightweight((byte[]) null));
|
() -> WordPdfValidator.checkPageCount((byte[]) null));
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -354,9 +281,9 @@ class WordPdfValidatorTest {
|
|||||||
|
|
||||||
// 3 разрыва + первая страница = не менее 4; до фикса lightweight
|
// 3 разрыва + первая страница = не менее 4; до фикса lightweight
|
||||||
// не видел разрывы в strict-namespace и возвращал 1
|
// не видел разрывы в strict-namespace и возвращал 1
|
||||||
assertDoesNotThrow(() -> WordPdfValidator.checkPageCountLightweight(docx, 4));
|
assertDoesNotThrow(() -> WordPdfValidator.checkPageCount(docx, 4));
|
||||||
ConversionException ex = assertThrows(ConversionException.class,
|
ValidationException ex = assertThrows(ValidationException.class,
|
||||||
() -> WordPdfValidator.checkPageCountLightweight(docx, 3));
|
() -> WordPdfValidator.checkPageCount(docx, 3));
|
||||||
assertTrue(ex.getMessage().contains("не менее 4"), ex.getMessage());
|
assertTrue(ex.getMessage().contains("не менее 4"), ex.getMessage());
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|||||||
Reference in New Issue
Block a user