Customers Mail Cloud Java SDK（非公式）にて追加パラメーターに対応しました

Java SDK 技術情報

システムからメール送信を行う処理を実装することはよくあります。多くの場合、ローカルサーバからSMTPを使いますが、FaaSなどでSMTPポートがふさがれていることがあります。そうした時に便利なのがWeb API経由でのメール送信になります。

今回、非公式ではありますがJavaでCustomers Mail Cloudを手軽に使えるようにするSDKを更新しましたので、使い方を解説します。

コードについて

コードはgoofmint/Customers-Mail-Cloud-Java: Customers Mail CloudのJava用SDKですにて公開しています。ライセンスはMIT Licenseで、自由に利用、改変可能です。

共通処理

初期化は次のように行います。

String apiKey = System.getenv("API_KEY");;
String apiUser = System.getenv("API_USER");;
client =  new CustomersMailCloud(apiUser, apiKey);

契約内容の設定

契約状態によってメソッドが異なります。

  • トライアル client.trial();
  • スタンダード client.standard();
  • プロ client.pro(subdomain);

メール送信

CustomersMailCloudMail mail = client.getMail();
mail.subject = "Test mail";
mail.text = "Mail body";
mail.html = "<h1>Mail body</h1>";
CustomersMailCloudMailAddress toAddress = new CustomersMailCloudMailAddress();
toAddress.name = "Example user";
toAddress.address = "example@example.com";
mail.to = new CustomersMailCloudMailAddress[1];
mail.to[0] = toAddress;
CustomersMailCloudMailAddress fromAddress = new CustomersMailCloudMailAddress();
fromAddress.name = "Admin";
fromAddress.address = "info@smtps.jp";
mail.from = fromAddress;

今回、さらに以下のプロパティが使えるようになりました。

// 追加ヘッダー
mail.addHeader("X-Custom-Header", "CustomValue");
// ReplyTo
CustomersMailCloudMailAddress replyToAddress = new CustomersMailCloudMailAddress();
replyToAddress.name = "Reply To";
replyToAddress.address = "replyto@example.com";
mail.reply_to = replyToAddress;
// EnvFrom
mail.env_from = "envfrom@example.com";

そして、 send メソッドで送信を行います。

String id = client.send(mail);
System.out.println(id);

結果はIDが返ってきます。

<f23ec790-403f-11eb-a4d7-9ca3ba311822@mta03.sandbox.smtps.jp>

エラーの場合

エラーの場合は CustomersMailCloudException が返ってきます。

try {
  // 略
} catch (CustomersMailCloudException e) {
  System.err.println(e.getMessage());
}

この中にエラーメッセージが返ってきます。

まとめ

現在はテキストとHTMLメールの送信のみサポートしています。添付ファイルは今後対応予定です。まず最も利用が多いであろうテキストメール送信について、ぜひご利用ください。