java - リスト、配列、マップなどのメッセージ本文の例xml / jsonをenunciateで生成しますか？

Question

enunciateを介してRESTAPIドキュメントを生成することができ、メッセージ本文用に生成されるxmlとjsonの例が本当に気に入っています。しかし、リスト、配列、マップなどのそれらを生成する方法を見つけることができません。

私はmavenを使用しており、ビルドプラグインのmavenノード内にdocsゴールを持つenunciateプラグイン（通常）で構成されています。

これは可能ですか？

ありがとう。

Answer 1

残念ながら、Enunciateは現時点ではこれをサポートしていません。

その理由は歴史的です。Enunciateは、JSONがすべて普及する前に作成されたため、元の設計では、JAXBオブジェクトを返すWebサービスのみを文書化することでした。JSONのサポートは後で追加され、それ以来何度も拡張されています。

今日でも、EnunciateのJSONサポートは、POJOでのみサポートされており、Jacksonアノテーションなどではなく、JAXBアノテーションに基づいているため、二流市民のように感じられます。JSONを第一級市民にするための作業はまだ必要ですが、Java標準のJSONアノテーションセット（JAXBアノテーションセットなど）がないため、その取り組みは妨げられています。したがって、作業が今日行われた場合、特定のJSONライブラリの実装（おそらくJackson）に関連付ける必要があります。