Customers Mail Cloud 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";
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;
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、添付ファイルは今後対応します。まず最も多いであろうテキストメール送信について、ぜひご利用ください。