Chúng tôi vui mừng thông báo việc phát hành GroupDocs.Assembly for Java 26.11, có sẵn từ tháng 11 năm 2026. Bản phát hành này mang lại các tính năng và bản sửa lỗi của GroupDocs.Assembly for .NET 26.11 cho Java:

  • các mẫu có thể được kiểm tra dựa trên JSON Schema;
  • các trang của mẫu và báo cáo có thể được render thành hình ảnh;
  • việc tải các tài nguyên bên ngoài được kiểm soát bởi ứng dụng;
  • REMOVE_EMPTY_PARAGRAPHS hoạt động cho các mẫu bảng tính và văn bản thuần;
  • <<image>> hoạt động trong ô bảng của bản trình bày và giải quyết đường dẫn tương đối so với thư mục mẫu;
  • các thẻ màu chấp nhận chuỗi hex.

Các engine Aspose được đóng gói chuyển từ các phiên bản đầu năm 2026 sang 26.10, và một số bản sửa lỗi bao gồm cấp phép, mã hoá báo cáo, mã vạch và nội dung HTML. Java 8 vẫn là nền tảng cơ bản.

Những điểm mới trong bản phát hành này

Khóa Tóm tắt Thể loại
ASSEMBLYNET-145 JsonDataSource chấp nhận một JSON Schema: các thành viên được khai báo trong schema có thể được tham chiếu ngay cả khi chúng null, rỗng hoặc thiếu trong dữ liệu, và kiểu giá trị được lấy từ schema Tính năng
ASSEMBLYNET-8 DocumentAssembler.generatePreview render các trang của mẫu, báo cáo đã lắp ráp và các tài liệu khác thành hình ảnh PNG, JPEG hoặc BMP Tính năng
ASSEMBLYNET-36, ASSEMBLYNET-37 DocumentAssemblyOptions.REMOVE_EMPTY_PARAGRAPHS hoạt động cho các mẫu bảng tính và tài liệu văn bản thuần Tính năng
ASSEMBLYNET-140 Các tài nguyên bên ngoài được tham chiếu bởi mẫu và dữ liệu nằm dưới sự kiểm soát của ứng dụng; các tài nguyên có tham chiếu đến từ dữ liệu sẽ bị bỏ qua theo mặc định Bảo mật
ASSEMBLYJAVA-353 Aspose.Words 26.10.1, Aspose.Cells 26.10, Aspose.Slides 26.10, Aspose.Email 26.9 và Aspose.BarCode 26.10 được đóng gói Cập nhật
ASSEMBLYJAVA-353 Mã vạch GS1 (EAN-14, SCC-14, SSCC-18 và DataBar) giữ tính tự động sửa chữa văn bản mã của chúng với Aspose.BarCode 26.10 Sửa lỗi
ASSEMBLYNET-52 Thẻ <<image>> hoạt động trong một ô bảng của bản trình bày, và các thẻ trong hình dạng của nhóm hình dạng được xử lý Cải tiến
ASSEMBLYNET-62 Đường dẫn hình ảnh tương đối từ dữ liệu được giải quyết so với thư mục của mẫu Cải tiến
ASSEMBLYNET-25 Màu được cung cấp dưới dạng chuỗi có thể là giá trị hex trong backColor và các thẻ màu biểu đồ Cải tiến
ASSEMBLYNET-155 Một Boolean thiếu trong dữ liệu JSON, XML hoặc CSV được tính là false trong ?: và trong where, count, any, all và first thay vì gây lỗi Sửa lỗi
ASSEMBLYNET-157 groupBy và distinct trên các đối tượng lồng nhau hợp nhất các đối tượng bằng nhau; các tham chiếu $id/$ref của dữ liệu JSON được hỗ trợ Sửa lỗi
ASSEMBLYNET-142 License.setLicense(InputStream) đọc một luồng đã được đọc từ đầu Sửa lỗi
ASSEMBLYNET-143 Việc tiêu thụ giấy phép tính theo mức được báo cáo khi một thao tác hoàn thành Sửa lỗi
ASSEMBLYNET-158 Các báo cáo văn bản và HTML của các mẫu chỉ chứa ASCII được ghi bằng UTF-8, vì vậy dữ liệu không phải Latin không còn bị mất Sửa lỗi
ASSEMBLYNET-160 Mã vạch không còn gây lỗi NullPointerException khi phông chữ của hộp văn bản không được cài đặt Sửa lỗi
ASSEMBLYNET-159 Các thẻ trong tiêu đề cuộc trò chuyện của mẫu MSG được lắp ráp giống như các thẻ trong tiêu đề của nó Sửa lỗi
ASSEMBLYNET-152 Thẻ <<doc>> trong một mẫu bảng tính, bản trình bày hoặc văn bản sẽ thất bại với thông báo rõ ràng; một assembleDocument thất bại sẽ không để lại tệp đầu ra rỗng Sửa lỗi
ASSEMBLYJAVA-354 Thẻ biểu thức -html kết thúc đoạn văn của nó không còn để lại đoạn trống sau HTML kết thúc bằng một phần tử khối Sửa lỗi

Thay đổi hành vi cần kiểm tra trước khi nâng cấp

  1. Các tài nguyên bên ngoài từ dữ liệu được bỏ qua theo mặc định. Ví dụ, <<image [item.PhotoUrl]>> trong đó PhotoUrl là một URI http hoặc https hiện sẽ cho một hình ảnh trống. Thêm các máy chủ vào LoadSaveOptions.getWhitelistedResources(), hoặc gọi LoadSaveOptions.setSkipExternalResources(false) để giữ lại hành vi trước. Các tài nguyên được tham chiếu bởi chính mẫu và các đường dẫn tệp cục bộ vẫn hoạt động như trước.
  2. Lời gọi JsonDataSource mơ hồ. new JsonDataSource(path, null) với đối số thứ hai là null nguyên gốc không còn biên dịch được. Ép kiểu đối số: new JsonDataSource(path, (JsonDataLoadOptions) null). Các ứng dụng đã biên dịch không bị ảnh hưởng.
  3. Báo cáo văn bản và HTML UTF-8. Các báo cáo của các mẫu văn bản và HTML chỉ chứa ASCII mà không có dấu byte order mark hiện được ghi bằng UTF-8 thay vì windows-1252. Để giữ một trang mã một byte, khai báo nó trong mẫu (<meta charset> trong HTML).
  4. groupBy và distinct trên các đối tượng lồng nhau của dữ liệu JSON, XML và DataSet hiện hợp nhất các đối tượng bằng nhau thay vì tạo một nhóm cho mỗi hàng.
  5. Không có đoạn trống thêm sau HTML. Thẻ -html kết thúc đoạn của nó không còn để lại đoạn trống sau HTML kết thúc bằng một phần tử khối. Để giữ một dòng trống, kết thúc HTML bằng <p>&nbsp;</p>.
  6. Mã vạch DataBar Expanded. Một mã vạch DataBar Expanded hoặc DataBar Expanded Stacked với văn bản mã chỉ gồm các chữ số hiện được mã hoá như một GTIN với định danh ứng dụng (01), giống như các loại DataBar khác.
  7. Văn bản ngoại lệ đã thay đổi cho thẻ <<doc>> trong các mẫu bảng tính, bản trình bày và văn bản; loại ngoại lệ vẫn giống nhau.
  8. API đã bị loại bỏ. ICustomFontsHandler.resetFontSources() đã bị loại bỏ; thay vào đó gọi FontSettings.resetFontSources().

Tính năng mới

Hỗ trợ JSON Schema cho JsonDataSource

Một mẫu được kiểm tra dựa trên cấu trúc của dữ liệu trước khi bất kỳ <<if>> nào được đánh giá. Với JSON, cấu trúc đó thường được lấy từ chính dữ liệu, vì vậy một tham chiếu bên trong một nhánh không bao giờ được render sẽ thất bại khi dữ liệu phía sau nó là null, mảng rỗng hoặc thiếu.

JsonDataSource hiện chấp nhận một JSON Schema, tương tự như XmlDataSource chấp nhận một XML Schema, và mẫu được kiểm tra dựa trên schema:

  • các thành viên được khai báo trong schema có thể được tham chiếu ngay cả khi chúng null, rỗng hoặc không có trong dữ liệu;
  • các thành viên không được khai báo trong schema vẫn sẽ gây lỗi, vì vậy các tên sai chính tả vẫn được phát hiện như trước;
  • kiểu giá trị được lấy từ schema, vì vậy một boolean là Boolean và một chuỗi chứa các chữ số vẫn là chuỗi.

Cho một khách hàng không có thẻ thanh toán và không có dữ liệu khách hàng thân thiết, và một số tài khoản là một chuỗi các chữ số:

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

và mẫu này:

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

đưa schema bên cạnh dữ liệu:

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

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

Kết quả là No payment card on file. với số tài khoản 00042. Nếu không có schema, cùng một mẫu sẽ thất bại ở customer.Cards.first().Type, và số tài khoản sẽ được đọc như số 42.

Schema có thể được cung cấp dưới dạng đường dẫn tệp hoặc một InputStream, có hoặc không có JsonDataLoadOptions. Các từ khóa được hỗ trợ là type (bao gồm các kiểu nullable), properties, items, format (date-time và date), enum, const, allOf và các con trỏ $ref cục bộ. oneOf, anyOf, not, $ref từ xa hoặc đệ quy, items dạng tuple và mảng các mảng không được hỗ trợ.

Xem trước tài liệu

DocumentAssembler.generatePreview render các trang của một tài liệu thành hình ảnh PNG, JPEG hoặc BMP: một mẫu, một tài liệu được lắp ráp bởi GroupDocs.Assembly, hoặc bất kỳ tài liệu nào khác ở định dạng được hỗ trợ, từ tệp hoặc luồng. Các trang của tài liệu xử lý văn bản, văn bản và HTML, các trang đã in của bảng tính, các slide của bản trình bày và các tin nhắn email cùng phần đầu của chúng được render.

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

Khi cả setWidth và setHeight đều được đặt, các trang sẽ được thu phóng để vừa với kích thước đó đồng thời giữ tỷ lệ khung hình của chúng. Các bản xem trước được tạo mà không tải bất kỳ tài nguyên bên ngoài nào, và các hình ảnh được tạo sẽ được tính vào giấy phép tính theo mức giống như các tài liệu đã lắp ráp.

REMOVE_EMPTY_PARAGRAPHS cho các mẫu bảng tính và văn bản thuần

DocumentAssemblyOptions.REMOVE_EMPTY_PARAGRAPHS hiện hoạt động cho các mẫu bảng tính và tài liệu văn bản thuần. Ở đây, một đoạn là một dòng văn bản: một dòng trong văn bản của ô, hoặc của tài liệu văn bản, mà trở nên rỗng sau khi các thẻ mẫu được xử lý sẽ bị xóa cùng với ký tự ngắt dòng của nó. Các thẻ như <<if>> và <<foreach>> được viết trên các dòng riêng không còn để lại các dòng trống phía sau.

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

Mẫu:

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

Kết quả:

Prefix
Suffix

Văn bản mẫu tương tự trong một ô bảng tính sẽ cho cùng một kết quả trong ô. Các tài liệu HTML và XML vẫn giữ nguyên.

Bảo mật: kiểm soát tài nguyên bên ngoài

Một thẻ <<image>> hoặc <<doc>> có thể đánh giá thành một URI lấy từ dữ liệu, và GroupDocs.Assembly trước đây sẽ lấy nó mà không có cách nào ngăn chặn. Do đó, một máy chủ lắp ráp tài liệu từ dữ liệu do người khác cung cấp có thể bị buộc phải yêu cầu các địa chỉ nội bộ.

GroupDocs.Assembly hiện cho biết mỗi tham chiếu tới tài nguyên bên ngoài đến từ đâu (ExternalResourceOrigin):

  • TEMPLATE — tài liệu mẫu tham chiếu trực tiếp tới tài nguyên, bao gồm một URI nguyên gốc trong thẻ như <<image ["https://example.com/logo.png"]>>;
  • DATA — tham chiếu đến từ dữ liệu, chẳng hạn một URI mà biểu thức thẻ đánh giá thành.

Theo mặc định, các tài nguyên được tham chiếu bởi mẫu sẽ được tải như trước, và các tài nguyên có tham chiếu đến từ dữ liệu sẽ bị bỏ qua. Bốn thành viên của LoadSaveOptions kiểm soát điều này:

  • setSkipExternalResources (true theo mặc định) — tài nguyên bên ngoài không được tải;
  • setTrustTemplateResources (true theo mặc định) — các tài nguyên được tham chiếu bởi mẫu sẽ được tải ngay cả khi việc bỏ qua đang bật; đặt thành false khi các mẫu đến từ nguồn không tin cậy;
  • getWhitelistedResources — tên máy chủ hoặc tiền tố URI tuyệt đối được cho phép ngay cả khi việc bỏ qua đang bật;
  • setExternalResourceHandler — một ExternalResourceHandler được gọi cho mỗi tài nguyên bên ngoài trước khi nó được yêu cầu, để cho phép, bỏ qua hoặc cung cấp nội dung của nó.
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);
            }
        }
    }
}

Các tài nguyên bên ngoài là các tài nguyên tiếp cận mạng: các URI http, https và ftp, các đường dẫn UNC và các URI file có máy chủ từ xa. Các đường dẫn tệp cục bộ không bị ảnh hưởng. Một hình ảnh bị bỏ qua trong tài liệu sẽ được thay thế bằng một hình ảnh trong suốt; một giá trị <<image>> hoặc <<doc>> bị bỏ qua sẽ được xử lý như một giá trị rỗng.

Cải tiến

Hình ảnh trong ô bảng và nhóm hình dạng của bản trình bày

Trong một mẫu bản trình bày, thẻ <<image>> chỉ có thể được đặt trong một hộp văn bản. Hiện một ô bảng cũng là một vùng chứa hình ảnh: hình ảnh sẽ trở thành nền ảnh của ô, bao gồm các ô của các hàng được lặp lại bằng <<foreach>>, vì vậy có thể xây dựng một bảng liệt kê các mục cùng hình ảnh của chúng. Với -fitHeight, hàng sẽ mở rộng để hiển thị hình ảnh với tỷ lệ khung hình của nó. Các thẻ trong các hình dạng của nhóm hình dạng, bao gồm các nhóm lồng nhau, hiện được xử lý giống như các hình dạng khác.

Đường dẫn hình ảnh tương đối được giải quyết so với thư mục mẫu

Thẻ <<image>> nhận một đường dẫn tệp tương đối từ dữ liệu, chẳng hạn Images/photo.png, hiện sẽ giải quyết nó so với thư mục của mẫu trước, tương tự như các tài nguyên liên kết của tài liệu Microsoft Office. Đối với một mẫu được tải từ luồng, đặt thư mục bằng 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"));
}

Nếu không có tệp nào tồn tại ở đó, thư mục hiện tại sẽ được sử dụng như trước.

Chuỗi màu hex

Một màu được cung cấp dưới dạng chuỗi hiện có thể là một giá trị hex — "#RRGGBB", "#RGB" hoặc "#AARRGGBB" — bên cạnh tên màu và một số nguyên ARGB, trong các thẻ backColor và thẻ màu biểu đồ. Ví dụ, <<backColor [item.Color]>> với "#FF0000" đến từ dữ liệu hiện áp dụng màu đỏ.

Sửa lỗi

  • Các Boolean thiếu trong dữ liệu JSON, XML và CSV hiện được tính là false trong toán tử điều kiện ?: và trong các điều kiện của where, count, any, all và first, thay vì gây lỗi NullPointerException.
  • groupBy và distinct trên các đối tượng lồng nhau của dữ liệu JSON và XML so sánh các đối tượng theo giá trị, vì vậy các khách hàng bằng nhau tạo thành một nhóm. JSON được viết với các tham chiếu được bảo tồn ($id/$ref) hiện được hỗ trợ.
  • License.setLicense(InputStream) đọc một ByteArrayInputStream từ dấu đánh dấu và một FileInputStream từ vị trí 0, vì vậy một luồng đã được dùng để cấp phép cho sản phẩm GroupDocs khác không còn thất bại với “Unexpected EOF in prolog”.
  • Việc tiêu thụ tính theo mức được báo cáo khi việc lắp ráp tài liệu hoặc tạo bản xem trước hoàn thành, thay vì sau đó từ một luồng nền.
  • Các báo cáo văn bản và HTML của các mẫu chỉ chứa ASCII được ghi bằng UTF-8, vì vậy dữ liệu như Café hoặc Привет không còn bị mất vào windows-1252.
  • Mã vạch mà văn bản mã được vẽ bởi engine (QR, DataMatrix, Aztec và các loại khác) không còn gây lỗi khi phông chữ của hộp văn bản không được cài đặt — thường là Calibri trên Linux. Thay vào đó sẽ sử dụng một phông chữ dự phòng.
  • Mẫu MSG: các thẻ trong tiêu đề cuộc trò chuyện được xử lý giống như các thẻ trong tiêu đề, vì vậy Outlook sẽ xâu chuỗi các tin nhắn một cách chính xác.
  • <<doc>> trong các mẫu bảng tính, bản trình bày và văn bản thất bại với một thông báo cho biết thẻ không được hỗ trợ cho định dạng, và một assembleDocument thất bại sẽ không để lại tệp đầu ra rỗng.
  • Nội dung HTML: một thẻ biểu thức -html kết thúc đoạn của nó không còn để lại một đoạn trống thêm sau HTML kết thúc bằng một phần tử khối (ASSEMBLYJAVA-354).
  • Mã vạch GS1: GroupDocs.Assembly hiện tự sửa các văn bản mã chỉ gồm chữ số của các mã vạch EAN-14, SCC-14, SSCC-18 và DataBar, vì Aspose.BarCode 26.10 đã ngừng thực hiện, vì vậy các mã vạch này vẫn giống như trong 26.10.1.

Các engine Aspose được nâng cấp lên 26.10

GroupDocs.Assembly for Java 26.10.1 đã đóng gói các thư viện Aspose từ đầu năm 2026, vì vậy các lỗ hổng đã được khắc phục trong chúng kể từ đó đã được các công cụ quét bảo mật báo cáo. Các engine được đóng gói hiện là:

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

POM được công bố vẫn không khai báo bất kỳ phụ thuộc nào. Vì các engine đã được làm mới, các tài liệu được tạo lại có thể khác nhau ở mức byte trong khi vẫn tương đương về mặt hình ảnh và chức năng. Nếu bạn so sánh byte đầu ra được tạo với các baseline đã lưu, hãy làm mới các baseline đó sau khi nâng cấp.

Ghi chú cho người dùng Java

  • Ngày với Z hoặc một độ lệch trong dữ liệu JSON hoặc CSV là các giá trị java.util.Date của thời điểm chính xác đó, và một mẫu định dạng sẽ in chúng theo múi giờ mặc định của JVM. Để đầu ra không phụ thuộc vào máy chủ, chạy JVM với một múi giờ cố định, ví dụ -Duser.timezone=UTC.
  • ExternalResourceOrigin và PreviewFormats là các lớp chứa các hằng số int, giống như các enum khác của Java API. CreatePageStream và ReleasePageStream là các giao diện chức năng, vì vậy các lambda phù hợp.

Cách nhận bản cập nhật

Maven

Thêm kho GroupDocs và phụ thuộc vào pom.xml của bạn:

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

Tải trực tiếp

Tải JAR từ trang tải xuống GroupDocs.Assembly for Java 26.11.

Tài nguyên