ICode9

精准搜索请尝试: 精确搜索
首页 > 其他分享> 文章详细

Swashbuckle Swagger UI:如何从XML注释中的参数中删除必需的

2019-10-26 01:09:17  阅读:356  来源: 互联网

标签:swashbuckle c swagger-ui


我想在控制器中的某些参数上更改所需的属性.我使用XML注释来链接到Swagger.示例图片here

解决方法:

在继续之前,请仔细考虑您的参数.该参数是否确实需要,您的键入内容是否反映出来?是否有合理的默认值?在这种情况下,预期的行为是什么?根据您的答案,您可能更喜欢以下两种解决方案之一:

选项1:可选参数

如果accessTokenID具有合理的默认值,则可以在API签名上指定该值,并且Swashbuckle将根据需要停止标识该参数.

例如,此示例中的id在Swagger UI中将解析为可选:

public HttpResponseMessage Get(int id = 0)

如果确实不需要参数,则可为空的类型可能更有意义(例如,如果您在空输入中列出所有值):

public HttpResponseMessage Get(int? id = null)

选项2:SwaggerDefaultValue属性

solution in the Swashbuckle GitHub创建了一个IOperationFilter来处理SwaggerDefaultValue属性并将其应用于Swagger UI.如果您希望使用此参数,但是想在Swagger UI中设置一些默认值,则可以使用此解决方案.

例如,这将在Swagger UI文本字段中显示“ 0”,而不是“((必需)”):

[SwaggerDefaultValue("id", "0")]
public HttpResponseMessage Get(int id)

标签:swashbuckle,c,swagger-ui
来源: https://codeday.me/bug/20191026/1932693.html

本站声明: 1. iCode9 技术分享网(下文简称本站)提供的所有内容,仅供技术学习、探讨和分享;
2. 关于本站的所有留言、评论、转载及引用,纯属内容发起人的个人观点,与本站观点和立场无关;
3. 关于本站的所有言论和文字,纯属内容发起人的个人观点,与本站观点和立场无关;
4. 本站文章均是网友提供,不完全保证技术分享内容的完整性、准确性、时效性、风险性和版权归属;如您发现该文章侵犯了您的权益,可联系我们第一时间进行删除;
5. 本站为非盈利性的个人网站,所有内容不会用来进行牟利,也不会利用任何形式的广告来间接获益,纯粹是为了广大技术爱好者提供技术内容和技术思想的分享性交流网站。

专注分享技术,共同学习,共同进步。侵权联系[81616952@qq.com]

Copyright (C)ICode9.com, All Rights Reserved.

ICode9版权所有