Share
Transcript
29 slides
-
gRPCͰ࢝ΊΔ ϋΠύϑΥʔϚϯε λΠϓηʔϑΣϒ։ൃ Introduction of high-performance and type-safe development with
gRPC. Gunma.web #49 ςʔϚϑϦʔ 2023.06.03 @ Takasaki Met., Empire of Gunma Tsubasa SEKIGUCHI -
TinyKitten Freelance frontend engineer I 💖 OSS & Cat🐈 Born
in Gunma🐴 Live in Tokyo🗼 -
ࠓ͞Βฉ͚ͳ͍RPCʹ͍ͭͯ 3FNPUF1SPDFEVSF$BMMͷུ αʔϏεؒͷใͷΓऔΓʹݹ͔͘Β ΘΕ͍ͯΔ ೄจ࣌ΑΓޙͰ͢
͍ΘΏΔΫϥΠΞϯταʔόʔܕͷ௨৴ αʔόʔ্ʹ࣮͞Ε͍ͯΔॲཧΛΫϥΠΞϯτ͔Β ύϥϝʔλ͖Ͱୟ͍ͯύϥϝʔλʹର͢Δॲཧ݁Ռ Λฦ͢ -
ࠓ͞Βฉ͚ͳ͍RPCʹ͍ͭͯ ͲͷΑ͏ʹϦΫΤετΛૹ৴͢Δ͔ɺ ͲͷΑ͏ͳϑΥʔϚοτͰ௨৴͢Δ͔ʜ ࣌ʹԠͯ͡มԽ͍ͯ͠Δ ࠷ۙ)5514͕ओྲྀͷΑ͏Ͱ͢ɻ
9.-Λѻ͏9.-31$ +40/Λ͏+40/31$ͳͲ͕طଘʹ͋Γ·͢ ੲͷϓϩτίϧͰ$03#"ͱ͔%$0.ͱ͔ ϐϯͱ͖·ͤΜ͔ʁ ϐϯͱ͜ͳ͍Ͱ͢ ӈͷֆըΈ͍ͨʹԎΛ͍ͬͯͨࠒͳ͔ͬͨΑ͏Ͱ͢ -
ࠓ·ͰͷRPCͷΠέͯͳ͍ 9.-31$+40/31$Α͘ΘΕ͍ͯΔ ϑΥʔϚοτͳͷͰಋೖ͍͢͠ ͨͩ͠ͲͪΒςΩετϕʔεͰ͋Γɺ )551جຊతʹςΩετϕʔεͰσʔλΛ
ΓऔΓ͢Δ͠ɺόΠφϦѻ͍ͮΒ͘ɺ ࣌ؒࢄൃతʹσʔλΛΓऔΓͮ͠Β͍ ௨৴࣌ͷΦʔόʔϔουଘࡏ͢Δ Ԏ͔Ϟʔϧε৴߸ΑΓϚγͰ͚͢Ͳ -
ͦ͜ͰొgRPC͘Μ લͷεϥΠυͰઆ໌ͨ͠Λղܾ͢ΔͨΊʹ (PPHMFʹΑΓߟҊ͞Εͨϓϩτίϧ (PPHMFࣗࣾͷϚΠΫϩαʔϏεؒͷ௨৴ͷͨΊʹ։ ൃ͞ΕͨγεςϜʮ4UVCCZʯ͕લ 4UVCCZͱҧͬͯ044
ݱࡏɺ-JOVY'PVOEBUJPOࡿԼͷ $MPVE/BUJWF$PNQVUJOH'PVOEBUJPOʹΑͬͯ ։ൃ͕ਐΊΒΕΔ -
H31$͘Μͷ͕͜͜εΰΠ H13$ͷجຊతͳίϯηϓτ ಛఆͷݴޠϓϥοτϑΥʔϜʹґଘ͠ͳ͍ ϖΠϩʔυΛΘͳ͍ ૬ޓӡ༻ੑ͕͋ΓҰൠతͳΠϯλʔωοτͰ
ར༻Մೳ ൚༻ੑ͕͋Γͳ͕Βઐ༻ͷͷͱൺͯ ύϑΥʔϚϯε໘ͰҰൠʹྼΔ͜ͱͳ͍ ετϦʔϛϯάͰͷใୡʹରԠ͍ͯ͠Δ -
H31$͘Μͷ͕͜͜εΰΠ σʔλͷγϦΞϥΠζʹ1SPUPDPM#V ff FSTͱ͍͏ ٕज़Λ༻͢Δ ҰͭఆٛϑΝΠϧΛ࡞ΕαʔόʔΫϥΠΞϯτ ίʔυ͕શࣗಈͰੜ͞ΕΔͷͰ
54Ͱ͋Ε λΠϓηʔϑʹ։ൃͰ͖Δ ͋ͱࣗͰௐ͍ͯͩ͘͞ ͱ͍͑ۜͷؙͰͳ͍ -
H31$͘Μͷ͕͜͜Α͘ͳ͍ )551ͰH31$ͱ௨৴͢Δ߹ɺ)551Λ ಋೖ͢Δඞཁ͕͋Δ ͱ͍͑ɺ)551ͷΈͰαʔϏεΛߦ͏ͷ ݱ࣌Ͱݫ͍͠ͷͰɺී௨&OWPZ͋ͨΓͷ
ϓϩΩγΛט·ͤΔ ༨ஊͰ͕͢3VTUͷUPOJDͱ͍͏αʔόʔϥΠϒϥϦ ඪ४ػೳͰ)551Λͯ͘͠ΕΔͷͰ &OWPZ͕ෆཁͰ͢ ͪͳΈʹӈͷֆըΞυϦΞʔϯɾϒϥΤϧͷ ʮ͍ۤༀ #JUUFS5POJD ʯͰ͢ -
H31$͘Μͷ͕͜͜Α͘ͳ͍ 1SPUPDPM#V ff FSTͷఆٛϑΝΠϧΛ͑ ϑϩϯτΤϯυͷ"1*௨৴ίʔυΛੜͰ͖Δ͕ɺ ٯʹݴ͏ͱఆٛϑΝΠϧ͕ڞ༗͞Ε͍ͯͳ͍ͱ௨৴ ࣗମͰ͖ͳ͍
ڞ༗͞Ε͍ͯͯఆٛϑΝΠϧ͕ݹ͔ͬͨΒ ಉظ͞Ε͍ͯͳ͔ͬͨΒ ΫϥΠΞϯτ͔Β ୟ͚ͳ͍͔ ࠷ۙ+3ͷӺ͔ͦΒי͕ೖͬͯΔڶഴ͕ͳ͘ͳͬͯ൵͍͠Ͱ͢ -
H31$Ͳ͏͏ͷʁ ϓϩτίϧఆٛϑΝΠϧΛ࡞ QSPUP ϓϩτίϧఆٛϑΝΠϧ͔Β࣮ࡍʹ͏ݴޠͷ ιʔείʔυΛੜͯ͠Β͏
͕ΜΔ syntax = "proto3"; package app.trainlcd.grpc; service StationAPI { rpc GetStationById (GetStationByIdRequest) returns (SingleStationResponse) {} rpc GetStationByGroupId (GetStationByGroupIdRequest) returns (MultipleStationResponse) {} rpc GetStationByCoordinates (GetStationByCoordinatesRequest) returns (MultipleStationResponse) {} rpc GetStationsByLineId (GetStationByLineIdRequest) returns (MultipleStationResponse) {} } message GetStationByIdRequest { uint32 id = 1; } -
ϓϩτίϧఆٛϑΝΠϧΛ࡞ QSPUP ϓϩτίϧఆٛϑΝΠϧΛ࡞ QSPUP ϓϩτίϧఆٛϑΝΠϧ͔Β࣮ࡍʹ͏ݴޠͷ
ιʔείʔυΛੜͯ͠Β͏ ͕ΜΔ syntax = "proto3"; package app.trainlcd.grpc; service StationAPI { rpc GetStationById (GetStationByIdRequest) returns (SingleStationResponse) {} rpc GetStationByGroupId (GetStationByGroupIdRequest) returns (MultipleStationResponse) {} rpc GetStationByCoordinates (GetStationByCoordinatesRequest) returns (MultipleStationResponse) {} rpc GetStationsByLineId (GetStationByLineIdRequest) returns (MultipleStationResponse) {} } message GetStationByIdRequest { uint32 id = 1; } -
ϓϩτίϧఆٛϑΝΠϧΛ࡞ QSPUP // example.proto // Protocol Buffers 3ͷه๏Ͱهड़͢Δ͜ͱΛએݴ syntax
= “proto3"; package ύοέʔδ໊; service αʔϏε໊ { rpc ϓϩγʔδϟ໊ (Ҿͱͯ͠ड͚औΔϝοηʔδܕ) returns (ฦΓͱͳΔϝοηʔδܕ) {} } message ϝοηʔδܕͷ໊લ { ܕ ϑΟʔϧυ໊ = ඥ͚ΔϑΟʔϧυ൪߸(1,2,3…); } ߏͱͯ͜͠Μͳײ͡ -
ϓϩτίϧఆٛϑΝΠϧΛ࡞ QSPUP // empireCivilServant.proto // ͨͱ͑…ࢢॴͰ͏ϓϩτίϧΛఆٛ͢Δ syntax = “proto3”;
package org.gunmaweb.grpc; service EmpireCivilServant { rpc GetCitizen (CitizenRequest) returns (CitizenResponse) {} } message CitizenRequest { uint32 id = 1; } message CitizenResponse { uint32 id = 1; string name = 2; bool is_happiness = 3; // gRPCؔͳ͍Ͱ͕͢ࢢຽͷٛͰ͢ } ࢢॴͷࢢຽཧγεςϜ͔Կ͔Ͱ࡞Γͦ͏ͳϓϩτίϧఆٛ -
ϓϩτίϧఆٛϑΝΠϧΛ࡞ QSPUP // enum.proto enum City { TAKASAKI =
0; // enumͷ0͔Β࢝·Βͳ͍ͱμϝ MAEBASHI = 1; OTA = 2; ISESAKI = 3; TATEBAYASHI = 4; … } // Ϩεϙϯε໊લͷεϥΠυͱಉ͡Ͱ͢ message CitizenResponse { uint32 id = 1; string name = 2; bool is_happiness = 3; // gRPCؔͳ͍Ͱ͕͢ࢢຽͷٛͰ͢ City city_of_residence = 4; } &OVN͋Γ·͢ -
H31$Ͳ͏͏ͷʁ ϓϩτίϧఆٛϑΝΠϧΛ࡞ QSPUP ϓϩτίϧఆٛϑΝΠϧ͔Β࣮ࡍʹ͏ݴޠͷ ιʔείʔυΛੜͯ͠Β͏
͕ΜΔ syntax = "proto3"; package app.trainlcd.grpc; service StationAPI { rpc GetStationById (GetStationByIdRequest) returns (SingleStationResponse) {} rpc GetStationByGroupId (GetStationByGroupIdRequest) returns (MultipleStationResponse) {} rpc GetStationByCoordinates (GetStationByCoordinatesRequest) returns (MultipleStationResponse) {} rpc GetStationsByLineId (GetStationByLineIdRequest) returns (MultipleStationResponse) {} } message GetStationByIdRequest { uint32 id = 1; } -
$ protoc -I=$SRC_DIR $SRC_DIR/empire.proto \ —js_out=import_style=commonjs:./$DST_DIR ϓϩτίϧఆٛϑΝΠϧ͔Β࣮ࡍʹ͏ݴޠͷ ιʔείʔυΛੜͯ͠Β͏
͜Ε͚ͩͰQSPUPϑΝΠϧ͔Β+4ͷίʔυΛੜͰ͖Δ ͕ɺ͜Ε͚ͩͰ5ZQF4DSJQUʹରԠ͍ͯ͠ͳ͍😩 -
ϓϩτίϧఆٛϑΝΠϧ͔Β࣮ࡍʹ͏ݴޠͷ ιʔείʔυΛੜͯ͠Β͏ ͪͳΈʹલͷεϥΠυͷίϚϯυΛ࣮ߦ͢Δͱ ͜Μͳײ͡ͷίʔυ ઌ಄ͷൈਮ ͕ग़ྗ͞Ε·͢ //
empire_pb.js // source: empire.proto /** * @fileoverview * @enhanceable * @suppress {missingRequire} reports error on implicit type usages. * @suppress {messageConventions} JS Compiler reports an error if a variable or * field starts with 'MSG_' and isn't a translatable message. * @public */ // GENERATED CODE -- DO NOT EDIT! /* eslint-disable */ // @ts-nocheck var jspb = require('google-protobuf'); var goog = jspb; var global = (typeof globalThis !== 'undefined' && globalThis) || (typeof window !== 'undefined' && window) || (typeof global !== 'undefined' && global) || (typeof self !== 'undefined' && self) || (function () { return this; }).call(null) || Function('return this’)(); -
# ts-protoc-genΛಥͬࠐΜͩύε PROTOC_GEN_TS_PATH=“./node_modules/.bin/protoc-gen-ts” # ͖ͬ͞࡞ͬͨ.protoϑΝΠϧ PROTOC_SRC_PATH=“./empire.proto” # ੜ͞Εͨίʔυ͕͜͜ʹ͛ࠐ·ΕΔ OUT_DIR=“./generated” protoc
\ --plugin="protoc-gen-ts=${PROTOC_GEN_TS_PATH}" \ --js_out="import_style=commonjs,binary:${OUT_DIR}" \ --ts_out="${OUT_DIR}" \ ${PROTOC_SRC_PATH} ϓϩτίϧఆٛϑΝΠϧ͔Β࣮ࡍʹ͏ݴޠͷ ιʔείʔυΛੜͯ͠Β͏ ίϚϯυ͕͍ͷͰɺ γΣϧεΫϦϓτΛ࡞͙ͬͯ͑͢ΔΑ͏ʹ͠·͠ΐ͏ -
ϓϩτίϧఆٛϑΝΠϧ͔Β࣮ࡍʹ͏ݴޠͷ ιʔείʔυΛੜͯ͠Β͏ ͜ΕͰ5ZQF4DSJQUͷఆٛϑΝΠϧ ͪ͜Βઌ಄ͷൈਮ ͕ు͖ग़͞Ε·ͨ͠ɻ Α͔ͬͨͰ͢Ͷ // package:
org.gunmaweb.grpc // file: proto/empire.proto import * as jspb from "google-protobuf"; export class CitizenRequest extends jspb.Message { getId(): number; setId(value: number): void; serializeBinary(): Uint8Array; toObject(includeInstance?: boolean): CitizenRequest.AsObject; static toObject(includeInstance: boolean, msg: CitizenRequest): CitizenRequest.AsObject; static extensions: {[key: number]: jspb.ExtensionFieldInfo<jspb.Message>}; static extensionsBinary: {[key: number]: jspb.ExtensionFieldBinaryInfo<jspb.Message>}; static serializeBinaryToWriter(message: CitizenRequest, writer: jspb.BinaryWriter): void; static deserializeBinary(bytes: Uint8Array): CitizenRequest; static deserializeBinaryFromReader(message: CitizenRequest, reader: jspb.BinaryReader): CitizenRequest; } -
͕ΜΔ ϓϩτίϧఆٛϑΝΠϧΛ࡞ QSPUP ϓϩτίϧఆٛϑΝΠϧ͔Β࣮ࡍʹ͏ݴޠͷ ιʔείʔυΛੜͯ͠Β͏
͕ΜΔ w ؤுΔ͔ؤுΔ͔ͷͰߟ͑ͯԼ͍͞ w ͨͿΜ࣮֬ʹա͍͗ͯΔͷͰऴΘΓ·͢ -
͝ਗ਼ௌ͋Γ͕ͱ͏͍͟͝·ͨ͠ʂ Thank you for listening! Gunma.web #49 ςʔϚϑϦʔ 2023.06.03 @
Takasaki metropolis, Empire of Gunma Tsubasa SEKIGUCHI