Lanzamiento de nuestro SDK oficial de Java

Ifedapo Olarewaju

Desarrollador · Lagos, Nigeria · Mostrar bio

Lo dijimos en serio cuando lo comentamos: se venían noticias emocionantes sobre nuestros SDK y, para demostrarlo, queremos darte un adelanto de lo que tenemos preparado.

Hoy nos complace anunciar el lanzamiento oficial de nuestro SDK de Java.

Este SDK incluye las siguientes funciones y también soporte para nuestra API del protocolo tus⁠, añadida recientemente:

• Crear una Assembly (por supuesto). Esto admite las subidas reanudables del protocolo tus⁠, algo ideal cuando subes archivos grandes en una red poco fiable.
• Obtener una Assembly
• Cancelar la ejecución de una Assembly
• Listar Assemblies
• Crear un Template
• Actualizar un Template
• Eliminar un Template
• Listar Templates
• Obtener un Template
• Obtener la factura mensual de tu cuenta

Aquí tienes algunos pasos rápidos para empezar:

1. Instala el SDK descargándolo manualmente desde Maven Central Search⁠, o bien puedes instalarlo desde nuestros repositorios de Maven y 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. Crea una clase Example e instancia en ella el cliente de Transloadit. Para ello tendrás que introducir tus credenciales de 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. Crea una nueva instancia de Assembly y añade el archivo que quieres subir, junto con los Assembly Steps y las Instructions, para poder procesarlo. Después de hacerlo, tu clase actualizada debería verse así:

   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. Envía la Assembly a Transloadit llamando al método save. Este método habilita de forma predeterminada las subidas reanudables del protocolo tus⁠. Nuestra clase Example actualizada ahora debería verse así:

   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. Como queremos esperar a que se complete la ejecución de la Assembly antes de ver el resultado, ahora añadiremos un fragmento más para que la clase quede así:

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

¡Y listo! Es así de fácil poner en marcha nuestro nuevo SDK de Java. 😄

Para obtener documentación y ejemplos más detallados, echa un vistazo a:

• Ejemplos: https://github.com/transloadit/java-sdk/tree/master/examples⁠
• Código fuente: https://github.com/transloadit/java-sdk⁠
• Documentación: https://javadoc.io/doc/com.transloadit.sdk/transloadit/0.0.3⁠

Esperamos que disfrutes de nuestro nuevo lanzamiento. ¡Mantente atento, que viene más!