Document Conversion Java Cloud REST API

Product Page | Docs | Live Demos | Swagger UI | Code Samples | Blog | Free Support | Free Trial

GroupDocs.Conversion Cloud SDK for Java helps you build cloud Document Converter Java Apps that work without installing any 3rd party software. It is a wrapper around GroupDocs.Conversion Cloud REST APIs.

Cloud Document Conversion SDK Features

• Ability to convert the cloud documents to other supported formats in various ways, such as:
  • Convert whole cloud document from one format to another format
  • Convert N number of cloud Word processing document’s consecutive pages to PDF
  • Choose and convert specific pages of cloud Wordprocessing documents to PDF format
• Add watermark during the cloud document conversion
• Ability to convert cloud documents that use non-standard or custom fonts
• Option to convert the documents with using the cloud storage
• Ability to get list of supported file formats as well as fetch other useful information related to the cloud document.
• Convert cloud files and documents from a wide range of file formats to various supported file formats, such as:
  • Convert any supported format to one of the supported conversion file formats.
  • Convert cloud documents to MS Word® documents
  • Convert cloud documents to MS Excel® spreadsheets
  • Convert cloud documents to MS PowerPoint® presentations
  • Convert cloud documents to Image Formats
  • Convert cloud documents to HTML Format
  • Convert cloud documents to PDF Format
  • Convert cloud documents to Text Format
• During conversion the missing font(s) can be replaced with any of the provided fonts.
• Ability to extract format-specific information from the cloud documents, such as:
  • CAD Files: list of Drawing layers and Sketch layouts
  • Email Files: list of folders within an Outlook® data file
  • PDF Files: document printing restrictions information
  • MS Project® Files: start and end date of the project
• Load source document with various extended options, such as loading a specific sheet from a whole Spreadsheet document.

Supported Document Conversion File Formats

Microsoft Word®: DOC, DOCM, DOCX, DOT, DOTM, DOTX, RTF, TXT
OpenOffice Writer®: ODT, OTT
Microsoft Excel®: XLS, XLS2003, XLSB, XLSM, XLSX, CSV
OpenOffice Calc®: ODS
Microsoft PowerPoint®: PPS, PPSX, PPT, PPTX
OpenOffice Impress®: ODP
Microsoft Visio®: VDW, VDX, VSD, VSDX, VSS, VST, VSX, VTX
Microsoft Outlook®: EML, MSG
Apple® Mail: EMLX
Microsoft Project®: MPP, MPT
Adobe Photoshop®: PSD
CAD: DWG, DXF
Images: BMP, GIF, ICO, JPG, JPEG, PNG, TIF, TIFF
Vector Images: SVG
Markup: HTM, HTML, MHT
Fixed Layout: PDF, XPS

Requirements

Building the API client library requires:

1. Java 1.7+
2. Maven

Prerequisites

To use GroupDocs.Conversion Cloud SDK for Java you need to register an account with GroupDocs Cloud and lookup/create Client ID and Client Secret at Cloud Dashboard. There is free quota available. For more details, see GroupDocs Cloud Pricing.

Install GroupDocs.Conversion-Cloud from Maven

Add GroupDocs Cloud repository to your application pom.xml

<repository>
    <id>repository.groupdocs.cloud</id>
    <name>repository.groupdocs.cloud</name>
    <url>https://repository.groupdocs.cloud/repo/</url>
</repository>

Install from source

To install the API client library to your local Maven repository, simply execute:

mvn clean install

To deploy it to a remote Maven repository instead, configure the settings of the repository and execute:

mvn clean deploy

Refer to the OSSRH Guide for more information.

Maven users

Add this dependency to your project’s POM:

<dependency>
    <groupId>com.groupdocs</groupId>
    <artifactId>groupdocs-conversion-cloud</artifactId>
    <version>22.3</version>
    <type>pom</type>
</dependency>

Others

At first generate the JAR by executing:

mvn clean package

Then manually install the following JARs:

• target/groupdocs-conversion-cloud-22.3.jar
• target/lib/*.jar

Get Started

Please follow the Quick Start instructions.

Sample Java Code to convert Cloud Document DOCX to Cloud PDF

// For complete examples and data files, please go to https://github.com/groupdocs-conversion-cloud/groupdocs-conversion-cloud-java-samples
String MyClientSecret = ""; // Get ClientId and ClientSecret from https://dashboard.groupdocs.cloud
String MyClientId = ""; // Get ClientId and ClientSecret from https://dashboard.groupdocs.cloud

Configuration configuration = new Configuration(MyClientId, MyClientSecret);

// Create API instance
ConvertApi apiInstance = new ConvertApi(configuration);

// Prepare convert settings
ConvertSettings settings = new ConvertSettings();
settings.setFilePath("WordProcessing/four-pages.docx");
settings.setFormat("pdf");
settings.setOutputPath("converted");

List<StoredConvertedResult> result = apiInstance.convertDocument(new ConvertDocumentRequest(settings));

Authorization & Authentication

Authentication schemes defined for the API is as follows:

JWT

• Type: OAuth 2.0
• Flow: application
• Authorization URL: https://api.groupdocs.cloud/connect/token
• Token Lifetime: 1 day (Default)

Product Page | Docs | Live Demos | Swagger UI | Code Samples | Blog | Free Support | Free Trial