GroupDocs.Comparison for Java 26.3 Release Notes
Full list of changes in this release
| ID | Summary | Category |
|---|---|---|
| COMPARISONNET-4435 | Fix PNG comparison | Fix |
| COMPARISONNET-4428 | Sonar updates: GetDocumentInfoTests Cells dimensions 204/342/184/274 → 300/450/300/600 | Update |
| COMPARISONNET-4428 | Test structure and Licenses paths; code coverage paths | Test |
| COMPARISONNET-4428 | Adding and enabling HTML tests (Comparer param document→stream) | Test |
| COMPARISONJAVA | Text/HTML test changes (setSaveOriginalState, test comments) | Test |
| COMPARISONJAVA | Antihack tests (core/common) | Test |
| COMPARISONJAVA | Covering different compare methods (ComparerTests in core/common) | Test |
| COMPARISONJAVA | Adding MultiWordsTests (core/word, 3 tests disabled) | Test |
| COMPARISONJAVA | Compare class changes: AntiHackController Default, performCheck in Comparer | Fix |
| COMPARISONJAVA | Fixing XML declaration (Javadoc License/Metered references removed) | Fix |
| COMPARISONNET-4453 | Adding images tests (BmpTests → core.imagingtests; DicomTests disabled) | Test |
| COMPARISONJAVA | Multi compare and diagram tests (DiagramTest disables) | Test |
| COMPARISONJAVA | Diagram disables (GroupShapes, TestDiagramMemoryStream, etc.) | Test |
| COMPARISONJAVA | Aspose.Diagram: LoadFileFormat.VDX/VDW, pom aspose.diagram | Update |
| COMPARISONJAVA | Fixing build: DiagramCompareResult isTextEmpty→getChars!=null; CodeFileTest disables | Fix |
| COMPARISONJAVA | DiagramTest updates (MultiDiagram, diagramImageTest, GetTextTests) | Test |
| COMPARISONJAVA | Fix build: words/format/Converter CalculateGaps package-private | Fix |
| COMPARISONJAVA | More tests: APITests LoadOptions, ComparerTests compare_GetChanges, CompareResultTests applyChanges, HtmlCompareResult setSettingStyle*, selfComparisonCheck public static | Test |
| COMPARISONJAVA | Comparer: case DIFFERENT commented out; selfComparisonCheck public for tests | Fix |
| COMPARISONJAVA | APITests differentTest: ComparisonException for compare png vs dxf | Test |
| COMPARISONJAVA | .gitlab-ci.yml sonar_scanner allow_failure | Update |
| COMPARISONJAVA | New unit tests (ComparisonCADImage constructors removed) | Test |
| COMPARISONJAVA | New unit tests: words InstanceHelper getDocument(String,String) removed; StyleChangeInfoTests, ComparisonTextStyleTests (diagram) | Test |
| COMPARISONJAVA | Updates, more tests: Comparer→BasePdfTest, heirs updated | Test |
| COMPARISONJAVA | Tests for static methods: visibility → package-private | Test |
| COMPARISONJAVA | Fix build: ComparisonDocument constructor (Aspose.Words.Document) package-private | Fix |
| COMPARISONJAVA | Adding slides tests, other units (BadFileTest svg vs docx → FileFormatException) | Test |
| COMPARISONNET-4472 | Excel comparison hanging: Cells InstanceHelper/LoadOptions, ComparisonRange mergedCells, ComparisonWorkbook worksheets | Fix |
| COMPARISONNET-4453 | Sonar: CommonMethods.standartName null-check, StylesSetter.isHighlightColorSupported package-private | Fix |
| COMPARISONJAVA | Fixing failed: CellsTests Test1–Test24 commented; SimpleTableTests 10→12 children | Test |
| COMPARISONJAVA | Revert: ComparisonWorkbook worksheet cache, new list per call | Fix |
| COMPARISONJAVA | Fix tests: MultiComparer png→UNDEFINED, else UNDEFINED→TEXT | Fix |
| COMPARISONJAVA | Tests: Cells StylesComparer.equals, WordSeparator.runsMerger package-private | Fix |
| COMPARISONJAVA | Build fix: ComparisonMailMessage(Document, FileType), Comparer/MultiComparer pass getFileType() | Fix |
| COMPARISONJAVA | Words InstanceHelper.getDocument(InputStream, LoadOptions, String password) | Feature |
| COMPARISONJAVA | Fixies: Email FileType passed (aligned with build fix) | Fix |
| COMPARISONNET-4565 | Word paragraphs merging: logic kept, merge behavior fixed (see 121) | Fix |
| COMPARISONJAVA | ParagraphsMerger: null/whitespace/short strings (word-count threshold), snapshot of child nodes in handleParagraph | Fix |
| COMPARISONJAVA | Fix for Word: ICompareResult.getResultDocument(), WordsCompareResult returns _wordsDocument | Fix |
| COMPARISONNET-4685 | WordCompareOptions class, deprecate Word options in CompareOptions, get…() helpers, Word code uses helpers | Feature |
WordCompareOptions (COMPARISONNET-4685)
Word-specific options are now available in a dedicated WordCompareOptions class (extends CompareOptions). Use it when comparing Word documents to configure MarkLineBreaks, CompareBookmarks, CompareVariableProperty, CompareDocumentProperty, ShowRevisions, LeaveGaps, WordTrackChanges, RevisionAuthorName, and DisplayMode (Revisions / Highlight). The same options remain on CompareOptions but are deprecated in favor of WordCompareOptions.
Result document for Word
When comparing Word documents, the result Aspose Words document can be obtained via getResult().getResultDocument() even when not saving to a stream, so callers can access the comparison result document in all scenarios.
Email comparison and FileType
ComparisonMailMessage now accepts an optional FileType in the constructor. Comparer and MultiComparer pass the source/target document FileType when creating email comparison instances, improving detection and behavior when comparing email files.
ParagraphsMerger improvements
Merging of Word paragraphs now handles null or whitespace-only text (returns 0 similarity), applies a word-count threshold for short strings (returns 10 when fewer than 4 words), and takes a snapshot of child nodes before moving them to avoid concurrent modification issues.
Words InstanceHelper overload
InstanceHelper.getDocument(InputStream stream, LoadOptions loadOptions, String password) was added to load a Word document from a stream with optional load options and password.