1. ホーム
  2. swagger

[解決済み] ネット5のウェブAPIでSwashbuckleをアップグレードしてSwaggerResponseを使用するには?

2022-02-19 07:17:37

質問

私たちは、Core2.2からnet5.0にアップグレードし、それに伴いSwashbuckleパッケージをアップグレードした、〜150コントローラ(〜500メソッド)を持つWeb APIを持っています。

旧バージョンのSwashbuckleでは SwaggerResponse 属性を使ってSwaggerUIに情報を表示することができ、私たちはそれを500以上のメソッドで多用しました。

ある時点で SwaggerResponse 属性は非推奨となり、推奨される解決策は別の方法となります。 https://github.com/domaindrivendev/Swashbuckle.AspNetCore/issues/159

を行う方法はありますか?

  • を使用するか SwaggerResponse 属性で指定するか、あるいは、最新のSwashbuckleで
  • 既存のコードを変換しますか?

どのように解決するのですか?

を使用することをお勧めします。 ProduceResponseTypeAttribute を使用することができます。 SwaggerResponse NuGet パッケージ経由で Swashbuckle.AspNetCore.Annotations .

タイプ SwaggerResponse は完全に削除されたわけではなく、メインの Swashbuckle パッケージから移動しただけです。 Swashbuckle.AspNetCore をオプションの追加パッケージ Swashbuckle.AspNetCore.Annotations(アノテーション)