Javaを使ってBuildVu Microserviceにアクセスする
はじめに
以下のチュートリアルでは、ホストされたBuildVuクラウドAPIを使ってPDFファイルをHTMLやSVGに変換する方法を紹介します：
- IDRsolutionsのトライアルおよびクラウドサブスクリプションサービス
- あなた自身のセルフホストBuildVuマイクロサービス
上記のサービスはすべて、通常のHTTPリクエストでアクセスすることができますが、このチュートリアルでは、REST APIをシンプルなRubyラッパーとして提供する、オープンソースの Java IDRCloudClient を使用します。
前提条件
この作業を始める前に、JDKの最新バージョン（バージョン8以上）がインストールされていることを確認する必要があります。詳しくはJavaのウェブサイトをご覧ください。
サンプルコード
PDFファイルをHTMLやSVGに変換する基本的なコード例です。設定オプションと詳細機能は下記にあります。
import java.util.Map;
public final class ExampleUsage {
public static void main(final String[] args) {
final IDRCloudClient client = new IDRCloudClient("https://cloud.idrsolutions.com/cloud/" + IDRCloudClient.BUILDVU);
final HashMap<String, String> params = new HashMap<>();
params.put("token", "token"); //Required only when connecting to the IDRsolutions trial and cloud subscription service
params.put("input", IDRCloudClient.UPLOAD);
params.put("file", "path/to/file.pdf");
try {
final Map<String, String> results = client.convert(params);
System.out.println(" --------- ");
System.out.println(results.get("previewUrl"));
IDRCloudClient.downloadResults(results, "path/to/outputDir", "example");
} catch (final ClientException | InterruptedException e) {
e.printStackTrace();
}
}
}
コールバックURLへ結果を返す
BuildVu Microserviceは、完了時に変換ステータスを送信するコールバックURLを受け付けます。コールバックURLを使用すると、変換がいつ完了したかを判断するためにサービスをポーリングする必要がなくなります。
以下のように、コールバックの url を params マップに指定します。
final HashMap<String, String> params = new HashMap<>();
params.put("token", "token"); //Required only when connecting to the IDRsolutions trial and cloud subscription service
params.put("input", IDRCloudClient.UPLOAD);
params.put("file", "path/to/file.pdf");
params.put("callbackUrl", "http://listener.url");
設定オプション
BuildVu APIは、変換をカスタマイズするためのキーバリューペア設定オプションを含む文字列化されたJSONオブジェクトを受け付けます。この設定はconvertメソッドに与える必要があります。PDFファイルをHTMLまたはSVGに変換するための設定オプションの完全なリストはこちらをご覧ください。
params.put("settings", "{\"key\":\"value\",\"key\":\"value\"}");
URLによるアップロード
ローカルファイルをアップロードするだけでなく、BuildVu Microserviceがダウンロードして変換を実行するURLを指定することもできます。そのためには、parameters変数のinputとfileの値を以下のように置き換えてください。
params.put("input", IDRCloudClient.DOWNLOAD);
params.put("url", "http://exampleURL/exampleFile.pdf");
認証を使用する
BuildVu Microserviceに認証が必要な場合は、ユーザ名とパスワードを入力する必要があります。これらは、以下のように username と password という2つの変数を convert メソッドに渡すことで提供されます。
params.put("username","yourUsername");
params.put("password","yourPassword");