fix: результаты ревью — chart-DoS-потолки, нормализаторы, 405/415, инфраструктура #54

Merged
pjandro merged 9 commits from fix/review-findings into main 2026-10-26 03:22:39 +03:00
32 changed files with 807 additions and 104 deletions
+4
View File
@@ -10,3 +10,7 @@ dependency-reduced-pom.xml
wordpdf-web/node_modules
wordpdf-web/dist
.env
.venv/
/.mise/
__pycache__/
.pytest_cache/
+27 -5
View File
@@ -210,6 +210,7 @@ jobs:
REGISTRY_USER: ${{ secrets.REGISTRY_USER }}
REGISTRY_PASSWORD: ${{ secrets.REGISTRY_PASSWORD }}
WORDPDF_API_KEY: ${{ secrets.WORDPDF_API_KEY }}
DEPLOY_KNOWN_HOSTS: ${{ secrets.DEPLOY_KNOWN_HOSTS }}
steps:
- name: Check deploy vars and secrets
run: |
@@ -217,7 +218,7 @@ jobs:
for v in DEPLOY_HOST DEPLOY_USER DEPLOY_DIR REGISTRY WORDPDF_MAX_MB WORDPDF_MAX_PAGES; do
[ -n "${!v}" ] || { echo "Задайте Actions Variable $v — см. GITEA-vars.md" >&2; missing=1; }
done
for s in DEPLOY_SSH_KEY REGISTRY_USER REGISTRY_PASSWORD WORDPDF_API_KEY; do
for s in DEPLOY_SSH_KEY REGISTRY_USER REGISTRY_PASSWORD WORDPDF_API_KEY DEPLOY_KNOWN_HOSTS; do
[ -n "${!s}" ] || { echo "Задайте Actions Secret $s — см. GITEA-vars.md" >&2; missing=1; }
done
exit "$missing"
@@ -230,6 +231,9 @@ jobs:
# Ключ API в файл не пишется: compose интерполирует его из окружения деплоя.
- name: Render prod stack files
run: &render-stack-files |
set -euo pipefail
# (якорь общий с rollback; команды шага — heredoc'и в кавычках и
# ||-цепочка pip — pipefail-safe)
cat > docker-compose.yml <<COMPOSE
name: wordpdf-prod
# Рендерится CI на каждый деплой (Gitea Actions, job deploy в main.yml) —
@@ -244,6 +248,9 @@ jobs:
# не крушит стек бесконечным crash-loop. Синтаксис on-failure:N podman
# переваривает и применяет (проверено: maxtries=N, после исчерпания exited).
restart: on-failure:5
# heap вписан в лимит (-XX:MaxRAMPercentage=70 в ENTRYPOINT образа);
# паритет с repo compose.yml
mem_limit: 2g
# healthcheck дублируется в compose, а не только в Containerfile: podman
# выгружает образы в OCI, где HEALTHCHECK теряется, а gateway в depends_on
# ждал бы healthy вечно. wget, не curl: alpine-jre образ curl не содержит.
@@ -339,7 +346,11 @@ jobs:
mkdir -p "$HOME/.ssh" && chmod 700 "$HOME/.ssh"
printf '%s\n' "$DEPLOY_SSH_KEY" > "$HOME/.ssh/id_deploy"
chmod 600 "$HOME/.ssh/id_deploy"
set -- -i "$HOME/.ssh/id_deploy" -o StrictHostKeyChecking=accept-new
# host-key pinning: пустой секрет → пустой known_hosts → ssh падает на
# StrictHostKeyChecking=yes ДО передачи секретов (fail-closed)
printf '%s\n' "$DEPLOY_KNOWN_HOSTS" > "$HOME/.ssh/known_hosts"
chmod 600 "$HOME/.ssh/known_hosts"
set -- -i "$HOME/.ssh/id_deploy" -o UserKnownHostsFile="$HOME/.ssh/known_hosts" -o StrictHostKeyChecking=yes
D=$(printf '%q' "$DEPLOY_DIR")
H="$DEPLOY_USER@$DEPLOY_HOST"
ssh "$@" "$H" "umask 077; mkdir -p $D && cat > $D/docker-compose.yml" < docker-compose.yml
@@ -435,6 +446,9 @@ jobs:
WORDPDF_MAX_PAGES: ${{ vars.WORDPDF_MAX_PAGES }}
DEPLOY_SSH_KEY: ${{ secrets.DEPLOY_SSH_KEY }}
WORDPDF_API_KEY: ${{ secrets.WORDPDF_API_KEY }}
DEPLOY_KNOWN_HOSTS: ${{ secrets.DEPLOY_KNOWN_HOSTS }}
REGISTRY_USER: ${{ secrets.REGISTRY_USER }}
REGISTRY_PASSWORD: ${{ secrets.REGISTRY_PASSWORD }}
steps:
# Конфиг рендерится заново (тот же шаг, что у deploy) и перезаливается: откат
# не зависит от того, что осталось на хосте после упавшего деплоя (рег. run 482:
@@ -449,13 +463,16 @@ jobs:
mkdir -p "$HOME/.ssh" && chmod 700 "$HOME/.ssh"
printf '%s\n' "$DEPLOY_SSH_KEY" > "$HOME/.ssh/id_deploy"
chmod 600 "$HOME/.ssh/id_deploy"
set -- -i "$HOME/.ssh/id_deploy" -o StrictHostKeyChecking=accept-new
# host-key pinning, как в deploy (fail-closed на пустом секрете)
printf '%s\n' "$DEPLOY_KNOWN_HOSTS" > "$HOME/.ssh/known_hosts"
chmod 600 "$HOME/.ssh/known_hosts"
set -- -i "$HOME/.ssh/id_deploy" -o UserKnownHostsFile="$HOME/.ssh/known_hosts" -o StrictHostKeyChecking=yes
D=$(printf '%q' "$DEPLOY_DIR")
H="$DEPLOY_USER@$DEPLOY_HOST"
ssh "$@" "$H" "umask 077; mkdir -p $D && cat > $D/docker-compose.yml" < docker-compose.yml
{
printf 'export DEPLOY_DIR=%q REGISTRY=%q WORDPDF_API_KEY=%q\n' \
"$DEPLOY_DIR" "$REGISTRY" "$WORDPDF_API_KEY"
printf 'export DEPLOY_DIR=%q REGISTRY=%q REGISTRY_USER=%q REGISTRY_PASSWORD=%q WORDPDF_API_KEY=%q\n' \
"$DEPLOY_DIR" "$REGISTRY" "$REGISTRY_USER" "$REGISTRY_PASSWORD" "$WORDPDF_API_KEY"
cat <<'REMOTE'
set -euo pipefail
cd "$DEPLOY_DIR"
@@ -466,6 +483,11 @@ jobs:
. ./.rollback.env
podman tag "$PREV_APP" "$REGISTRY/wordpdf-app:prod"
podman tag "$PREV_WEB" "$REGISTRY/wordpdf-web:prod"
# реестр :prod обязан соответствовать откаченному ранящемуся образу:
# иначе ручной pull/пересборка стека вернёт битый билд
printf '%s' "$REGISTRY_PASSWORD" | podman login "$REGISTRY" --username "$REGISTRY_USER" --password-stdin
podman push "$REGISTRY/wordpdf-app:prod"
podman push "$REGISTRY/wordpdf-web:prod"
timeout 90 podman-compose up -d --force-recreate app web
for _ in $(seq 1 30); do
[ "$(podman inspect -f '{{.State.Health.Status}}' wordpdf-prod-app-1)" = healthy ] && break
View File
+9 -9
View File
File diff suppressed because one or more lines are too long
+1 -1
View File
@@ -25,5 +25,5 @@ USER app
EXPOSE 8080
HEALTHCHECK --interval=10s --timeout=3s --start-period=10s --retries=5 \
CMD HTTP_PROXY= http_proxy= HTTPS_PROXY= https_proxy= wget -qO /dev/null http://127.0.0.1:8080/actuator/health || exit 1
ENTRYPOINT ["java", "-Djava.awt.headless=true", "-jar", "/app/app.jar"]
ENTRYPOINT ["java", "-Djava.awt.headless=true", "-XX:MaxRAMPercentage=70", "-jar", "/app/app.jar"]
+1
View File
@@ -17,6 +17,7 @@ job'ах `deploy`/`autotests` с внятным сообщением, чего
|`WORDPDF_API_KEY`|Прод-ключ API wordpdf|Единственный источник — этот Secret (прод `.env` выведен из эксплуатации, job `deploy` удаляет его как наследие); значение уже в Gitea|
|`REGISTRY_USER`|Логин docker-реестра для CI-пуша (`ci-deploy`)|Nexus: Security → Users (роль `ci-deploy-role`, права на docker-hosted репозиторий)|
|`REGISTRY_PASSWORD`|Пароль этого пользователя|Nexus: Security → Users → `ci-deploy` (Reset password)|
|`DEPLOY_KNOWN_HOSTS`|Строка known_hosts прод-хоста (host-key pinning: job `deploy` пишет её в `~/.ssh/known_hosts` и ставит `StrictHostKeyChecking=yes`)|`ssh-keyscan -t ed25519 <IP из DEPLOY_HOST>` с любой машины, знающей хост. Завести ДО мержа: без секрета деплой падает fail-closed (ssh отваливается до передачи ключей) и штатно отрабатывает `rollback`|
## Переменные (Settings → Actions → Variables)
+2
View File
@@ -12,6 +12,8 @@ services:
app:
build: .
restart: unless-stopped
# Паритет с compose.yml: heap вписан в лимит (-XX:MaxRAMPercentage=70).
mem_limit: 2g
# Дублирует HEALTHCHECK из Containerfile: podman выгружает образы в OCI,
# где поля healthcheck нет — без явного healthcheck depends_on
# service_healthy ждал бы healthy вечно. Прокси обнуляем на команде.
+3
View File
@@ -7,6 +7,9 @@ services:
app:
build: .
restart: unless-stopped
# Heap вписываем в лимит контейнера (-XX:MaxRAMPercentage=70 в ENTRYPOINT);
# вход 16×5 МБ очередь + FOP-рендер в 2 ГБ помещаются.
mem_limit: 2g
# Дублирует HEALTHCHECK из Containerfile: podman выгружает образы в OCI,
# где поля healthcheck нет — без явного healthcheck depends_on
# service_healthy ждал бы healthy вечно. Прокси обнуляем на команде.
+8 -1
View File
@@ -16,7 +16,14 @@ server {
set $upstream_app http://app:8080;
set $upstream_web http://web:80;
location /api/ { proxy_pass $upstream_app; }
location /api/ {
# в proxy_pass нет path-части, поэтому URI передаётся как есть
proxy_pass $upstream_app;
# wordpdf.convert-timeout=2m; дефолтный proxy_read_timeout 60s рвёт
# длинные конвертации (паритет с прод-рендером в main.yml)
proxy_read_timeout 300s;
proxy_send_timeout 300s;
}
location /swagger-ui { proxy_pass $upstream_app; }
location /v3/api-docs { proxy_pass $upstream_app; }
# открыт фильтром приложения (wordpdf.api-key его не проверяет) — мониторинг/HEALTHCHECK снаружи
@@ -5,6 +5,8 @@ import org.slf4j.LoggerFactory;
import org.springframework.beans.factory.annotation.Value;
import org.springframework.http.HttpStatus;
import org.springframework.http.ResponseEntity;
import org.springframework.web.HttpMediaTypeNotSupportedException;
import org.springframework.web.HttpRequestMethodNotSupportedException;
import org.springframework.web.bind.MissingServletRequestParameterException;
import org.springframework.web.bind.annotation.ExceptionHandler;
import org.springframework.web.bind.annotation.RestControllerAdvice;
@@ -20,8 +22,9 @@ import ru.pjandro.wordpdf.ValidationException;
* <p>{@link ValidationException} ядра доходит сюда напрямую — валидатор
* бросает его сам; в {@link ConversionFailedException} превращается только
* прочий {@code ru.pjandro.wordpdf.ConversionException} рендер-стадии.
* Случайная утечка прочего исключения попадёт в обработчик {@link Exception}
* (500).</p>
* Метод/тип содержимого не по контракту — 405/415 (иначе утонули бы в
* catch-all 500). Случайная утечка прочего исключения попадёт в обработчик
* {@link Exception} (500).</p>
*/
@RestControllerAdvice
final class ApiExceptionHandler {
@@ -113,6 +116,20 @@ final class ApiExceptionHandler {
.body(new ApiError("Некорректное значение параметра «" + e.getName() + "»"));
}
/** Метод не поддерживается (единственный эндпоинт — POST /api/v1/convert). */
@ExceptionHandler(HttpRequestMethodNotSupportedException.class)
ResponseEntity<ApiError> methodNotSupported(HttpRequestMethodNotSupportedException e) {
return ResponseEntity.status(HttpStatus.METHOD_NOT_ALLOWED)
.body(new ApiError("Метод не поддерживается"));
}
/** Не multipart-тело запроса (application/json и т.п.). */
@ExceptionHandler(HttpMediaTypeNotSupportedException.class)
ResponseEntity<ApiError> badContentType(HttpMediaTypeNotSupportedException e) {
return ResponseEntity.status(HttpStatus.UNSUPPORTED_MEDIA_TYPE)
.body(new ApiError("Неподдерживаемый тип содержимого"));
}
/** Прочее — внутренняя ошибка; подробность только в лог, не в ответ. */
@ExceptionHandler(Exception.class)
ResponseEntity<ApiError> unexpected(Exception e) {
@@ -25,7 +25,7 @@ import java.util.Locale;
*
* <p>Здесь только HTTP-слой: проверка presence/расширения и формирование
* {@code Content-Disposition}; проверка содержимого (zip, размер, страницы) —
* зона {@link ConversionService#validate}. Ошибки в JSON-ответ переводит
* зона {@link ConversionService}. Ошибки в JSON-ответ переводит
* {@link ApiExceptionHandler}. Лимиты входа — только конфигурация сервера
* (свойства {@code wordpdf.max-mb}/{@code wordpdf.max-pages}, env
* {@code WORDPDF_MAX_MB}/{@code WORDPDF_MAX_PAGES}); параметрами запроса
@@ -7,10 +7,13 @@ spring.application.name=wordpdf-app
# дефолты — константы ядра (5 / 100), задаются ConvertController.
# Значение <= 0 — падение на старте. Сами ключи здесь не объявлены:
# пустое значение затенит SpEL-дефолт @Value.
# file-size-threshold=100MB держит файл в памяти (ядро и так читает всё в RAM).
# file-size-threshold=2MB: части больше 2 МБ сбрасываются на диск Tomcat, heap
# держит только копию getBytes() одной сериализованной конвертации (порог 100MB
# буферизовал в heap каждую параллельную загрузку до валидации размера — OOM-килл
# контейнера).
spring.servlet.multipart.max-file-size=100MB
spring.servlet.multipart.max-request-size=100MB
spring.servlet.multipart.file-size-threshold=100MB
spring.servlet.multipart.file-size-threshold=2MB
# Таймаут одной конвертации (binding Duration в ConversionService)
wordpdf.convert-timeout=2m
@@ -33,6 +33,7 @@ import static org.junit.jupiter.api.Assertions.assertThrows;
import static org.junit.jupiter.api.Assertions.assertNotNull;
import static org.junit.jupiter.api.Assertions.assertTrue;
import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.get;
import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.post;
import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.multipart;
import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.content;
import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.header;
@@ -417,6 +418,32 @@ class ConvertControllerTest {
org.hamcrest.Matchers.containsString("Не найдено")));
}
/**
* GET на единственный POST-эндпоинт — 405 с JSON-текстом от
* {@code ApiExceptionHandler}, а не 500 от catch-all.
* Регрессия — ConvertControllerTest#methodNotSupportedReturns405.
*/
@Test
void methodNotSupportedReturns405() throws Exception {
mockMvc.perform(get("/api/v1/convert"))
.andExpect(status().isMethodNotAllowed())
.andExpect(jsonPath("$.error").value("Метод не поддерживается"));
}
/**
* POST с не-multipart телом (application/json) — 415 с JSON-текстом,
* не 500 от catch-all.
* Регрессия — ConvertControllerTest#badContentTypeReturns415.
*/
@Test
void badContentTypeReturns415() throws Exception {
mockMvc.perform(post("/api/v1/convert")
.contentType(MediaType.APPLICATION_JSON)
.content("{}"))
.andExpect(status().isUnsupportedMediaType())
.andExpect(jsonPath("$.error").value("Неподдерживаемый тип содержимого"));
}
/**
* Отказ чтения партиты контейнером ({@code IOException} из
* {@code getBytes}) — {@link ValidationException} (400-смысл: вход не
@@ -324,7 +324,11 @@ public final class WordPdfValidator {
}
}
return 0;
} catch (XMLStreamException | NumberFormatException e) {
} catch (XMLStreamException | NumberFormatException | IllegalStateException e) {
// getElementText() на <Pages> с дочерним элементом бросает
// IllegalStateException (не XMLStreamException) — кэш просто
// нечитаем, нижняя оценка считается по разрывам.
// Регрессия — WordPdfValidatorTest#cachedPagesUnreadableFallsBackToZero.
return 0;
} finally {
in.close();
@@ -26,8 +26,15 @@ import java.util.regex.Pattern;
*/
public final class DocxOnOffNormalizer {
/**
* {@code w:val="on"/"off"} только внутри открывающего тега: group 1 — от
* {@code <} до {@code w:val=} в пределах одного тега ({@code [^<>]} не
* пересекает границу тега), литеральный {@code w:val="on"} в тексте
* {@code w:t} не правится. Регрессия — DocxOnOffNormalizerTest#onOffInTextNotTouched.
*/
private static final Pattern ON_OFF = Pattern.compile(
"w:val=([\"'])(on|off)\\1", Pattern.CASE_INSENSITIVE);
"(<[A-Za-z][A-Za-z0-9:]*(?:\\s[^<>]*)?)w:val=([\"'])(on|off)\\2",
Pattern.CASE_INSENSITIVE);
private DocxOnOffNormalizer() {
}
@@ -82,9 +89,9 @@ public final class DocxOnOffNormalizer {
m.reset();
StringBuilder sb = new StringBuilder(xml.length());
while (m.find()) {
String value = "on".equalsIgnoreCase(m.group(2)) ? "true" : "false";
String value = "on".equalsIgnoreCase(m.group(3)) ? "true" : "false";
m.appendReplacement(sb, Matcher.quoteReplacement(
"w:val=" + m.group(1) + value + m.group(1)));
m.group(1) + "w:val=" + m.group(2) + value + m.group(2)));
}
m.appendTail(sb);
return sb.toString();
@@ -30,8 +30,10 @@ import java.util.zip.ZipOutputStream;
* (в transitional они называются {@code w:left}/{@code w:right}) —
* JAXB сообщает «unexpected element» и границы теряются;</li>
* <li>атрибуты {@code w:start}/{@code w:end} у {@code w:ind} и значения
* {@code start}/{@code end} у {@code w:jc}/{@code w:tab} — в
* transitional таких имён/значений нет, JAXB их отбрасывает.</li>
* {@code start}/{@code end} у {@code w:jc}/{@code w:tab} — в strict-модели
* это единственные имена, а transitional-модель docx4j их не принимает
* (значения {@code w:tab} — и подавно: enum {@code STTabJc} в docx4j
* 17.3.2 содержит только left/right).</li>
* </ul>
*
* <p>Полный strict→transitional рерайт не делается: mc-preprocessor уже
@@ -45,9 +47,27 @@ import java.util.zip.ZipOutputStream;
* пропускается: там {@code w:lvl/w:start} — легитимный transitional-элемент
* (стартовое значение счётчика), регрессия — StrictOoxmlNormalizerTest.
*
* <p>Transitional-документы (Word пишет {@code a:}-проценты целыми, {@code
* w:start} вне numbering.xml и {@code w:jc val="start"} не бывает) проходят
* без изменений: если правок не было, возвращается исходный массив.
* <p>Правила применяются с учётом направления документа (часть strict, только
* если содержит URI {@code http://purl.oclc.org}):
* <ul>
* <li>атрибуты {@code w:start}/{@code w:end} переименовываются только внутри
* открывающего тега и только когда в том же теге нет {@code w:left}/
* {@code w:right}: transitional {@code CT_Ind} допускает сосуществование
* (Word пишет обе пары), слепая глобальная замена порождала дубль
* атрибута — не well-formed XML (регрессия —
* StrictOoxmlNormalizerTest#indCoexistLeftStartUntouched,
* WordPdfConverterTest#indCoexistForms_convertsNotRejected);</li>
* <li>элементы {@code w:start}/{@code w:end} переименовываются глобально
* только в strict-частях; в transitional — лишь внутри {@code w:tcMar}/
* {@code w:tblCellMar} и лишь при отсутствии одноимённого {@code w:left}/
* {@code w:right}-ребёнка (transitional-схема допускает обе пары детей,
* {@code maxOccurs=1} на left — дубль ломает JAXB);</li>
* <li>значения {@code start}/{@code end} у {@code w:jc} правятся только в
* strict: transitional {@code JcEnumeration} docx4j их содержит, экспортёр
* пишет {@code fo:text-align} как есть, а FOP разрешает start/end по
* направлению абзаца (FO 1.1) — замена на left ломала RTL; значения
* {@code w:tab} правятся всегда (enum без start/end).</li>
* </ul>
*
* Регрессия — WordPdfConverterTest#strictOoxml_convertsNotRejected.
*/
@@ -71,9 +91,27 @@ public final class StrictOoxmlNormalizer {
private static final Pattern START_ELEMENT = Pattern.compile("<w:start(?=[\\s/>])");
private static final Pattern END_ELEMENT = Pattern.compile("<w:end(?=[\\s/>])");
/** Значения {@code start}/{@code end} у {@code w:jc}/{@code w:tab}. */
private static final Pattern JC_TAB_VALUE = Pattern.compile(
"(<w:(?:jc|tab)\\b[^>]*?w:val=\")(start|end)\"");
/** URI strict-пакета (ECMA-376 1-е изд.); его наличие в части — признак strict. */
private static final String STRICT_NS = "http://purl.oclc.org";
/** Открывающий тег любого элемента — носитель атрибутов для точечного рерайта. */
private static final Pattern OPEN_TAG = Pattern.compile("<[A-Za-z][A-Za-z0-9:]*\\b[^>]*>");
/**
* Блок {@code w:tcMar}/{@code w:tblCellMar}: единственное место transitional,
* где элементы {@code w:start}/{@code w:end} легальны (CT_TcMar допускает их
* наравне с {@code w:left}/{@code w:right}).
*/
private static final Pattern MAR_BLOCK = Pattern.compile(
"<(w:tcMar|w:tblCellMar)\\b[^>]*>.*?</\\1>", Pattern.DOTALL);
/** Значения {@code start}/{@code end} у {@code w:jc} (правятся только в strict). */
private static final Pattern JC_VALUE = Pattern.compile(
"(<w:jc\\b[^>]*?w:val=\")(start|end)\"");
/** Значения {@code start}/{@code end} у {@code w:tab} (правятся всегда). */
private static final Pattern TAB_VALUE = Pattern.compile(
"(<w:tab\\b[^>]*?w:val=\")(start|end)\"");
private StrictOoxmlNormalizer() {
}
@@ -99,9 +137,11 @@ public final class StrictOoxmlNormalizer {
String name = entry.getName();
if (name.startsWith("word/") && name.endsWith(".xml")) {
// в numbering.xml w:start — элемент стартового значения
// счётчика, его не переименовываем
String fixed = rewrite(new String(data, StandardCharsets.UTF_8),
!"word/numbering.xml".equals(name));
// счётчика, его не переименовываем; направление части — по
// наличию strict-URI (transitional-правила мягче)
String xml = new String(data, StandardCharsets.UTF_8);
String fixed = rewrite(xml, !"word/numbering.xml".equals(name),
xml.contains(STRICT_NS));
if (fixed != null) {
changed = true;
data = fixed.getBytes(StandardCharsets.UTF_8);
@@ -116,43 +156,122 @@ public final class StrictOoxmlNormalizer {
}
/**
* Применяет к XML-строке все правила, включая переименование элементов
* {@code w:start}/{@code w:end}.
* Применяет к XML-строке все правила в strict-режиме, включая переименование
* элементов {@code w:start}/{@code w:end} (хук юнит-тестов).
*
* @return новая строка либо null, если правок не было
*/
static String rewrite(String xml) {
return rewrite(xml, true);
return rewrite(xml, true, true);
}
/**
* Правила нормализации strict-OOXML.
* Правила нормализации (javadoc класса).
*
* @param renameStartEnd переименовывать ли элементы {@code w:start}/
* {@code w:end} (false для word/numbering.xml)
* @param strict strict-часть (URI {@code http://purl.oclc.org}):
* глобальный рерайт элементов и значений {@code w:jc};
* в transitional — только guard-правила
* @return новая строка либо null, если правок не было
*/
private static String rewrite(String xml, boolean renameStartEnd) {
static String rewrite(String xml, boolean renameStartEnd, boolean strict) {
String r = xml;
if (r.indexOf('%') >= 0) {
r = percentTags(r, A_TAG);
r = percentTags(r, FILL_TO_RECT_TAG);
r = percentText(r);
}
if (renameStartEnd
&& (r.contains("<w:start") || r.contains("</w:start>")
|| r.contains("<w:end") || r.contains("</w:end>"))) {
r = renameStartEndElements(r);
if (strict) {
if (renameStartEnd
&& (r.contains("<w:start") || r.contains("</w:start>")
|| r.contains("<w:end") || r.contains("</w:end>"))) {
r = renameStartEndElements(r);
}
} else {
r = renameMarBlockElements(r);
}
if (r.contains(" w:start=\"") || r.contains(" w:end=\"")) {
r = r.replace(" w:start=\"", " w:left=\"").replace(" w:end=\"", " w:right=\"");
r = renameStartEndAttrs(r);
}
if (r.contains("w:val=\"start\"") || r.contains("w:val=\"end\"")) {
r = jcTabValues(r);
if (strict) {
r = renameValues(r, JC_VALUE);
}
r = renameValues(r, TAB_VALUE);
}
return r.equals(xml) ? null : r;
}
/**
* Атрибуты {@code w:start→w:left}/{@code w:end→w:right} только внутри
* открывающего тега и только при отсутствии в нём {@code w:left}/{@code
* w:right}: CT_Ind (transitional) допускает обе пары, дубль атрибута —
* не well-formed XML; литеральный текст {@code w:val}-вида в {@code w:t}
* не затрагивается.
*/
private static String renameStartEndAttrs(String xml) {
Matcher tags = OPEN_TAG.matcher(xml);
StringBuilder sb = null;
while (tags.find()) {
String tag = tags.group();
String fixed = tag;
if (fixed.contains(" w:start=\"") && !fixed.contains(" w:left=\"")) {
fixed = fixed.replace(" w:start=\"", " w:left=\"");
}
if (fixed.contains(" w:end=\"") && !fixed.contains(" w:right=\"")) {
fixed = fixed.replace(" w:end=\"", " w:right=\"");
}
if (!fixed.equals(tag)) {
if (sb == null) {
sb = new StringBuilder(xml.length());
}
tags.appendReplacement(sb, Matcher.quoteReplacement(fixed));
}
}
if (sb == null) {
return xml;
}
tags.appendTail(sb);
return sb.toString();
}
/**
* Transitional-частичный рерайт элементов: только внутри {@code w:tcMar}/
* {@code w:tblCellMar} и только когда одноимённого {@code w:left}/{@code
* w:right}-ребёнка в блоке нет (иначе дубль с maxOccurs=1 ломает JAXB).
*/
private static String renameMarBlockElements(String xml) {
if (!xml.contains("<w:start") && !xml.contains("<w:end")) {
return xml;
}
Matcher blocks = MAR_BLOCK.matcher(xml);
StringBuilder sb = null;
while (blocks.find()) {
String block = blocks.group();
String fixed = block;
if (fixed.contains("<w:start") && !fixed.contains("<w:left")) {
fixed = START_ELEMENT.matcher(fixed).replaceAll("<w:left");
fixed = fixed.replace("</w:start>", "</w:left>");
}
if (fixed.contains("<w:end") && !fixed.contains("<w:right")) {
fixed = END_ELEMENT.matcher(fixed).replaceAll("<w:right");
fixed = fixed.replace("</w:end>", "</w:right>");
}
if (!fixed.equals(block)) {
if (sb == null) {
sb = new StringBuilder(xml.length());
}
blocks.appendReplacement(sb, Matcher.quoteReplacement(fixed));
}
}
if (sb == null) {
return xml;
}
blocks.appendTail(sb);
return sb.toString();
}
/**
* Переименование элементов {@code w:start}/{@code w:end} в
* {@code w:left}/{@code w:right} только с границей имени:
@@ -219,9 +338,9 @@ public final class StrictOoxmlNormalizer {
return sb.toString();
}
/** Значения {@code start}/{@code end} у {@code w:jc}/{@code w:tab} → {@code left}/{@code right}. */
private static String jcTabValues(String xml) {
Matcher m = JC_TAB_VALUE.matcher(xml);
/** Значения {@code start}/{@code end} по паттерну тега → {@code left}/{@code right}. */
private static String renameValues(String xml, Pattern tagValue) {
Matcher m = tagValue.matcher(xml);
if (!m.find()) {
return xml;
}
@@ -14,6 +14,8 @@ import java.awt.geom.RoundRectangle2D;
import java.awt.image.BufferedImage;
import java.util.ArrayList;
import java.util.List;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
/**
* Рендер графика DrawingML в растр. Кадрирование (рамка chartSpace),
@@ -26,6 +28,8 @@ import java.util.List;
*/
final class ChartRenderer {
private static final Logger LOG = LoggerFactory.getLogger(ChartRenderer.class);
/** Разрешение растра: 300 dpi, чтобы подписи не мылились при печати. */
static final int DPI = 300;
@@ -113,7 +117,7 @@ final class ChartRenderer {
Surface2dPainter.paint(g, spec, box, palette);
case AREA3D, LINE3D, BAR3D ->
Cartesian3dPainter.paint(g, spec, box, palette);
default -> { /* UNSUPPORTED: вызывающий не должен сюда доходить */ }
default -> LOG.warn("тип графика {} не поддерживается — пустой PNG", spec.type);
}
if (legend != null && spec.legendOverlay) {
double y = "t".equals(spec.legendPos)
@@ -405,6 +409,14 @@ final class ChartRenderer {
}
/**
* Границы оси + шаг. Враждебные {@code c:min}/{@code c:max} (размах до 1e300,
* не-конечные границы, переполнение stacked-сумм в Infinity) не должны давать
* вечные циклы делений: шаг пересчитывается по ФАКТИЧЕСКОМУ интервалу, так что
* {@code (hi - lo) / unit <= MAX_TICKS + 1} при любых входах — все циклы
* {@code for (v = lo; v <= hi + unit/2; v += unit)} у художников завершаются.
* Регрессия — ChartRendererTest#axisBounds_explicitHugeRange_reunitsToMaxTicks,
* WordPdfConverterTest#hostileChartAxis_convertsNotHangs.
*
* @param padMax для декартовых осей Word поднимает верхнюю границу за
* максимум данных: «первое деление выше Ymax + (Ymax − Ymin)/20»
* (KB101939). Без этого линия упёрта в верхнюю границу области
@@ -414,6 +426,12 @@ final class ChartRenderer {
*/
static double[] axisBounds(ChartSpec.AxisSpec axis, double dataMin, double dataMax,
boolean padMax) {
if (!Double.isFinite(dataMin)) {
dataMin = 0;
}
if (!Double.isFinite(dataMax)) {
dataMax = 0;
}
double unit = axis != null && axis.majorUnit != null
&& usableMajorUnit(axis.majorUnit, dataMax - dataMin)
? axis.majorUnit
@@ -433,6 +451,21 @@ final class ChartRenderer {
if (hi <= lo) {
hi = lo + unit;
}
double span = hi - lo;
if (!Double.isFinite(span)) {
// Явные min/max дали не-конечный размах — откат к границам данных.
lo = Math.min(0, dataMin);
hi = Math.max(0, dataMax);
if (!(hi > lo)) {
lo = 0;
hi = 1;
}
unit = niceUnit((hi - lo) / 5.0);
} else if (span / unit > MAX_TICKS) {
// Явные min/max конечны, но интервал гигантский при мелком шаге —
// укрупняем шаг до приемлемого числа делений.
unit = niceUnit(span / MAX_TICKS);
}
return new double[]{lo, hi, unit};
}
@@ -807,7 +807,7 @@ final class ChartSpec {
spPr = c.getSpPr();
numFmt = c.getNumFmt() != null ? c.getNumFmt().getFormatCode() : "General";
if (c.getMajorUnit() != null) {
a.majorUnit = c.getMajorUnit().getVal();
a.majorUnit = finite(c.getMajorUnit().getVal());
}
} else if (ax instanceof CTSerAx c) {
scaling = c.getScaling();
@@ -833,10 +833,10 @@ final class ChartSpec {
a.numFmt = numFmt;
if (scaling != null) {
if (scaling.getMin() != null) {
a.min = scaling.getMin().getVal();
a.min = finite(scaling.getMin().getVal());
}
if (scaling.getMax() != null) {
a.max = scaling.getMax().getVal();
a.max = finite(scaling.getMax().getVal());
}
if (scaling.getOrientation() != null && scaling.getOrientation().getVal() != null) {
a.reversed = scaling.getOrientation().getVal() == STOrientation.MAX_MIN;
@@ -868,6 +868,16 @@ final class ChartSpec {
return a;
}
/**
* Не-конечные {@code c:min}/{@code c:max}/{@code c:majorUnit} (NaN/Infinity —
* ST_Double допускает их литерально) отбрасываются до предвыделения циклов
* делений: враждебный chart-XML не должен доходить до осевых циклов
* художников. Регрессия — ChartSpecTest#nonFiniteScalingBounds_dropped.
*/
private static Double finite(Double v) {
return v != null && Double.isFinite(v) ? v : null;
}
private static String seriesName(CTSerTx tx) {
if (tx == null) {
return null;
@@ -695,8 +695,23 @@ final class DrawMlColor {
return Math.max(0.0, Math.min(1.0, v));
}
/**
* Hex-RGB из {@code a:srgbClr/@val}. Не-конечный вход (null) и битое
* значение (враждебная тема: {@code val="zzzz"}) — null: вызывающие
* (baseOf → put/resolve) пропускают базу и держат office-дефолт, битая
* тема не валит всю конвертацию.
* Регрессия — DrawMlColorTest#invalidSrgbHexFallsBackToOfficeDefault.
*/
static Color decodeHex(String hex) {
long v = Long.parseLong(hex, 16);
return new Color((int) ((v >> 16) & 0xFF), (int) ((v >> 8) & 0xFF), (int) (v & 0xFF));
if (hex == null) {
return null;
}
try {
long v = Long.parseLong(hex, 16);
return new Color((int) ((v >> 16) & 0xFF), (int) ((v >> 8) & 0xFF),
(int) (v & 0xFF));
} catch (NumberFormatException e) {
return null;
}
}
}
@@ -48,6 +48,9 @@ final class DrawMlText {
private static final String ALIGN_CTR = "ctr";
private static final String VALIGN_BOTTOM = "b";
/** Длина строки, дальше которую рез не идёт (прогресс гарантирован 1 символом). */
private static final int SINGLE_CHAR = 1;
private DrawMlText() {
}
@@ -218,38 +221,44 @@ final class DrawMlText {
}
}
/** Жадный перенос по пробелам; длинные слова режутся по символам. */
private static List<String> wrapLines(String text, GlyphFont f, double sizePt,
double maxWidth) {
/**
* Жадный перенос по пробелам; длинные слова режутся по символам.
* Ширина набирается инкрементально ({@link GlyphFont#advance} аддитивен —
* сумма ширин глифов без кернинга), а рез слова ищет границу экспоненциальным
* удвоением с бинарным сужением — O(L log L) на строку вместо кубической
* деградации на гигантских словах. Регрессия — DrawMlTextTest#hugeWord_wrapsLinearly.
*/
static List<String> wrapLines(String text, GlyphFont f, double sizePt, double maxWidth) {
List<String> out = new ArrayList<>();
double limit = Math.max(1, maxWidth);
double spaceW = f.advance(" ", sizePt);
for (String hard : text.split("\\n")) {
if (hard.isEmpty()) {
out.add("");
continue;
}
StringBuilder cur = new StringBuilder();
double curWidth;
double curWidth = 0;
for (String word : hard.split(" ")) {
if (word.isEmpty()) {
continue;
}
String candidate = cur.length() == 0 ? word : cur + " " + word;
double w = f.advance(candidate, sizePt);
if (w <= limit || cur.length() == 0) {
double wordW = f.advance(word, sizePt);
if (cur.length() > 0 && curWidth + spaceW + wordW > limit) {
out.add(cur.toString());
cur.setLength(0);
cur.append(candidate);
continue;
curWidth = 0;
}
if (cur.length() > 0) {
cur.append(' ');
curWidth += spaceW;
}
out.add(cur.toString());
cur.setLength(0);
cur.append(word);
curWidth = f.advance(word, sizePt);
curWidth += wordW;
// Слово шире лимита — режется по символам (в т.ч. первое в
// абзаце: иначе гигантское слово переполняло бокс).
while (curWidth > limit && cur.length() > 1) {
int cut = cur.length() - 1;
while (cut > 1 && f.advance(cur.substring(0, cut), sizePt) > limit) {
cut--;
}
int cut = fitCut(cur, f, sizePt, limit);
out.add(cur.substring(0, cut));
cur.delete(0, cut);
curWidth = f.advance(cur.toString(), sizePt);
@@ -262,6 +271,37 @@ final class DrawMlText {
return out;
}
/**
* Макс. k ∈ [1, s.length()], что advance(s[0,k)) ≤ limit; иначе 1 (прогресс
* гарантирован). Экспоненциальный поиск останавливается на первом переборе,
* поэтому окно поиска ограничено размером вписывающегося префикса, а не
* длиной строки.
*/
private static int fitCut(CharSequence s, GlyphFont f, double sizePt, double limit) {
int n = s.length();
if (n <= SINGLE_CHAR) {
return n;
}
int lo = 1;
int hi = 2;
while (hi < n && f.advance(s.subSequence(0, hi).toString(), sizePt) <= limit) {
lo = hi;
hi = Math.min(n, hi * 2);
}
if (hi == n && f.advance(s.subSequence(0, n).toString(), sizePt) <= limit) {
return n;
}
while (hi - lo > 1) {
int mid = (lo + hi) >>> 1;
if (f.advance(s.subSequence(0, mid).toString(), sizePt) <= limit) {
lo = mid;
} else {
hi = mid;
}
}
return lo;
}
/** Ширина строки в тех же единицах, что и размер шрифта. */
static double textWidth(String text, Style style) {
return fontFor(style).advance(text, style.sizePt());
@@ -74,6 +74,14 @@ public final class DrawingPreRenderer {
private static final String DIAGRAM_DRAWING_REL =
"http://schemas.microsoft.com/office/2007/relationships/diagramDrawing";
/**
* Верхняя граница {@code wp:extent} в EMU: максимальная страница Word —
* 22″ (≈20.1M EMU), берём 24″ с запасом. Больше — враждебный docx: растр при
* 300 dpi дал бы десятки тысяч пикселей в стороне (OOM при BufferedImage и
* ImageIO). Регрессия — WordPdfConverterTest#hugeExtentChart_removedNotOom.
*/
private static final long MAX_EXTENT_EMU = 22_000_000L;
private DrawingPreRenderer() {
}
@@ -182,36 +190,38 @@ public final class DrawingPreRenderer {
if (graphic == null || graphic.getGraphicData() == null) {
continue;
}
if (cx <= 0 || cy <= 0) {
LOG.warn("drawing без wp:extent — оставлен как есть");
GraphicData gd = graphic.getGraphicData();
if (PICTURE_URI.equals(gd.getUri()) || gd.getAny().isEmpty()) {
continue; // уже картинка / пусто
}
// Детект payload и проверка error-флагов — ДО extent-guard'а:
// error-флаг обязан сработать и для drawing без/с враждебным extent.
Object payload = gd.getAny().get(0);
String name = payload instanceof JAXBElement<?> el && el.getName() != null
? el.getName().toString() : "";
boolean isChart = CHART_ELEMENT.equals(name);
boolean isDiagram = DIAGRAM_ELEMENT.equals(name);
if (isChart && options.errorOnCharts()) {
throw new DrawingFoundException(DrawingFoundException.Kind.CHARTS);
}
if (isDiagram && options.errorOnSmartArt()) {
throw new DrawingFoundException(DrawingFoundException.Kind.SMARTART);
}
if (cx <= 0 || cy <= 0 || cx > MAX_EXTENT_EMU || cy > MAX_EXTENT_EMU) {
LOG.warn("drawing вне допустимого wp:extent (cx={}, cy={}) — объект оставлен как есть",
cx, cy);
continue;
}
GraphicData gd = graphic.getGraphicData();
String uri = gd.getUri();
BufferedImage img = null;
String label = null;
if (PICTURE_URI.equals(uri)) {
continue; // уже картинка
}
if (gd.getAny().isEmpty()) {
continue;
}
Object payload = gd.getAny().get(0);
if (payload instanceof JAXBElement<?> el) {
String name = el.getName() == null ? "" : el.getName().toString();
if (CHART_ELEMENT.equals(name)) {
if (options.errorOnCharts()) {
throw new DrawingFoundException(DrawingFoundException.Kind.CHARTS);
}
img = renderChart(part, (CTRelId) el.getValue(), colors, cx, cy);
label = "график";
} else if (DIAGRAM_ELEMENT.equals(name)) {
if (options.errorOnSmartArt()) {
throw new DrawingFoundException(DrawingFoundException.Kind.SMARTART);
}
img = renderDiagram(part, (CTRelIds) el.getValue(), colors, cx, cy);
label = "SmartArt";
}
if (isChart) {
img = renderChart(part, (CTRelId) ((JAXBElement<?>) payload).getValue(),
colors, cx, cy);
label = "график";
} else if (isDiagram) {
img = renderDiagram(part, (CTRelIds) ((JAXBElement<?>) payload).getValue(),
colors, cx, cy);
label = "SmartArt";
}
if (img == null) {
if (label != null) {
@@ -234,7 +244,9 @@ public final class DrawingPreRenderer {
try {
ChartSpec spec = ChartSpec.parse(space, colors);
return ChartRenderer.render(spec, cx / 12700.0, cy / 12700.0, colors);
} catch (RuntimeException e) {
} catch (RuntimeException | OutOfMemoryError e) {
// OOM — второй эшелон после MAX_EXTENT_EMU/MAX_POINTS: враждебный
// chart-XML не должен валить всю конвертацию, деградация = объект удалён.
LOG.warn("рендер графика r:id={} упал: {}", ref.getId(), e.toString());
return null;
}
@@ -255,7 +267,7 @@ public final class DrawingPreRenderer {
}
try {
return SmartArtRenderer.render(drawing, data, colors, cx / 12700.0, cy / 12700.0);
} catch (RuntimeException e) {
} catch (RuntimeException | OutOfMemoryError e) {
LOG.warn("рендер SmartArt упал: {}", e.toString());
return null;
}
@@ -299,6 +311,7 @@ public final class DrawingPreRenderer {
png = bos.toByteArray();
} catch (Exception e) {
LOG.warn("PNG не собран: {}", e.toString());
gd.getAny().clear(); // контракт: упавший рендер — объект удалён
return;
}
BinaryPartAbstractImage imagePart;
@@ -306,11 +319,13 @@ public final class DrawingPreRenderer {
imagePart = BinaryPartAbstractImage.createImagePart(pkg, part, png);
} catch (Exception e) {
LOG.warn("ImagePart не создан: {}", e.toString());
gd.getAny().clear();
return;
}
String relId = relIdFor(part, imagePart);
if (relId == null) {
LOG.warn("r:id для ImagePart {} не найден", imagePart.getPartName());
gd.getAny().clear();
return;
}
@@ -619,6 +619,21 @@ class WordPdfConverterTest {
assertTrue(text.contains("таблица"), "текст PDF: " + text);
}
/**
* Transitional-документ с обеими формами отступа (Word пишет
* {@code w:ind w:left w:start} одновременно): до guard'а глобальная замена
* {@code w:start→w:left} порождала дубль атрибута — не well-formed XML,
* конвертация падала (500). Регрессия — StrictOoxmlNormalizer.
*/
@Test
void indCoexistForms_convertsNotRejected() throws Exception {
byte[] docx = minimalDocx(
"<w:p><w:pPr><w:ind w:left=\"720\" w:start=\"720\"/></w:pPr>"
+ "<w:r><w:t>СОСУЩЕСТВОВАНИЕ</w:t></w:r></w:p>");
Path pdf = convertPdf(docx, "coexist");
assertTrue(norm(pdfText(pdf)).contains("СОСУЩЕСТВОВАНИЕ"), "текст пропал");
}
/**
* Абзац только из невидимых символов (U+0085/U+2028/U+2029/U+2060/U+FEFF)
* не раздувает PDF: FOP превращает первые три в принудительные переносы
@@ -743,4 +758,132 @@ class WordPdfConverterTest {
zos.write(xml.getBytes(StandardCharsets.UTF_8));
zos.closeEntry();
}
/** Штатный c:valAx для in-memory chart-фикстур (без явных min/max). */
private static final String PLAIN_VALAX =
"<c:axId val=\"11\"/><c:scaling><c:orientation val=\"minMax\"/></c:scaling>"
+ "<c:delete val=\"0\"/><c:axPos val=\"l\"/><c:crossAx val=\"11\"/>";
/**
* Минимальный in-memory docx: абзац-маркер + один линейный график (ряд 0..100)
* с указанным {@code wp:extent} и полным содержимым {@code c:valAx}
* (valAxXml — дети c:valAx в порядке ECMA-376 §21.2.2.219). Конвенция
* враждебного XML in-memory — WordPdfValidatorTest.
*/
private static byte[] chartDocx(long cx, long cy, String valAxXml) throws IOException {
String w = "http://schemas.openxmlformats.org/wordprocessingml/2006/main";
String c = "http://schemas.openxmlformats.org/drawingml/2006/chart";
StringBuilder pts = new StringBuilder();
for (int i = 0; i <= 10; i++) {
pts.append("<c:pt idx=\"").append(i).append("\"><c:v>")
.append(i * 10).append("</c:v></c:pt>");
}
ByteArrayOutputStream out = new ByteArrayOutputStream();
try (ZipOutputStream zos = new ZipOutputStream(out)) {
putZip(zos, "[Content_Types].xml",
"<?xml version=\"1.0\" encoding=\"UTF-8\" standalone=\"yes\"?>"
+ "<Types xmlns=\"http://schemas.openxmlformats.org/package/2006/content-types\">"
+ "<Default Extension=\"rels\" ContentType=\"application/vnd.openxmlformats-package.relationships+xml\"/>"
+ "<Default Extension=\"xml\" ContentType=\"application/xml\"/>"
+ "<Override PartName=\"/word/document.xml\" ContentType=\"application/vnd.openxmlformats-officedocument.wordprocessingml.document.main+xml\"/>"
+ "<Override PartName=\"/word/charts/chart1.xml\" ContentType=\"application/vnd.openxmlformats-officedocument.drawingml.chart+xml\"/>"
+ "</Types>");
putZip(zos, "_rels/.rels",
"<?xml version=\"1.0\" encoding=\"UTF-8\" standalone=\"yes\"?>"
+ "<Relationships xmlns=\"http://schemas.openxmlformats.org/package/2006/relationships\">"
+ "<Relationship Id=\"rId1\" Type=\"http://schemas.openxmlformats.org/officeDocument/2006/relationships/officeDocument\" Target=\"word/document.xml\"/>"
+ "</Relationships>");
putZip(zos, "word/document.xml",
"<?xml version=\"1.0\" encoding=\"UTF-8\" standalone=\"yes\"?>"
+ "<w:document xmlns:w=\"" + w + "\""
+ " xmlns:wp=\"http://schemas.openxmlformats.org/drawingml/2006/wordprocessingDrawing\">"
+ "<w:body>"
+ "<w:p><w:r><w:t>ГРАФИКМАРКЕР</w:t></w:r></w:p>"
+ "<w:p><w:r><w:drawing>"
+ "<wp:inline distT=\"0\" distB=\"0\" distL=\"0\" distR=\"0\">"
+ "<wp:extent cx=\"" + cx + "\" cy=\"" + cy + "\"/>"
+ "<wp:docPr id=\"1\" name=\"d1\"/>"
+ "<a:graphic xmlns:a=\"http://schemas.openxmlformats.org/drawingml/2006/main\">"
+ "<a:graphicData uri=\"" + c + "\">"
+ "<c:chart xmlns:c=\"" + c + "\""
+ " xmlns:r=\"http://schemas.openxmlformats.org/officeDocument/2006/relationships\""
+ " r:id=\"rId2\"/>"
+ "</a:graphicData></a:graphic></wp:inline></w:drawing></w:r></w:p>"
+ "<w:sectPr><w:pgSz w:w=\"11906\" w:h=\"16838\"/></w:sectPr>"
+ "</w:body></w:document>");
putZip(zos, "word/_rels/document.xml.rels",
"<?xml version=\"1.0\" encoding=\"UTF-8\" standalone=\"yes\"?>"
+ "<Relationships xmlns=\"http://schemas.openxmlformats.org/package/2006/relationships\">"
+ "<Relationship Id=\"rId2\" Type=\"http://schemas.openxmlformats.org/officeDocument/2006/relationships/chart\" Target=\"charts/chart1.xml\"/>"
+ "</Relationships>");
putZip(zos, "word/charts/chart1.xml",
"<?xml version=\"1.0\" encoding=\"UTF-8\" standalone=\"yes\"?>"
+ "<c:chartSpace xmlns:c=\"" + c + "\""
+ " xmlns:a=\"http://schemas.openxmlformats.org/drawingml/2006/main\">"
+ "<c:chart><c:plotArea>"
+ "<c:lineChart><c:grouping val=\"standard\"/>"
+ "<c:ser><c:idx val=\"0\"/><c:order val=\"0\"/>"
+ "<c:val><c:numRef><c:numCache><c:formatCode>General</c:formatCode>"
+ "<c:ptCount val=\"11\"/>" + pts + "</c:numCache></c:numRef></c:val>"
+ "</c:ser>"
+ "<c:axId val=\"11\"/><c:axId val=\"12\"/>"
+ "</c:lineChart>"
+ "<c:catAx><c:axId val=\"12\"/>"
+ "<c:scaling><c:orientation val=\"minMax\"/></c:scaling>"
+ "<c:delete val=\"0\"/><c:axPos val=\"b\"/><c:crossAx val=\"11\"/></c:catAx>"
+ "<c:valAx>" + valAxXml + "</c:valAx>"
+ "</c:plotArea></c:chart></c:chartSpace>");
}
return out.toByteArray();
}
/**
* Враждебные c:min/c:max (размах 2e300) при явном c:majorUnit=1: шаг делений
* пересчитывается по фактическому интервалу — конвертация завершается за
* секунды, график становится растром (до фикса — вечный цикл делений оси).
* Регрессия — ChartRenderer#axisBounds.
*/
@Test
void hostileChartAxis_convertsNotHangs() throws Exception {
byte[] docx = chartDocx(4_000_000L, 3_000_000L,
"<c:axId val=\"11\"/>"
+ "<c:scaling><c:orientation val=\"minMax\"/>"
+ "<c:max val=\"1e300\"/><c:min val=\"-1e300\"/></c:scaling>"
+ "<c:delete val=\"0\"/><c:axPos val=\"l\"/><c:crossAx val=\"11\"/>"
+ "<c:majorUnit val=\"1\"/>");
Path pdf = convertPdf(docx, "hostile-axis");
assertTrue(norm(pdfText(pdf)).contains("ГРАФИКМАРКЕР"), "пропал текст");
assertTrue(imageCount(pdf) >= 1, "график должен стать растром");
}
/**
* Враждебный wp:extent (122M EMU ≈ 133″): график не рендерится (кап
* MAX_EXTENT_EMU), документ конвертируется без OOM (до фикса —
* BufferedImage на десятки тысяч пикселей в стороне).
* Регрессия — DrawingPreRenderer#MAX_EXTENT_EMU.
*/
@Test
void hugeExtentChart_removedNotOom() throws Exception {
byte[] docx = chartDocx(122_000_000L, 122_000_000L, PLAIN_VALAX);
Path pdf = convertPdf(docx, "huge-extent");
assertTrue(norm(pdfText(pdf)).contains("ГРАФИКМАРКЕР"), "пропал текст");
assertEquals(0, imageCount(pdf), "график вне extent-капа не должен рендериться");
}
/**
* Error-флаг обязан сработать и для drawing без wp:extent: детект payload
* идёт до extent-guard'а (иначе обход — DrawingFoundException(CHARTS)).
* Регрессия — DrawingPreRenderer#replaceDrawing.
*/
@Test
void chartWithoutExtent_errorFlagRejects() throws Exception {
byte[] docx = chartDocx(0, 0, PLAIN_VALAX);
ConversionException ex = assertThrows(ConversionException.class, () ->
convertPdf(docx, "no-extent",
new ConvertOptions(true, false, false,
WordPdfSettings.MAX_INPUT_MB, WordPdfSettings.MAX_PAGES)));
assertTrue(ex instanceof DrawingFoundException dfe
&& dfe.kind() == DrawingFoundException.Kind.CHARTS,
"ожидался DrawingFoundException(CHARTS), получено: " + ex);
}
}
@@ -485,6 +485,30 @@ class WordPdfValidatorTest {
assertTrue(ex.getMessage().contains("не менее 5"), ex.getMessage());
}
/**
* Нечитаемый кэш: {@code <Pages>} с дочерним элементом —
* {@code getElementText()} бросает {@code IllegalStateException} (не
* {@code XMLStreamException}): до фикса валидатор давал 400 на валидном
* .docx. Кэш считается отсутствующим, нижняя оценка — по разрывам.
* Регрессия — WordPdfValidatorTest#cachedPagesUnreadableFallsBackToZero.
*/
@Test
void cachedPagesUnreadableFallsBackToZero() throws Exception {
String app = "<?xml version=\"1.0\"?>"
+ "<Properties xmlns=\"http://schemas.openxmlformats.org/officeDocument/2006/extended-properties\">"
+ "<Pages><b>x</b></Pages></Properties>";
String body = "<w:p><w:r><w:br w:type=\"page\"/></w:r></w:p>"
+ "<w:p><w:r><w:br w:type=\"page\"/></w:r></w:p>";
byte[] docx = rawDocx(java.util.Map.of(
DOCUMENT_PART, docPart(body),
"docProps/app.xml", app));
assertDoesNotThrow(() -> WordPdfValidator.checkPageCount(docx, 100));
ValidationException ex = assertThrows(ValidationException.class,
() -> WordPdfValidator.checkPageCount(docx, 2));
assertTrue(ex.getMessage().contains("не менее 3"),
"оценка по разрывам потеряна: " + ex.getMessage());
}
/** Колонтитулы считаются, .rels колонтитула — нет; записи-каталоги не пугают сканер. */
@Test
void pageCount_headerCountedRelsAndDirsNot() throws Exception {
@@ -1,6 +1,7 @@
package ru.pjandro.wordpdf.fonts;
import org.docx4j.fonts.PhysicalFont;
import org.junit.jupiter.api.BeforeAll;
import org.junit.jupiter.api.Test;
import java.io.IOException;
@@ -28,6 +29,18 @@ import static org.junit.jupiter.api.Assertions.*;
*/
class BundledFontsTest {
/**
* Тесты читают реестр начертаний ({@code BundledFonts.regular(...)}),
* который наполняет {@code init()}; без него {@code VARIANTS} пуста и
* {@code allFamiliesHaveAllVariants} падал при запуске класса отдельно.
* {@code init()} идемпотентен — {@code mapperMapsCommonMsFontsToBundledOnes}
* со своим порядком («маппер → init») остаётся зелёным.
*/
@BeforeAll
static void initBundledFonts() {
BundledFonts.init();
}
/** Все файлы из списка должны присутствовать в classpath (resources/fonts/).
* Путь — абсолютный (через classloader), не относительный к пакету класса. */
@Test
@@ -98,4 +98,21 @@ class DocxOnOffNormalizerTest {
assertNull(DocxOnOffNormalizer.rewrite("<w:b w:val=\"false\"/>"));
assertNull(DocxOnOffNormalizer.rewrite("без атрибутов"));
}
/**
* Литеральный {@code w:val="on"} в тексте {@code w:t} — не атрибут:
* паттерн заякорен на открывающий тег, текст не правится.
* Регрессия — DocxOnOffNormalizerTest#onOffInTextNotTouched.
*/
@Test
void onOffInTextNotTouched() {
assertNull(DocxOnOffNormalizer.rewrite(
"<w:p><w:r><w:t>флаг w:val=\"on\" выключен</w:t></w:r></w:p>"));
String r = DocxOnOffNormalizer.rewrite(
"<w:p><w:rPr><w:b w:val=\"off\"/></w:rPr>"
+ "<w:r><w:t>текст w:val=\"on\"</w:t></w:r></w:p>");
assertNotNull(r);
assertTrue(r.contains("<w:b w:val=\"false\"/>"), r);
assertTrue(r.contains("<w:t>текст w:val=\"on\"</w:t>"), r);
}
}
@@ -238,4 +238,83 @@ class StrictOoxmlNormalizerTest {
assertNull(StrictOoxmlNormalizer.rewrite("<w:ind w:val=\"start\"/>"));
assertNull(StrictOoxmlNormalizer.rewrite("<w:lvlText w:val=\"end\"/>"));
}
/**
* Transitional CT_Ind допускает сосуществование w:left+w:start (Word пишет
* обе пары): глобальная замена порождала дубль атрибута — не well-formed
* XML. Регрессия — WordPdfConverterTest#indCoexistForms_convertsNotRejected.
*/
@Test
void indCoexistLeftStartUntouched() {
assertNull(StrictOoxmlNormalizer.rewrite(
"<w:ind w:left=\"720\" w:start=\"720\"/>", true, true));
assertNull(StrictOoxmlNormalizer.rewrite(
"<w:ind w:left=\"720\" w:start=\"720\"/>", true, false));
assertNull(StrictOoxmlNormalizer.rewrite(
"<w:ind w:right=\"360\" w:end=\"360\"/>", true, false));
}
/** Только w:start (без w:left) — рерайт и в transitional (иначе отступ теряется). */
@Test
void indStartOnlyRenamedTransitional() {
String r = StrictOoxmlNormalizer.rewrite("<w:ind w:start=\"720\"/>", true, false);
assertNotNull(r);
assertTrue(r.contains("w:left=\"720\""), r);
}
/** CT_TcMar transitional допускает одновременных start+left детей — блок как есть. */
@Test
void tcMarCoexistKept() {
assertNull(StrictOoxmlNormalizer.rewrite(
"<w:tcMar><w:start w:w=\"100\" w:type=\"dxa\"/>"
+ "<w:left w:w=\"200\" w:type=\"dxa\"/></w:tcMar>", true, false));
}
/** Только start/end в блоке tcMar — рерайт и в transitional. */
@Test
void tcMarStartOnlyRenamedTransitional() {
String r = StrictOoxmlNormalizer.rewrite(
"<w:tblCellMar><w:start w:w=\"100\" w:type=\"dxa\"/>"
+ "<w:end w:w=\"300\" w:type=\"dxa\"/></w:tblCellMar>", true, false);
assertNotNull(r);
assertTrue(r.contains("<w:left w:w=\"100\""), r);
assertTrue(r.contains("<w:right w:w=\"300\""), r);
}
/** Вне tcMar/tblCellMar элементы transitional не переименовываются (JAXB их парсит). */
@Test
void tcBordersElementsKeptTransitional() {
assertNull(StrictOoxmlNormalizer.rewrite(
"<w:tcBorders><w:start w:val=\"single\"/></w:tcBorders>", true, false));
}
/**
* w:jc val="start" в transitional — JcEnumeration docx4j содержит START/END,
* FOP разрешает их по направлению (FO 1.1): рерайт ломал RTL, значение
* остаётся как есть.
*/
@Test
void jcStartKeptTransitional() {
assertNull(StrictOoxmlNormalizer.rewrite("<w:jc w:val=\"start\"/>", true, false));
}
/** А w:tab val="start" правится всегда: STTabJc docx4j 17.3.2 — только left/right. */
@Test
void tabStartRenamedTransitional() {
String r = StrictOoxmlNormalizer.rewrite(
"<w:tab w:val=\"start\" w:pos=\"1\"/>", true, false);
assertNotNull(r);
assertTrue(r.contains("<w:tab w:val=\"left\" w:pos=\"1\"/>"), r);
}
/** Transitional-документ с обеими формами атрибута — исходный массив байтов. */
@Test
void transitionalCoexistReturnsOriginalArray() throws Exception {
byte[] docx = makeDocx(
"[Content_Types].xml", "<Types/>",
"word/document.xml",
"<w:document xmlns:w=\"http://schemas.openxmlformats.org/wordprocessingml/2006/main\">"
+ "<w:p><w:pPr><w:ind w:left=\"1\" w:start=\"1\"/></w:pPr></w:p></w:document>");
assertSame(docx, StrictOoxmlNormalizer.normalize(docx));
}
}
@@ -217,6 +217,36 @@ class ChartRendererTest {
assertEquals(12.0, b[1], 0.001, "hi<=lo — поднимаем до lo+unit");
}
/**
* Враждебные явные c:min/c:max (размах 2e300 при явном шаге 1): шаг
* пересчитывается по фактическому интервалу — число делений ≤ MAX_TICKS+1,
* все циклы делений у художников завершаются.
* Регрессия — ChartRendererTest#axisBounds_explicitHugeRange_reunitsToMaxTicks.
*/
@Test
void axisBounds_explicitHugeRange_reunitsToMaxTicks() {
ChartSpec.AxisSpec ax = new ChartSpec.AxisSpec();
ax.min = -1e300;
ax.max = 1e300;
ax.majorUnit = 1.0;
double[] r = ChartRenderer.axisBounds(ax, 0, 10);
assertTrue(Double.isFinite(r[0]) && Double.isFinite(r[1]) && Double.isFinite(r[2]),
"границы/шаг обязаны остаться конечными");
assertTrue((r[1] - r[0]) / r[2] <= 1001,
"слишком много делений: " + (r[1] - r[0]) / r[2]);
}
/** Не-конечные границы (переполнение размаха) — откат к границам данных. */
@Test
void axisBounds_infiniteSpan_fallsBackToData() {
ChartSpec.AxisSpec ax = new ChartSpec.AxisSpec();
ax.min = -1e308;
ax.max = 1e308;
double[] r = ChartRenderer.axisBounds(ax, 0, 10);
assertTrue(r[0] >= 0 && r[1] <= 12 && (r[1] - r[0]) / r[2] <= 1001,
"ожидаем откат к данным: " + r[0] + ".." + r[1] + " шаг " + r[2]);
}
/** formatValue: 0.00/0.0/General/null. */
@Test
void formatValueFormats() {
@@ -636,6 +636,35 @@ class ChartSpecTest {
assertEquals("General", spec.serAxis.numFmt);
}
/**
* Не-конечные c:min/c:max/c:majorUnit (NaN/Infinity — ST_Double допускает)
* отбрасываются на разборе: враждебный chart-XML не должен протаскивать
* их в циклы делений. Регрессия — ChartSpecTest#nonFiniteScalingBounds_dropped.
*/
@Test
void nonFiniteScalingBounds_dropped() {
CTChart chart = new CTChart();
CTPlotArea pa = new CTPlotArea();
CTValAx val = new CTValAx();
CTScaling scaling = new CTScaling();
CTDouble min = new CTDouble();
min.setVal(Double.NaN);
CTDouble max = new CTDouble();
max.setVal(Double.POSITIVE_INFINITY);
scaling.setMin(min);
scaling.setMax(max);
val.setScaling(scaling);
CTAxisUnit unit = new CTAxisUnit();
unit.setVal(Double.NaN);
val.setMajorUnit(unit);
pa.getValAxOrCatAxOrDateAx().add(val);
chart.setPlotArea(pa);
ChartSpec spec = ChartSpec.parse(spaceWith(chart), new DrawMlColor(null));
assertNull(spec.valAxis.min, "NaN c:min должен быть отброшен");
assertNull(spec.valAxis.max, "Infinity c:max должен быть отброшен");
assertNull(spec.valAxis.majorUnit, "NaN c:majorUnit должен быть отброшен");
}
@Test
void numericCategoriesSparsePadded() {
CTBarChart bar = new CTBarChart();
@@ -126,6 +126,26 @@ class DrawMlColorTest {
assertEquals("Calibri Light", colors.majorFontName());
}
/**
* Битая тема: {@code a:srgbClr val="zzzz"} в accent1 — decodeHex отдаёт
* null, put пропускает, схема держит office-дефолт (битая тема не валит
* всю конвертацию). Регрессия — DrawMlColorTest#invalidSrgbHexFallsBackToOfficeDefault.
*/
@Test
void invalidSrgbHexFallsBackToOfficeDefault() {
Theme theme = new Theme();
BaseStyles el = new BaseStyles();
CTColorScheme cs = new CTColorScheme();
cs.setAccent1(srgb("zzzz"));
el.setClrScheme(cs);
theme.setThemeElements(el);
DrawMlColor colors = new DrawMlColor(theme);
assertEquals(OFFICE_ACCENT1, colors.schemeColor("accent1"),
"битый hex должен деградировать к office-дефолту");
assertNull(colors.resolve(srgb("не-шестнадцатеричное")),
"resolve битой базы — null (вызывающий берёт дефолт)");
}
@Test
void schemeColorNullAndUnknownFallBackToBlack() {
DrawMlColor colors = new DrawMlColor(null);
@@ -286,4 +286,23 @@ class DrawMlTextTest {
assertEquals(3, DrawMlText.lineCount(
"альфа бета гамма дельта эпсилон зета эта йота капа лямбда", s, 100));
}
/**
* Слово из 50 000 символов: перенос завершается за O(L log L) (инкрементальная
* ширина + экспоненциальный поиск границы реза) и каждая строка влезает в
* лимит ширины. Регрессия — DrawMlTextTest#hugeWord_wrapsLinearly.
*/
@Test
void hugeWord_wrapsLinearly() {
BundledFonts.init();
var f = DrawMlText.fontFor(style("Carlito", false, false));
String huge = "A".repeat(50_000);
double limit = 120;
List<String> lines = DrawMlText.wrapLines(huge, f, 12, limit);
assertTrue(lines.size() > 1, "гигантское слово должно быть порезано");
for (String line : lines) {
assertTrue(line.length() == 1 || f.advance(line, 12) <= limit,
"строка шире лимита: " + line.length() + " симв.");
}
}
}
+2 -2
View File
@@ -60,7 +60,7 @@ export async function convertDocx(
const json = (await resp.json().catch(() => null)) as { error?: string } | null
throw new ApiError(json?.error ?? `HTTP ${resp.status}`)
}
// Framework 7 отдаёт `filename*=UTF-8''…` (charset в верхнем регистре) —
// Spring отдаёт `filename*=UTF-8''…` (charset в верхнем регистре) —
// флаг i обязателен; фолбэк — имя исходника с заменой расширения
const cd = resp.headers.get('Content-Disposition') ?? ''
const m = /filename\*=utf-8''([^;]+)/i.exec(cd)
@@ -72,7 +72,7 @@ export async function convertDocx(
/**
* Требует ли сервер ключ: GET /api/v1/convert (эндпоинт POST-only) —
* 401 пишет ApiKeyFilter при требуемом и непринятом ключе; при выключенной
* аутентификации (dev) до фильтра дело не доходит — 405 от Spring.
* аутентификации (dev) до фильтра дело не доходит — 405 от ApiExceptionHandler.
* Сетевая ошибка — 'open': не блокировать UI, конвертация сама покажет ошибку.
*/
export async function probeApiKey(): Promise<'open' | 'required'> {
+2 -2
View File
@@ -130,8 +130,8 @@ export default function App() {
<div>
<h1 className="text-2xl font-semibold">Word → PDF</h1>
<p className="mt-1 text-sm text-muted">
docx → PDF на docx4j + Apache FOP. Лимиты (файл ≤ 5 МБ,
≤ 100 страниц) задаёт сервер; переопределение из формы убрано.
docx → PDF на docx4j + Apache FOP. Лимиты задаёт сервер;
переопределение из формы убрано.
</p>
</div>
</header>