公式 Java SDK のリリース
SDK に関する楽しみなお知らせを予告した先日の投稿は、口先だけではありません。今回は、準備してきたものを少しご紹介します。
本日、公式 Java SDK をリリースしました!

この SDK は以下の機能を備え、最近追加した tus API にも対応しています。
- Assemblyの作成(もちろんです)。tus による再開可能なアップロードに対応しているため、不安定なネットワークで大きなファイルをアップロードする場合に便利です。
- Assemblyの取得
- Assemblyの実行のキャンセル
- Assemblyの一覧取得
- Templateの作成
- Templateの更新
- Templateの削除
- Templateの一覧取得
- Templateの取得
- アカウントの月次請求書の取得
簡単な手順で使い始められます。
-
Maven Central Search から SDK を手動でダウンロードしてインストールするか、当社の Maven および 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> -
Exampleクラスを作成し、その中で Transloadit クライアントをインスタンス化します。ここでは 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"); } } -
新しいAssemblyインスタンスを作成し、アップロードするファイルと、その処理に使うAssembly Stepおよび処理設定を追加します。更新後のクラスは次のようになります。
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")); } } -
saveメソッドを呼び出して、Assemblyを Transloadit に送信します。このメソッドでは、tus による再開可能なアップロードがデフォルトで有効になります。更新後のExampleクラスは次のようになります。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(); } } } -
Assemblyの実行が完了してから結果を確認したいので、コードをさらに追加します。クラスは次のようになります。
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(); } } }
これで準備完了です!新しい Java SDK は、このように簡単に使い始められます。😄
詳しいドキュメントやサンプルについては、以下をご覧ください。
- サンプル: https://github.com/transloadit/java-sdk/tree/master/examples
- ソースコード: https://github.com/transloadit/java-sdk
- ドキュメント: https://javadoc.io/doc/com.transloadit.sdk/transloadit/0.0.3
新しいリリースをぜひご活用ください。今後のお知らせもお楽しみに!
