Migration Notes

Why To Migrate?

Here are the key reasons to use the new updated API provided by GroupDocs.Conversion for Java since version 20.2:

  • Converter class introduced as a single entry point to manage the document conversion process to any supported file format (instead of ConversionHander class from previous versions). 
  • The overall conversion speed improved dramatically by saving each page as soon as it was converted, not when all pages list were converted. 
  • Product architecture was redesigned from scratch in order to decreased memory usage (from 10% to 400% approx. depending on document type).
  • Document convert options simplified for easy control over document conversion and saving processes.

How To Migrate?

Here is a brief comparison of how to convert document into PDF format using old and new API.

Old coding style

String documentPath = "sample.docx";
String outputPath = "C:\\output\\converted.pdf";

//Instantiating the conversion handler
ConversionHandler conversionHandler = Common.getConversionHandler();

SaveOptions saveOptions = new PdfSaveOptions();
saveOptions.setConvertFileType(PdfFileType.Pdf);
 
ConvertedDocument convertedDocumentPath = conversionHandler.convert(documentPath , saveOptions);
convertedDocumentPath.save("C:\\output\\converted.pdf");

New coding style

String documentPath = "C:\\sample.docx"; 
String outputPath = "C:\\output\\converted.pdf";
 
try(Converter converter = new Converter(documentPath))
{
    PdfConvertOptions convertOptions = new PdfConvertOptions();
    converter.Convert(outputPath, convertOptions);
}

For more code examples and specific use cases please refer to our Developer Guide documentation or GitHub samples and showcases.