0
スワッガーのサンプルデータを表示する方法はありますか。モデル、両方の入力&出力、クエリパラメータ、ヘッダーなど?私はこれに関連するものを注釈のドキュメントで見つけることができませんでした。あなたがウィキに言及した注釈のいくつかのドキュメントを見れば https://github.com/swagger-api/swagger-core/wiki/Annotations-1.5.XスワッガーUIのサンプルデータ
スワッガーのサンプルデータを表示する方法はありますか。モデル、両方の入力&出力、クエリパラメータ、ヘッダーなど?私はこれに関連するものを注釈のドキュメントで見つけることができませんでした。あなたがウィキに言及した注釈のいくつかのドキュメントを見れば https://github.com/swagger-api/swagger-core/wiki/Annotations-1.5.XスワッガーUIのサンプルデータ
あなたは彼らがexample
またはexamples
と呼ばれる彼らのオプションパラメータ1の間で持って表示されます。このパラメータを使用して、1つの例を追加することも、複数の例を追加することもできます(許可されている場合)。
クエリパラメータのたとえばあなたが@ApiParam
注釈を使用して、このようにそれを行うことができます:返信用
@Path("/{username}")
@ApiOperation(value = "Updated user")
public Response updateUser(
@ApiParam(example = "moondaisy") @QueryParam("username") String username
) {
...
}
おかげで、クエリのparamsやヘッダのええ例のパラメータは単純明快です。私は体の例を行う方法を理解することができませんでした。 PATCHメソッドは、複数のエンドポイントに対して再利用されるため、モデルに注釈を付ける必要が常にないため、特に困難です。 – user2524908