首页
学习
活动
专区
工具
TVP
发布
精选内容/技术社群/优惠产品,尽在小程序
立即前往

为什么添加ApiExplorer会破坏Swashbuckle?

模型出错了,请稍后重试~

页面内容是否对你有帮助?
有帮助
没帮助

相关·内容

  • webapi文档描述-swagger

    阅读目录 使用swagger 汉化及问题解决 ApiExplorer思路拓展 总结 回到顶部 使用swagger   1.创建webapi项目解决方案   2.引用swagger nuget包   Swashbuckle...4.添加接口注释 完成上面三部运行项目,可以看到接口描述已经生成,浏览地址http://xxx/Swagger。但是没有接口的注释,下面添加接口注释 ?  项目属性->勾选生成xml文档文件 ?....js") }); 这段代码的作用是向页面输出引用Swashbuckle.Dummy.SwaggerExtensions.testScript1.js文件,或许疑问js文件路径为什么这么奇怪。...来反编译一下Swashbuckle.Core.dll ? 弄清楚了实现原理,现在来实现汉化。添加自己的中文语言包,和转换js,实现逻辑参考swagger源码。 ?   ...本篇所使用示例代码下载地址:SwaggerDemo,参考资源:       Swashbuckle:https://github.com/domaindrivendev/Swashbuckle

    1.7K90

    (转载非原创)由ASP.NET Core WebApi添加Swagger报错引发的探究

    当项目开发完成后,给项目添加Swagger,笔者用的是Swashbuckle.AspNetCore这个组件,添加Swagger的方式大致如下,首先是在Startup类的ConfigureServices...Swashbuckle.AspNetCore入手# 在GitHub上找到Swashbuckle.AspNetCore仓库位置,近期GitHub不太稳定,除了梯子貌似也没有很好的办法,多刷新几次将就着用吧...仓库中造了下没发现相关定义,于是用VS找到引用发现定义如下 namespace Microsoft.AspNetCore.Mvc.ApiExplorer { public interface IApiDescriptionGroupCollectionProvider...这样的话可以做到只添加一个扩展方法就能解决问题,而不需要挨个Action进行添加HttpMethod。...后续小插曲# 通过上面的方式解决了Swagger报错之后,在后来无意中翻看Swashbuckle.AspNetCore文档的时候发现了IDocumentFilter这个Swagger过滤器,想着如果能通过过滤器的方式去解决这个问题更优雅

    1.9K00

    .NET WebAPI 实现 接口版本控制并打通 Swagger支持

    api-version=2 header传入版本标记,通过校验 header 中的 api-version 字段的值,用来区分调用不同版本的api 第一种方式的缺陷很明显,当接口版本多了之后接口的地址定义很乱...首先创建一个 asp.net webapi 项目,本文使用 vs2022 直接创建 asp.net webapi 项目 项目创建好之后安装如下几个nuget包: Swashbuckle.AspNetCore...Microsoft.AspNetCore.Mvc.Versioning.ApiExplorer 注册 api 版本控制服务 #region 注册 api 版本控制 builder.Services.AddApiVersioning...移除项目默认的 swagger 配置 // Learn more about configuring Swagger/OpenAPI at https://aka.ms/aspnetcore/swashbuckle...只要在这些控制器头部添加 [ApiVersionNeutral] 标记即可,添加了 [ApiVersionNeutral] 标记的控制器则表明该控制器退出了版本控制逻辑,无论 app 前端传入的版本号的是多少

    1.1K40

    5. abp集成asp.net core

    接下来就是两个方法了,首先是IsRemoteService,顾名思义就是检索RemoteService,从代码来看,主要就是检索RemoteAttribute和继承自IRemoteService接口的类,为什么要根据这两个来检索呢...type in types) { ControllerTypes.Add(type); } } 它正是通过调用IsRemoteService方法来检索规约控制器,然后添加到...这句话是摘自博客 Introduction to the ApiExplorer in ASP.NET Core。我们翻译过来就是:ApiExplorer包含发现和公开MVC应用程序元数据的功能。...abp中是如何处理ApiExplorer的呢?...这是一个接口其中就有一个实现HttpMethodActionConstraint,这个类就是约束了Action的HTTP类型,也就是平时在action上标记的[HTTPGet],一般标记了此特性,aspnetcore默认实例化一个

    41910

    ASP.NET Core MVC应用模型的构建: Action的选择

    通过标注的特性注册到Action方法上的过滤器会被提取出来,对应的元数据添加到Filters属性中。...应用在Action方法上的用于封装路由信息(特性路由、约束和终结点元数据)的SelectorModel对象按照上述的方式构建出来,并添加到Selectors属性中。...标注到属性上的特性添加到Attributes属性中。如下所示的是描述Controller属性的PropertyModel类型,和描述Action方法参数的ParameterModel类型的定义。...标注在Controller类型或者Action方法上实现了IActionConstraintMetadata接口的特性作为约束添加到ActionConstraints属性中。...除此之外,这两个特性直接作为终结点元数据被添加到SelectorModel对象的EndpointMetadata属性中,该属性还会包含一个针对HTTP方法约束的HttpMethodMetada对象。

    15010

    VB.NET ASP.NET WebAPI及应用(番外篇)Swagger接口文档自动生成

    ---- 整体效果 请求效果: ---- 正题: 一,新建一个WebAPI应用(不会的认真看,前面文章有说,的跳过) 二,开始正题,创建WebAPI应用成功后,打开VS;工具->NuGet...包管理程器->管理解决方案的NuGet程序包 三,在浏览的搜索框里面 搜索Swagger关键字,找到Swashbuckle的程序包或者直接搜索Swashbuckle,然后点击安装 四,安装成功后会在...Imports System.Web.Http Imports Swashbuckle.Application <Assembly: PreApplicationStartMethod(GetType(...Class 七,在Controllers控制器目录下明天加一个默认HomeController控制器 八,然后点击运行项目,出现403错误不用管他(因为没有默认指定控制器),我们直接在地址后面添加...home 访问我们创建的home控制器即可 8.1.出现以下页面说明成功访问home控制器Swagger UI 九.接下来测试一下Swagger是否已经自动生成WebAPI文档,我们只需要在地址后面添加

    2.2K40

    ASP.NET Core 实战:构建带有版本控制的 API 接口

    在系统迭代的整个过程中,不可避免的添加新的资源,或是修改现有的资源,后端接口作为暴露给外界的服务,变动的越小,对服务的使用方造成的印象就越小,因此,如何对我们的 API 接口进行合适的版本控制,我们势必需要首先考虑...在使用 Swashbuckle.AspNetCore 之前,首先我们需要在 API(Grapefruit.WebApi) 项目中添加对于 Swashbuckle.AspNetCore 的引用。...当引用添加完成后,我们就可以在项目中配置 Swagger 了。 ? Install-Package Swashbuckle.AspNetCore ?   ...在重新生成项目的过程中,你会发现,错误列表显示很多警告信息,提示我们一些方法没有添加 XML 注释。...和上面使用 Swashbuckle.AspNetCore 的方式相同,在我们使用 Versioning 之前,需要在我们的 API 项目中添加对于该 dll 的引用。

    1.2K30

    或许是你应该了解的一些 ASP.NET Core Web API 使用小技巧

    如果你有看过构建可读性更高的 ASP.NET Core 路由这篇文章,你会发现其实我们最终实现的是 hyphen(-) 格式的 Url 地址,那么这里我们为什么不进行后续的修改了呢?   ...Install-Package Microsoft.AspNetCore.Mvc.Versioning Install-Package Microsoft.AspNetCore.Mvc.Versioning.ApiExplorer...首先,我们需要通过 Nuget 添加 Swashbuckle.AspNetCore 这个 dll 文件,之后我们就可以在此基础上实现对于 Swagger 的配置。...5、构建符合 Restful 风格的接口   在没有采用 Restful 风格来构建接口返回值时,我们可能习惯于在接口返回的信息中添加一个接口是否请求成功的标识,就像下面代码中示例的这种返回形式。...当然,当接口的 HTTP 返回状态码为 400 时,最终还是返回我们自定义的错误信息对象,所以这里为了不造成前后端对接上的歧义,我们最好将返回的对象信息也作为参数添加到 ProducesResponseType

    1.4K40
    领券