S potěšením oznamujeme vydání GroupDocs.Assembly for Java 26.11, dostupné od listopadu 2026. Toto vydání přináší funkce a opravy z GroupDocs.Assembly pro .NET 26.11 do Javy:
- šablony mohou být kontrolovány vůči JSON Schema;
- stránky šablon a zpráv mohou být vykresleny do obrázků;
- načítání externích zdrojů je pod kontrolou aplikace;
REMOVE_EMPTY_PARAGRAPHSfunguje pro šablony tabulek a prostý text;- tagy
<<image>>fungují v buňkách tabulky prezentací a rozřeší relativní cesty vůči složce šablony; - tagy barev přijímají hex řetězce.
Balíčkové enginy Aspose přecházejí ze svých raných verzí 2026 na 26.10 a řada oprav zahrnuje licencování, kódování reportů, čárové kódy a HTML obsah. Java 8 zůstává výchozím.
Co je nového v tomto vydání
| Klíč | Shrnutí | Kategorie |
|---|---|---|
| ASSEMBLYNET-145 | JsonDataSource přijímá JSON Schema: členové deklarovaní ve schématu mohou být odkazováni i když jsou v datech null, prázdní nebo chybějící, a typy hodnot pocházejí ze schématu |
Funkce |
| ASSEMBLYNET-8 | DocumentAssembler.generatePreview vykresluje stránky šablon, sestavených zpráv a dalších dokumentů do PNG, JPEG nebo BMP obrázků |
Funkce |
| ASSEMBLYNET-36, ASSEMBLYNET-37 | DocumentAssemblyOptions.REMOVE_EMPTY_PARAGRAPHS funguje pro šablony tabulek a prosté textové dokumenty |
Funkce |
| ASSEMBLYNET-140 | Externí zdroje odkazované šablonami a daty jsou pod kontrolou aplikace; zdroje, jejichž odkazy pocházejí z dat, jsou ve výchozím nastavení přeskočeny | Zabezpečení |
| ASSEMBLYJAVA-353 | Aspose.Words 26.10.1, Aspose.Cells 26.10, Aspose.Slides 26.10, Aspose.Email 26.9 a Aspose.BarCode 26.10 jsou zahrnuty | Aktualizace |
| ASSEMBLYJAVA-353 | GS1 čárové kódy (EAN-14, SCC-14, SSCC-18 a DataBar) zachovávají automatickou korekci textu kódu s Aspose.BarCode 26.10 | Oprava |
| ASSEMBLYNET-52 | <<image>> tag funguje v buňce tabulky prezentace a tagy ve tvarech skupinových tvarů jsou zpracovány |
Vylepšení |
| ASSEMBLYNET-62 | Relativní cesta k obrázku z dat je rozřešena vůči složce šablony | Vylepšení |
| ASSEMBLYNET-25 | Barva zadaná jako řetězec může být hexadecimální hodnota v backColor a tagy barvy grafu |
Vylepšení |
| ASSEMBLYNET-155 | Chybějící Boolean v JSON, XML nebo CSV datech se počítá jako false v ?: a v where, count, any, all a first místo selhání |
Oprava |
| ASSEMBLYNET-157 | groupBy a distinct nad vnořenými objekty slučují stejné objekty; $id/$ref odkazy v JSON datech jsou podporovány |
Oprava |
| ASSEMBLYNET-142 | License.setLicense(InputStream) čte proud, který již byl čten od jeho začátku |
Oprava |
| ASSEMBLYNET-143 | Spotřeba měřené licence je hlášena po dokončení operace | Oprava |
| ASSEMBLYNET-158 | Textové a HTML zprávy ASCII‑only šablon jsou zapisovány v UTF‑8, takže ne‑latinská data již nejsou ztracena | Oprava |
| ASSEMBLYNET-160 | Čárové kódy již nepadnou s NullPointerException, když není nainstalováno písmo jejich textového pole |
Oprava |
| ASSEMBLYNET-159 | Tagy v tématu konverzace MSG šablony jsou sestaveny jako tagy v předmětu | Oprava |
| ASSEMBLYNET-152 | <<doc>> tag v tabulce, prezentaci nebo textové šabloně selže s jasnou zprávou; neúspěšný assembleDocument nenechá prázdný výstupní soubor |
Oprava |
| ASSEMBLYJAVA-354 | -html výrazový tag ukončující svůj odstavec již nenechává prázdný odstavec po HTML končícím blokovým elementem |
Oprava |
Změny chování, které je třeba zkontrolovat před aktualizací
- Externí zdroje z dat jsou ve výchozím nastavení přeskočeny. Například
<<image [item.PhotoUrl]>>, kdePhotoUrlje http nebo https URI, nyní vrátí prázdný obrázek. Přidejte hosty doLoadSaveOptions.getWhitelistedResources(), nebo zavolejteLoadSaveOptions.setSkipExternalResources(false), abyste zachovali předchozí chování. Zdroje odkazované samotnou šablonou a lokální souborové cesty fungují jako dříve. - Nejednoznačné volání
JsonDataSource.new JsonDataSource(path, null)s doslovnýmnulljako druhým argumentem již nekompiluje. Přetypujte argument:new JsonDataSource(path, (JsonDataLoadOptions) null). Zkompilované aplikace nejsou ovlivněny. - UTF-8 textové a HTML zprávy. Zprávy ASCII‑only textových a HTML šablon bez BOM jsou nyní zapisovány v UTF‑8 místo windows-1252. Pro zachování jednojádrové znakové sady ji deklarujte v šabloně (
<meta charset>v HTML). groupByadistinctnad vnořenými objekty JSON, XML a DataSet dat nyní slučují stejné objekty místo vytváření jedné skupiny na řádek.- Žádný extra odstavec po HTML.
-htmltag ukončující svůj odstavec již nenechává prázdný odstavec po HTML končícím blokovým elementem. Pro zachování prázdného řádku ukončete HTML pomocí<p> </p>. - DataBar Expanded čárové kódy. DataBar Expanded nebo DataBar Expanded Stacked čárový kód s textem kódu pouze z číslic je nyní kódován jako GTIN s aplikátorem (01), stejně jako ostatní typy DataBar.
- Změněný text výjimky pro
<<doc>>tag v tabulce, prezentaci a textových šablonách; typ výjimky zůstává stejný. - Odstraněné API.
ICustomFontsHandler.resetFontSources()je odstraněno; místo toho použijteFontSettings.resetFontSources().
Nové funkce
Podpora JSON Schema pro JsonDataSource
Šablona je kontrolována vůči struktuře svých dat před vyhodnocením jakéhokoli <<if>>. U JSON se struktura dříve brala přímo z dat, takže odkaz uvnitř větve, která se nikdy nevykreslí, selhal, pokud data za ním byla null, prázdné pole nebo chybějící.
JsonDataSource nyní přijímá JSON Schema, stejně jako XmlDataSource přijímá XML Schema, a šablona je kontrolována proti schématu:
- členové deklarovaní ve schématu mohou být odkazováni i když jsou v datech null, prázdní nebo chybějící;
- členové nedeklarovaní ve schématu stále selžou, takže překlepy jsou detekovány jako dříve;
- typy hodnot pocházejí ze schématu, takže boolean je
Booleana řetězec obsahující číslice zůstává řetězcem.
Příklad dat:
{ "Name": "Quayside Bistro", "Account": "00042", "Cards": [], "Loyalty": null }
Schéma:
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"Name": { "type": "string" },
"Account": { "type": "string" },
"Cards": {
"type": "array",
"items": { "type": "object", "properties": { "Type": { "type": "string" }, "Last4": { "type": "string" } } }
},
"Loyalty": { "type": ["object", "null"], "properties": { "Level": { "type": "string" } } }
}
}
Šablona:
Customer: <<[customer.Name]>>
Account number: <<[customer.Account]>>
<<if [customer.Cards.count() > 0]>>Payment card: <<[customer.Cards.first().Type]>> ending in <<[customer.Cards.first().Last4]>><<else>>No payment card on file.<</if>>
Loyalty program: <<[customer.Loyalty?.Level]>>
Použijte schéma vedle dat:
JsonDataSource dataSource = new JsonDataSource("Customer.json", "Customer.schema.json");
DocumentAssembler assembler = new DocumentAssembler();
assembler.assembleDocument("Json schema.docx", "output.docx", new DataSourceInfo(dataSource, "customer"));
Výsledek je No payment card on file. s číslem účtu 00042. Bez schématu selže stejná šablona na customer.Cards.first().Type a číslo účtu se načte jako číslo 42.
Schéma může být zadáno jako cesta k souboru nebo InputStream, s nebo bez JsonDataLoadOptions. Podporovaná klíčová slova jsou type (včetně nullable typů), properties, items, format (date-time a date), enum, const, allOf a lokální $ref ukazatele. oneOf, anyOf, not, vzdálené nebo rekurzivní $ref, tuple‑form items a pole polí nejsou podporovány.
Náhled dokumentu
DocumentAssembler.generatePreview vykresluje stránky dokumentu do PNG, JPEG nebo BMP obrázků: šablonu, dokument sestavený GroupDocs.Assembly nebo jakýkoli jiný podporovaný formát, ze souboru nebo proudu. Vykreslují se stránky textových, HTML dokumentů, tištěné stránky tabulek, snímky prezentací a e‑mailové zprávy s hlavičkou.
DocumentAssembler assembler = new DocumentAssembler();
ByteArrayOutputStream report = new ByteArrayOutputStream();
try (InputStream template = new FileInputStream("Customer orders.docx"))
{
assembler.assembleDocument(template, report,
new DataSourceInfo(new JsonDataSource("Customers.json"), "customers"));
}
// A stream is created for every page and released when the page is written.
PreviewOptions options = new PreviewOptions(
pageNumber -> new FileOutputStream("page" + pageNumber + ".png"),
(pageNumber, pageStream) -> pageStream.close());
options.setPreviewFormat(PreviewFormats.PNG);
options.setResolution(120); // dots per inch; 96 by default
// options.setPageNumbers(new int[] { 1, 2 }); // all pages by default
assembler.generatePreview(new ByteArrayInputStream(report.toByteArray()), options);
Když jsou nastaveny jak setWidth, tak setHeight, stránky jsou škálovány tak, aby se vešly do dané velikosti při zachování poměru stran. Náhledy jsou generovány bez načítání externích zdrojů a generované obrázky jsou počítány v rámci měřené licence stejně jako sestavené dokumenty.
REMOVE_EMPTY_PARAGRAPHS pro šablony tabulek a prostého textu
DocumentAssemblyOptions.REMOVE_EMPTY_PARAGRAPHS nyní funguje i pro šablony tabulek a prosté textové dokumenty. Zde je odstavec řádek textu: řádek textu buňky nebo textového dokumentu, který po zpracování tagů šablony zůstane prázdný, je odstraněn spolu s koncem řádku. Tagy jako <<if>> a <<foreach>> psané na samostatných řádcích již nenechávají prázdné řádky.
DocumentAssembler assembler = new DocumentAssembler();
assembler.setOptions(DocumentAssemblyOptions.REMOVE_EMPTY_PARAGRAPHS);
assembler.assembleDocument("Empty paragraph.txt", "result.txt", new DataSourceInfo("dummy", "dummy"));
Šablona:
Prefix
<<if [false]>>
Text to be removed
<</if>>
Suffix
Výsledek:
Prefix
Suffix
Stejný text šablony v buňce tabulky dává stejný výsledek v rámci buňky. HTML a XML dokumenty zůstávají beze změny.
Zabezpečení: kontrola externích zdrojů
Tag <<image>> nebo <<doc>> může vyhodnotit URI převzaté z dat a GroupDocs.Assembly jej dříve načítal bez možnosti zamezit tomu. Server, který sestavuje dokumenty z dat poskytnutých třetími stranami, tak mohl být přiměn požadovat interní adresy.
GroupDocs.Assembly nyní uvádí, odkud každá reference na externí zdroj pochází (ExternalResourceOrigin):
TEMPLATE— dokument šablony odkazuje na zdroj sám, včetně doslovného URI v tagu jako<<image ["https://example.com/logo.png"]>>;DATA— reference pochází z dat, například URI, které vyhodnotí výraz tagu.
Ve výchozím nastavení jsou zdroje odkazované šablonou načítány jako dříve a zdroje, jejichž reference pocházejí z dat, jsou přeskočeny. Čtyři členové LoadSaveOptions toto řídí:
setSkipExternalResources(trueve výchozím nastavení) — externí zdroje nejsou načítány;setTrustTemplateResources(trueve výchozím nastavení) — zdroje odkazované šablonou jsou načteny i při zapnutém přeskočení; nastavte nafalse, pokud šablony pocházejí z nedůvěryhodných zdrojů;getWhitelistedResources— názvy hostitelů nebo absolutní URI prefixy povolené i při zapnutém přeskočení;setExternalResourceHandler—ExternalResourceHandlervolaný pro každý externí zdroj před jeho požadavkem, aby jej povolil, přeskočil nebo poskytl jeho obsah.
final String photoUri = "https://images.example.com/photos/no-photo.jpg";
DocumentAssembler assembler = new DocumentAssembler();
// Default options: the URI comes from data, so the image is skipped and left empty.
assembler.assembleDocument("Inserting image.docx", "Skipped.docx", new DataSourceInfo(photoUri, "expression"));
// Allow a trusted host and see every decision. The handler can also provide the content itself.
LoadSaveOptions options = new LoadSaveOptions();
options.getWhitelistedResources().add("images.example.com");
options.setExternalResourceHandler(new LocalImageHandler("no-photo.jpg"));
assembler.assembleDocument("Inserting image.docx", "Provided.docx", options, new DataSourceInfo(photoUri, "expression"));
public class LocalImageHandler extends ExternalResourceHandler
{
private final String mImagePath;
public LocalImageHandler(String imagePath) { mImagePath = imagePath; }
@Override
public void onLoading(ExternalResourceLoadingArgs args)
{
System.out.println(ExternalResourceOrigin.toString(args.getOrigin()) + " resource " + args.getUri() + ": "
+ (args.isSkipped() ? "skipped" : "allowed"));
// Provide the content instead of requesting it.
if (!args.isSkipped() && args.getUri().toLowerCase().startsWith("https://images.example.com/"))
{
try
{
args.setData(Files.readAllBytes(Paths.get(mImagePath)));
}
catch (IOException e)
{
throw new UncheckedIOException(e);
}
}
}
}
Externí zdroje jsou zdroje, které se dostanou na síť: http, https a ftp URI, UNC cesty a file URI s vzdáleným hostitelem. Lokální souborové cesty nejsou ovlivněny. Přeskočený obrázek v dokumentu je nahrazen transparentním obrázkem; přeskočená hodnota <<image>> nebo <<doc>> je považována za prázdnou.
Vylepšení
Obrázky v buňkách tabulky a skupinových tvarech prezentací
V šabloně prezentace mohl být tag <<image>> umístěn jen do textového pole. Buňka tabulky je nyní také kontejnerem pro obrázek: obrázek se stane výplní buňky, včetně buněk řádků opakovaných pomocí <<foreach>>, takže lze vytvořit tabulku s položkami a jejich obrázky. S -fitHeight řádek roste, aby zobrazil obrázek v poměru stran. Tagy ve tvarech skupinových tvarů, včetně vnořených skupin, jsou nyní zpracovány jako ostatní tvary.
Relativní cesty k obrázkům rozřešené vůči složce šablony
Tag <<image>>, který získá relativní cestu k souboru z dat, například Images/photo.png, ji nyní nejprve rozřeší vůči složce šablony, podobně jako propojené zdroje dokumentů Microsoft Office. Pro šablonu načtenou ze streamu nastavte složku pomocí LoadSaveOptions.setResourceLoadBaseUri:
DocumentAssembler assembler = new DocumentAssembler();
// A template loaded from a stream has no folder: set it with setResourceLoadBaseUri.
LoadSaveOptions options = new LoadSaveOptions();
options.setResourceLoadBaseUri("C:\\Reports\\Templates");
try (InputStream template = new FileInputStream("C:\\Reports\\Templates\\Inserting image.docx");
OutputStream report = new FileOutputStream("output-from-stream.docx"))
{
assembler.assembleDocument(template, report, options, new DataSourceInfo("../Images/no-photo.jpg", "expression"));
}
Pokud tam soubor neexistuje, použije se aktuální adresář jako dříve.
Hexadecimální řetězce barev
Barva zadaná jako řetězec může nyní být hexadecimální hodnota — "#RRGGBB", "#RGB" nebo "#AARRGGBB" — kromě názvu barvy a ARGB celého čísla, v backColor a tagy barvy grafu. Například <<backColor [item.Color]>> s "#FF0000" pocházejícím z dat nyní aplikuje červenou.
Opravy
- Chybějící Booleany v JSON, XML a CSV datech se nyní počítají jako
falsev podmínkovém operátoru?:a v predikátechwhere,count,any,allafirst, místo selhání sNullPointerException. groupByadistinctnad vnořenými objekty JSON a XML dat porovnávají objekty podle hodnot, takže stejní zákazníci tvoří jednu skupinu. JSON zapisovaný s zachovanými odkazy ($id/$ref) je nyní podporován.License.setLicense(InputStream)čteByteArrayInputStreamod svého marku aFileInputStreamod pozice 0, takže proud již použitý k licencování jiného GroupDocs produktu již nehlásí “Unexpected EOF in prolog”.- Spotřeba měřené licence je hlášena po dokončení sestavení dokumentu nebo generování náhledu, místo později z background threadu.
- Textové a HTML zprávy ASCII‑only šablon jsou zapisovány v UTF‑8, takže data jako
CaféneboПриветjiž nejsou ztracena na windows‑1252. - Čárové kódy, jejichž text je kreslen enginem (QR, DataMatrix, Aztec a další) již nepadnou, když není nainstalováno písmo jejich textového pole — typicky Calibri na Linuxu. Místo toho se použije náhradní písmo.
- MSG šablony: tagy v tématu konverzace jsou zpracovány jako tagy v předmětu, takže Outlook správně řetězí zprávy.
<<doc>>v tabulce, prezentaci a textových šablonách selže s hláškou, že tag není podporován pro daný formát, a neúspěšnýassembleDocumentjiž nenechá prázdný výstupní soubor.- HTML obsah:
-htmlvýrazový tag ukončující svůj odstavec již nenechává extra prázdný odstavec po HTML končícím blokovým elementem (ASSEMBLYJAVA-354). - GS1 čárové kódy: GroupDocs.Assembly nyní sám opravuje texty kódu pouze s číslicemi u EAN‑14, SCC‑14, SSCC‑18 a DataBar čárových kódů, protože Aspose.BarCode 26.10 to přestal dělat, takže tyto kódy zůstávají stejné jako v 26.10.1.
Aspose enginy aktualizovány na 26.10
GroupDocs.Assembly for Java 26.10.1 zahrnoval Aspose knihovny z počátku roku 2026, takže zranitelnosti opravené v nich od té doby byly nahlášeny bezpečnostními skenery. Zahrnuté enginy jsou nyní:
| Engine | 26.10.1 | 26.11 |
|---|---|---|
| Aspose.Words for Java | 26.3 | 26.10.1 |
| Aspose.Cells for Java | 26.3 | 26.10 |
| Aspose.Slides for Java | 26.2 | 26.10 |
| Aspose.Email for Java | 26.1 | 26.9 |
| Aspose.BarCode for Java | 26.6 | 26.10 |
Publikovaný POM stále neuvádí žádné závislosti. Protože byly enginy obnoveny, mohou se vygenerované dokumenty lišit na úrovni bajtů, i když zůstávají vizuálně i funkčně ekvivalentní. Pokud porovnáváte bajty výstupu s uloženými referenčními soubory, po aktualizaci tyto referenční soubory obnovte.
Poznámky pro uživatele Javy
- Data s
Znebo offsetem v JSON nebo CSV datech jsoujava.util.Datehodnoty přesně v daném okamžiku a formátovací vzor je vypisuje ve výchozím časovém pásmu JVM. Pro výstup nezávislý na serveru spusťte JVM s pevně nastaveným časovým pásmem, např.-Duser.timezone=UTC. ExternalResourceOriginaPreviewFormatsjsou třídyintkonstant, podobně jako ostatní výčty Java API.CreatePageStreamaReleasePageStreamjsou funkční rozhraní, takže lambda výrazy fungují.
Jak získat aktualizaci
Maven
Přidejte repozitář GroupDocs a závislost do svého pom.xml:
<repositories>
<repository>
<id>groupdocs-artifacts-repository</id>
<name>GroupDocs Artifacts Repository</name>
<url>https://releases.groupdocs.com/java/repo/</url>
</repository>
</repositories>
<dependencies>
<dependency>
<groupId>com.groupdocs</groupId>
<artifactId>groupdocs-assembly</artifactId>
<version>26.11</version>
</dependency>
</dependencies>
Přímé stažení
Stáhněte JAR ze GroupDocs.Assembly for Java 26.11 download page.