MicroProfileは大小様々な仕様が存在します。 前回紹介したサンプルアプリにMicroProfileの各機能を組み込んでフィット感を試してみた結果、MicroProfileを採用するのであれば『これは抑えておくベキ、もしくは使っておくベキ』と言える仕様がいくつかありました。今回はその中から厳選した3つの仕様をランキング形式で紹介します。

APIレベルまでまとめて1度で説明するのはムリがあるため、今回はどんなことができるかの概要を紹介し、APIも含めた利用法は次回3回に分けて説明していきます。

話しは戻って、それでは早速ランキング発表に行きます！

REST APIの仕様はOAS(OpenAPI Specification)に従った形式で記述するのが最近のスタンダードとなりつつありますが、MicroProfile OpenAPIはこのOASをコードから生成するためのアノテーションとそのOASの取得方法を定めた仕様となります。

と言ってもピンと来ないかと思いますので動作イメージを図にしてみると次のようになります。

MicroProfile OpenAPIを利用することで、図のように『REST APIを公開しているサーバが、自身が動作させているモジュールから取得した情報をもとに、OASでAPI仕様を返却する』と言った、ある意味完全なまでの仕様と実装の一致を実現する^[1]ことが可能となります。

またもう1つのメリットは、例えばパラメータの意味などコードから解釈できない情報は当然アノテーションで意味を明示する必要がありますが、コードから解釈できるものはアノテーションを付けなくともコードをもとにかなりの程度のOASドキュメントを自動で生成してくれます。

OASドキュメントをスクラッチから手で書いていて特に手間が掛かるものとして、入出力に利用するDTOの定義がありますが、これはなにも手を加えなくても使用に十分耐える程度のOASドキュメントをコードから生成してくれます。すごく便利です！

マイクロサービスなアプリケーションはコンテナ上での稼働が前提となるため、ポータブルである必要があります。

このため、内部で持っている設定をアプリケーション外部の環境変数などで上書きする機能や同じ設定を複数の設定源が持っている場合、設定源ごとに優先度を定義し値を決定するといった機能が必要となります。

MicroProfile Configは正にこのようなことが考慮された設定仕様となります。
例えば下の図のようにjarの内部にデフォルト値として開発用の接続先情報を持たせ、環境ごとに環境変数でこの設定を変更するといったことが簡単にできるようになります。

また、MicroProfile ConfigはJava SE環境でも動作可能でCDIを必須としません。ですので、MicroProfileとしてではなく、このConfig機能だけ単独でも利用できます^[2]。なので、これ単独でも利用したくなるくらい使い勝手の良い設定機能と言えます。

REST通信にはREST APIを公開する側のRESTリソースとREST APIを呼び出す側のRESTクライアントの2つが登場します。

JAX-RSを使ってRESTクラアントを実装する場合、JAX-RSのWebTargetクラスを使ってリクエストの送受信を行う定型的で冗長な実装が必要となります。しかし、MicroProfile RestClientを使うとなんと！このRESTクライアントの実装が不要となります。

必要となるのは呼び出すREST APIを表したJavaのインタフェースのみとなります。RESTクライアントで必要となる呼び出し処理はMicroProfileのランタイムにより、インタフェースに基づいたProxyが動的に生成され処理されます^[3]。

またRESTリソース側の統合テストレベルを行う場合、疑似的な対向アプリとなるRESTクライアント側のテストコードの実装に手間が掛かりましたが、RestClientの仕組みと使うことで、RESTクライアントの実装をせずにRESTリソース自身のインタフェースを使ってRESTリソースの呼び出しが行えるため、テストでも威力を発揮します。

厳選3仕様、いかがでしたでしょうか。使ってみたいなと少しでも思っていただけたら幸いです。次回は3回に分けて今回紹介したそれぞれの仕様についてAPIレベルで利用法を紹介していきたいと思います。