在Startup中 services.AddSwaggerGen(options => { options.SwaggerDoc("v1", new Info { Title = "IMS API", Version = "v1" }); options.SwaggerDoc("v2", new Info { Title = "IMS API V2", Version = "v2"

上一篇net core 2.2 swagger的枚举描述,core 3.0 需要升级swagger到5.0rc版,配置需要做些修改,swaager启用了OpenApi标准,之前的枚举描述方法也失效了. 这里通过了反射程序集,获取所有枚举定义放入字典,然后通过OpenApiSchema.Key来查表找到对应的枚举类型,通过Microsoft.OpenApi.Any.OpenApiInteger.Value强转会枚举,再补写枚举对应的描述. /// <summary> /// 基本状态 /// &

dotnet core 2.2开发项目中,常会使用Swagger UI来生成在线Api文档. 某些接口不想放到Swagger中可以这样写Filter: /// <summary> /// 隐藏swagger接口特性标识 /// </summary> [System.AttributeUsage(System.AttributeTargets.Method | System.AttributeTargets.Class)] public partial class HiddenApi

模型类的某些属性以枚举形式出现,我们希望在打开编辑表单时在选择列表中显示枚举值.有时我们想要枚举元素名称,但有时我们想要使用自定义名称甚至翻译. 这个例子演示了如何获取枚举元素名称以选择ASP.NET Core上的列表. 假设我们有一个客户实体,其客户类型属性定义为枚举. public class Customer { public Guid Id { get; set; } public string Name { get; set; } public CustomerTypeEnum Typ

集成.NET Core+Swagger+Consul+Polly+Ocelot+IdentityServer4+Exceptionless+Apollo的微服务开发框架 Github源代码地址 https://github.com/PeyShine/Demo.MicroServer Apollo配置中心 Apollo(阿波罗)是携程框架部门研发的分布式配置中心,能够集中化管理应用不同环境.不同集群的配置,配置修改后能够实时推送到应用端,并且具备规范的权限.流程治理等特性,适用于微服务配置管理场景

原文:MVC中下拉框显示枚举项 本篇将通过3种方式,把枚举项上的自定义属性填充到下拉框: 1.通过控制器返回List<SelectListItem>类型给前台视图 2.通过为枚举类型属性打上UIHint属性让模版显示枚举项 3.通过自定义元数据提供器DataAnnotationsModelMetadataProvider让模版显示枚举项   我们经常会把类型为Int16的属性通过枚举来获得.比如: public class SomeClass { public int16 Status{get

之前的博文 ASP.NET Core中显示自定义错误页面 中的方法是在项目中硬编码实现的,当有多个项目时,就会造成不同项目之间的重复代码,不可取. 在这篇博文中改用middleware实现,并且放在独立的项目中发布成NuGet包,项目中使用时只需安装NuGet包,然后在Startup的Configure()方法中添加如下的一行代码. app.UseCustomErrorPages(); CustomErrorPagesMiddleware的实现代码如下: public class CustomE

PowerDesigner中默认不显示Common注释列,可根据以下步骤显示并紫东填充Name列内容. 1.显示Common注释列 2.运行VB Script脚本自动赋值 使用Shift+Ctrl+X快捷键打开脚本运行窗口,粘贴以下代码执行即可. 注:若Common列为空,则填充Name列内容:不为空则必不变. '如果comment为空,则填入name;如果不为空,则保留不变,避免已有的注释丢失. Option Explicit ValidationMode = True Interactive

从ASP.NET MVC 5开始,Html.DropDownListFor已经提供了对Enum的支持,但在这以前,需要通过帮助方法或扩展方法来让Html.DropDownListFor显示枚举值. 本篇解决在ASP.NET MVC 4 下Html.DropDownListFor显示默认项的问题. 以上,使用Select是通过Html.DropDownListFor来实现的,Select的选项值是从枚举中读出.可以看到,某个枚举值成了默认选项,而我想让"==请选择=="成为Select的

Eclipse+pydev解决中文显示和注释问题的方法大全 Eclipse的设置 window->preferences->general->editors->texteditors->spelling->encoding->UTF-8,编辑器的编码格式 window->preferences->workspace->textfile encoding->UTF-8 打开eclipse安装目录->eclipse.ini,末行加上”-D

swagger是webapi文档描述及调试工具,要在asp.net mvc中使用swagger,需要安装Swashbuckle.Core这个包,安装好后会在app_start中生成SwaggerConfig.cs文件,修改Register方法在文件中指定webapi项目生成的xml文件所在路径,详细配置请参考 https://github.com/domaindrivendev/Swashbuckle using System.Web.Http; using WebActivatorEx; us

一.入门 https://www.nuget.org/packages/Swashbuckle.AspNetCore.SwaggerGen/ 1.添加核心NUGET包 Swashbuckle.AspNetCore: 2.startup中配置: ConfigureServices中: //注册swagger生成器,定义一个或多个swagger文档 services.AddSwaggerGen(c => { c.SwaggerDoc("v1", new Info { Version

引用作者原话:Asp.Net的WebApi中使用Swagger作为说明和测试的页面是非常不错的,比起WebApiTestClient来至少在界面上的很大的提升.但是使用Swagger时如果只是一般的控制器直接放到Controller下就可以了,而如果因不同的业务需求而需要分类或者有同名的类名时时则没办法很好的处理. 因为业务需求需要创建域,但是Swagger 并未将域添加到接口.所以需要加上以下操作才行. 安装Swagger 方法:  为了大家多看微软官方文档.就直接引用Swagger安装及使用

Swagger 是一个规范和完整的框架,用于生成.描述.调用和可视化 RESTful 风格的 Web 服务.是一款RESTFUL接口的文档在线自动生成+功能测试软件.主要目的是构建标准的.稳定的.可重用的.交互式的API以及简单方便的功能测试.总体目标是使客户端和文件系统作为服务器以同样的速度来更新.文件的方法,参数和模型紧密集成到服务器端的代码,允许API来始终保持同步.Swagger 让部署管理和使用功能强大的API从未如此简单. 作用:     1. 根据基于规范的标准设计和建模API  

项目之前开发完接口后,我们还需要写接口说明文档,现在有了swagger方便了很多,可以网页版直接测试,当然了也减少了我们的工作量. 使用swagger生成接口说明文档,大致需要2个步骤 1.从“管理 NuGet 程序包”对话框中: 右键单击“解决方案资源管理器” > “管理 NuGet 包”中的项目 将“包源”设置为“nuget.org” 在搜索框中输入“Swashbuckle.AspNetCore” 从“浏览”选项卡中选择“Swashbuckle.AspNetCore”包,然后单击“安装” 2

开始之前,先介绍下swagger常用方法. services.AddSwaggerGen    //添加swagger中间件 c.SwaggerDoc  //配置swagger文档,也就是右上角的下拉框内容 c.IncludeXmlComments  //引用程序集xml,用于加载出 备注信息等如图 c.AddSecurityDefinition  //添加授权验证  c.DocInclusionPredicate    //核心方法,指定分组被加载时 回调进入,也就是swagger右上角下拉框

1.本文章参考 点击链接跳转 改写的 一对多分组模式.需要一对一的可以参考 2.本文主要讲的是 一对多 分组公用, 同时把尚未分组的加载出来 3.效果演示GIF图: 具体操作代码如下: 1.在项目创建一个目录(ApiGroup),然后创建三个类,分别为ApiGroupAttribute.cs(控制器特性),ApiGroupNames.css(系统分组枚举),GroupInfoAttribute.cs(给系统分组枚举值增加相关信息的特性,这个主要是用于在Swagger分组时可关联Title,Ver

在 ASP.NET Core 中,默认情况下当发生500或404错误时,只返回http状态码,不返回任何内容,页面一片空白. 如果在 Startup.cs 的 Configure() 中加上 app.UseStatusCodePages(); ,500错误时依然是一片空白(不知为何对500错误不起作用),404错误时有所改观,页面会显示下面的文字: Status Code: 404; Not Found 如果我们想实现不管500还是404错误都显示自己定制的友好错误页面,那该怎么办呢? 对于50

public enum 枚举名称    {        /// <summary>        /// 注释描述1        /// </summary>        [Description("注释描述1")]//通过Description可以通过C#方法读取到描述信息        Yes = 1,        /// <summary>        /// 注释描述2        /// </summary>    

因为场景需要,要把某些特定的api过滤掉,不允许显示在swaggerui里, 具体操作步骤: 分为三步 步骤1: 创建Attribute    /// <summary> /// ignore some api on swagger.json /// </summary> [AttributeUsage(AttributeTargets.Method, AllowMultiple = false, Inherited = false)] public class SwaggerIg