Z przyjemnością ogłaszamy wydanie GroupDocs.Assembly for Java 26.11, dostępne od listopada 2026. To wydanie przenosi funkcje i poprawki z GroupDocs.Assembly for .NET 26.11 do Javy:

  • szablony mogą być sprawdzane względem JSON Schema;
  • strony szablonów i raportów mogą być renderowane do obrazów;
  • ładowanie zewnętrznych zasobów jest kontrolowane przez aplikację;
  • REMOVE_EMPTY_PARAGRAPHS działa dla szablonów arkuszy kalkulacyjnych i zwykłego tekstu;
  • tagi <<image>> działają w komórkach tabel prezentacji i rozwiązują ścieżki względne względem folderu szablonu;
  • tagi koloru akceptują ciągi szesnastkowe.

Dołączone silniki Aspose przechodzą z ich wczesnych wersji 2026 na 26.10, a szereg poprawek obejmuje licencjonowanie, kodowanie raportów, kody kreskowe i zawartość HTML. Java 8 pozostaje bazą.

Co nowego w tym wydaniu

Klucz Podsumowanie Kategoria
ASSEMBLYNET-145 JsonDataSource akceptuje JSON Schema: elementy zadeklarowane w schemacie mogą być odwoływane nawet gdy są null, puste lub nieobecne w danych, a typy wartości pochodzą ze schematu Funkcja
ASSEMBLYNET-8 DocumentAssembler.generatePreview renderuje strony szablonów, złożonych raportów i innych dokumentów do obrazów PNG, JPEG lub BMP Funkcja
ASSEMBLYNET-36, ASSEMBLYNET-37 DocumentAssemblyOptions.REMOVE_EMPTY_PARAGRAPHS działa dla szablonów arkuszy kalkulacyjnych i dokumentów zwykłego tekstu Funkcja
ASSEMBLYNET-140 Zewnętrzne zasoby odwoływane przez szablony i dane są pod kontrolą aplikacji; zasoby, których odwołania pochodzą z danych, są domyślnie pomijane Bezpieczeństwo
ASSEMBLYJAVA-353 Dołączone są Aspose.Words 26.10.1, Aspose.Cells 26.10, Aspose.Slides 26.10, Aspose.Email 26.9 i Aspose.BarCode 26.10 Aktualizacja
ASSEMBLYJAVA-353 Kody kreskowe GS1 (EAN-14, SCC-14, SSCC-18 i DataBar) zachowują automatyczną korektę tekstu kodu przy użyciu Aspose.BarCode 26.10 Poprawka
ASSEMBLYNET-52 Tag <<image>> działa w komórce tabeli prezentacji, a tagi w kształtach grupowych są przetwarzane Ulepszenie
ASSEMBLYNET-62 Ścieżka względna obrazu pochodząca z danych jest rozwiązywana względem folderu szablonu Ulepszenie
ASSEMBLYNET-25 Kolor podany jako ciąg może być wartością szesnastkową w tagach backColor i kolorach wykresów Ulepszenie
ASSEMBLYNET-155 Brakująca wartość Boolean w danych JSON, XML lub CSV jest traktowana jako false w operatorze ?: oraz w where, count, any, all i first zamiast powodować błąd Poprawka
ASSEMBLYNET-157 groupBy i distinct na zagnieżdżonych obiektach łączą równe obiekty; referencje $id/$ref danych JSON są obsługiwane Poprawka
ASSEMBLYNET-142 License.setLicense(InputStream) odczytuje strumień, który został już odczytany od początku Poprawka
ASSEMBLYNET-143 Zużycie licencji rozliczanej jest raportowane po zakończeniu operacji Poprawka
ASSEMBLYNET-158 Raporty tekstowe i HTML szablonów zawierających wyłącznie ASCII są zapisywane w UTF-8, więc dane niełacińskie nie są już tracone Poprawka
ASSEMBLYNET-160 Kody kreskowe nie powodują już NullPointerException, gdy czcionka ich pola tekstowego nie jest zainstalowana Poprawka
ASSEMBLYNET-159 Tagi w temacie konwersacji szablonu MSG są składane tak jak te w temacie Poprawka
ASSEMBLYNET-152 Tag <<doc>> w szablonie arkusza, prezentacji lub tekstu kończy się wyraźnym komunikatem o błędzie; nieudane assembleDocument nie pozostawia pustego pliku wyjściowego Poprawka
ASSEMBLYJAVA-354 Tag wyrażenia -html kończący swój akapit nie pozostawia już pustego akapitu po HTML kończącym się elementem blokowym Poprawka

Zmiany w zachowaniu, które należy sprawdzić przed aktualizacją

  1. Zewnętrzne zasoby pochodzące z danych są domyślnie pomijane. Na przykład <<image [item.PhotoUrl]>>, gdzie PhotoUrl jest adresem http lub https, teraz daje pusty obraz. Dodaj hosty do LoadSaveOptions.getWhitelistedResources(), lub wywołaj LoadSaveOptions.setSkipExternalResources(false), aby zachować poprzednie zachowanie. Zasoby odwoływane przez sam szablon oraz lokalne ścieżki plików działają jak wcześniej.
  2. Niejednoznaczne wywołanie JsonDataSource. new JsonDataSource(path, null) z dosłownym drugim argumentem null już się nie kompiluje. Rzutuj argument: new JsonDataSource(path, (JsonDataLoadOptions) null). Aplikacje już skompilowane nie są dotknięte.
  3. Raporty tekstowe i HTML w UTF-8. Raporty szablonów tekstowych i HTML zawierających wyłącznie ASCII, bez znacznika kolejności bajtów, są teraz zapisywane w UTF-8 zamiast windows-1252. Aby zachować jednowyjątkową stronę kodową, zadeklaruj ją w szablonie (<meta charset> w HTML).
  4. groupBy i distinct na zagnieżdżonych obiektach danych JSON, XML i DataSet teraz łączą równe obiekty zamiast tworzyć jedną grupę na wiersz.
  5. Brak dodatkowego akapitu po HTML. Tag -html kończący swój akapit nie pozostawia już pustego akapitu po HTML kończącym się elementem blokowym. Aby zachować pustą linię, zakończ HTML tagiem <p>&nbsp;</p>.
  6. Kody kreskowe DataBar Expanded. Kod kreskowy DataBar Expanded lub DataBar Expanded Stacked z tekstem kodu składającym się wyłącznie z cyfr jest teraz kodowany jako GTIN z identyfikatorem aplikacji (01), podobnie jak inne typy DataBar.
  7. Zmieniony tekst wyjątku dla tagu <<doc>> w szablonach arkusza, prezentacji i tekstu; typ wyjątku pozostaje ten sam.
  8. Usunięte API. ICustomFontsHandler.resetFontSources() zostało usunięte; zamiast tego wywołaj FontSettings.resetFontSources().

Nowe funkcje

Obsługa JSON Schema dla JsonDataSource

Szablon jest sprawdzany względem struktury swoich danych przed oceną jakiegokolwiek <<if>>. W przypadku JSON struktura była pobierana z samych danych, więc odwołanie wewnątrz gałęzi, która nigdy nie jest renderowana, kończyło się niepowodzeniem, gdy dane za nią były null, pustą tablicą lub brakowały.

JsonDataSource teraz akceptuje JSON Schema, tak jak XmlDataSource akceptuje XML Schema, a szablon jest sprawdzany względem schematu:

  • elementy zadeklarowane w schemacie mogą być odwoływane nawet jeśli są null, puste lub nieobecne w danych;
  • elementy niezadeklarowane w schemacie nadal powodują błąd, więc błędnie napisane nazwy są wykrywane jak wcześniej;
  • typy wartości pochodzą ze schematu, więc boolean jest Boolean, a ciąg zawierający cyfry pozostaje ciągiem.

Przykładowo, klient bez kart płatniczych i bez danych lojalnościowych, oraz numer konta będący ciągiem cyfr:

{ "Name": "Quayside Bistro", "Account": "00042", "Cards": [], "Loyalty": null }
{
  "$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" } } }
  }
}

oraz ten szablon:

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]>>

przekaż schemat obok danych:

JsonDataSource dataSource = new JsonDataSource("Customer.json", "Customer.schema.json");

DocumentAssembler assembler = new DocumentAssembler();
assembler.assembleDocument("Json schema.docx", "output.docx", new DataSourceInfo(dataSource, "customer"));

Wynikiem jest No payment card on file. z numerem konta 00042. Bez schematu ten sam szablon kończy się błędem przy customer.Cards.first().Type, a numer konta jest odczytywany jako liczba 42.

Schemat może być podany jako ścieżka do pliku lub InputStream, z lub bez JsonDataLoadOptions. Obsługiwane słowa kluczowe to type (w tym typy nullable), properties, items, format (date-time i date), enum, const, allOf oraz lokalne wskaźniki $ref. oneOf, anyOf, not, zdalne lub rekurencyjne $ref, items w formie krotki oraz tablice tablic nie są obsługiwane.

Podgląd dokumentu

DocumentAssembler.generatePreview renderuje strony dokumentu do obrazów PNG, JPEG lub BMP: szablon, dokument złożony przez GroupDocs.Assembly lub dowolny inny dokument obsługiwanego formatu, z pliku lub strumienia. Renderowane są strony dokumentów edytorów tekstu, tekstowych i HTML, wydrukowane strony arkuszy kalkulacyjnych, slajdy prezentacji oraz wiadomości e‑mail wraz z nagłówkiem.

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);

Gdy ustawione są zarówno setWidth, jak i setHeight, strony są skalowane, aby pasowały do tego rozmiaru, zachowując proporcje. Podglądy są generowane bez ładowania żadnych zewnętrznych zasobów, a wygenerowane obrazy są liczone w ramach licencjonowania rozliczanego, podobnie jak złożone dokumenty.

REMOVE_EMPTY_PARAGRAPHS dla szablonów arkuszy i zwykłego tekstu

DocumentAssemblyOptions.REMOVE_EMPTY_PARAGRAPHS działa teraz również dla szablonów arkuszy kalkulacyjnych i dokumentów zwykłego tekstu. W tym kontekście akapit to linia tekstu: linia tekstu komórki lub dokumentu tekstowego, która po przetworzeniu tagów szablonu staje się pusta, jest usuwana wraz ze znakiem końca linii. Tagów takich jak <<if>> i <<foreach>> zapisanych w osobnych liniach już nie pozostawia pustych linii.

DocumentAssembler assembler = new DocumentAssembler();
assembler.setOptions(DocumentAssemblyOptions.REMOVE_EMPTY_PARAGRAPHS);
assembler.assembleDocument("Empty paragraph.txt", "result.txt", new DataSourceInfo("dummy", "dummy"));

Template:

Prefix
<<if [false]>>
Text to be removed
<</if>>
Suffix

Result:

Prefix
Suffix

Ten sam tekst szablonu w komórce arkusza daje taki sam wynik w tej komórce. Dokumenty HTML i XML pozostają niezmienione.

Bezpieczeństwo: kontrola zewnętrznych zasobów

Tag <<image>> lub <<doc>> może ocenić się do URI pobranego z danych, a GroupDocs.Assembly pobierał go bez możliwości zapobieżenia temu. Serwer składający dokumenty z danych dostarczonych przez innych mógłby w ten sposób zostać zmuszony do żądania wewnętrznych adresów.

GroupDocs.Assembly teraz informuje, skąd pochodzi każde odwołanie do zewnętrznego zasobu (ExternalResourceOrigin):

  • TEMPLATE — dokument szablonu odwołuje się do zasobu bezpośrednio, w tym dosłowny URI w tagu takim jak <<image ["https://example.com/logo.png"]>>;
  • DATA — odwołanie pochodzi z danych, np. URI, do którego ocenia wyrażenie tagu.

Domyślnie zasoby odwoływane przez szablon są ładowane jak wcześniej, a zasoby, których odwołania pochodzą z danych, są pomijane. Cztery elementy LoadSaveOptions kontrolują to:

  • setSkipExternalResources (true domyślnie) — zewnętrzne zasoby nie są ładowane;
  • setTrustTemplateResources (true domyślnie) — zasoby odwoływane przez szablon są ładowane nawet gdy pomijanie jest włączone; ustaw false, gdy szablony pochodzą z niepewnych źródeł;
  • getWhitelistedResources — nazwy hostów lub absolutne prefiksy URI dozwolone nawet przy włączonym pomijaniu;
  • setExternalResourceHandler — ExternalResourceHandler wywoływany dla każdego zewnętrznego zasobu przed jego żądaniem, aby go zezwolić, pominąć lub dostarczyć jego zawartość.
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);
            }
        }
    }
}

Zewnętrzne zasoby to zasoby docierające do sieci: URI http, https i ftp, ścieżki UNC oraz URI plików zdalnych hostów. Lokalne ścieżki plików nie są dotknięte. Pomięty obraz w dokumencie jest zastępowany przez przezroczysty obraz; pominięta wartość <<image>> lub <<doc>> jest traktowana jako pusta wartość.

Ulepszenia

Obrazy w komórkach tabel i grupowych kształtach prezentacji

W szablonie prezentacji tag <<image>> mógł być umieszczony tylko w polu tekstowym. Komórka tabeli jest teraz również kontenerem obrazu: obraz staje się wypełnieniem komórki, w tym komórek wierszy powtarzanych przez <<foreach>>, więc można zbudować tabelę wymieniającą elementy wraz z ich obrazami. Z -fitHeight wiersz rośnie, aby pokazać obraz w jego proporcjach. Tagi w kształtach grupowych, w tym w zagnieżdżonych grupach, są teraz przetwarzane jak inne kształty.

Względne ścieżki obrazów rozwiązywane względem folderu szablonu

Tag <<image>>, który otrzymuje względną ścieżkę pliku z danych, np. Images/photo.png, teraz najpierw rozwiązuje ją względem folderu szablonu, analogicznie do powiązanych zasobów dokumentów Microsoft Office. Dla szablonu ładowanego ze strumienia ustaw folder przy pomocy 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"));
}

Jeśli tam nie istnieje plik, używany jest bieżący katalog, tak jak wcześniej.

Szesnastkowe ciągi kolorów

Kolor podany jako ciąg może teraz być wartością szesnastkową — "#RRGGBB", "#RGB" lub "#AARRGGBB" — oprócz nazwy koloru i liczby całkowitej ARGB, w tagach backColor i kolorach wykresów. Na przykład <<backColor [item.Color]>> z "#FF0000" pochodzącym z danych teraz stosuje czerwony.

Poprawki

  • Brakujące wartości Boolean w danych JSON, XML i CSV są teraz liczone jako false w operatorze warunkowym ?: oraz w predykatach where, count, any, all i first, zamiast powodować NullPointerException.
  • groupBy i distinct na zagnieżdżonych obiektach danych JSON i XML porównują obiekty według wartości, więc równi klienci tworzą jedną grupę. JSON zapisany z zachowanymi referencjami ($id/$ref) jest teraz obsługiwany.
  • License.setLicense(InputStream) odczytuje ByteArrayInputStream od swojego znacznika i FileInputStream od pozycji 0, więc strumień już użyty do licencjonowania innego produktu GroupDocs nie kończy się już błędem „Unexpected EOF in prolog”.
  • Zużycie rozliczane jest raportowane po zakończeniu składania dokumentu lub generowania podglądu, zamiast później z wątku w tle.
  • Raporty tekstowe i HTML szablonów zawierających wyłącznie ASCII są zapisywane w UTF-8, więc dane takie jak Café czy Привет nie są już tracone na rzecz windows-1252.
  • Kody kreskowe, których tekst kodu jest rysowany przez silnik (QR, DataMatrix, Aztec i inne) nie kończą się już błędem, gdy czcionka ich pola tekstowego nie jest zainstalowana — typowo Calibri na Linuksie. Zamiast tego używana jest czcionka zapasowa.
  • Szablony MSG: tagi w temacie konwersacji są przetwarzane jak te w temacie, więc Outlook prawidłowo wątkowo wyświetla wiadomości.
  • <<doc>> w szablonach arkusza, prezentacji i tekstu kończy się komunikatem, że tag nie jest obsługiwany dla tego formatu, a nieudane assembleDocument nie pozostawia już pustego pliku wyjściowego.
  • Zawartość HTML: tag wyrażenia -html kończący swój akapit nie pozostawia już dodatkowego pustego akapitu po HTML kończącym się elementem blokowym (ASSEMBLYJAVA-354).
  • Kody kreskowe GS1: GroupDocs.Assembly teraz samodzielnie koryguje teksty kodów składające się wyłącznie z cyfr dla kodów EAN-14, SCC-14, SSCC-18 i DataBar, ponieważ Aspose.BarCode 26.10 przestał to robić, więc te kody pozostają takie same jak w 26.10.1.

Silniki Aspose zaktualizowane do 26.10

GroupDocs.Assembly for Java 26.10.1 zawierał biblioteki Aspose z wczesnego 2026, więc luki naprawione w nich od tego czasu zostały wykryte przez skanery bezpieczeństwa. Dołączone silniki są teraz:

Silnik 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

Opublikowany plik POM nadal nie deklaruje zależności. Ponieważ silniki zostały odświeżone, wygenerowane dokumenty mogą różnić się na poziomie bajtów, pozostając jednocześnie wizualnie i funkcjonalnie równoważne. Jeśli porównujesz bajtowo wygenerowany wynik z przechowywanymi bazami, odśwież te bazy po aktualizacji.

Uwagi dla użytkowników Javy

  • Daty z Z lub offsetem w danych JSON lub CSV są wartościami java.util.Date tego dokładnego momentu, a wzorzec formatu wypisuje je w domyślnej strefie czasowej JVM. Aby uzyskać wynik niezależny od serwera, uruchom JVM z ustaloną strefą czasową, np. -Duser.timezone=UTC.
  • ExternalResourceOrigin i PreviewFormats są klasami stałych int, podobnie jak inne wyliczenia API Javy. CreatePageStream i ReleasePageStream są interfejsami funkcyjnymi, więc lambdy pasują.

Jak uzyskać aktualizację

Maven

Dodaj repozytorium GroupDocs i zależność do swojego 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>

Bezpośrednie pobranie

Pobierz plik JAR ze strony pobierania GroupDocs.Assembly for Java 26.11.

Zasoby