Examples

Author: jonas-jasas

src/main/java/com/convertapi/ConversionResult.java

@@ -12,41 +12,39 @@
 import java.util.concurrent.ExecutionException;
 
 public class ConversionResult {
-    private final CompletableFuture<ConversionResponse> responseFuture;
+    private final ConversionResponse response;
 
-    public ConversionResult(CompletableFuture<ConversionResponse> responseFuture) {
-        this.responseFuture = responseFuture;
+    public ConversionResult(ConversionResponse responseFuture) {
+        this.response = responseFuture;
     }
 
-    public CompletableFuture<Integer> fileCount() throws ExecutionException, InterruptedException {
-        return responseFuture.thenApplyAsync(r -> r.Files.length);
+    public Integer fileCount() throws ExecutionException, InterruptedException {
+        return response.Files.length;
     }
 
-    public CompletableFuture<List<String>> urls() throws ExecutionException, InterruptedException {
-        return responseFuture.thenApplyAsync(r -> {
-            List<String> valueList = new ArrayList();
-            for (ConversionResponseFile file: r.Files) valueList.add(file.Url);
-            return valueList;
-        });
+    public List<String> urls() {
+        List<String> valueList = new ArrayList();
+        for (ConversionResponseFile file: response.Files) valueList.add(file.Url);
+        return valueList;
     }
 
-    public CompletableFuture<Integer> conversionCost() throws ExecutionException, InterruptedException {
-        return responseFuture.thenApplyAsync(r -> r.ConversionCost);
+    public Integer conversionCost() throws ExecutionException, InterruptedException {
+        return response.ConversionCost;
     }
 
-    public CompletableFuture<ConversionResultFile> getFile(int index) {
-        return responseFuture.thenApplyAsync(r -> new ConversionResultFile(r.Files[index]));
+    public ConversionResultFile getFile(int index) {
+        return new ConversionResultFile(response.Files[index]);
     }
 
-    public Path saveFile(Path file) throws ExecutionException, InterruptedException {
-        return getFile(0).thenCompose(f -> f.saveFile(file)).get();
+    public CompletableFuture<Path> saveFile(Path file)  {
+        return getFile(0).saveFile(file);
     }
 
-    public List<Path> saveFiles(Path directory) throws ExecutionException, InterruptedException, NotDirectoryException {
-        if (!Files.isDirectory(directory)) throw new NotDirectoryException(directory.toString());
-        List<Path> paths = new ArrayList<Path>();
-        for (int i = 0; i < responseFuture.get().Files.length; i++) {
-            paths.add(getFile(i).thenCompose(f -> f.saveFile(directory)).get());
+    public List<CompletableFuture<Path>> saveFiles(Path directory) {
+        if (!Files.isDirectory(directory)) throw new RuntimeException("Directory expected, but received: " + directory.toString());
+        List<CompletableFuture<Path>> paths = new ArrayList();
+        for (int i = 0; i < response.Files.length; i++) {
+            paths.add(getFile(i).saveFile(directory));
         }
         return paths;
     }

src/main/java/com/convertapi/ConvertApi.java

@@ -1,6 +1,7 @@
 package com.convertapi;
 
 import com.convertapi.model.ConversionResponse;
+import com.convertapi.model.User;
 import com.google.gson.Gson;
 import okhttp3.HttpUrl;
 import okhttp3.MultipartBody;
@@ -16,11 +17,11 @@
 public class ConvertApi {
     private static final List<String> IGNORE_PARAMS = Arrays.asList( "storefile", "async", "jobid", "timeout");
 
-    public static ConversionResult convert(String fromFormat, String toFormat, Param[] params) {
+    public static CompletableFuture<ConversionResult> convert(String fromFormat, String toFormat, Param[] params) {
         return convert(fromFormat, toFormat, params, Config.defaults());
     }
 
-    public static ConversionResult convert(String fromFormat, String toFormat, Param[] params, Config config) {
+    public static CompletableFuture<ConversionResult> convert(String fromFormat, String toFormat, Param[] params, Config config) {
         CompletableFuture<ConversionResponse> completableResponse = CompletableFuture.supplyAsync(() -> {
             HttpUrl url = Http.getUrlBuilder(config)
                     .addPathSegment(fromFormat)
@@ -66,6 +67,31 @@ public static ConversionResult convert(String fromFormat, String toFormat, Param
             return new Gson().fromJson(bodyString, ConversionResponse.class);
         });
 
-        return new ConversionResult(completableResponse);
+        return completableResponse.thenApply(r -> new ConversionResult(r));
+    }
+
+    public static User getUser() {
+        return getUser(Config.defaults());
+    }
+
+    public static User getUser(Config config) {
+        HttpUrl url = Http.getUrlBuilder(config).addPathSegment("user").build();
+        Request request = new Request.Builder()
+                .url(url)
+                .addHeader("Accept", "application/json")
+                .build();
+
+        String bodyString;
+        try {
+            Response response = Http.getClient().newCall(request).execute();
+            bodyString = response.body().string();
+            if (response.code() != 200) {
+                throw new ConversionException(bodyString);
+            }
+        } catch (IOException e) {
+            throw new RuntimeException(e);
+        }
+
+        return new Gson().fromJson(bodyString, User.class);
     }
 }

src/main/java/com/convertapi/Param.java

@@ -15,8 +15,12 @@ public class Param {
     private String name;
     private CompletableFuture<List<String>> value;
 
-    public Param(String name, String value) {
+    private Param(String name) {
         this.name = name.toLowerCase();
+    }
+
+    public Param(String name, String value) {
+        this(name.toLowerCase());
         List<String> valueList = new ArrayList();
         valueList.add(value);
         this.value = CompletableFuture.completedFuture(valueList);
@@ -35,7 +39,7 @@ public Param(String name, byte[] value, String fileFormat) {
     }
 
     public Param(String name, byte[] value, String fileFormat, Config config) {
-        this(name, "");
+        this(name);
         String fileName = "getFile." + fileFormat;
         String contentTypeString = MimetypesFileTypeMap.getDefaultFileTypeMap().getContentType(fileName);
         this.value = upload(value, fileName, MediaType.parse(contentTypeString), config);
@@ -46,23 +50,26 @@ public Param(String name, Path value) throws IOException {
     }
 
     public Param(String name, Path value, Config config) throws IOException {
-        this(name, "");
+        this(name);
         String contentTypeString = MimetypesFileTypeMap.getDefaultFileTypeMap().getContentType(value.toFile());
         this.value = upload(Files.readAllBytes(value), value.getFileName().toString(), MediaType.parse(contentTypeString), config);
     }
 
     public Param(String name, ConversionResult value) throws ExecutionException, InterruptedException {
         this(name, value, 0);
-        this.value = value.urls();
+        this.value = CompletableFuture.completedFuture(value.urls());
     }
 
     public Param(String name, ConversionResult value, int fileIndex) throws ExecutionException, InterruptedException {
-        this(name, "");
-        this.value = value.getFile(fileIndex).thenApplyAsync(f -> {
-            List<String> valueList = new ArrayList();
-            valueList.add(f.getUrl());
-            return valueList;
-        });
+        this(name);
+        List<String> valueList = new ArrayList();
+        valueList.add(value.getFile(fileIndex).getUrl());
+        this.value = CompletableFuture.completedFuture(valueList);
+    }
+
+    public Param(String name, CompletableFuture<ConversionResult> value) throws ExecutionException, InterruptedException {
+        this(name);
+        this.value = value.thenApply(r -> r.urls());
     }
 
     public String getName() {

src/main/java/com/convertapi/examples/ConversionChaining.java

@@ -3,6 +3,7 @@
 import java.io.IOException;
 import java.nio.file.Path;
 import java.nio.file.Paths;
+import java.util.concurrent.CompletableFuture;
 import java.util.concurrent.ExecutionException;
 import com.convertapi.Config;
 import com.convertapi.ConversionResult;
@@ -16,21 +17,21 @@
 
 public class ConversionChaining {
     public static void main(String[] args) throws IOException, ExecutionException, InterruptedException {
-        Config.setDefaultSecret("YOUR API SECRET"); //Get your secret at https://www.convertapi.com/a
+        Config.setDefaultSecret("YOUR API SECRET");    //Get your secret at https://www.convertapi.com/a
 
         System.out.println("Converting PDF to JPG and compressing result files with ZIP");
-        ConversionResult jpgResult = ConvertApi.convert("docx", "jpg", new Param[]{new Param("file", Paths.get("./test-files/test.docx"))});
+        CompletableFuture<ConversionResult> jpgResult = ConvertApi.convert("docx", "jpg", new Param[]{new Param("file", Paths.get("test-files/test.docx"))});
         System.out.println("ConvertApi.convert is not blocking method, proceeding to ZIP conversion");
 
-        ConversionResult zipResult = ConvertApi.convert("jpg", "zip", new Param[]{new Param("files", jpgResult)});
+        CompletableFuture<ConversionResult> zipResult = ConvertApi.convert("jpg", "zip", new Param[]{new Param("files", jpgResult)});
 
         System.out.println("Saving result file (blocking operation)");
         Path tempDir = Paths.get(System.getProperty("java.io.tmpdir"));
-        Path path = zipResult.saveFile(tempDir);
+        CompletableFuture<Path> path = zipResult.get().saveFile(tempDir);
 
-        System.out.println("DOCX -> JPG conversion cost: " + jpgResult.conversionCost().get());
-        System.out.println("DOCX -> JPG conversion result file count: " + jpgResult.fileCount().get());
-        System.out.println("JPG -> ZIP conversion cost: " + zipResult.conversionCost().get());
-        System.out.println("ZIP file saved to: " + path.toString());
+        System.out.println("DOCX -> JPG conversion cost: " + jpgResult.get().conversionCost());
+        System.out.println("DOCX -> JPG conversion result file count: " + jpgResult.get().fileCount());
+        System.out.println("JPG -> ZIP conversion cost: " + zipResult.get().conversionCost());
+        System.out.println("ZIP file saved to: " + path.get().toString());
     }
 }

src/main/java/com/convertapi/examples/ConvertRemoteFile.java

@@ -3,6 +3,7 @@
 import java.io.IOException;
 import java.nio.file.Path;
 import java.nio.file.Paths;
+import java.util.concurrent.CompletableFuture;
 import java.util.concurrent.ExecutionException;
 import com.convertapi.Config;
 import com.convertapi.ConversionResult;
@@ -20,10 +21,10 @@ public static void main(String[] args) throws IOException, ExecutionException, I
         Param fileParam = new Param("file", "https://cdn.convertapi.com/cara/testfiles/presentation.pptx");
 
         System.out.println("Converting remote PPTX to PDF");
-        ConversionResult result = ConvertApi.convert("pptx", "pdf", new Param[]{fileParam});
+        CompletableFuture<ConversionResult> result = ConvertApi.convert("pptx", "pdf", new Param[]{fileParam});
 
         Path pdfFile = Paths.get(System.getProperty("java.io.tmpdir") + "/myfile.pdf");
-        result.saveFile(pdfFile);
+        result.get().saveFile(pdfFile);
 
         System.out.println("PDF file saved to: " + pdfFile.toString());
     }

src/main/java/com/convertapi/examples/ConvertWebToPdf.java

@@ -3,6 +3,7 @@
 import java.io.IOException;
 import java.nio.file.Path;
 import java.nio.file.Paths;
+import java.util.concurrent.CompletableFuture;
 import java.util.concurrent.ExecutionException;
 import com.convertapi.Config;
 import com.convertapi.ConversionResult;
@@ -19,14 +20,14 @@ public static void main(String[] args) throws IOException, ExecutionException, I
         Config.setDefaultSecret("YOUR API SECRET");    //Get your secret at https://www.convertapi.com/a
 
         System.out.println("Converting WEB to PDF");
-        ConversionResult result = ConvertApi.convert("web", "pdf", new Param[]{
+        CompletableFuture<ConversionResult> result = ConvertApi.convert("web", "pdf", new Param[]{
                 new Param("url", "https://en.wikipedia.org/wiki/Data_conversion"),
                 new Param("filename", "web-example")
         });
 
         Path tmpDir = Paths.get(System.getProperty("java.io.tmpdir"));
-        Path pdfFile = result.saveFile(tmpDir);
+        CompletableFuture<Path> pdfFile = result.get().saveFile(tmpDir);
 
-        System.out.println("PDF file saved to: " + pdfFile.toString());
+        System.out.println("PDF file saved to: " + pdfFile.get().toString());
     }
 }

src/main/java/com/convertapi/examples/ConvertWordToPdfAndPng.java

@@ -9,6 +9,7 @@
 import java.nio.file.Path;
 import java.nio.file.Paths;
 import java.util.List;
+import java.util.concurrent.CompletableFuture;
 import java.util.concurrent.ExecutionException;
 
 /**
@@ -20,22 +21,21 @@
 
 public class ConvertWordToPdfAndPng {
     public static void main(String[] args) throws IOException, ExecutionException, InterruptedException {
-        Config.setDefaultSecret("YOUR API SECRET"); //Get your secret at https://www.convertapi.com/a
+        Config.setDefaultSecret("YOUR API SECRET");    //Get your secret at https://www.convertapi.com/a
+        Path tempDir = Paths.get(System.getProperty("java.io.tmpdir"));
 
         System.out.println("Converting DOCX to PDF and JPG in parallel");
 
         Param docxFileParam = new Param("file", Paths.get("test-files/test.docx"));
 
-        ConversionResult pdfResult = ConvertApi.convert("docx", "pdf", new Param[]{docxFileParam});
-        ConversionResult jpgResult = ConvertApi.convert("docx", "jpg", new Param[]{docxFileParam});
+        CompletableFuture<ConversionResult> pdfResult = ConvertApi.convert("docx", "pdf", new Param[]{docxFileParam});
+        CompletableFuture<ConversionResult> jpgResult = ConvertApi.convert("docx", "jpg", new Param[]{docxFileParam});
 
-        Path tempDir = Paths.get(System.getProperty("java.io.tmpdir"));
-        Path pdfPath = pdfResult.saveFile(tempDir);
-        List<Path> jpgPaths = jpgResult.saveFiles(tempDir);
+        System.out.println("PDF file saved to: " + pdfResult.get().saveFile(tempDir).get());
 
-        System.out.println("PDF file saved to: " + pdfPath.toString());
-        for (Path path: jpgPaths) {
-            System.out.println("JPG file saved to: " + path.toString());
+        List<CompletableFuture<Path>> jpgPaths = jpgResult.get().saveFiles(tempDir);
+        for (CompletableFuture<Path> path: jpgPaths) {
+            System.out.println("JPG file saved to: " + path.get().toString());
         }
     }
 }

src/main/java/com/convertapi/examples/CreatePdfThumbnail.java

@@ -0,0 +1,42 @@
+package com.convertapi.examples;
+
+import com.convertapi.Config;
+import com.convertapi.ConversionResult;
+import com.convertapi.ConvertApi;
+import com.convertapi.Param;
+
+import java.io.IOException;
+import java.nio.file.Path;
+import java.nio.file.Paths;
+import java.util.List;
+import java.util.concurrent.CompletableFuture;
+import java.util.concurrent.ExecutionException;
+
+/**
+ * Example of extracting first page from PDF and then chaining conversion PDF page to JPG.
+ * https://www.convertapi.com/pdf-to-extract
+ * https://www.convertapi.com/pdf-to-jpg
+ */
+
+public class CreatePdfThumbnail {
+    public static void main(String[] args) throws IOException, ExecutionException, InterruptedException {
+        Config.setDefaultSecret("YOUR API SECRET");    //Get your secret at https://www.convertapi.com/a
+        Path tempDir = Paths.get(System.getProperty("java.io.tmpdir"));
+
+        System.out.println("Creating PDF thumbnail");
+
+        CompletableFuture<ConversionResult> pdfFirstPageResult = ConvertApi.convert("pdf", "extract", new Param[]{
+                new Param("file", Paths.get("test-files/test.pdf")),
+                new Param("pagerange", "1")
+        });
+
+        CompletableFuture<ConversionResult> thumbnailResult = ConvertApi.convert("pdf", "jpg", new Param[]{
+                new Param("file", pdfFirstPageResult),
+                new Param("scaleimage","true"),
+                new Param("scaleproportions","true"),
+                new Param("imageheight",300)
+        });
+
+        System.out.println("JPG thumbnail file saved to: " + thumbnailResult.get().saveFile(tempDir).get());
+    }
+}

src/main/java/com/convertapi/examples/UserInformation.java

@@ -0,0 +1,34 @@
+package com.convertapi.examples;
+
+import com.convertapi.Config;
+import com.convertapi.ConversionResult;
+import com.convertapi.ConvertApi;
+import com.convertapi.Param;
+import com.convertapi.model.User;
+
+import java.io.IOException;
+import java.nio.file.Path;
+import java.nio.file.Paths;
+import java.util.List;
+import java.util.concurrent.CompletableFuture;
+import java.util.concurrent.ExecutionException;
+
+/**
+ * Retrieve user information
+ * https://www.convertapi.com/doc/user
+ */
+
+public class UserInformation {
+    public static void main(String[] args) throws IOException, ExecutionException, InterruptedException {
+        Config.setDefaultSecret("YOUR API SECRET");    //Get your secret at https://www.convertapi.com/a
+        User user = ConvertApi.getUser();
+
+        System.out.println("API Key: " + user.ApiKey);
+        System.out.println("Secret: " + user.Secret);
+        System.out.println("Email: " + user.Email);
+        System.out.println("Name: " + user.FullName);
+        System.out.println("Status: " + user.Status);
+        System.out.println("Active: " + user.Active);
+        System.out.println("Seconds left: " + user.SecondsLeft);
+    }
+}

src/main/java/com/convertapi/model/User.java

@@ -0,0 +1,11 @@
+package com.convertapi.model;
+
+public class User {
+    public String Secret;
+    public int ApiKey;
+    public boolean Active;
+    public String FullName;
+    public String Email;
+    public int SecondsLeft;
+    public String Status;
+}