{"id":926,"date":"2023-11-12T22:13:40","date_gmt":"2023-11-12T13:13:40","guid":{"rendered":"https:\/\/sheltie-garage.xyz\/tech\/?p=926"},"modified":"2023-11-12T22:13:42","modified_gmt":"2023-11-12T13:13:42","slug":"goecho%e3%81%a7%e3%82%84%e3%81%a3%e3%81%a6%e3%81%bf%e3%82%8b%e3%82%b9%e3%82%ad%e3%83%bc%e3%83%9e%e9%a7%86%e5%8b%95%e9%96%8b%e7%99%ba","status":"publish","type":"post","link":"https:\/\/sheltie-garage.xyz\/tech\/2023\/11\/goecho%e3%81%a7%e3%82%84%e3%81%a3%e3%81%a6%e3%81%bf%e3%82%8b%e3%82%b9%e3%82%ad%e3%83%bc%e3%83%9e%e9%a7%86%e5%8b%95%e9%96%8b%e7%99%ba\/","title":{"rendered":"Go+Echo\u3067\u3084\u3063\u3066\u307f\u308b\u30b9\u30ad\u30fc\u30de\u99c6\u52d5\u958b\u767a"},"content":{"rendered":"\n
\n

\u30b9\u30ad\u30fc\u30de\u99c6\u52d5\u958b\u767a\u3068\u306f
\u30b7\u30b9\u30c6\u30e0\u958b\u767a\u306b\u304a\u3044\u3066\u8907\u6570\u306e\u30b7\u30b9\u30c6\u30e0\u3092\u7d50\u5408\u3059\u308b\u969b\u306b\u5171\u901a\u3068\u306a\u308b\u6a19\u6e96\u7684\u306a\u30b9\u30ad\u30fc\u30de\u3092\u7528\u3044\u3066\u30a4\u30f3\u30bf\u30fc\u30d5\u30a7\u30fc\u30b9\u3092\u8a2d\u8a08\u3057\u958b\u767a\u3092\u9032\u3081\u308b\u624b\u6cd5\u306e\u4e00\u3064\u3067\u3059\u3002
WebAPI\u306e\u5b9a\u7fa9\u8a18\u8ff0\u306b\u304a\u3044\u3066\u306fOpenAPI\u3001\u30d7\u30ed\u30c8\u30b3\u30eb\u3068\u3057\u3066GraphQL, gRPC\u306a\u3069\u304c\u5b58\u5728\u3057\u307e\u3059\u3002<\/p>\nhttps:\/\/www.arsaga.jp\/news\/dx-technical-glossary\/%E3%82%B9%E3%82%AD%E3%83%BC%E3%83%9E%E9%A7%86%E5%8B%95%E9%96%8B%E7%99%BA\/#:~:text=%E3%82%B9%E3%82%AD%E3%83%BC%E3%83%9E%E9%A7%86%E5%8B%95%E9%96%8B%E7%99%BA%E3%81%A8%E3%81%AF,%E3%81%AA%E3%81%A9%E3%81%8C%E5%AD%98%E5%9C%A8%E3%81%97%E3%81%BE%E3%81%99%E3%80%82<\/cite><\/blockquote>\n\n\n\n

\u3068\u3044\u3046\u3053\u3068\u3067\u3001\u3056\u3063\u304f\u308a\u304a\u4f1d\u3048\u3059\u308b\u3068WebAPI\u306e\u30d1\u30e9\u30e1\u30fc\u30bf\u90e8\u5206\u3092\u5148\u306b\u8a2d\u8a08\u3057\u3066\u3001\u305d\u308c\u306b\u5408\u308f\u305b\u3066\u30d3\u30b8\u30cd\u30b9\u30ed\u30b8\u30c3\u30af\u3092\u4f5c\u308a\u8fbc\u3093\u3067\u3044\u304f\u624b\u6cd5\u30fb\u30fb\u30fb\u3068\u3001\u4e2d\u306e\u4eba\u306f\u7406\u89e3\u3057\u3066\u3044\u307e\u3059\u3002<\/p>\n\n\n\n

\u4eca\u56de\u306fGo + Echo + OpenAPI\u3092\u5229\u7528\u3057\u3066\u30b9\u30ad\u30fc\u30de\u99c6\u52d5\u958b\u767a\u3092\u5b9f\u8df5\u3057\u3088\u3046\u3068\u601d\u3044\u307e\u3059\u3002<\/p>\n\n\n\n

\u30a8\u30c7\u30a3\u30bf\u306e\u30bb\u30c3\u30c8\u30a2\u30c3\u30d7<\/h2>\n\n\n\n

OpenAPI\u306b\u6e96\u62e0\u3057\u305f\u4ed5\u69d8\u66f8\u3092YAML\u3067\u8a18\u8ff0\u3059\u308b\u305f\u3081\u306bVS Code\u306b\u62e1\u5f35\u6a5f\u80fd\u3092\u30a4\u30f3\u30b9\u30c8\u30fc\u30eb\u3057\u307e\u3059\u3002
\u4eca\u56de\u306f\u300cOpenAPI (Swagger) Editor\u300d\u3092\u5229\u7528\u3057\u307e\u3057\u305f\u3002<\/p>\n\n\n\n

\u3053\u308c\u3067\u3001VS Code\u4e0a\u3067\u30d7\u30ec\u30d3\u30e5\u30fc\u3057\u3064\u3064\u4ed5\u69d8\u66f8\u3092\u66f8\u304f\u3053\u3068\u304c\u51fa\u6765\u307e\u3059\u3002
(\u4e0b\u753b\u50cf\u8d64\u67a0\u3067\u30d7\u30ec\u30d3\u30e5\u30fc\u304c\u8868\u793a\u3067\u304d\u307e\u3059)<\/p>\n\n\n\n

\"\"<\/figure>\n\n\n\n

\u30b9\u30ad\u30fc\u30de\u5b9a\u7fa9\u66f8\u306e\u4f5c\u6210<\/h2>\n\n\n\n

\u30a8\u30c7\u30a3\u30bf\u306e\u8a2d\u5b9a\u304c\u7d42\u308f\u3063\u305f\u306e\u3067\u3001\u5b9f\u969b\u306b\u5b9a\u7fa9\u3092\u4f5c\u6210\u3057\u307e\u3059\u3002
\u4eca\u56de\u306f\u30b7\u30f3\u30d7\u30eb\u306b\u540d\u524d\u3068E-Mail\u3092\u53d7\u3051\u53d6\u308b\u3060\u3051\u306eWebAPI\u3068\u3057\u307e\u3057\u305f\u3002<\/p>\n\n\n\n

openapi: 3.0.0\ninfo:\n  version: 1.0.0\n  title: RIDE-Content\n  description: >-\n    \u30e6\u30fc\u30b6\u30fc\u540d\u3068E-Mail\u3092\u53d7\u3051\u53d6\u308a\u3001\u53d7\u3051\u53d6\u3063\u305f\u5024\u3092\u305d\u306e\u307e\u307e\u8fd4\u5374\u3057\u307e\u3059\u3002\nservers:\n  - url: 'http:\/\/localhost:1232'\n    description: \u30ed\u30fc\u30ab\u30eb\u74b0\u5883\npaths:\n  \/user:\n    post:\n      description: >\n        \u30e6\u30fc\u30b6\u30fc\u540d\u3068E-Mail\u3092\u53d7\u3051\u53d6\u308a\u3001\u305d\u306e\u5024\u3092\u8fd4\u5374\u3059\u308b\n      operationId: user\n      requestBody:\n        required: true\n        content:\n          application\/json:\n            schema:\n              $ref: "#\/components\/schemas\/UserSampleRequest"\n      responses:\n        '200':\n          description: "\u767b\u9332\u6210\u529f"\n          content:\n            application\/json:\n              schema:\n                $ref: '#\/components\/schemas\/UserSampleResponse'\n        '400':\n          description: "\u30ea\u30af\u30a8\u30b9\u30c8\u306e\u30d0\u30ea\u30c7\u30fc\u30b7\u30e7\u30f3\u30a8\u30e9\u30fc"\n          content:\n            application\/json:\n              schema:\n                $ref: '#\/components\/schemas\/Error'\n        '500':\n          description: "\u5185\u90e8\u30a8\u30e9\u30fc"\n          content:\n            application\/json:\n              schema:\n                $ref: '#\/components\/schemas\/Error'\ncomponents:\n  schemas:\n    UserSampleRequest:\n      type: "object"\n      required:\n        - "name"\n        - "email"\n      properties:\n        name:\n          type: "string"\n          x-go-type: string\n          example: "test_name"\n          description: "\u30e6\u30fc\u30b6\u30fc\u540d"\n        email:\n          type: "string"\n          x-go-type: string\n          example: "test@mail.com"\n          description: "\u30d1\u30b9\u30ef\u30fc\u30c9"\n    UserSampleResponse:\n      type: "boolean"\n      x-go-type: bool\n      example: true\n      description: "true:\u51e6\u7406\u6210\u529f\u3001false:\u51e6\u7406\u5931\u6557"\n    Error:\n      type: "object"\n      properties:\n        error:\n          type: "string"\n          example: "\u3053\u3053\u306b\u30a8\u30e9\u30fc\u30e1\u30c3\u30bb\u30fc\u30b8\u304c\u8a2d\u5b9a\u3055\u308c\u307e\u3059"\n          description: "\u30a8\u30e9\u30fc\u30e1\u30c3\u30bb\u30fc\u30b8"\nexternalDocs:\n  description: "Find out more about Swagger"\n  url: "http:\/\/swagger.io"<\/code><\/pre><\/div>\n\n\n\n
Go + Echo\u306e\u30bb\u30c3\u30c8\u30a2\u30c3\u30d7<\/h2>\n\n\n\n
\u5148\u7a0b\u4f5c\u6210\u3057\u305fOpenAPI\u306e\u5b9a\u7fa9\u66f8\u3092\u5143\u306b\u3001WebAPI\u3092\u4f5c\u6210\u3057\u307e\u3059\u3002
\u307e\u305a\u306fGO + Echo\u306e\u30d7\u30ed\u30b8\u30a7\u30af\u30c8\u3092\u4f5c\u6210\u3057\u307e\u3059\u3002<\/p>\n\n\n\n
\u30d7\u30ed\u30b8\u30a7\u30af\u30c8\u306e\u30c7\u30a3\u30ec\u30af\u30c8\u30ea\u306b\u79fb\u52d5\u3057\u3001\u4ee5\u4e0b\u306e\u30b3\u30de\u30f3\u30c9\u3067\u30bb\u30c3\u30c8\u30a2\u30c3\u30d7\u3092\u884c\u3044\u307e\u3059\u3002<\/p>\n\n\n\n
go mod init sdd\ngo get github.com\/labstack\/echo\/v4<\/code><\/pre><\/div>\n\n\n\n
\u3053\u308c\u3067Echo\u306e\u30d7\u30ed\u30b8\u30a7\u30af\u30c8\u304c\u4f5c\u6210\u3055\u308c\u307e\u3057\u305f\u3002<\/p>\n\n\n\n
OpenAPI\u306e\u5b9a\u7fa9\u66f8\u304b\u3089Go\u306e\u30bd\u30fc\u30b9\u3092\u4f5c\u6210\u3059\u308b<\/h2>\n\n\n\n
\u4eca\u56de\u306f\u300coapi-codegen<\/a>\u300d\u3092\u5229\u7528\u3057\u307e\u3057\u305f\u3002
Go\u7528\u306e\u30bd\u30fc\u30b9\u30b3\u30fc\u30c9\u30b8\u30a7\u30cd\u30ec\u30fc\u30bf\u306f\u3044\u304f\u3064\u304b\u3042\u308a\u307e\u3059\u304c\u3001oapi-codegen\u306f\u300c\u751f\u6210\u3059\u308b\u30bd\u30fc\u30b9\u304c1\u3064\u306e\u307f\u300d\u3068\u3044\u3046\u3053\u3068\u3067\u3001\u4e00\u756a\u30b7\u30f3\u30d7\u30eb\u306b\u6271\u3048\u305d\u3046\u3060\u3063\u305f\u305f\u3081\u3001\u4eca\u56de\u4f7f\u7528\u3059\u308b\u3053\u3068\u306b\u3057\u307e\u3057\u305f\u3002
\u4e0b\u8a18\u30b3\u30de\u30f3\u30c9\u3067\u30a4\u30f3\u30b9\u30c8\u30fc\u30eb\u3057\u307e\u3059\u3002<\/p>\n\n\n\n
go install github.com\/deepmap\/oapi-codegen\/v2\/cmd\/oapi-codegen@latest<\/code><\/pre><\/div>\n\n\n\n
\u30a4\u30f3\u30b9\u30c8\u30fc\u30eb\u304c\u7d42\u308f\u3063\u305f\u3089\u3001\u4ee5\u4e0b\u306e\u30b3\u30de\u30f3\u30c9\u3067yaml\u30d5\u30a1\u30a4\u30eb\u304b\u3089Go\u30bd\u30fc\u30b9\u3092\u751f\u6210\u3057\u307e\u3059\u3002
\u5148\u7a0b\u4f5c\u6210\u3057\u305fOpenAPI\u306e\u5b9a\u7fa9\u30d5\u30a1\u30a4\u30eb(yml\u30d5\u30a1\u30a4\u30eb)\u3001\u30d1\u30c3\u30b1\u30fc\u30b8\u540d\u3001\u51fa\u529b\u3055\u308c\u308b\u30d5\u30a1\u30a4\u30eb\u540d\u3092\u6307\u5b9a\u3057\u307e\u3059\u3002<\/p>\n\n\n\n
oapi-codegen -package sdd openapi.yaml > sdd.gen.go\ngo mod tidy<\/code><\/pre><\/div>\n\n\n\n
oapi-codegen\u306fmain\u95a2\u6570\u306f\u751f\u6210\u3057\u306a\u3044\u306e\u3067\u3001\u81ea\u5206\u3067\u5b9a\u7fa9\u3059\u308b\u5fc5\u8981\u304c\u3042\u308a\u307e\u3059\u3002
\u5b9f\u969b\u306bmain\u95a2\u6570\u3092\u4f5c\u6210\u3057\u3001\u52d5\u4f5c\u3092\u78ba\u8a8d\u3057\u3066\u307f\u307e\u3059\u3002<\/p>\n\n\n\n
main\u95a2\u6570\u3092\u4f5c\u6210\u3059\u308b<\/h2>\n\n\n\n
main\u95a2\u6570\u3092\u4f5c\u6210\u3057\u307e\u3059\u3002
\u666e\u901a\u306eGo\u30d7\u30ed\u30b0\u30e9\u30e0\u306e\u305f\u3081\u3001Echo\u306e\u30b5\u30f3\u30d7\u30eb\u306b\u57fa\u3065\u3044\u3066\u4f5c\u6210\u3057\u307e\u3059\u3002
(Echo\u306e\u30b5\u30f3\u30d7\u30eb\u3092\u5143\u306b\u4f5c\u3063\u305f\u306e\u3067\u3001\u30d5\u30a1\u30a4\u30eb\u540d\u306fserver.go\u3068\u3044\u3046\u540d\u524d\u306b\u3057\u307e\u3057\u305f)<\/p>\n\n\n\n
package main\n\nimport (\n\t"net\/http"\n\t"sdd\/sdd"\n\n\t"github.com\/labstack\/echo\/v4"\n)\n\ntype webapi struct{}\n\nfunc (w webapi) User(ctx echo.Context) error {\n\n\tvar reqBody sdd.UserSampleRequest\n\tctx.Bind(&reqBody)\n\n\treturn ctx.JSON(http.StatusOK, reqBody)\n}\n\nfunc main() {\n\te := echo.New()\n\n\tapi := webapi{}\n\tsdd.RegisterHandlers(e, api)\n\n\te.Logger.Fatal(e.Start(":1323"))\n}\n<\/code><\/pre><\/div>\n\n\n\n
\u3053\u306e\u6642\u70b9\u3067\u3001\u30c7\u30a3\u30ec\u30af\u30c8\u30ea\u69cb\u6210\u306f\u4ee5\u4e0b\u306e\u3088\u3046\u306b\u306a\u3063\u3066\u3044\u307e\u3059\u3002<\/p>\n\n\n\n
\"\"<\/figure>\n\n\n\n
\u52d5\u4f5c\u3092\u78ba\u8a8d\u3057\u3066\u307f\u308b<\/h2>\n\n\n\n
server.go\u3092VS Code\u306e\u30c7\u30d0\u30c3\u30b0\u30e2\u30fc\u30c9\u3067\u5b9f\u884c\u3057\u3001\u52d5\u4f5c\u3092\u78ba\u8a8d\u3057\u3066\u307f\u307e\u3059\u3002
WebAPI\u306e\u30a8\u30f3\u30c8\u30ea\u30dd\u30a4\u30f3\u30c8\u3068\u3001\u6e21\u3059\u3079\u304d\u30c7\u30fc\u30bf\u306fOpenAPI\u306e\u5b9a\u7fa9\u66f8\u3067\u5b9a\u7fa9\u6e08\u307f\u3068\u306a\u308a\u307e\u3059\u306e\u3067\u3001\u305d\u306e\u5024\u3092\u5229\u7528\u3057\u307e\u3059\u3002<\/p>\n\n\n\n
\"\"<\/figure>\n\n\n\n
POSTMAN\u3092\u5229\u7528\u3057\u3066\u3001\u30ea\u30af\u30a8\u30b9\u30c8\u3092\u5b9f\u884c\u3057\u307e\u3057\u305f\u3002
\u9001\u4fe1\u3057\u305f\u5024\u304c\u305d\u306e\u307e\u307e\u30ec\u30b9\u30dd\u30f3\u30b9\u3068\u3057\u3066\u5e30\u3063\u3066\u304d\u307e\u3057\u305f\u306e\u3067\u3001\u52d5\u4f5c\u306f\u5927\u4e08\u592b\u305d\u3046\u3067\u3059\u3002<\/p>\n\n\n\n
\"\"<\/figure>\n\n\n\n
\u4ee5\u4e0a\u3067\u3059<\/h2>\n\n\n\n
\u3068\u3044\u3046\u3053\u3068\u3067\u3001\u3056\u3063\u304f\u308a\u3067\u3059\u304cGo + Echo\u3092\u5229\u7528\u3057\u305f\u30b9\u30ad\u30fc\u30de\u99c6\u52d5\u958b\u767a\u306e\u7d39\u4ecb\u3092\u884c\u3044\u307e\u3057\u305f\u3002
OpenAPI\u306e\u4ed5\u69d8\u306b\u57fa\u3065\u3044\u305f\u5b9a\u7fa9\u3092\u884c\u3046\u3053\u3068\u3067\u3001\u8a2d\u8a08\u66f8\u3068API\u306e\u5b9f\u88c5\u304c\u30ba\u30ec\u3066\u3057\u307e\u3046\u3001\u3068\u3044\u3046\u3053\u3068\u3082\u9632\u3052\u308b\u304b\u3068\u601d\u3044\u307e\u3059\u3002<\/p>\n\n\n\n
\u81ea\u5206\u306f\u4eca\u307e\u3067\u500b\u4eba\u958b\u767a\u3092\u884c\u3046\u3068\u304d\u306b\u8a2d\u8a08\u66f8\u306f\u66f8\u3044\u3066\u3044\u306a\u304b\u3063\u305f\u306e\u3067\u3059\u304c\u3001\u4eca\u5f8c\u306fOpenAPI\u306e\u5b9a\u7fa9\u66f8\u3092\u3061\u3083\u3093\u3068\u4f5c\u3063\u3066\u958b\u767a\u3092\u884c\u3063\u3066\u3044\u304d\u305f\u3044\u3068\u601d\u3044\u307e\u3057\u305f\u3002
(API\u4e00\u89a7\u304c\u78ba\u8a8d\u3067\u304d\u305f\u308a\u3001API\u306e\u4ed5\u69d8\u304c\u307e\u3068\u307e\u3063\u3066\u3044\u308b\u8cc7\u6599\u3068\u3044\u3046\u306e\u306f\u3001\u5f8c\u3005\u52a9\u304b\u308b\u8cc7\u6599\u306b\u306a\u308b\u306e\u3067)<\/p>\n\n\n
\n\t
\n\t\t
\n\t\t\t\t\t\t\t<\/a>\t\t\t\t\t<\/div>\n\t\t
\n\t\t\t
\n\t\t\t\t\t\t\t\t\tWeb API\u306e\u8a2d\u8a08 \uff08Programmer’s SELECTION\uff09 [ Arnaud Lauret ]<\/a>\t\t\t\t\t\t\t<\/div>\n\t\t\t
\n\t\t\t\t\t\t\t
created by Rinker<\/a><\/div>\n\t\t\t\t\t\t\t\t\t\t
\n\t\t\t\t\t\t\t\u00a54,180<\/span>\n\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t(2026\/04\/11 07:08:56\u6642\u70b9 \u697d\u5929\u5e02\u5834\u8abf\u3079-<\/span>\u8a73\u7d30)<\/span>\n\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t<\/div>\n\t\t\t\t\t\t<\/div>\n\t\t\t\t\t\t