デフォルトでは、Swagger はクラスのデータ メンバーを解析して、パラメーターとして使用されるオブジェクト、または特定の Web サービスによって返されるオブジェクトを文書化します。Jackson を使用している場合、Jackson アノテーションは API のより正確な説明を提供します。
Swagger に Jackson アノテーションを解析させる (簡単な) 方法を知っている人はいますか? おそらくオーバーライドされたパーサーですか?
これが役立つかどうかは定かではありませんが、Jackson 2.1 以降では、Jackson 自身が見ている POJO 構造を公開しており ( ObjectMapper.acceptJsonFormatVisitor
)、さまざまな種類のアーティファクトの生成に使用できます。たとえば、Avroスキーマジェネレーターを作成しました(Jackson Avroモジュールの一部として)
バージョン 1.2 の時点で、Swagger は独自に Jackson アノテーションを解析できます。Jackson 2.1を使用してこれを確認しました。