This repository contains GroupDocs.Viewer Cloud SDK for Java source code. This SDK allows you to work with GroupDocs.Viewer Cloud REST APIs in your Java applications. This allows rendering any type of documents - Word, Excel, Presentation, Cad, Email, etc, to HTML, image or PDF format with the flexibility to render the whole document or custom range of pages.
- Java SE Development Kit 8
Add following repository and dependency to your project's POM
<repository> <id>groupdocs-artifact-repository</id> <name>GroupDocs Artifact Repository</name> <url>https://repository.groupdocs.cloud/repo</url> </repository>
<dependency> <groupId>com.groupdocs</groupId> <artifactId>groupdocs-viewer-cloud</artifactId> <version>26.6</version> <scope>compile</scope> </dependency>
Add following repository and dependency to your build.gradle:
repositories { maven { url "https://repository.groupdocs.cloud/repo/" } } ... dependencies { ... implementation 'com.groupdocs:groupdocs-viewer-cloud:26.6' }
- Please follow the installation instruction
- Get your AppSID and AppKey at Dashboard and use them in your code
- Build and execute
- Explore more samples at GitHub
Below is an example demonstrating how to preview document using GroupDocs.Viewer Cloud SDK for Java:
import com.groupdocs.cloud.viewer.api.ViewApi; import com.groupdocs.cloud.viewer.client.Configuration; import com.groupdocs.cloud.viewer.model.requests.ConvertAndDownloadRequest; import java.io.File; import java.io.FileInputStream; import java.io.InputStream; import java.io.OutputStream; import java.io.FileOutputStream; public class Example { public static void main(String[] args) { // For complete examples and data files, please go to https://github.com/groupdocs-viewer-cloud/groupdocs-viewer-cloud-java-samples String myClientId = ""; // Get Client Id from https://dashboard.groupdocs.cloud String myClientSecret = ""; // Get Client Secret from https://dashboard.groupdocs.cloud Configuration configuration = new Configuration(myClientId, myClientSecret); ViewApi viewApi = new ViewApi(configuration); String format = "jpg"; try (InputStream fileStream = new FileInputStream("myfile.docx")) { ConvertAndDownloadRequest request = new ConvertAndDownloadRequest(format, fileStream); InputStream result = viewApi.convertAndDownload(request); // Save the resulting stream (a *.jpg file) for your purpose try (OutputStream outStream = new FileOutputStream("output.jpg")) { byte[] buffer = new byte[8192]; int bytesRead; while ((bytesRead = result.read(buffer)) != -1) { outStream.write(buffer, 0, bytesRead); } } result.close(); } catch (Exception e) { System.err.println("Failed to convert and download the document"); e.printStackTrace(); } } }
And here is an example demonstrating how to upload the document, render it, and download the result using GroupDocs.Viewer Cloud SDK for Java:
import com.groupdocs.cloud.viewer.api.ViewApi; import com.groupdocs.cloud.viewer.api.FileApi; import com.groupdocs.cloud.viewer.client.Configuration; import com.groupdocs.cloud.viewer.model.*; import com.groupdocs.cloud.viewer.model.requests.*; import java.io.FileInputStream; import java.io.InputStream; import java.io.OutputStream; import java.io.FileOutputStream; public class Example { public static void main(String[] args) { // For complete examples and data files, please go to https://github.com/groupdocs-viewer-cloud/groupdocs-viewer-cloud-java-samples String myClientId = ""; // Get Client Id from https://dashboard.groupdocs.cloud String myClientSecret = ""; // Get Client Secret from https://dashboard.groupdocs.cloud Configuration configuration = new Configuration(myClientId, myClientSecret); try { // Upload a file to cloud storage FileApi fileApi = new FileApi(configuration); try (InputStream uploadStream = new FileInputStream("myfile.docx")) { UploadFileRequest uploadRequest = new UploadFileRequest("myfile.docx", uploadStream, null); fileApi.uploadFile(uploadRequest); } // Render it to HTML ViewApi viewApi = new ViewApi(configuration); FileInfo fileInfo = new FileInfo(); fileInfo.setFilePath("myfile.docx"); ViewOptions viewOptions = new ViewOptions(); viewOptions.setFileInfo(fileInfo); viewOptions.setViewFormat(ViewOptions.ViewFormatEnum.HTML); viewOptions.setOutputPath("myfile.html"); CreateViewRequest viewRequest = new CreateViewRequest(viewOptions); viewApi.createView(viewRequest); // Download the result DownloadFileRequest downloadRequest = new DownloadFileRequest("myfile.html", null, null); InputStream result = fileApi.downloadFile(downloadRequest); // Use resulting stream (a *.html file in this example) for your purpose try (OutputStream outStream = new FileOutputStream("output.html")) { byte[] buffer = new byte[8192]; int bytesRead; while ((bytesRead = result.read(buffer)) != -1) { outStream.write(buffer, 0, bytesRead); } } result.close(); } catch (Exception e) { System.err.println("Failed to upload, render, or download the document"); e.printStackTrace(); } } }
Building the API client library requires Maven to be installed. Refer to the official documentation for more information.
At first generate the JAR by executing following command in "/src" working directory:
mvn package -D maven.test.skip=true
Then manually install the following JARs:
- target/groupdocs-viewer-cloud-26.6.jar
- target/lib/*.jar
All GroupDocs.Viewer Cloud SDKs are licensed under MIT License.
Your feedback is very important to us. Please feel free to contact us using our Support Forums.