Features and Functionalities

Features and Functionalities

Overview

Aspose.Words FOSS for Java creates, reads, edits, and converts Word documents without Microsoft Word. Document is the object that holds a whole document, and DocumentBuilder writes content into it. This page lists the formats that were run against the published package and links to a guide for each task.


Supported Formats

These formats were saved and loaded on Java 8, 17 and 21. Each one works in both directions.

FormatLoadSave
DOCXYesYes
DOCM (macro-enabled document)YesYes
DOTX (template)YesYes
DOTM (macro-enabled template)YesYes
Flat OPC, plus its macro-enabled, template, and macro-enabled template variantsYesYes
MarkdownYesYes
Plain textYesYes

Formats This Edition Rejects

Saving as PDF, XPS, HTML, MHTML, EPUB, RTF, DOC, ODT, WordML, PNG, SVG, or TIFF (this list is not exhaustive) throws an UnsupportedOperationException whose message starts with FOSS. Loading HTML, ODT, or RTF does the same. These calls were run, not read from the source. DocumentBuilder.insertHtml is a separate method: it ran without an error on a short HTML fragment and put the text into the document.


Task Guides

TaskGuide
Create, open, and merge documentsWorking with Documents
Write headings and paragraphsWorking with Text
Build tablesWorking with Tables
Find and replace textFind and Replace
Accept tracked changesTracked Changes
Open documents and MarkdownLoading Documents
Save and convertSaving Documents
Name positions in the textBookmarks
Add footnotes and endnotesFootnotes and Endnotes
Set built-in and custom propertiesDocument Properties
Set page size, orientation and marginsPage Setup
Make bulleted and numbered listsLists
Insert and update fieldsFields
Add content controlsContent Controls
Insert chartsCharts
Read and remove digital signaturesDigital Signatures

Key Classes

ClassDescription
DocumentRepresents a Word document.
DocumentBuilderProvides methods to insert text, images and other content, specify font, paragraph and section formatting.
RangeRepresents a contiguous area in a document.
SaveFormatIndicates the format in which the document is saved.
ImportFormatModeSpecifies how formatting is merged when importing content from another document.

The API reference lists every public type. Only the members shown in these guides were run for this documentation. Each reference page states how many of its members are marked limited or not supported in this edition and how many were not exercised by a verified example; only rejected or limited members carry a marker on their own row.


Known Limitations

  • Formats listed under “Formats This Edition Rejects” are rejected when you load or save them. A file in a format that Document does not recognise, such as a PNG, an SVG or a PDF, is not rejected: its bytes load as plain text.
  • Document has no mail merge execution, comparison, page count or page layout methods, and the results of layout-dependent fields such as PAGE and NUMPAGES come back empty.
  • Digital signatures cannot be created: DigitalSignatureUtil.sign throws an UnsupportedOperationException whose message starts with FOSS.
  • Saving as PNG, SVG, TIFF, PDF, or XPS is rejected.

Next Steps

See Also