Docs: AGENTS.md и README под байтовый API, ключ и два режима запуска

This commit is contained in:
Pjandro
2026-10-14 01:50:51 +00:00
parent e3363319d3
commit c8a45d84c5
2 changed files with 26 additions and 15 deletions
+8 -4
View File
@@ -27,7 +27,7 @@ java-word-pdf/
| Класс | Назначение |
|---|---|
| `ru.pjandro.wordpdf.WordPdfConverter` | публичный API: `convert(Path)` / `convert(Path, Path)` |
| `ru.pjandro.wordpdf.WordPdfConverter` | публичный API: `convert(byte[], String)` — байты на входе, байты PDF на выходе |
| `ru.pjandro.wordpdf.ConversionException` | исключение конвертации |
| `ru.pjandro.wordpdf.fonts.BundledFonts` | выгрузка TTF из jar и регистрация в docx4j |
| `ru.pjandro.wordpdf.fonts.BundledFontMapper` | маппинг имён шрифтов документа → TTF |
@@ -74,13 +74,17 @@ Swagger UI — `/swagger-ui.html`, OpenAPI — `/v3/api-docs`.
```java
import ru.pjandro.wordpdf.WordPdfConverter;
import java.nio.file.Files;
import java.nio.file.Path;
Path pdf = WordPdfConverter.convert(Path.of("doc.docx")); // doc.pdf рядом
WordPdfConverter.convert(Path.of("doc.docx"), Path.of("out.pdf")); // явный выход
byte[] docx = Files.readAllBytes(Path.of("doc.docx"));
byte[] pdf = WordPdfConverter.convert(docx, "doc"); // заголовок PDF
Files.write(Path.of("out.pdf"), pdf);
```
Ошибки валидации (не `.docx`, файл не найден) бросают `ConversionException`.
Ошибки валидации (не `.docx` по содержимому, размер больше 5 МБ, страниц
больше ста) бросают `ConversionException`. Работа с файлами — забота
вызывающего: ядро пути не принимает.
### Веб-интерфейс и Docker