{"id":2410,"date":"2013-05-23T12:38:58","date_gmt":"2013-05-23T03:38:58","guid":{"rendered":"http:\/\/auctionpro.co.kr\/?p=2410"},"modified":"2025-09-03T12:04:06","modified_gmt":"2025-09-03T03:04:06","slug":"kimstars-second-blog-__-json-%ea%b0%9c%ec%9a%94-%eb%b0%8f-%ec%98%88%ec%a0%9c","status":"publish","type":"post","link":"https:\/\/www.auctionpro.co.kr\/?p=2410","title":{"rendered":"JSON \uac1c\uc694 \ubc0f \uc608\uc81c"},"content":{"rendered":"\n
using Microsoft.AspNetCore.Mvc;\n\nnamespace CoinAPI.Controllers\n{\n    [ApiController]\n    [Route(\"api2\/[controller]\")]\n    public class OSIController : Controller\n    {\n        private readonly ILogger<OSIController> _logger;\n        private readonly IConfiguration Configuration;\n\n        public OSIController(ILogger<OSIController> logger, IConfiguration configuration)\n        {\n            _logger = logger;\n            Configuration = configuration;\n        }\n\n        \/\/ \uc0d8\ud50c \ub370\uc774\ud130 (\uc2e4\uc81c DB \ub300\uc2e0 \uc0ac\uc6a9)\n        private static List<OSIModel> _osiList = new List<OSIModel>\n        {\n            new OSIModel { Id = 1, Code = \"OSI1\", Description = \"Special meal request\" },\n            new OSIModel { Id = 2, Code = \"OSI2\", Description = \"Wheelchair assistance\" }\n        };\n\n        \/\/ GET: api\/OSI\n        [HttpGet]\n        public IActionResult GetAll()\n        {\n            return Ok(_osiList);\n        }\n\n        \/\/ GET: api\/OSI\/1\n        [HttpGet(\"{id}\")]\n        public IActionResult GetById(int id)\n        {\n            var osi = _osiList.FirstOrDefault(o => o.Id == id);\n            if (osi == null)\n                return NotFound(new { message = \"\ud574\ub2f9 OSI \uc815\ubcf4\ub97c \ucc3e\uc744 \uc218 \uc5c6\uc2b5\ub2c8\ub2e4.\" });\n\n            return Ok(osi);\n        }\n\n        \/\/ POST: api\/OSI\n        [HttpPost]\n        public IActionResult Create([FromBody] OSIModel newOsi)\n        {\n            if (!ModelState.IsValid)\n                return BadRequest(ModelState);\n\n            newOsi.Id = _osiList.Max(o => o.Id) + 1;\n            _osiList.Add(newOsi);\n\n            return CreatedAtAction(nameof(GetById), new { id = newOsi.Id }, newOsi);\n        }\n\n        \/\/ PUT: api\/OSI\/1\n        [HttpPut(\"{id}\")]\n        public IActionResult Update(int id, [FromBody] OSIModel updatedOsi)\n        {\n            var osi = _osiList.FirstOrDefault(o => o.Id == id);\n            if (osi == null)\n                return NotFound(new { message = \"\uc218\uc815\ud560 OSI \uc815\ubcf4\ub97c \ucc3e\uc744 \uc218 \uc5c6\uc2b5\ub2c8\ub2e4.\" });\n\n            osi.Code = updatedOsi.Code;\n            osi.Description = updatedOsi.Description;\n\n            return Ok(osi);\n        }\n\n        \/\/ DELETE: api\/OSI\/1\n        [HttpDelete(\"{id}\")]\n        public IActionResult Delete(int id)\n        {\n            var osi = _osiList.FirstOrDefault(o => o.Id == id);\n            if (osi == null)\n                return NotFound(new { message = \"\uc0ad\uc81c\ud560 OSI \uc815\ubcf4\ub97c \ucc3e\uc744 \uc218 \uc5c6\uc2b5\ub2c8\ub2e4.\" });\n\n            _osiList.Remove(osi);\n            return NoContent();\n        }\n    }\n\n    \/\/ \uc0d8\ud50c \ubaa8\ub378 \ud074\ub798\uc2a4\n    public class OSIModel\n    {\n        public int Id { get; set; }\n        public string Code { get; set; }\n        public string Description { get; set; }\n    }\n}<\/pre><\/div>\n\n\n\n
\"\"<\/a><\/figure>\n\n\n\n
\uc2e4\ubb34\uc5d0\uc11c \uad8c\uc7a5\ub418\ub294 \uc0ac\uc6a9 \ud328\ud134<\/strong><\/h2>\n\n\n\n
\uc791\uc5c5<\/th>\uc751\ub2f5 \ucf54\ub4dc<\/th>\uc751\ub2f5 \uba54\uc11c\ub4dc<\/th>\uc751\ub2f5 Body<\/th><\/tr><\/thead>
\uc0dd\uc131(Create)<\/td>201<\/td>CreatedAtAction()<\/code><\/td>\uc0dd\uc131\ub41c \ub370\uc774\ud130<\/td><\/tr>
\uc870\ud68c(Read)<\/td>200<\/td>Ok()<\/code><\/td>\ub370\uc774\ud130<\/td><\/tr>
\uc5c5\ub370\uc774\ud2b8(Update)<\/td>200<\/td>Ok()<\/code><\/td>\uc5c5\ub370\uc774\ud2b8\ub41c \ub370\uc774\ud130<\/td><\/tr>
\uc0ad\uc81c(Delete)<\/td>204<\/td>NoContent()<\/code><\/td>\uc5c6\uc74c<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
\uc644\uc804\ud55c CRUD \ucee8\ud2b8\ub864\ub7ec + Swagger \uc124\uc815<\/strong> \uc608\uc81c<\/h3>\n\n\n\n
1) Program.cs (Swagger + MVC \uc124\uc815)<\/p>\n\n\n\n
using Microsoft.OpenApi.Models;\n\nvar builder = WebApplication.CreateBuilder(args);\n\nbuilder.Services.AddControllers();\n\n\/\/ Swagger\nbuilder.Services.AddEndpointsApiExplorer();\nbuilder.Services.AddSwaggerGen(c =>\n{\n    c.SwaggerDoc(\"v1\", new OpenApiInfo\n    {\n        Title = \"OSI API\",\n        Version = \"v1\",\n        Description = \"Sample CRUD with CreatedAtAction \/ Ok \/ NoContent\"\n    });\n});\n\nvar app = builder.Build();\n\napp.UseHttpsRedirection();\n\napp.UseSwagger();\napp.UseSwaggerUI(c =>\n{\n    c.SwaggerEndpoint(\"\/swagger\/v1\/swagger.json\", \"OSI API v1\");\n    c.RoutePrefix = string.Empty; \/\/ https:\/\/localhost:5001\/ \uc9c4\uc785 \uc2dc Swagger \uc5f4\uae30\n});\n\napp.MapControllers();\n\napp.Run();<\/pre><\/div>\n\n\n\n
2) \ubaa8\ub378 (\uc720\ud6a8\uc131 \uac80\uc0ac \ud3ec\ud568)<\/p>\n\n\n\n
using System.ComponentModel.DataAnnotations;\n\npublic class OSIModel\n{\n    public int Id { get; set; }\n\n    [Required, StringLength(60)]\n    public string PassengerName { get; set; } = string.Empty;\n\n    [Required, StringLength(3, MinimumLength = 2)]\n    public string Airline { get; set; } = string.Empty; \/\/ \uc608: KE, OZ, AA\n\n    [Required, StringLength(200)]\n    public string Message { get; set; } = string.Empty; \/\/ \uc608: CTCE\/EMAIL@DOMAIN.COM\n\n    public bool IsActive { get; set; } = true;\n}\n<\/pre><\/div>\n\n\n\n
3) \uac04\ub2e8\ud55c \uc778\uba54\ubaa8\ub9ac \uc800\uc7a5\uc18c (\ub370\ubaa8\uc6a9)<\/p>\n\n\n\n
using System.Collections.Concurrent;\n\npublic static class OsiStore\n{\n    \/\/ Thread-safe\n    private static readonly ConcurrentDictionary<int, OSIModel> _map = new();\n    private static int _seq = 0;\n\n    public static IEnumerable<OSIModel> GetAll() => _map.Values.OrderBy(x => x.Id);\n\n    public static OSIModel? Get(int id) => _map.TryGetValue(id, out var v) ? v : null;\n\n    public static OSIModel Add(OSIModel m)\n    {\n        var id = Interlocked.Increment(ref _seq);\n        m.Id = id;\n        _map[id] = m;\n        return m;\n    }\n\n    public static bool Update(int id, OSIModel m)\n    {\n        if (!_map.ContainsKey(id)) return false;\n        m.Id = id;\n        _map[id] = m;\n        return true;\n    }\n\n    public static bool Remove(int id) => _map.TryRemove(id, out _);\n}\n<\/pre><\/div>\n\n\n\n
4) \ucee8\ud2b8\ub864\ub7ec (CRUD + \uc0c1\ud0dc\ucf54\ub4dc \uba85\ud655\ud654)<\/p>\n\n\n\n
using Microsoft.AspNetCore.Mvc;\n\n[ApiController]\n[Route(\"api\/[controller]\")]\npublic class OSIController : ControllerBase\n{\n    \/\/\/ <summary>\uc804\uccb4 \uc870\ud68c<\/summary>\n    [HttpGet]\n    [ProducesResponseType(StatusCodes.Status200OK)]\n    public ActionResult<IEnumerable<OSIModel>> GetAll()\n        => Ok(OsiStore.GetAll());\n\n    \/\/\/ <summary>\ub2e8\uac74 \uc870\ud68c<\/summary>\n    [HttpGet(\"{id:int}\")]\n    [ProducesResponseType(StatusCodes.Status200OK)]\n    [ProducesResponseType(StatusCodes.Status404NotFound)]\n    public ActionResult<OSIModel> GetById(int id)\n    {\n        var item = OsiStore.Get(id);\n        if (item is null) return NotFound();\n        return Ok(item); \/\/ 200 + \ubcf8\ubb38\n    }\n\n    \/\/\/ <summary>\uc0dd\uc131 (201 Created + Location \ud5e4\ub354)<\/summary>\n    [HttpPost]\n    [ProducesResponseType(StatusCodes.Status201Created)]\n    [ProducesResponseType(StatusCodes.Status400BadRequest)]\n    public ActionResult<OSIModel> Create([FromBody] OSIModel newOsi)\n    {\n        if (!ModelState.IsValid) return ValidationProblem(ModelState);\n\n        var created = OsiStore.Add(newOsi);\n\n        \/\/ \ud575\uc2ec: 201 Created + Location \ud5e4\ub354 (GET \/api\/OSI\/{id}\ub85c \uc774\ub3d9 \uac00\ub2a5)\n        return CreatedAtAction(\n            nameof(GetById),       \/\/ \ub300\uc0c1 \uc561\uc158\n            new { id = created.Id }, \/\/ \ub77c\uc6b0\ud2b8 \uac12 (\uc774\ub984 \uc77c\uce58 \uc911\uc694!)\n            created                \/\/ \uc751\ub2f5 \ubc14\ub514\n        );\n    }\n\n    \/\/\/ <summary>\uc804\uccb4 \uc218\uc815 (\uc131\uacf5 \uc2dc 204 No Content)<\/summary>\n    [HttpPut(\"{id:int}\")]\n    [ProducesResponseType(StatusCodes.Status204NoContent)]\n    [ProducesResponseType(StatusCodes.Status400BadRequest)]\n    [ProducesResponseType(StatusCodes.Status404NotFound)]\n    public IActionResult Update(int id, [FromBody] OSIModel updated)\n    {\n        if (!ModelState.IsValid) return ValidationProblem(ModelState);\n\n        var exist = OsiStore.Get(id);\n        if (exist is null) return NotFound();\n\n        \/\/ Id\ub294 \uacbd\ub85c \uae30\uc900\uc73c\ub85c \uace0\uc815\n        updated.Id = id;\n\n        OsiStore.Update(id, updated);\n\n        return NoContent(); \/\/ 204, \ubcf8\ubb38 \uc5c6\uc774 \uc131\uacf5\n    }\n\n    \/\/\/ <summary>\ubd80\ubd84 \uc218\uc815 \uc608\uc2dc (\ud65c\uc131\ud654\/\ube44\ud65c\uc131 \uac19\uc740 \uc0c1\ud0dc \ud1a0\uae00)<\/summary>\n    [HttpPatch(\"{id:int}\/activate\")]\n    [ProducesResponseType(StatusCodes.Status204NoContent)]\n    [ProducesResponseType(StatusCodes.Status404NotFound)]\n    public IActionResult Activate(int id)\n    {\n        var exist = OsiStore.Get(id);\n        if (exist is null) return NotFound();\n\n        exist.IsActive = true;\n        OsiStore.Update(id, exist);\n        return NoContent();\n    }\n\n    \/\/\/ <summary>\uc0ad\uc81c (\uc131\uacf5 \uc2dc 204 No Content)<\/summary>\n    [HttpDelete(\"{id:int}\")]\n    [ProducesResponseType(StatusCodes.Status204NoContent)]\n    [ProducesResponseType(StatusCodes.Status404NotFound)]\n    public IActionResult Delete(int id)\n    {\n        var ok = OsiStore.Remove(id);\n        if (!ok) return NotFound();\n        return NoContent(); \/\/ 204, \ubcf8\ubb38 \uc5c6\uc74c\n    }\n}\n<\/pre><\/div>\n\n\n\n
5) Swagger\uc5d0\uc11c \ud14c\uc2a4\ud2b8 \ud750\ub984 (\uc694\uc57d)<\/p>\n\n\n\n
POST \/api\/OSI<\/strong><\/p>\n\n\n\n