Aspose.Email for Java 25.2 Release Notes

All Changes

New Features

1. Support for Filtering or Searching Messages in MBOX Files

Aspose.Email for Java now provides the ability to filter or search messages within MBOX files using a query. This enhancement allows developers to efficiently retrieve only the messages that match specific criteria, improving performance and usability when working with large MBOX files.

API Changes:

• Added enumerateMessages(MailQuery query), which returns an enumerable collection of MailMessage instances that match the specified query.
• Added enumerateMessageInfo(MailQuery query), which returns an enumerable collection of MboxMessageInfo instances that match the specified query.

Code Example:

MboxStorageReader reader = MboxStorageReader.createReader("input.mbox", new MboxLoadOptions());
MailQueryBuilder mqb = new MailQueryBuilder();
mqb.getSubject().contains("Project Update");
mqb.getSentDate().before(new Date());

for (MailMessage message : reader.enumerateMessages(mqb.getQuery())) {
    System.out.println("Subject: " + message.getSubject());
}

2. Support for Paginated Retrieval of Messages from MBOX Files

Aspose.Email for Java now supports paginated retrieval of messages from MBOX files. This feature allows for efficient processing of large MBOX files by retrieving messages in smaller batches, reducing memory consumption and improving performance.

API Changes:

• Added enumerateMessages(int startIndex, int count), which retrieves a specified number of MailMessage instances starting from a given index.
• Added enumerateMessageInfo(int startIndex, int count), which retrieves a specified number of MboxMessageInfo instances starting from a given index.

Code Example:

MboxStorageReader reader = MboxStorageReader.createReader("input.mbox", new MboxLoadOptions());
int startIndex = 0;
int count = 10; // Retrieve messages in batches of 10

for (MailMessage message : reader.enumerateMessages(startIndex, count)) {
    System.out.println("Subject: " + message.getSubject());
}

3. Support for Extract HTML body resources as attachments

Aspose.Email for Java now supports extracting image-linked content from the HTML body and embedding it as attachments in MIME messages. This enhancement ensures that linked images are preserved and properly associated with the email, improving content integrity and offline accessibility.

API Changes:

• Added HtmlSaveOption.ExtractHTMLBodyResourcesAsAttachments, defines whether to extract HTML body resources as attachments

Code Example:

MailMessage mailMessage = MailMessage.load("input.eml");
HtmlSaveOptions options = new HtmlSaveOptions();
options.setExtractHTMLBodyResourcesAsAttachments(true);
options.setResourceHtmlRenderingHandler(new ResourceHtmlRenderingHandler() {
    public void invoke(final Object sender, final ResourceHtmlRenderingEventArgs e) {
        System.out.println(e.getPathToResourceFile() + " " + ((Attachment)sender).getContentId());
    }
});