From 0e9266450cb1270973dc00db3a803382504d6dd1 Mon Sep 17 00:00:00 2001 From: Pjandro Date: Sun, 22 Nov 2026 21:39:08 +0300 Subject: [PATCH] =?UTF-8?q?build:=20maven-javadoc-plugin=20=D0=B4=D0=BB?= =?UTF-8?q?=D1=8F=20=D0=BF=D1=83=D0=B1=D0=BB=D0=B8=D1=87=D0=BD=D0=BE=D0=B3?= =?UTF-8?q?=D0=BE=20API=20core?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - Корневой pom: версия 3.12.0 + pluginManagement (outputDirectory закреплён на target/site, цель — только javadoc:javadoc, лайфцикл verify не меняется). - wordpdf-core объявляет плагин без executions; wordpdf-app javadoc не генерирует. - Правки javadoc-комментарий по ошибкам doclint: {@code <=} в ChartImageHandler, полные имена {@link ru.pjandro.wordpdf.ConversionException} в DocToDocx. --- pom.xml | 23 +++++++++++++++++++ wordpdf-core/pom.xml | 9 ++++++++ .../internal/chart/ChartImageHandler.java | 4 ++-- .../wordpdf/internal/doc/DocToDocx.java | 8 ++++--- 4 files changed, 39 insertions(+), 5 deletions(-) diff --git a/pom.xml b/pom.xml index b766a6a..1ccb04a 100644 --- a/pom.xml +++ b/pom.xml @@ -39,6 +39,8 @@ 0.8.15 + + 3.12.0 @@ -156,6 +158,27 @@ maven-jar-plugin 3.5.1 + + + org.apache.maven.plugins + maven-javadoc-plugin + ${maven-javadoc-plugin.version} + + UTF-8 + all,-missing + protected + true + wordpdf-core API + wordpdf-core API (javadoc) + + ${project.build.directory}/site + + org.apache.maven.plugins maven-pmd-plugin diff --git a/wordpdf-core/pom.xml b/wordpdf-core/pom.xml index cac6295..3cbb14e 100644 --- a/wordpdf-core/pom.xml +++ b/wordpdf-core/pom.xml @@ -143,6 +143,15 @@ + + + org.apache.maven.plugins + maven-javadoc-plugin + diff --git a/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/chart/ChartImageHandler.java b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/chart/ChartImageHandler.java index bec1661..b8f3406 100644 --- a/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/chart/ChartImageHandler.java +++ b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/chart/ChartImageHandler.java @@ -30,10 +30,10 @@ import java.nio.ByteBuffer; * * Медиа документов (фото/скрины) — не наши части, но и для них штатный путь * дорог: {@code PictureCompression.compress} декодирует полный растр (ImageIO) - * ДО любых решений, а для не-JPEG без кропа с ppi <= threshold (и без размера + * ДО любых решений, а для не-JPEG без кропа с ppi {@code <=} threshold (и без размера * в макете) результат всегда null — декод впустую. Здесь такое решение * принимается по 26 байтам заголовка (PNG/GIF/BMP), растр не декодируется - * вовсе. JPEG сознательно не ускоряем: Word при ppi <= threshold перекодирует + * вовсе. JPEG сознательно не ускоряем: Word при ppi {@code <=} threshold перекодирует * его «для размера», вывод должен остаться побайтно прежним. * * Регрессии — WordPdfConverterTest#chartMedia_notDownsampled, diff --git a/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/doc/DocToDocx.java b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/doc/DocToDocx.java index dbc03fd..df9f675 100644 --- a/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/doc/DocToDocx.java +++ b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/doc/DocToDocx.java @@ -67,7 +67,7 @@ import java.util.regex.Pattern; * *

Контракт ошибок: любой некорректный вход (не CFB, не Word, шифрование, * Word 6/95, обрезка, цикл в цепочках, страницы сверх лимита) — - * {@link ConversionException}.

+ * {@link ru.pjandro.wordpdf.ConversionException}.

*/ public final class DocToDocx { @@ -122,7 +122,8 @@ public final class DocToDocx { * @param docBytes контейнер Word 97–2003 * @param maxMb лимит размера входа (МБ) — из него порог пиксельной * площади растра ({@code WordPdfValidator.maxImagePixels}) - * @throws ConversionException на некорректном/зашифрованном/чужом входе + * @throws ru.pjandro.wordpdf.ConversionException + * на некорректном/зашифрованном/чужом входе */ public static byte[] convert(byte[] docBytes, long maxMb) { long maxPixels = WordPdfValidator.maxImagePixels(maxMb); @@ -226,7 +227,8 @@ public final class DocToDocx { * Нижняя оценка числа страниц бинарного .doc (кэш PageCount + явные * разрывы) — для {@code WordPdfValidator.checkPageCountDoc}. * - * @throws ConversionException на некорректном/зашифрованном/чужом входе + * @throws ru.pjandro.wordpdf.ConversionException + * на некорректном/зашифрованном/чужом входе */ public static int countPages(byte[] docBytes) { return DocFile.open(docBytes).countPages();