{"id":839,"date":"2024-06-19T17:22:17","date_gmt":"2024-06-19T08:22:17","guid":{"rendered":"https:\/\/mvc.auctionpro.co.kr\/?p=839"},"modified":"2024-06-19T17:25:56","modified_gmt":"2024-06-19T08:25:56","slug":"swagger%ec%97%90-description-%ec%84%b8%ed%8c%85","status":"publish","type":"post","link":"https:\/\/mvc.auctionpro.co.kr\/?p=839","title":{"rendered":"Swagger\uc5d0 Description \uc138\ud305"},"content":{"rendered":"\n

Overview : NetCore 6.0 \uae30\uc900\uc73c\ub85c \uc544\ub798\uc640 \uac19\uc774 \ub098\uc624\uac8c \ud558\uae30<\/h3>\n\n\n\n
\"\"<\/figure>\n\n\n\n

<\/p>\n\n\n\n

1.csproj \ud30c\uc77c\uc744 Edit\ub85c \uc5f4\uc5b4 PropertyGroup \uc5d0 \ucd94\uac00 <\/h3>\n\n\n\n
    <GenerateDocumentationFile>true<\/GenerateDocumentationFile>\n    <NoWarn>$(NoWarn);1591<\/NoWarn><\/pre><\/div>\n\n\n\n
\ucd94\uac00\ud6c4 \ub0b4\uc6a9 \ubc0f \uc124\uba85<\/h3>\n\n\n\n
<Project Sdk=\"Microsoft.NET.Sdk.Web\">\n\n  <PropertyGroup>\n    <TargetFramework>net6.0<\/TargetFramework>\n    <Nullable>enable<\/Nullable>\n    <ImplicitUsings>enable<\/ImplicitUsings>\n    <OutputType>Exe<\/OutputType>\n    <GenerateDocumentationFile>true<\/GenerateDocumentationFile>\n    <NoWarn>$(NoWarn);1591<\/NoWarn>\n  <\/PropertyGroup>\n\n::: \uc544\ub798 \uc0dd\ub7b5 ::<\/pre><\/div>\n\n\n\n
\"\"<\/figure>\n\n\n\n
<GenerateDocumentationFile>true<\/GenerateDocumentationFile><\/strong>:<\/p>\n\n\n\n
    \n
  • XML \ubb38\uc11c \ud30c\uc77c \uc0dd\uc131\uc744 \ud65c\uc131\ud654\ud569\ub2c8\ub2e4. \ucf54\ub4dc \ub0b4 XML \uc8fc\uc11d\uc744 \uae30\ubc18\uc73c\ub85c \ubb38\uc11c \ud30c\uc77c\uc744 \uc0dd\uc131\ud569\ub2c8\ub2e4.<\/li>\n<\/ul>\n\n\n\n
    <NoWarn>$(NoWarn);1591<\/NoWarn><\/strong>:<\/p>\n\n\n\n
      \n
    • \ud2b9\uc815 \uacbd\uace0\ub97c \ubb34\uc2dc\ud558\ub3c4\ub85d \uc124\uc815\ud569\ub2c8\ub2e4. \uc5ec\uae30\uc11c 1591 \uacbd\uace0\ub294 “XML \uc8fc\uc11d\uc774 \uc5c6\ub294 \uacf5\uac1c \uba64\ubc84”\uc5d0 \ub300\ud55c \uacbd\uace0\uc774\uba70, \uc774\ub97c \ubb34\uc2dc\ud558\ub3c4\ub85d \uc124\uc815\ud569\ub2c8\ub2e4.<\/li>\n<\/ul>\n\n\n\n
      2.Program.cs \uc544\ub798\uc640 \uc218\uc815 <\/h3>\n\n\n\n
      builder.Services.AddControllers().AddXmlDataContractSerializerFormatters();\n\nbuilder.Services.AddSwaggerGen(c =>\n{\n    c.SwaggerDoc(\"v1\", new OpenApiInfo\n    {\n        Title = \"MemoryCache MsSQL MySQL\",\n        Version = \"1.0\",\n        Description = \"\uba54\ubaa8\ub9ac \uce90\uc2f1 \ud14c\uc2a4\ud2b8 Json\",\n        TermsOfService = new Uri(\"https:\/\/www.auctionpro.co.kr\"),\n        Contact = new OpenApiContact\n        {\n            Email = \"noreply@auctionpro.co.kr\"\n        },\n        License = new OpenApiLicense\n        {\n            Name = \"\ub77c\uc774\uc13c\uc2a4\",\n            Url = new Uri(\"https:\/\/www.auctionpro.co.kr\")\n        }\n    });\n    var xmlFile = $\"{Assembly.GetExecutingAssembly().GetName().Name}.xml\";\n    var xmlPath = Path.Combine(AppContext.BaseDirectory, xmlFile);\n    c.IncludeXmlComments(xmlPath);\n});\n\nif (app.Environment.IsDevelopment())\n{   \n    app.UseDeveloperExceptionPage();\n    app.UseSwagger();\n    app.UseSwaggerUI(c => c.SwaggerEndpoint(\"\/swagger\/v1\/swagger.json\", \"MemoryCache MsSQL MySQL v1\"));\n}<\/pre><\/div>\n\n\n\n
      \ucd5c\uc885 \ub0b4\uc6a9 \uc608\uc81c<\/h3>\n\n\n\n
      using InMemoryCacheCore.Infrastructure.V01;\nusing InMemoryCacheCore.Services02.V13;\nusing Microsoft.OpenApi.Models;\nusing System.Reflection;\n\nvar builder = WebApplication.CreateBuilder(args);\n\n\/\/ Add services to the container.\nbuilder.Services.AddControllers();\n\/\/ Learn more about configuring Swagger\/OpenAPI at https:\/\/aka.ms\/aspnetcore\/swashbuckle\nbuilder.Services.AddEndpointsApiExplorer();\nbuilder.Services.AddSwaggerGen();\n\nbuilder.Services.AddHttpClient();\nbuilder.Services.AddScoped<ICacheProvider, CacheProvider>(); \/\/infrastructure\nbuilder.Services.AddScoped<IHttpClient, InMemoryCacheCore.Infrastructure.V01.HttpClient>();     \/\/infrastructure\n\nbuilder.Services.AddScoped<ICacheGetSet, CacheGetSet>(); \/\/\ucd94\uac00\nbuilder.Services.AddScoped<ICacheGetSet, CacheGetSet>(); \/\/\ucd94\uac00\nbuilder.Services.AddMemoryCache();\n\nbuilder.Services.AddControllers().AddXmlDataContractSerializerFormatters();\n\nbuilder.Services.AddSwaggerGen(c =>\n{\n    c.SwaggerDoc(\"v1\", new OpenApiInfo\n    {\n        Title = \"MemoryCache MsSQL MySQL\",\n        Version = \"1.0\",\n        Description = \"\uba54\ubaa8\ub9ac \uce90\uc2f1 \ud14c\uc2a4\ud2b8 Json\",\n        TermsOfService = new Uri(\"https:\/\/www.auctionpro.co.kr\"),\n        Contact = new OpenApiContact\n        {\n            Email = \"noreply@auctionpro.co.kr\"\n        },\n        License = new OpenApiLicense\n        {\n            Name = \"\ub77c\uc774\uc13c\uc2a4\",\n            Url = new Uri(\"https:\/\/www.auctionpro.co.kr\")\n        }\n    });\n    var xmlFile = $\"{Assembly.GetExecutingAssembly().GetName().Name}.xml\";\n    var xmlPath = Path.Combine(AppContext.BaseDirectory, xmlFile);\n    c.IncludeXmlComments(xmlPath);\n});\n\nvar app = builder.Build();\n\n\/\/ Configure the HTTP request pipeline.\nif (app.Environment.IsDevelopment())\n{   \n    app.UseDeveloperExceptionPage();\n    app.UseSwagger();\n    app.UseSwaggerUI(c => c.SwaggerEndpoint(\"\/swagger\/v1\/swagger.json\", \"MemoryCache MsSQL MySQL v1\"));\n}\n\n\/\/if (!app.Environment.IsDevelopment())\n\/\/{\napp.UseHttpsRedirection();\n\/\/}\n\napp.UseAuthorization();\n\napp.MapControllers();\n\napp.Run();\n<\/pre><\/div>\n\n\n\n
      3.Controller.cs \uc5d0 \uc544\ub798 \ub0b4\uc6a9 \ucd94\uac00<\/h3>\n\n\n\n
              \/\/\/ <summary>\n        \/\/\/ \uacf5\ud56d\ucf54\ub4dc \uac00\uc838\uc624\uae30\n        \/\/\/ <\/summary>\n        \/\/\/ <param name=\"AAA\"><font color='red'>*<\/font>AAA\uac12 \uc124\uba85<\/param>\n        \/\/\/ <param name=\"BBB\">BBB\uac12 \uc124\uba85<\/param>\n        \/\/\/ <returns><\/returns><\/pre><\/div>\n\n\n\n
      \ucd5c\uc885 \ub0b4\uc6a9 \uc608\uc81c<\/h3>\n\n\n\n
      using InMemoryCacheCore.Models;\nusing InMemoryCacheCore.Services02.V13;\nusing Microsoft.AspNetCore.Mvc;\n\nnamespace InMemoryCacheCore.Controllers\n{\n    [Route(\"api\/[controller]\")]\n    [ApiController]\n    public class AirlineController : ControllerBase\n    {\n        private readonly ICacheGetSet _cacheGetSet;\n\n        private readonly string _cacheKey = \"_ACode\";\n\n        public AirlineController(ICacheGetSet cacheGetSet )\n        {\n            _cacheGetSet = cacheGetSet ?? throw new ArgumentNullException(nameof(cacheGetSet));\n        }\n\n        \/\/\/ <summary>\n        \/\/\/ \uacf5\ud56d\ucf54\ub4dc \uac00\uc838\uc624\uae30\n        \/\/\/ <\/summary>\n        \/\/\/ <param name=\"AAA\"><font color='red'>*<\/font>AAA\uac12 \uc124\uba85<\/param>\n        \/\/\/ <param name=\"BBB\">BBB\uac12 \uc124\uba85<\/param>\n        \/\/\/ <returns><\/returns>\n        [HttpGet]\n        public async Task<IEnumerable<Code>> Get(string AAA, string BBB)\n        {\n            try {\n                IEnumerable<Code>? codes = await _cacheGetSet.CacheGet(_cacheKey);\n                return codes;\n                }\n                catch {\n                    return Enumerable.Empty<Code>();\n                }\n        }\n\n    }\n}\n<\/pre><\/div>\n","protected":false},"excerpt":{"rendered":"
      Overview : NetCore 6.0 \uae30\uc900\uc73c\ub85c \uc544\ub798\uc640 \uac19\uc774 \ub098\uc624\uac8c \ud558\uae30 1.csproj \ud30c\uc77c\uc744 Edit\ub85c \uc5f4\uc5b4 PropertyGroup \uc5d0 \ucd94\uac00 \ucd94\uac00\ud6c4 \ub0b4\uc6a9 \ubc0f \uc124\uba85 <GenerateDocumentationFile>true<\/GenerateDocumentationFile>: <NoWarn>$(NoWarn);1591<\/NoWarn>: 2.Program.cs \uc544\ub798\uc640 \uc218\uc815 \ucd5c\uc885 \ub0b4\uc6a9 \uc608\uc81c 3.Controller.cs \uc5d0 \uc544\ub798 \ub0b4\uc6a9 \ucd94\uac00 \ucd5c\uc885 \ub0b4\uc6a9 \uc608\uc81c<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[1],"tags":[],"class_list":["post-839","post","type-post","status-publish","format-standard","hentry","category-uncategorized"],"_links":{"self":[{"href":"https:\/\/mvc.auctionpro.co.kr\/index.php?rest_route=\/wp\/v2\/posts\/839","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/mvc.auctionpro.co.kr\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/mvc.auctionpro.co.kr\/index.php?rest_route=\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/mvc.auctionpro.co.kr\/index.php?rest_route=\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/mvc.auctionpro.co.kr\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=839"}],"version-history":[{"count":3,"href":"https:\/\/mvc.auctionpro.co.kr\/index.php?rest_route=\/wp\/v2\/posts\/839\/revisions"}],"predecessor-version":[{"id":846,"href":"https:\/\/mvc.auctionpro.co.kr\/index.php?rest_route=\/wp\/v2\/posts\/839\/revisions\/846"}],"wp:attachment":[{"href":"https:\/\/mvc.auctionpro.co.kr\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=839"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/mvc.auctionpro.co.kr\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=839"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/mvc.auctionpro.co.kr\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=839"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}