web API .net - .net core 对比学习-使用Swagger
-
King
根据前两篇的介绍，我们知道.net web api 和 .net core web api在配置方面的不同如下：
1. .net web api的配置是在 App_Stat文件夹里面添加对应的配置类，然后在Global.asax.cs文件里面注册。
2. .net web api的配置是在Startup文件的Config和ConfigService方法里面添加注册。
对于swagger的配置,与上面的类似，我们来看一下如何在.net web api 和 .net core api项目中添加swagger.
1. 添加nuget包。
左边是.net core 需要使用的包：Swashbuckle.AspNetCore
右边是.net需要使用的包： Swashbuckle 和 Swashbuckle.Core
2. 配置使用swagger.
对于.net core web api项目我们在Startup中的ConfigService和Config方法中添加以下代码。下面的代码省去了添加MVC和路由的配置。
public void ConfigureServices(IServiceCollection services)
{
//添加swagger文档
services.AddSwaggerGen(
c => {
c.SwaggerDoc("v1", new Info
{
Title = "Test Api",
Version = "v1",
Description = "Swagger学习",
TermsOfService = "Note",
Contact = new Contact { Name = "Email", Email = "该邮件地址已受到反垃圾邮件插件保护。要显示它需要在浏览器中启用 JavaScript。", Url = "https://home.cnblogs.com/u/ZhangDamon" }
});
});
}
public void Configure(IApplicationBuilder app, IHostingEnvironment env)
{
app.UseSwaggerUI(
c => {
c.SwaggerEndpoint("/swagger/v1/swagger.json", "Test Web API");
});
}
知识兔对于.net web api项目，当安装完nuget包之后，在App_Start文件夹中会自动生成SwaggerConfig.cs文件。我们删除里面的注释，保留以下代码。
using System.Web.Http;
using WebActivatorEx;
using FreWebApi;
using Swashbuckle.Application;
using Swashbuckle.Swagger;
using System.Collections.Generic;
using System.Web.Http.Description;
[assembly: PreApplicationStartMethod(typeof(SwaggerConfig), "Register")]
namespace FreWebApi
{
public class SwaggerConfig
{
public static void Register()
{
var thisAssembly = typeof(SwaggerConfig).Assembly;
GlobalConfiguration.Configuration
.EnableSwagger(c =>
{
c.SingleApiVersion("v1", "FreWebApi");
c.IncludeXmlComments(GetXmlCommentsPath());
//c.OperationFilter<HttpHeaderFilter>();
})
.EnableSwaggerUi(c =>
{
c.InjectJavaScript(thisAssembly, "SwaggerDemo.Scripts.swaggerui.swagger_lang.js");
});
}
private static string GetXmlCommentsPath()
{
return string.Format(@"{0}\bin\FreWebApi.xml", System.AppDomain.CurrentDomain.BaseDirectory);
}
}
}
知识兔这个时候我们打开运行然后浏览器中输入swagger地址，就可以看到swagger ui界面了。
根据前两篇的介绍，我们知道.net web api 和 .net core web api在配置方面的不同如下：
1. .net web api的配置是在 App_Stat文件夹里面添加对应的配置类，然后在Global.asax.cs文件里面注册。
2. .net web api的配置是在Startup文件的Config和ConfigService方法里面添加注册。
对于swagger的配置,与上面的类似，我们来看一下如何在.net web api 和 .net core api项目中添加swagger.
1. 添加nuget包。
左边是.net core 需要使用的包：Swashbuckle.AspNetCore
右边是.net需要使用的包： Swashbuckle 和 Swashbuckle.Core
2. 配置使用swagger.
对于.net core web api项目我们在Startup中的ConfigService和Config方法中添加以下代码。下面的代码省去了添加MVC和路由的配置。
public void ConfigureServices(IServiceCollection services)
{
//添加swagger文档
services.AddSwaggerGen(
c => {
c.SwaggerDoc("v1", new Info
{
Title = "Test Api",
Version = "v1",
Description = "Swagger学习",
TermsOfService = "Note",
Contact = new Contact { Name = "Email", Email = "该邮件地址已受到反垃圾邮件插件保护。要显示它需要在浏览器中启用 JavaScript。", Url = "https://home.cnblogs.com/u/ZhangDamon" }
});
});
}
对于.net web api项目，当安装完nuget包之后，在App_Start文件夹中会自动生成SwaggerConfig.cs文件。我们删除里面的注释，保留以下代码。
有的同学可能觉得奇怪，为什么我们这次不需要在Global.asax.cs文件里面注册swagger的配置，我们回顾一下SwaggerConfig的代码，里面下面这有下面这个特性，它可以指定在web api 启动的时候自动注册swagger的配置。
3. 注释文档的配置
对于.net 和.net core 来说生产文档注释的配置基本类似，首先我们需要添加xml路径，右击项目->属性->生产，选择输出路径，一般情况下都会有个默认路径不需要修改。