Web APi

2026-05-06 15:17:34 +00:00 · 2021-11-20 22:16:59 +10:00 · 2021-11-20 22:16:59 +10:00 · 2e8596e0b7
commit 2e8596e0b7
parent f6ae6364a9
16 changed files with 588 additions and 1 deletions
--- a/src/ServerManager.WebApplication/Startup.cs
+++ b/src/ServerManager.WebApplication/Startup.cs
@ -0,0 +1,101 @@
+using Microsoft.AspNetCore.Builder;
+using Microsoft.AspNetCore.Hosting;
+using Microsoft.AspNetCore.Mvc;
+using Microsoft.AspNetCore.Mvc.ApiExplorer;
+using Microsoft.AspNetCore.Mvc.Versioning;
+using Microsoft.Extensions.Configuration;
+using Microsoft.Extensions.DependencyInjection;
+using Microsoft.Extensions.Hosting;
+using ServerManager.WebApplication.Extensions;
+using ServerManager.WebApplication.Services;
+
+namespace ServerManager.WebApplication
+{
+    public class Startup
+    {
+        public Startup(IConfiguration configuration)
+        {
+            Configuration = configuration;
+        }
+
+        public IConfiguration Configuration { get; }
+
+        // This method gets called by the runtime. Use this method to add services to the container.
+        public void ConfigureServices(IServiceCollection services)
+        {
+            services.AddControllers();
+
+            services.AddResponseCaching();
+
+            /*
+             * https://github.com/Microsoft/aspnet-api-versioning/wiki
+             */
+            services.AddApiVersioning(o =>
+            {
+                o.DefaultApiVersion = ApiVersion.Default;
+                o.AssumeDefaultVersionWhenUnspecified = true;
+                o.ReportApiVersions = true;
+                o.ApiVersionReader = ApiVersionReader.Combine(
+                    new MediaTypeApiVersionReader("Version"),
+                    new HeaderApiVersionReader("X-Version")
+                );
+            });
+
+            services.AddVersionedApiExplorer(o =>
+            {
+                // add the versioned api explorer, which also adds IApiVersionDescriptionProvider service
+                // note: the specified format code will format the version as "'v'major[.minor][-status]"
+                o.GroupNameFormat = "'v'VVV";
+            });
+
+            services.AddScoped<IServerQueryService, QueryMasterService>();
+
+            services.AddSwaggerGen(o =>
+            {
+                o.OperationFilter<SwaggerDefaultValues>();
+            });
+        }
+
+        // This method gets called by the runtime. Use this method to configure the HTTP request pipeline.
+        public void Configure(IApplicationBuilder app, IWebHostEnvironment env, IApiVersionDescriptionProvider provider)
+        {
+            if (env.IsDevelopment())
+            {
+                app.UseDeveloperExceptionPage();
+            }
+
+            var enableSwagger = Configuration.GetValue<bool>("EnableSwagger");
+            if (enableSwagger)
+            {
+                var swaggerRoutePrefix = Configuration.GetValue<string>("SwaggerRoutePrefix");
+                if (!string.IsNullOrWhiteSpace(swaggerRoutePrefix) && !swaggerRoutePrefix.EndsWith("/"))
+                {
+                    swaggerRoutePrefix += "/";
+                }
+
+                app.UseSwagger();
+                app.UseSwaggerUI(o =>
+                {
+                    // build a swagger endpoint for each discovered API version
+                    foreach (var description in provider.ApiVersionDescriptions)
+                    {
+                        o.SwaggerEndpoint($"/{swaggerRoutePrefix}swagger/{description.GroupName}/swagger.json", $"Server Managers API {description.GroupName.ToUpperInvariant()}");
+                    }
+                });
+            }
+
+            app.UseHttpsRedirection();
+
+            app.UseRouting();
+
+            app.UseResponseCaching();
+
+            app.UseAuthorization();
+
+            app.UseEndpoints(endpoints =>
+            {
+                endpoints.MapControllers();
+            });
+        }
+    }
+}