.Net Core 使用swagger UI

swagger UI json

第一步:首先添加包Swashbuckle.AspNetCore (可經過微軟添加包命令Install-Package 包名進行添加,也能夠經過管理NuGet程序包進行添加)windows

第二步:修改launchUrl爲swagger,即程序啓動後進入swagger UI風格頁面也能夠說Rest風格。app

{
  "$schema": "http://json.schemastore.org/launchsettings.json",
  "iisSettings": {
    "windowsAuthentication": false, 
    "anonymousAuthentication": true, 
    "iisExpress": {
      "applicationUrl": "http://localhost:55360",
      "sslPort": 44347
    }
  },
  "profiles": {
    "IIS Express": {
      "commandName": "IISExpress",
      "launchBrowser": true,
      "launchUrl": "swagger",
      "environmentVariables": {
        "ASPNETCORE_ENVIRONMENT": "Development"
      }
    },
    "WebApi": {
      "commandName": "Project",
      "launchBrowser": true,
      "launchUrl": "swagger",
      "applicationUrl": "https://localhost:5001;http://localhost:5000",
      "environmentVariables": {
        "ASPNETCORE_ENVIRONMENT": "Development"
      }
    }
  }
}
launchSettings.json

第三步:在Startup.cs中的方法ConfigureServices方法中添加swagger 相關代碼。ide

   public voidConfigureServices(IServiceCollection services)
        {
         

            services.AddMvc();
            #region  添加SwaggerUI

            services.AddSwaggerGen(options =>
            {
                options.SwaggerDoc("v1", new Info
                {
                    Title = "dapper API接口文檔",
                    Version = "v1",
                    Description = "RESTful API for Dapper",
                    TermsOfService = "Z Terms Of Service",
                    Contact = new Contact { Name = "zhang", Email = "904086892@qq.com", Url = "" }
                });
            });
            #endregion
  }
ConfigureServices方法

第四步:在Startup.cs中的方法Configure方法中添加swagger 相關代碼。ui

 public void Configure(IApplicationBuilder app, IHostingEnvironment env)
        {            
            if (env.IsDevelopment())
                app.UseDeveloperExceptionPage();
            else
                app.UseHsts();

            #region 使用SwaggerUI

            app.UseSwagger();
            app.UseSwaggerUI(options =>
            {
                options.SwaggerEndpoint("/swagger/v1/swagger.json", "Dapper API V1");
            });

            #endregion
            app.UseHttpsRedirection();

            app.UseMvc();
        }                    
Configure方法

最後運行項目,可在該頁面下進行使用接口。效果以下:spa

相關文章
相關標籤/搜索