Lancement de notre SDK Java officiel

Nous étions sérieux lorsque nous avons annoncé que des nouvelles passionnantes concernant nos SDK allaient bientôt arriver, et pour le prouver, nous aimerions vous donner un avant-goût de ce que nous vous réservons.

Aujourd’hui, nous avons le plaisir d’annoncer la sortie officielle de notre SDK Java !

Ce SDK offre les fonctionnalités suivantes et prend également en charge notre API tus⁠ récemment ajoutée :

• Créer une Assembly (bien sûr). Cette fonction prend en charge les téléversements avec reprise de tus⁠, ce qui est idéal lorsque vous téléversez des fichiers volumineux sur un réseau peu fiable.
• Récupérer une Assembly
• Annuler l’exécution d’une Assembly
• Lister les Assemblies
• Créer un Template
• Mettre à jour un Template
• Supprimer un Template
• Lister les Templates
• Récupérer un Template
• Récupérer la facture mensuelle de votre compte

Voici quelques étapes rapides pour bien démarrer :

1. Installez le SDK en le téléchargeant manuellement depuis Maven Central Search⁠, ou installez-le depuis nos dépôts Maven et Jcenter.

   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. Créez une classe Example dans laquelle vous instanciez le client Transloadit. Vous devrez pour cela saisir vos identifiants d’API :

   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. Créez une nouvelle instance d’Assembly et ajoutez le fichier que vous souhaitez téléverser, ainsi que les Assembly Steps et les Instructions, afin de le traiter. Une fois cela fait, votre classe mise à jour devrait ressembler à ceci :

   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. Soumettez l’Assembly à Transloadit en appelant la méthode save. Cette méthode active par défaut les téléversements avec reprise de tus⁠. Notre classe Example mise à jour devrait maintenant ressembler à ceci :

   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. Comme nous voulons attendre que l’exécution de l’Assembly soit terminée avant de consulter le résultat, nous allons maintenant ajouter un dernier extrait de code pour que la classe ressemble à ceci :

   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();
       }
     }
   }
   

Et voilà ! Rien de plus simple pour faire fonctionner notre nouveau SDK Java. 😄

Pour une documentation et des exemples plus détaillés, veuillez consulter :

• Exemples : https://github.com/transloadit/java-sdk/tree/master/examples⁠
• Code source : https://github.com/transloadit/java-sdk⁠
• Documentation : https://javadoc.io/doc/com.transloadit.sdk/transloadit/0.0.3⁠

Nous espérons que cette nouvelle version vous plaira. Restez à l’écoute pour la suite !