Wir veröffentlichen unser offizielles Java SDK

Ifedapo Olarewaju

Entwickler · Lagos, Nigeria · Bio anzeigen

Wir haben es ernst gemeint, als wir sagten, dass es spannende Neuigkeiten zu unseren SDKs geben wird. Um das zu beweisen, möchten wir Ihnen einen Vorgeschmack darauf geben, was wir in petto haben.

Heute freuen wir uns, die offizielle Veröffentlichung unseres Java SDK bekannt zu geben!

Dieses SDK bietet die folgenden Funktionen und unterstützt außerdem unsere kürzlich hinzugefügte tus⁠-API:

• Eine Assembly erstellen (natürlich). Dabei werden die fortsetzbaren Uploads von tus⁠ unterstützt, was ideal ist, wenn Sie große Dateien in einem unzuverlässigen Netzwerk hochladen.
• Eine Assembly abrufen
• Die Ausführung einer Assembly abbrechen
• Assemblies auflisten
• Ein Template erstellen
• Ein Template aktualisieren
• Ein Template löschen
• Templates auflisten
• Ein Template abrufen
• Die monatliche Rechnung für Ihr Konto abrufen

Hier sind ein paar schnelle Schritte für den Einstieg:

1. Installieren Sie das SDK, indem Sie es manuell von Maven Central Search⁠ herunterladen, oder installieren Sie es aus unseren Maven- und Jcenter-Repositories.

   Gradle:

   compile 'com.transloadit.sdk:transloadit:0.0.3'
   

   Maven:

   <dependency>
     <groupId>com.transloadit.sdk</groupId>
     <artifactId>transloadit</artifactId>
     <version>0.0.3</version>
   </dependency>
   

2. Erstellen Sie eine Klasse Example und instanziieren Sie darin den Transloadit-Client. Dafür müssen Sie Ihre API-Zugangsdaten eingeben:

   import com.transloadit.sdk.Transloadit;
   
   public class Example {
   
     public static void main(String[] args) {
       Transloadit transloadit = new Transloadit("YOUR_TRANSLOADIT_KEY", "YOUR_TRANSLOADIT_SECRET");
     }
   }
   

3. Erstellen Sie eine neue Instanz einer Assembly und fügen Sie die Datei hinzu, die Sie hochladen möchten, zusammen mit den Assembly Steps und Instructions, um sie zu verarbeiten. Danach sollte Ihre aktualisierte Klasse so aussehen:

   import com.transloadit.sdk.Transloadit;
   import java.io.File;
   import java.util.HashMap;
   import java.util.Map;
   import com.transloadit.sdk.Assembly;
   
   public class Example {
   
     public static void main(String[] args) {
       Transloadit transloadit = new Transloadit("YOUR_TRANSLOADIT_KEY", "YOUR_TRANSLOADIT_SECRET");
   
       Assembly assembly = transloadit.newAssembly();
   
       Map<String, Object> stepOptions = new HashMap<>();
       stepOptions.put("width", 75);
       stepOptions.put("height", 75);
       assembly.addStep("resize", "/image/resize", stepOptions);
   
       assembly.addFile(new File("PATH/TO/FILE.jpg"));
     }
   }
   

4. Senden Sie die Assembly an Transloadit, indem Sie die Methode save aufrufen. Diese Methode aktiviert standardmäßig die fortsetzbaren Uploads von tus⁠. Unsere aktualisierte Klasse Example sollte nun so aussehen:

   import com.transloadit.sdk.Transloadit;
   import com.transloadit.sdk.exceptions.LocalOperationException;
   import com.transloadit.sdk.exceptions.RequestException;
   import com.transloadit.sdk.response.AssemblyResponse;
   import java.io.File;
   import java.util.HashMap;
   import java.util.Map;
   import com.transloadit.sdk.Assembly;
   
   public class Example {
   
     public static void main(String[] args) {
       Transloadit transloadit = new Transloadit("YOUR_TRANSLOADIT_KEY", "YOUR_TRANSLOADIT_SECRET");
   
       Assembly assembly = transloadit.newAssembly();
   
       Map<String, Object> stepOptions = new HashMap<>();
       stepOptions.put("width", 75);
       stepOptions.put("height", 75);
       assembly.addStep("resize", "/image/resize", stepOptions);
   
       assembly.addFile(new File("PATH/TO/FILE.jpg"));
       try {
         AssemblyResponse response = assembly.save();
       } catch (RequestException | LocalOperationException e) {
         // handle exception here
         e.printStackTrace();
       }
     }
   }
   

5. Da wir warten möchten, bis die Ausführung der Assembly abgeschlossen ist, bevor wir uns das Ergebnis ansehen, fügen wir nun einen weiteren Codeausschnitt hinzu, sodass die Klasse so aussieht:

   import com.transloadit.sdk.Transloadit;
   import com.transloadit.sdk.exceptions.LocalOperationException;
   import com.transloadit.sdk.exceptions.RequestException;
   import com.transloadit.sdk.response.AssemblyResponse;
   import java.io.File;
   import java.util.HashMap;
   import java.util.Map;
   import com.transloadit.sdk.Assembly;
   
   public class Example {
   
     public static void main(String[] args) {
       Transloadit transloadit = new Transloadit("YOUR_TRANSLOADIT_KEY", "YOUR_TRANSLOADIT_SECRET");
   
       Assembly assembly = transloadit.newAssembly();
   
       Map<String, Object> stepOptions = new HashMap<>();
       stepOptions.put("width", 75);
       stepOptions.put("height", 75);
       assembly.addStep("resize", "/image/resize", stepOptions);
   
       assembly.addFile(new File("PATH/TO/FILE.jpg"));
       try {
         AssemblyResponse response = assembly.save();
         // wait for assembly to finish executing.
         while (!response.isFinished()) {
           response = transloadit.getAssemblyByUrl(response.getSslUrl());
         }
         String resultUrl = response.getStepResult("resize").getJSONObject(0).getString("url");
         System.out.println("Here's your assembly result: " + resultUrl);
       } catch (RequestException | LocalOperationException e) {
         // handle exception here
         e.printStackTrace();
       }
     }
   }
   

Und fertig! So einfach ist es, unser neues Java SDK zum Laufen zu bringen. 😄

Ausführlichere Dokumentation und Beispiele finden Sie hier:

• Beispiele: https://github.com/transloadit/java-sdk/tree/master/examples⁠
• Quellcode: https://github.com/transloadit/java-sdk⁠
• Dokumentation: https://javadoc.io/doc/com.transloadit.sdk/transloadit/0.0.3⁠

Wir hoffen, dass Ihnen unsere neue Version gefällt. Bleiben Sie dran, es kommt noch mehr!