From the above diagram, you can see that there are three main parts of the new Aspose.Pdf: old Aspose.Pdf, Old Aspose.Pdf.Kit, and new Aspose.Pdf DOM API.
Support for Legacy Code
Aspose.Pdf.Generator namespace corresponds to the old Aspose.Pdf. All the namespaces and classes previously available in the old Aspose.Pdf can be found under this namespace. Aspose.Pdf.Facades namespace contains all the namespaces and classes provided by old Aspose.Pdf.Kit. If you want to use this new component with your legacy code then you can use these two namespaces. Most of the code will remain same; there will be only small changes due to the fact that we wanted to take advantage of the new PDF Engine. However, those changes are minor, and I’ll also explain the required changes separately.
New DOM API
All the namespaces except the two mentioned above belong to the new DOM API. In order to take full advantage of the flexibility provided by merged component, you need to migrate to the Aspose.Pdf DOM API. Also, as this API is consistent with other Aspose components, this will help you standardize your applications as well.
Challenge Your Creativity
You also need to understand another important aspect of the new component. You can see, in the above diagram, that Aspose.Pdf.Facades namespace is accessing the DOM API. This is because, although the interface is similar to the Aspose.Pdf.Kit for backward compatibility, the internal implementation is revamped to provide better results. Now, you have got two options for editing your PDF files: use Aspose.Pdf.Facades to implement the code quickly to save you the time, or use DOM API to solve complex business scenarios and challenge your creativity as well!
Introductory Video Tutorial
I have also created a video tutorial which explains different parts of the merged API. This video walks you through the namespaces provided by the merged Aspose.Pdf. Please watch this video tutorial for better understanding of the new component.
This video tutorial can also be found on the YouTube at the following URL: Introduction to Merged Aspose.Pdf.
In my upcoming blog posts and tutorials, I’ll show you the code snippets and samples of the merged API. In the meanwhile, if you have any questions or concerns, please do share with us.