Kami dengan senang hati mengumumkan rilis GroupDocs.Assembly for Java 26.11, tersedia sejak November 2026. Rilis ini membawa fitur dan perbaikan dari GroupDocs.Assembly untuk .NET 26.11 ke Java:

  • template dapat diperiksa terhadap JSON Schema;
  • halaman template dan laporan dapat dirender menjadi gambar;
  • pemuatan sumber daya eksternal berada di bawah kontrol aplikasi;
  • REMOVE_EMPTY_PARAGRAPHS berfungsi untuk template spreadsheet dan teks biasa;
  • tag <<image>> berfungsi di sel tabel presentasi dan menyelesaikan jalur relatif terhadap folder template;
  • tag warna menerima string heks.

Mesin Aspose yang dibundel berpindah dari versi awal 2026 mereka ke 26.10, dan sejumlah perbaikan mencakup lisensi, pengkodean laporan, kode batang, dan konten HTML. Java 8 tetap menjadi dasar.

Apa yang baru dalam rilis ini

Kunci Ringkasan Kategori
ASSEMBLYNET-145 JsonDataSource menerima JSON Schema: anggota yang dideklarasikan dalam skema dapat direferensikan bahkan ketika mereka null, kosong atau tidak ada dalam data, dan tipe nilai diambil dari skema Fitur
ASSEMBLYNET-8 DocumentAssembler.generatePreview merender halaman template, laporan yang dirakit, dan dokumen lain menjadi gambar PNG, JPEG, atau BMP Fitur
ASSEMBLYNET-36, ASSEMBLYNET-37 DocumentAssemblyOptions.REMOVE_EMPTY_PARAGRAPHS berfungsi untuk template spreadsheet dan dokumen teks biasa Fitur
ASSEMBLYNET-140 Sumber daya eksternal yang direferensikan oleh template dan data berada di bawah kontrol aplikasi; sumber daya yang referensinya berasal dari data secara default diabaikan Keamanan
ASSEMBLYJAVA-353 Aspose.Words 26.10.1, Aspose.Cells 26.10, Aspose.Slides 26.10, Aspose.Email 26.9, dan Aspose.BarCode 26.10 disertakan Pembaruan
ASSEMBLYJAVA-353 Barcode GS1 (EAN-14, SCC-14, SSCC-18, dan DataBar) mempertahankan koreksi otomatis teks kode mereka dengan Aspose.BarCode 26.10 Perbaikan
ASSEMBLYNET-52 Tag <<image>> berfungsi di sel tabel presentasi, dan tag dalam bentuk grup bentuk diproses Peningkatan
ASSEMBLYNET-62 Jalur gambar relatif dari data diselesaikan terhadap folder template Peningkatan
ASSEMBLYNET-25 Warna yang diberikan sebagai string dapat berupa nilai heks dalam backColor dan tag warna diagram Peningkatan
ASSEMBLYNET-155 Boolean yang hilang dalam data JSON, XML, atau CSV dihitung sebagai false dalam ?: serta dalam where, count, any, all, dan first alih-alih gagal dengan NullPointerException Perbaikan
ASSEMBLYNET-157 groupBy dan distinct pada objek bersarang menggabungkan objek yang sama; referensi $id/$ref pada data JSON didukung Perbaikan
ASSEMBLYNET-142 License.setLicense(InputStream) membaca aliran yang sudah dibaca dari awalnya Perbaikan
ASSEMBLYNET-143 Konsumsi lisensi bermeter dilaporkan ketika operasi selesai Perbaikan
ASSEMBLYNET-158 Laporan teks dan HTML dari template hanya ASCII ditulis dalam UTF-8, sehingga data non-Latin tidak lagi hilang Perbaikan
ASSEMBLYNET-160 Barcode tidak lagi gagal dengan NullPointerException ketika font kotak teks mereka tidak terpasang Perbaikan
ASSEMBLYNET-159 Tag dalam topik percakapan template MSG dirakit seperti tag pada subjeknya Perbaikan
ASSEMBLYNET-152 Tag <<doc>> dalam spreadsheet, presentasi, atau template teks gagal dengan pesan yang jelas; assembleDocument yang gagal tidak lagi meninggalkan file output kosong Perbaikan
ASSEMBLYJAVA-354 Tag ekspresi -html yang mengakhiri paragrafnya tidak lagi meninggalkan paragraf kosong setelah HTML yang berakhir dengan elemen blok Perbaikan

Perubahan perilaku yang perlu diperiksa sebelum memperbarui

  1. Sumber daya eksternal dari data diabaikan secara default. Misalnya, <<image [item.PhotoUrl]>> dimana PhotoUrl adalah URI http atau https kini menghasilkan gambar kosong. Tambahkan host ke LoadSaveOptions.getWhitelistedResources(), atau panggil LoadSaveOptions.setSkipExternalResources(false) untuk mempertahankan perilaku sebelumnya. Sumber daya yang direferensikan oleh template itu sendiri dan jalur file lokal tetap berfungsi seperti sebelumnya.
  2. Pemanggilan JsonDataSource yang ambigu. new JsonDataSource(path, null) dengan argumen kedua literal null tidak lagi dapat dikompilasi. Cast argumen tersebut: new JsonDataSource(path, (JsonDataLoadOptions) null). Aplikasi yang sudah dikompilasi tidak terpengaruh.
  3. Laporan teks dan HTML UTF-8. Laporan dari template teks dan HTML yang hanya ASCII tanpa byte order mark kini ditulis dalam UTF-8 alih-alih windows-1252. Untuk mempertahankan halaman kode satu byte, deklarasikan dalam template (<meta charset> di HTML).
  4. groupBy dan distinct pada objek bersarang dalam data JSON, XML, dan DataSet kini menggabungkan objek yang sama alih-alih memberikan satu grup per baris.
  5. Tidak ada paragraf ekstra setelah HTML. Tag -html yang mengakhiri paragrafnya tidak lagi meninggalkan paragraf kosong setelah HTML yang berakhir dengan elemen blok. Untuk mempertahankan baris kosong, akhiri HTML dengan <p>&nbsp;</p>.
  6. Barcode DataBar Expanded. Barcode DataBar Expanded atau DataBar Expanded Stacked dengan teks kode hanya angka kini dienkode sebagai GTIN dengan identifier aplikasi (01), seperti tipe DataBar lainnya.
  7. Teks pengecualian diubah untuk tag <<doc>> dalam spreadsheet, presentasi, dan template teks; tipe pengecualian tetap sama.
  8. API dihapus. ICustomFontsHandler.resetFontSources() dihapus; gunakan FontSettings.resetFontSources() sebagai gantinya.

Fitur baru

Dukungan JSON Schema untuk JsonDataSource

Template diperiksa terhadap struktur datanya sebelum ada <<if>> yang dievaluasi. Dengan JSON, struktur itu biasanya diambil dari data itu sendiri, sehingga referensi di dalam cabang yang tidak pernah dirender gagal ketika data di belakangnya null, array kosong, atau tidak ada.

JsonDataSource kini menerima JSON Schema, sama seperti XmlDataSource menerima XML Schema, dan template diperiksa terhadap skema:

  • anggota yang dideklarasikan dalam skema dapat direferensikan bahkan jika mereka null, kosong, atau tidak ada dalam data;
  • anggota yang tidak dideklarasikan dalam skema tetap gagal, sehingga nama yang salah eja terdeteksi seperti sebelumnya;
  • tipe nilai diambil dari skema, sehingga boolean menjadi Boolean dan string yang berisi digit tetap menjadi string.

Diberikan seorang pelanggan tanpa kartu pembayaran dan tanpa data loyalti, serta nomor akun yang berupa string digit:

{ "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" } } }
  }
}

dan template ini:

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

lewatkan skema bersamaan dengan data:

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

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

Hasilnya adalah No payment card on file. dengan nomor akun 00042. Tanpa skema, template yang sama gagal pada customer.Cards.first().Type, dan nomor akun dibaca sebagai angka 42.

Skema dapat diberikan sebagai jalur file atau InputStream, dengan atau tanpa JsonDataLoadOptions. Kata kunci yang didukung adalah type (termasuk tipe nullable), properties, items, format (date-time dan date), enum, const, allOf dan pointer $ref lokal. oneOf, anyOf, not, $ref remote atau rekursif, items bentuk tuple, dan array dalam array tidak didukung.

Pratinjau Dokumen

DocumentAssembler.generatePreview merender halaman dokumen menjadi gambar PNG, JPEG, atau BMP: sebuah template, dokumen yang dirakit oleh GroupDocs.Assembly, atau dokumen lain dalam format yang didukung, dari file atau aliran. Halaman dokumen pengolah kata, teks, dan HTML, halaman cetak spreadsheet, slide presentasi, dan pesan email beserta headernya dirender.

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

Ketika baik setWidth maupun setHeight diatur, halaman diskalakan agar sesuai ukuran tersebut sambil mempertahankan rasio aspek. Pratinjau dihasilkan tanpa memuat sumber daya eksternal, dan gambar yang dihasilkan dihitung oleh lisensi bermeter seperti dokumen yang dirakit.

REMOVE_EMPTY_PARAGRAPHS untuk template spreadsheet dan teks biasa

DocumentAssemblyOptions.REMOVE_EMPTY_PARAGRAPHS kini berfungsi untuk template spreadsheet dan dokumen teks biasa juga. Di sana, paragraf adalah baris teks: baris teks sel, atau dokumen teks, yang menjadi kosong setelah tag template diproses akan dihapus bersama dengan pemutus barisnya. Tag seperti <<if>> dan <<foreach>> yang ditulis pada barisnya sendiri tidak lagi meninggalkan baris kosong.

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

Teks template yang sama dalam sel spreadsheet memberikan hasil yang sama di dalam sel. Dokumen HTML dan XML tetap seperti semula.

Keamanan: kontrol sumber daya eksternal

Tag <<image>> atau <<doc>> dapat dievaluasi menjadi URI yang diambil dari data, dan GroupDocs.Assembly sebelumnya mengambilnya tanpa cara untuk mencegahnya. Sebuah server yang merakit dokumen dari data yang diberikan orang lain dapat dipaksa untuk meminta alamat internal.

GroupDocs.Assembly kini memberi tahu dari mana setiap referensi ke sumber daya eksternal berasal (ExternalResourceOrigin):

  • TEMPLATE — dokumen template mereferensikan sumber daya itu sendiri, termasuk URI literal dalam tag seperti <<image ["https://example.com/logo.png"]>>;
  • DATA — referensi berasal dari data, seperti URI yang dihasilkan oleh ekspresi tag.

Secara default, sumber daya yang direferensikan oleh template dimuat seperti sebelumnya, dan sumber daya yang referensinya berasal dari data diabaikan. Empat anggota LoadSaveOptions mengontrol ini:

  • setSkipExternalResources (true secara default) — sumber daya eksternal tidak dimuat;
  • setTrustTemplateResources (true secara default) — sumber daya yang direferensikan oleh template dimuat meskipun pengabaian diaktifkan; set ke false ketika template berasal dari sumber yang tidak terpercaya;
  • getWhitelistedResources — nama host atau awalan URI absolut yang diizinkan meskipun pengabaian diaktifkan;
  • setExternalResourceHandler — sebuah ExternalResourceHandler dipanggil untuk setiap sumber daya eksternal sebelum diminta, untuk mengizinkannya, melewatinya, atau menyediakan kontennya.
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);
            }
        }
    }
}

Sumber daya eksternal adalah sumber daya yang menjangkau jaringan: URI http, https, dan ftp, jalur UNC, serta URI file dengan host remote. Jalur file lokal tidak terpengaruh. Gambar yang diabaikan dalam dokumen digantikan dengan gambar transparan; nilai <<image>> atau <<doc>> yang diabaikan diperlakukan sebagai nilai kosong.

Peningkatan

Gambar dalam sel tabel dan grup bentuk pada presentasi

Pada template presentasi, tag <<image>> hanya dapat ditempatkan di kotak teks. Sekarang sel tabel juga menjadi kontainer gambar: gambar menjadi isian gambar sel, termasuk sel pada baris yang diulang oleh <<foreach>>, sehingga dapat dibuat tabel yang menampilkan item beserta gambar mereka. Dengan -fitHeight, baris akan memperbesar untuk menampilkan gambar dengan rasio aspeknya. Tag dalam bentuk grup bentuk, termasuk grup bersarang, kini diproses seperti bentuk lainnya.

Jalur gambar relatif diselesaikan terhadap folder template

Tag <<image>> yang mendapatkan jalur file relatif dari data, seperti Images/photo.png, kini pertama-tama menyelesaikannya terhadap folder template, mirip dengan sumber daya tertaut pada dokumen Microsoft Office. Untuk template yang dimuat dari aliran, atur folder dengan 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"));
}

Jika tidak ada file di sana, direktori saat ini digunakan seperti sebelumnya.

String warna heks

Warna yang diberikan sebagai string kini dapat berupa nilai heks — "#RRGGBB", "#RGB" atau "#AARRGGBB" — selain nama warna dan integer ARGB, dalam tag backColor dan tag warna diagram. Misalnya, <<backColor [item.Color]>> dengan "#FF0000" yang berasal dari data kini menghasilkan warna merah.

Perbaikan

  • Boolean yang hilang pada data JSON, XML, dan CSV kini dihitung sebagai false dalam operator kondisional ?: serta dalam predikat where, count, any, all, dan first, alih-alih gagal dengan NullPointerException.
  • groupBy dan distinct pada objek bersarang data JSON dan XML membandingkan objek berdasarkan nilai, sehingga pelanggan yang sama menjadi satu grup. JSON yang ditulis dengan referensi yang dipertahankan ($id/$ref) kini didukung.
  • License.setLicense(InputStream) membaca ByteArrayInputStream dari tanda (mark) dan FileInputStream dari posisi 0, sehingga aliran yang sudah digunakan untuk melisensikan produk GroupDocs lain tidak lagi gagal dengan “Unexpected EOF in prolog”.
  • Konsumsi bermeter dilaporkan ketika perakitan dokumen atau pembuatan pratinjau selesai, alih-alih kemudian dari thread latar belakang.
  • Laporan teks dan HTML dari template yang hanya ASCII ditulis dalam UTF-8, sehingga data seperti Café atau Привет tidak lagi hilang ke windows-1252.
  • Barcode yang teks kodenya digambar oleh mesin (QR, DataMatrix, Aztec, dan lainnya) tidak lagi gagal ketika font kotak teksnya tidak terpasang — biasanya Calibri di Linux. Font cadangan digunakan sebagai gantinya.
  • Template MSG: tag dalam topik percakapan diproses seperti tag pada subjek, sehingga Outlook menelusuri pesan dengan benar.
  • <<doc>> dalam spreadsheet, presentasi, dan template teks gagal dengan pesan yang menyatakan tag tidak didukung untuk format tersebut, dan assembleDocument yang gagal tidak lagi meninggalkan file output kosong.
  • Konten HTML: tag ekspresi -html yang mengakhiri paragrafnya tidak lagi meninggalkan paragraf kosong tambahan setelah HTML yang berakhir dengan elemen blok (ASSEMBLYJAVA-354).
  • Barcode GS1: GroupDocs.Assembly kini memperbaiki teks kode yang hanya berisi digit pada barcode EAN-14, SCC-14, SSCC-18, dan DataBar sendiri, karena Aspose.BarCode 26.10 berhenti melakukannya, sehingga barcode ini tetap sama seperti di 26.10.1.

Mesin Aspose ditingkatkan ke 26.10

GroupDocs.Assembly untuk Java 26.10.1 menyertakan pustaka Aspose dari awal 2026, sehingga kerentanan yang diperbaiki di dalamnya sejak saat itu dilaporkan oleh pemindai keamanan. Mesin yang disertakan kini:

Mesin 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

POM yang dipublikasikan masih tidak menyatakan dependensi. Karena mesin diperbarui, dokumen yang dihasilkan ulang mungkin berbeda pada level byte meskipun tetap secara visual dan fungsional setara. Jika Anda membandingkan byte output yang dihasilkan dengan baseline yang disimpan, segarkan baseline tersebut setelah memperbarui.

Catatan untuk pengguna Java

  • Tanggal dengan Z atau offset dalam data JSON atau CSV adalah nilai java.util.Date pada saat tepat itu, dan pola format mencetaknya dalam zona waktu default JVM. Untuk output yang tidak bergantung pada server, jalankan JVM dengan zona waktu tetap, misalnya -Duser.timezone=UTC.
  • ExternalResourceOrigin dan PreviewFormats adalah kelas konstanta int, seperti enumerasi lain pada API Java. CreatePageStream dan ReleasePageStream adalah antarmuka fungsional, sehingga lambda dapat digunakan.

Cara mendapatkan pembaruan

Maven

Tambahkan repositori GroupDocs dan dependensi ke pom.xml Anda:

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

Unduhan langsung

Unduh JAR dari halaman unduhan GroupDocs.Assembly for Java 26.11.

Sumber daya