Lançando nosso SDK Java oficial

Ifedapo Olarewaju

Desenvolvedor · Lagos, Nigéria · Mostrar biografia

Falamos sério quando dissemos que vinham novidades empolgantes sobre nossos SDKs. Para provar isso, queremos mostrar um pouco do que estamos preparando.

Hoje temos o prazer de anunciar o lançamento oficial do nosso SDK Java!

Este SDK vem com os recursos a seguir e também inclui suporte à nossa API de tus⁠, adicionada recentemente:

• Criar uma Assembly (claro). Isso oferece suporte a uploads retomáveis com tus⁠, o que é ótimo quando você envia arquivos grandes por uma rede instável.
• Obter uma Assembly
• Cancelar a execução de uma Assembly
• Listar Assemblies
• Criar um Template
• Atualizar um Template
• Excluir um Template
• Listar Templates
• Obter um Template
• Obter a fatura mensal da sua conta

Veja alguns passos rápidos para começar:

1. Instale o SDK baixando-o manualmente pelo Maven Central Search⁠. Você também pode instalá-lo pelos nossos repositórios Maven e 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. Crie uma classe Example e instancie o cliente da Transloadit dentro dela. Para isso, você precisará informar suas credenciais 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. Crie uma nova instância de Assembly e adicione o arquivo que você quer enviar, junto com os Assembly Steps e as Instructions, para processá-lo. Depois disso, sua classe atualizada deve ficar assim:

   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. Envie a Assembly para a Transloadit chamando o método save. Esse método habilita por padrão os uploads retomáveis do tus⁠. Nossa classe Example atualizada agora deve ficar assim:

   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 até que a execução da Assembly seja concluída antes de ver o resultado, vamos adicionar mais um trecho para que a classe fique assim:

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

E pronto! Colocar nosso novo SDK Java para funcionar é simples assim. 😄

Para documentação e exemplos mais detalhados, confira:

• Exemplos: https://github.com/transloadit/java-sdk/tree/master/examples⁠
• Código-fonte: https://github.com/transloadit/java-sdk⁠
• Documentação: https://javadoc.io/doc/com.transloadit.sdk/transloadit/0.0.3⁠

Esperamos que você aproveite nosso novo lançamento. Fique de olho, vem mais por aí!