committee-railsとOpenAPI Generatorでスキーマ駆動なAPI開発をする

by Y_uuu

Slide 1

Slide 1 text

גࣜձࣾ'VTJD*P5νʔϜ Ԭቌ༤ฏ 'VTJD5FDI-JWF7PM3VCZJTUͷू͍7PM DPNNJUUFFSBJMTͱ0QFO"1*(FOFSBUPSͰ   εΩʔϚۦಈͳ"1*։ൃΛ͢Δ📝

Slide 2

Slide 2 text

ࣗݾ঺հ • ॴଐ • גࣜձࣾ'VTJD*P5νʔϜ • ϑΟϤϧυϒʔτΩϟϯϓϝϯλʔ • ܦྺ • ؔ੢Ͱ૊ࠐΈΤϯδχΞ ʙ • ෱ԬͰ8FCΫϥ΢υΤϯδχΞ ʙ • ೝఆࢿ֨ *P5Ϋϥ΢υΤϯδχΞ Ԭ ቌ ༤ ฏ 0 L B [ B L J : V I F J ʘ /&8 ʗ

Slide 3

Slide 3 text

3VCZPO3BJMTΛ࢖ͬͨҊ݅4FOTPS$PSQVT*$ • $0ηϯαʔΛ༻͍ͨײછ঱ରࡦ*P5ιϦϡʔγϣϯ • ηϯαʔ஋Λ"84ʹऔΓࠐΈɺμογϡϘʔυʹՄࢹԽ • ͜ͷμογϡϘʔυΛ3VCZPO3BJMTͰ։ൃ IUUQTJOGPDPSQVTDPKQQVSQPTFTFOTPSDPSQVTJD IUUQTGVTJDDPKQXPSLT

Slide 4

Slide 4 text

3VCZPO3BJMTΛ࢖ͬͨҊ݅NPDLNPDL • *P5։ൃʹ͓͚ΔςετΛࢧԉ͢Δ'VTJDͷࣗࣾϓϩμΫτ • σόΠεͷ୅ΘΓʹσʔλΛૹ৴Ͱ͖ɺ਺΍ߏ଄Λࣗ༝ʹม͑ΒΕΔ • ίϯιʔϧը໘Λ3VCZPO3BJMTͰ։ൃ IUUQTNPDLNPDLDPN

Slide 5

Slide 5 text

3VCZPO3BJMTΛ࢖ͬͨҊ݅/JDPMF • ࣾ಺χίχίΧϨϯμʔγεςϜ 'VTJDͷࣾ಺γεςϜ • /FYUKTͱ3VCZPO3BJMTΛ࢖ͬͨ41"Ͱ͋Γɺ3BJMT͸"1*ϞʔυͰ࡞͍ͬͯΔ • ࠓ೔͓࿩͢Δ಺༰ͱ࠷΋਌͍͠ߏ੒ IUUQTUFDIGVTJDDPKQQPTUTOJDPMFSFOFXBM

Slide 6

Slide 6 text

લఏ • ຊ೔͓࿩͢Δ"1*͸શͯ8FC"1*Λࢦ͠·͢ • 3&45GVM"1*Λ૝ఆ͓ͯ͠࿩͠·͢ • ࣗ෼΋ϕετϓϥΫςΟεΛ໛ࡧ͍ͯ͠Δͱ͜ΖͰ͢ • ΋ͬͱྑ͍ํ๏΍πʔϧ͕͋Ε͹ͥͻϑΟʔυόοΫ͍ͩ͘͞🙏

Slide 7

Slide 7 text

໨࣍ 3BJMTͰ"1* "1*εΩʔϚ "1*ͷςετ ΫϥΠΞϯτίʔυࣗಈੜ੒ ·ͱΊ

Slide 8

Slide 8 text

3BJMTͰ"1*

Slide 9

Slide 9 text

3BJMTͰ"1*Λ࡞ͬͨ͜ͱ͸͋Γ·͔͢ʁ🙋

Slide 10

Slide 10 text

"1*Λ࡞ΔγνϡΤʔγϣϯ • 'VTJDͷडୗҊ݅͸ۀ຿γεςϜ͕ଟ͍ • 3BJMTͷϨʔϧʹ৐Δํ͕ߴ඼࣭ͳ΋ͷΛޮ཰తʹ։ൃͰ͖Δ IUUQTGVTJDDPKQXPSLT

Slide 11

Slide 11 text

"1*Λ࡞ΔγνϡΤʔγϣϯ • ͦΕͰ΋"1*Λ࡞ΔγνϡΤʔγϣϯ͸͋Δ • 6*69Λॏࢹ͢΂͘41"Ͱ։ൃ͢Δͱ͖ • ϞόΠϧΞϓϦΛఏڙ͢Δͱ͖ • ଞγεςϜͱ࿈ܞ͢Δͱ͖ • ඇಉظͰσʔλΛड͚౉͍ͨ͠͠ͱ͖ • FUD "1*αʔό 6*69ॏࢹͷ ϑϩϯτΤϯυ ϞόΠϧΞϓϦ ଞγεςϜ

Slide 12

Slide 12 text

"1*ʹ͓͚Δ೰Έ ϑϩϯτΤϯυͱόοΫΤϯυͰ ࢓༷ͷෆҰக͕ى͜Γ͕ͪ +BWB4DSJQUͱ3VCZͰ   ໋໊نଇ͕ҧ͏ DSFBUFE@BU͔DSFBUFE"U͔ 3BJMT͚ͩͰ࡞ΔΑΓ΋ ࣮૷ྔ͕େ͖͘ͳΔ ೝূͲ͏͢Δʁ ϖʔδωʔγϣϯ΍ݕࡧͲ͏͢Δʁ "1*Λ܁Γฦ͠ݺͿ͜ͱͰ ϖʔδͷද͕ࣔ஗͘ͳΓ͕ͪ

Slide 13

Slide 13 text

Slide 14

Slide 14 text

ϑϩϯτΤϯυͱόοΫΤϯυͰ࢓༷ͷෆҰக͕ى͜Γ͕ͪ "1*εΩʔϚΛॻ͍ͯෆҰகΛ๷͙

Slide 15

Slide 15 text

"1*εΩʔϚ

Slide 16

Slide 16 text

ΠϯλʔϑΣʔε࢓༷ΛܾΊΔ͜ͱͷॏཁੑ • ෳ਺ͷߏ੒ཁૉ͔Β੒ΓཱͭγεςϜΛ࡞Δࡍͷమଇ • ·ͣΠϯλʔϑΣʔε࢓༷ΛܾΊΔ ߏ੒ཁૉ" ߏ੒ཁૉ# ΠϯλʔϑΣʔε

Slide 17

Slide 17 text

ΠϯλʔϑΣʔε࢓༷ΛܾΊΔ͜ͱͷॏཁੑ • ΠϯλʔϑΣʔε࢓༷͕ܾ·͍ͬͯͳ͍ͱ • ૒ํ͕ಠࣗղऍͰ֤ϞδϡʔϧΛ࡞ͬͯ૊Έ߹Θͤͨͱ͖ʹ໰୊͕ੜ͡Δ • ૊Έ߹ΘͤΔ·Ͱ໰୊͕ݦࡏԽ͠ͳ͍ͷͰɺඞવతʹख໭Γ͕େ͖͘ͳΔ • ੹೚ͷॴࡏ͕ᐆດʹͳΓɺϞϝΔ ߏ੒ཁૉ" ߏ੒ཁૉ# NPPE ؾ෼ ͔ͩΒ จࣈͰ౉ͤ͹͍͍ͩΖ͏ NPPE͸FOVNͷ஋Λ ਺ࣈͰ౉ͯ͘͠ΕΔͩΖ͏ 1045BQJWOJLPT \ lNPPEzlHPPEz lEBUFzlz ^

Slide 18

Slide 18 text

"1*ʹ͓͚ΔΠϯλʔϑΣʔε࢓༷ʹ"1*εΩʔϚ • "1*εΩʔϚʹॻ͔ΕΔ৘ใ • 8FC"1*͕ఏڙ͢ΔΤϯυϙΠϯτ • "1*͕ఏڙ͢ΔϦιʔε • ϦΫΤετ͓ΑͼϨεϙϯεͷܗࣜ • ͳͲ ΫϥΠΞϯτ ϑϩϯτΤϯυ "1* όοΫΤϯυ 1045BQJWOJLPT \ lNPPEzlTUSJOHz lEBUFzlTUSJOHz ^ "1*εΩʔϚ

Slide 19

Slide 19 text

"1*εΩʔϚͷॻ͖ํ • 3&45GVMͳ"1*Ͱ͋Ε͹0QFO"1*͕Ұൠత • :".-͔+40/Ͱॻ͘ • 4UPQMJHIU4UVEJP౳ͷπʔϧΛ׆༻͢Δͱָ

Slide 20

Slide 20 text

"1*ͷςετ

Slide 21

Slide 21 text

ςετ͕ඞཁͳཧ༝ • ࢓༷ʹԊ࣮ͬͨ૷Ͱ͋Δ͔Λ֬ೝ͢ΔͨΊ ΫϥΠΞϯτ ϑϩϯτΤϯυ "1* όοΫΤϯυ 1045BQJWOJLPT \ lNPPEzlHPPEz lEBUFzlz ^ \ lJEz lNPPEzlHPPEz lEBUFzlz lVTFS@JEz lDSFBUFE"Uz5 lVQEBUFE"Uz5 ^ εΩʔϚʹͦͬͨϦΫΤ ετΛड͚෇͚Մೳ͔ʁ εΩʔϚʹԊͬͨϨεϙ ϯε͕ฦͬͯ͘Δ͔ʁ

Slide 22

Slide 22 text

ςετࣗମ͸γϯϓϧ • ࣮ࡍʹϦΫΤετͯ͠ɺظ଴ͨ͠Ϩεϙϯε͕ฦΔ͜ͱΛ֬ೝ͢Ε͹ྑ͍ • ϨεϙϯεσʔλΛࣄࡉ͔ʹ֬ೝ͢Δͷ͸େม • ຊདྷฦͯ͠͸͍͚ͳ͍σʔλ͕͍ࠞͬͯ͡Δ͜ͱʹؾ͖ͮʹ͍͘ ΫϥΠΞϯτ "1* 1045BQJWOJLPT \ lNPPEzlHPPEz lEBUFzlz ^ \ lJEz lNPPEzlHPPEz lEBUFzlz lVTFS@JEz lDSFBUFE"Uz5 lVQEBUFE"Uz5 ^ ͦΕͧΕνΣοΫ͢Δͷ͸େม

Slide 23

Slide 23 text

DPNNJUUFFSBJMT • DPNNJUUFFͱ͍͏HFNΛ3BJMTʹ૊ΈࠐΈ΍ͨ͘͢͠΋ͷ • 0QFO"1*ͷεΩʔϚ௨ΓͷϨεϙϯε͕དྷ͍ͯΔ͔νΣοΫͰ͖Δ

Slide 24

Slide 24 text

σϞ • ͜Μͳײ͡ͷςετίʔυΛॻ͘ DPNNJUUFFSBJMT͕ఏڙ͢ΔBTTFSUϝιου

Slide 25

Slide 25 text

σϞ • ฦ͍ͯ͠ΔϨεϙϯε • ςετ݁Ռ ຊདྷฦ͢΂͖NPPEΛ๨Ε͍ͯΔ NPPE͕ͳ͍͜ͱΛࢦఠͯ͘͠ΕΔ

Slide 26

Slide 26 text

σϞ • ฦ͍ͯ͠ΔϨεϙϯε • ςετ݁Ռ εΩʔϚʹ͸ଘࡏ͠ͳ͍,FZΛฦ͢ EVNNZ͕εΩʔϚʹ͸ଘࡏ͠ͳ͍ ͜ͱΛࢦఠͯ͘͠ΕΔ

Slide 27

Slide 27 text

ΫϥΠΞϯτίʔυࣗಈੜ੒

Slide 28

Slide 28 text

ΫϥΠΞϯτͷίʔυ • +BWB4DSJQUͷ৔߹9.-)UUQ3FRVFTU౳Λ࢖͏͜ͱͰॻ͚Δ • "1*͝ͱʹ͜ΕΛॻ͘ͷ͸େม • 5ZQF4DSJQUΛॻ͘ͱ͖ͷܕఆ͕ٛେม

Slide 29

Slide 29 text

0QFO"1*(FOFSBUPS • 0QFO"1*ͷεΩʔϚΛݩʹίʔυΛࣗಈੜ੒Ͱ͖Δ • ܕఆٛ΋ࣗಈੜ੒Ͱ͖Δ

Slide 30

Slide 30 text

σϞ • PQFOBQJHFOFSBUPSDMJίϚϯυΛ࣮ߦͯ͠ɺίʔυΛࣗಈੜ੒

Slide 31

Slide 31 text

σϞ • ੜ੒͞ΕͨΫϥΠΞϯτΛར༻ͨ͠ίʔυ

Slide 32

Slide 32 text

·ͱΊ

Slide 33

Slide 33 text

"1*ͷ։ൃ͸εΩʔϚۦಈͰ • όοΫΤϯυ͸ςετͰεΩʔϚ௨Γͷ࣮૷Λ୲อ • ϑϩϯτΤϯυ͸ࣗಈੜ੒ͰεΩʔϚ௨Γͷ࣮૷Λ୲อ ΫϥΠΞϯτ ϑϩϯτΤϯυ "1* όοΫΤϯυ 1045BQJWOJLPT \ lNPPEzlTUSJOHz lEBUFzlTUSJOHz ^ "1*εΩʔϚ ςετ ࣗಈੜ੒ 0QFO"1* DPNNJUUFFSBJMT 0QFO"1*(FOFSBUPS

Slide 34

Slide 34 text

ࢿྉ࡞੒ʹ࢖ͬͨιʔείʔυ • IUUQTHJUIVCDPNZVVVOJLP@BQJ

Slide 35

Slide 35 text

5IBOLZPV 'VTJDͰ͸*P5ͰੈͷதΛΞοϓσʔτ͚ͭͮ͠Δ   ΤϯδχΞΛืू͍ͯ͠·͢ IUUQTSFDSVJUGVTJDDPKQ