DITA Merge 4.0.0 - API Updates
Background
DITA Merge was first in released in April 2014 and originally only supported Concurrent Merge, with a few features. Since then, the product has evolved quite a bit. In the past few years, we have introduced features such as Table Processing, Sequential Merge, Rule Processed outputs, and more.
In the DITA Merge 4.0.0 release we have improved CALS and Simple table processing, and also added a few more configuration settings to control table processing. These table processing changes are breaking API changes.
API Changes
As we are releasing a major upgrade, we have decided to use this opportunity to update the DITA Merge API to improve consistency, and also make the API easier to understand and use. We have created a new package, com.deltaxml.mergecommon.config, which will include all the enums and configuration classes. This also allows us to use configuration classes in other products such as DITA Merge for similar features and at the same time maintain code easily. The following table summarises all the API changes in 4.0.0:
Original API Settings | New API Settings |
|---|---|
Respective table processing settings for classes : com.deltaxml.ditamerge.ConcurrentMerge, com.deltaxml.ditamerge.ThreeWayMerge, com.deltaxml.ditamerge.SequentialMerge
| |
com.deltaxml.mergecommon.config.EntityReferencePreservationMode | |
State | |
Result Type | |
com.deltaxml.ditamerge.ThreeWayMerge.ThreeWayMergeResultType | |
Three Way Merge Specific | |
com.deltaxml.ditamerge.ThreeWayMerge.TrackChangesAttributeMode | |
com.deltaxml.ditamerge.ThreeWayMerge.ExistingOxygenTCsProcessingMode | com.deltaxml.mergecommon.config.ExistingOxygenTCsProcessingMode |