カート刷新プロジェクトにおけるOpenAPIを活用したコード自動生成の今と明日 / AStudy20190419

Slide 1

Slide 1 text

த໺ڿਓΞεΫϧגࣜձࣾ "4UVEZ ΞεΫϧࣾ಺ษڧձ Χʔτ࡮৽ϓϩδΣΫτʹ͓͚Δ 0QFO"1*Λ׆༻ͨ͠ίʔυࣗಈੜ੒ͷ ࠓͱ໌೔ ͋͢

Slide 2

Slide 2 text

8FCΞϓϦέʔγϣϯΤϯδχΞ த໺ڿਓ!/","/0@"LJIJUP IUUQTBDLJOUPTIHJUIVCJPBCPVU

Slide 3

Slide 3 text

044׆ಈ w0QFO"1*(FOFSBUPS wIUUQTHJUIVCDPN0QFO"1*5PPMTPQFOBQJHFOFSBUPS w(BOFTIB Ψωʔγϟ wIUUQTHJUIVCDPNBDLJOUPTIHBOFTIB w4OJEFM εφΠσϧ wIUUQTHJUIVCDPNBDLJOUPTITOJEFM

Slide 4

Slide 4 text

8%#13&447PM ಛू <ޮ཰ٸ্ঢ>εΩʔϚۦಈ8FC"1*։ൃ ষޙ൒ʙষΛࣥච͍͖ͤͯͨͩ͞·͠ ͨ!ײँ IUUQTHJIZPKQNBHB[JOFXEQSFTTBSDIJWFWPM

Slide 5

Slide 5 text

No content

Slide 6

Slide 6 text

ΞεΫϧࣾ಺ษڧձ ฏ੒࠷ޙͷAStudy

Slide 7

Slide 7 text

໨࣍ wͳͥίʔυΛࣗಈੜ੒͢Δͷ͔ʁ w0QFO"1* w υΩϡϝϯτϑΥʔϚοτ΍पลπʔϧͷ֓ཁ w εΩʔϚۦಈ։ൃ wΧʔτ࡮৽ϓϩδΣΫτ w 0QFO"1*Λ׆༻ͨ͠ίʔυࣗಈੜ੒ w 0QFO"1*υΩϡϝϯτΛॻ͚ͩ͘Ͱ࠷௿ݶͷςετ͕ࣗಈతʹ૸Δੈք ίʔυࣗಈੜ੒ͷ׆༻ঢ়گΛ੔ཧ ͨ͠͏͑Ͱɺ0QFO"1*Λ׆༻ͯ͠ ΋ͬͱੜ࢈ੑΛߴΊΔͨΊʹɺ௚ ۙͰ΍Γ͍ͨ͜ͱΛ͓࿩͠·͢ʂ

Slide 8

Slide 8 text

ͳͥਓྨ͸ ίʔυΛࣗಈੜ੒͢ΔͷͩΖ͏͔

Slide 9

Slide 9 text

࢈ۀֵ໋ʹΈΔਐԽͷྺ࢙ ୈҰ࣍࢈ۀֵ໋ ୈೋ࣍࢈ۀֵ໋ ୈࡾ࣍࢈ۀֵ໋ ୈ࢛࣍࢈ۀֵ໋

Slide 10

Slide 10 text

࢈ۀֵ໋ʹΈΔਐԽͷྺ࢙ ୈҰ࣍࢈ۀֵ໋ ୈೋ࣍࢈ۀֵ໋ ୈࡾ࣍࢈ۀֵ໋ ୈ࢛࣍࢈ۀֵ໋ ػց΍ιϑτ΢ΣΞͰஔ͖׵͑ͯ ޮ཰Խ͍ͯ͘͠ਐԽͷྺ࢙

Slide 11

Slide 11 text

ίʔυΛॻ͘ͱ͍͏ӦΈʹ͓͚ΔਐԽ wίʔυͷࣗಈੜ੒ʹΑͬͯ։ൃΛࢧԉ͢Δπʔϧͨͪ wఆܕతͳίʔυ͸πʔϧʹ೚ͤΔ͜ͱͰ։ൃऀ͸ੜ࢈ੑΛߴΊɺۀ຿ϩδοΫ ʹूதͰ͖Δ ϘΠϥʔϓϨʔτίʔυͷੜ੒ पลπʔϧʹΑΔίʔυੜ੒ͷαϙʔτ ίʔυੜ੒Λ಺แͨ͠ύϥμΠϜ IUUQTQSPKFDUMPNCPLPSH IUUQTXXXKFUCSBJOTDPNJEFB IUUQTPQFOBQJHFOFSBUPSUFDI IUUQTXXXKIJQTUFSUFDI IUUQTHSBQIRMDPEFHFOFSBUPSDPN IUUQTHSQDJP

Slide 12

Slide 12 text

ͭ·ΓɺਐԽͷͨΊ

Slide 13

Slide 13 text

No content

Slide 14

Slide 14 text

Slide 15

Slide 15 text

OpenAPI

Slide 16

Slide 16 text

0QFO"1*֓ཁ IUUQTHJUIVCDPN0"*0QFO"1*4QFDJpDBUJPO The OpenAPI Speciﬁcation w0QFO"1* 0QFO"1*TQFDJpDBUJPO wچ4XBHHFSTQFDJpDBUJPO w3&45"1*ͷ࢓༷Λهड़͢ΔϑΥʔϚοτ w0QFO"1**OJUJBUJWF w0QFO"1*ͷϑΥʔϚοτΛਪਐ͢Δஂମ w.JDSPTPGUɺ(PPHMFɺ*#.ɺ4NBSU#FBSͳͲ͕ ࢀՃ

Slide 17

Slide 17 text

w೥݄0QFO"1**OJUJBUJWF݁੒ w೥݄4XBHHFSTQFDJpDBUJPO͕0QFO"1**OJUJBUJWFʹدଃ͞ΕΔ w4XBHHFSTQFDJpDBUJPO͕0QFO"1*TQFDJpDBUJPOʹϦωʔϜ͞ ΕΔ w೥݄0QFO"1*TQFDJpDBUJPOϦϦʔε w೥݄ݱࡏͷόʔδϣϯ͸0QFO"1*TQFDJpDBUJPO 0QFO"1*ྺ࢙ 4XBHHFSϓϩδΣΫτ 0QFO"1**OJUJBUJWF 0QFO"1*TQFD 4XBHHFSTQFD 4XBHHFSUPPMT

Slide 18

Slide 18 text

0QFO"1*ϑΥʔϚοτ IUUQTCMPHSFBENFJPBOFYBNQMFpMMFEHVJEFUPTXBHHFS

Slide 19

Slide 19 text

0QFO"1*ϑΥʔϚοτ ϝλ৘ใ IUUQTCMPHSFBENFJPBOFYBNQMFpMMFEHVJEFUPTXBHHFS

Slide 20

Slide 20 text

0QFO"1*ϑΥʔϚοτ ΤϯυϙΠϯτ IUUQTCMPHSFBENFJPBOFYBNQMFpMMFEHVJEFUPTXBHHFS

Slide 21

Slide 21 text

0QFO"1*ϑΥʔϚοτ ίϯϙʔωϯτ IUUQTCMPHSFBENFJPBOFYBNQMFpMMFEHVJEFUPTXBHHFS

Slide 22

Slide 22 text

पลπʔϧ

Slide 23

Slide 23 text

0QFO"1*पลπʔϧ w 4XBHHFS&EJUPS w 0QFO"1*υΩϡϝϯτ εΩʔϚ ͷهड़Λࢧԉ w IUUQTFEJUPSTXBHHFSJP w 4XBHHFS6* w "1*࢓༷Λࢹ֮ԽɺΠϯλϥΫςΟϒͳ"1*ૢ࡞ w IUUQTQFUTUPSFTXBHHFSJP w 0QFO"1*(FOFSBUPS w 0QFO"1*υΩϡϝϯτ͔ΒιʔείʔυΛࣗಈੜ੒ w IUUQTPQFOBQJHFOFSBUPSUFDI IUUQTPQFOBQJUPPMT

Slide 24

Slide 24 text

εΩʔϚۦಈ։ൃ

Slide 25

Slide 25 text

εΩʔϚۦಈ։ൃ IUUQTHJIZPKQNBHB[JOFXEQSFTTBSDIJWFWPM ͸͡ΊʹΈΜͳͰ8FC"1*ͷ࢓༷Λ૬ஊܾͯ͠Ίͯ 0QFO"1*υΩϡϝϯτΛهड़ͯ͠ पลπʔϧΛ׆༻ͯ͠։ൃΛޮ཰Խ͢Δ ։ൃνʔϜશମͷϫʔΫϑϩʔ εΩʔϚͰ։ൃΛۦಈ͢Δ͜ͱ

Slide 26

Slide 26 text

εΩʔϚۦಈ։ൃͱपลπʔϧ IUUQTCMPHPOLOJOKBTDIFNB@pSTU@EFWFMPQNFOU API هड़ݴޠҎޙͷੈք 0QFO"1*υΩϡϝϯτͷهड़ ࢓༷ͷڞ༗ɾ֬ೝ ελϒੜ੒ػೳΛར༻ͨ͠εΩϟϑΥʔϧσΟϯά ੜ੒ͨ͠ελϒΛར༻ͨ͠ฏߦ։ൃ ੜ੒ͨ͠ΫϥΠΞϯτΛར༻ͨ͠޻਺࡟ݮ ςετίʔυͷࣗಈੜ੒ Swagger Editor Swagger UI OpenAPI Generator

Slide 27

Slide 27 text

0QFO"1*υΩϡϝϯτͷهड़ ࢓༷ͷڞ༗ɾ֬ೝ Swagger Editor Swagger UI ίʔυࣗಈੜ੒ͷԸܙ͸େ͖͍ IUUQTCMPHPOLOJOKBTDIFNB@pSTU@EFWFMPQNFOU API هड़ݴޠҎޙͷੈք ελϒੜ੒ػೳΛར༻ͨ͠εΩϟϑΥʔϧσΟϯά ςετίʔυͷࣗಈੜ੒ OpenAPI Generator ੜ੒ͨ͠ελϒΛར༻ͨ͠ฏߦ։ൃ ੜ੒ͨ͠ΫϥΠΞϯτΛར༻ͨ͠޻਺࡟ݮ

Slide 28

Slide 28 text

Slide 29

Slide 29 text

Χʔτ࡮৽ϓϩδΣΫτ

Slide 30

Slide 30 text

Χʔτ࡮৽ϓϩδΣΫτ w-0)"$0ͷچ0SEFSγεςϜΛ৽"1*ج൫γεςϜʹҠߦ͢Δ wϓϩδΣΫτ໊UJBNBU ςΟΞϚτ wϨΨγʔΛ୤٫͠ɺ։ൃޮ཰΍αʔϏεͷ඼࣭Λ޲্͢Δ wΧʔτɾϨδը໘Λര଎Խ͢Δ շదͳ͓ങ͍෺ମݧͷఏڙ

Slide 31

Slide 31 text

Χʔτ࡮৽ϓϩδΣΫτͷͬ͘͟Γͨ͠ਤ #'' ഑ૹ ঎඼ Ϣʔβʔ ஫จ "1*ج൫ ,PUMJO 4QSJOH#PPU 4QSJOH8FC'MVY ,PUMJO+BWB 4QSJOH#PPU "QBDIF$BNFM 5ZQF4DSJQU +2VFSZ 0QFO"1* 1SPUPDPM#V⒎FST "1*࢓༷ɾεΩʔϚఆٛ

Slide 32

Slide 32 text

"1*࢓༷ɾεΩʔϚఆٛ ഑ૹ ঎඼ Ϣʔβʔ ஫จ ,PUMJO 4QSJOH#PPU 4QSJOH8FC'MVY ,PUMJO+BWB 4QSJOH#PPU "QBDIF$BNFM 5ZQF4DSJQU +2VFSZ 0QFO"1*Λ΋ͱʹͨ͠ίʔυੜ੒ͷ׆༻ঢ়گ "1*ج൫ 0QFO"1* 1SPUPDPM#V⒎FST #'' #''ͰͷϞσϧΫϥεੜ੒ͷΈ

Slide 33

Slide 33 text

0QFO"1*υΩϡϝϯτͷهड़ ࢓༷ͷڞ༗ɾ֬ೝ Swagger Editor Swagger UI ίʔυࣗಈੜ੒׆༻ͷ༨஍͸͋Δ IUUQTCMPHPOLOJOKBTDIFNB@pSTU@EFWFMPQNFOU API هड़ݴޠҎޙͷੈք ελϒੜ੒ػೳΛར༻ͨ͠εΩϟϑΥʔϧσΟϯά ςετίʔυͷࣗಈੜ੒ OpenAPI Generator ੜ੒ͨ͠ελϒΛར༻ͨ͠ฏߦ։ൃ ੜ੒ͨ͠ΫϥΠΞϯτΛར༻ͨ͠޻਺࡟ݮ

Slide 34

Slide 34 text

"1*࢓༷ɾεΩʔϚఆٛ ഑ૹ ঎඼ Ϣʔβʔ ஫จ ,PUMJO+BWB 4QSJOH#PPU "QBDIF$BNFM 5ZQF4DSJQU +2VFSZ ׆༻ͷ༨஍͸͋Δ"1*ΫϥΠΞϯτ "1*ج൫ ,PUMJO 4QSJOH#PPU 4QSJOH8FC'MVY 0QFO"1* 1SPUPDPM#V⒎FST #'' ίϧʔνϯͰ࢖͍΍͍͢Α͏ʹ 8FC$MJFOUΛಠࣗʹϥοϓͨ͠Ϋϥε Λ࢖͍ͬͯΔͷͰɺ ࣗಈੜ੒ͷ׆༻͸೉͍͔͠΋ "1*ΫϥΠΞϯτͷࣗಈੜ੒

Slide 35

Slide 35 text

"1*࢓༷ɾεΩʔϚఆٛ ,PUMJO 4QSJOH#PPU 4QSJOH8FC'MVY 5ZQF4DSJQU +2VFSZ ׆༻ͷ༨஍͸͋Δ"1*αʔόʔ #'' ,PUMJO+BWB 4QSJOH#PPU "QBDIF$BNFM ഑ૹ ঎඼ Ϣʔβʔ ஫จ "1*ج൫ 0QFO"1* 1SPUPDPM#V⒎FST ελϒੜ੒Λར༻ͨ͠εΩϟϑΥʔϧσΟϯά ࠾༻͍ͯ͠Δٕज़͕ɺ 0QFO"1*(FOFSBUPS͕ੜ੒͢Δ ελϒͷίʔυͱҧ͏ͷͰ࢖͑ͳ͍͔΋

Slide 36

Slide 36 text

׆༻ͷ༨஍͸͋Δ΋ͷͷ #'' ഑ૹ ঎඼ Ϣʔβʔ ஫จ "1*ج൫ ,PUMJO 4QSJOH#PPU 4QSJOH8FC'MVY ,PUMJO+BWB 4QSJOH#PPU "QBDIF$BNFM 5ZQF4DSJQU +2VFSZ 0QFO"1* 1SPUPDPM#V⒎FST "1*࢓༷ɾεΩʔϚఆٛ ಋೖͷखؒʹݟ߹͏͚ͩͷޮՌ͕ಘΒΕΔ͔Ͳ͏͔ ඍົͳ͜ͱ͕ଟ͔ͬͨ ໨త͸ɺίʔυࣗಈੜ੒ͷ׆༻Ͱ͸ͳ͘։ൃͷੜ࢈ੑΛ্͛Δ͜ͱ ͦ͜Ͱ

Slide 37

Slide 37 text

APIͷE2Eςετ(ͷҰ෦)Λ ࣗಈੜ੒͍ͨ͠

Slide 38

Slide 38 text

εΩʔϚۦಈ։ൃ IUUQTHJIZPKQNBHB[JOFXEQSFTTBSDIJWFWPM ୈষ0QFO"1*ʹΑΔεΩʔϚۦಈ։ൃ ʮεΩʔϚΛ༻͍ͯ࢓༷ͱ࣮૷ͷҰகΛࣗಈςετ͢Δʯ 3VCZPO3BJMTͰ࣮૷ͨ͠"1*αʔόͷϨεϙϯε ͕ɺ0QFO"1*υΩϡϝϯτͱဃ཭͍ͯ͠ͳ͍͔ࣗ ಈతʹνΣοΫ͢Δ࣮૷Λ঺հ͍ͯ͠Δɻ 34QFD PBT@QBSTFS KTPO@TDIFNB $PNNJUUFF

Slide 39

Slide 39 text

IUUQTHJIZPKQNBHB[JOFXEQSFTTBSDIJWFWPM εΩʔϚۦಈ։ൃ ୈষ0QFO"1*ʹΑΔεΩʔϚۦಈ։ൃ ʮεΩʔϚΛ༻͍ͯ࢓༷ͱ࣮૷ͷҰகΛࣗಈςετ͢Δʯ 3VCZPO3BJMTͰ࣮૷ͨ͠"1*αʔόͷϨεϙϯε ͕ɺ0QFO"1*υΩϡϝϯτͱဃ཭͍ͯ͠ͳ͍͔ࣗ ಈతʹνΣοΫ͢Δ࣮૷Λ঺հ͍ͯ͠Δɻ 34QFD PBT@QBSTFS KTPO@TDIFNB $PNNJUUFF Χʔτ࡮৽ϓϩδΣΫτ͕࠾༻͍ͯ͠Δٕज़Ͱ Ͳ͏࣮ݱ͢Δ͔

Slide 40

Slide 40 text

Spring Cloud Contract (SCC)

Slide 41

Slide 41 text

4QSJOH$MPVE$POUSBDU 4$$ w$POTVNFS%SJWFO$POUSBDUT $%$ EFWFMPQNFOU w IUUQXXXTFSWJDFEFTJHOQBUUFSOTDPN8FC4FSWJDF&WPMVUJPO$POTVNFS%SJWFO$POUSBDUT w"1*ར༻ऀ͕ظ଴͢ΔڍಈΛυΩϡϝϯτԽ͢Δ $POUSBDU w"1*ར༻ऀఏڙऀͷ૒ํ͕$POUSBDUΛ΋ͱʹςετΛߦ͏͜ͱͰ඼࣭Λอ ͪͳ͕ΒχʔζΛຬͨ͢։ൃΛߦ͏ w4QSJOH$MPVE$POUSBDU͸$%$ͷ࣮ફΛαϙʔτ͢Δπʔϧ w$POUSBDUͷهड़͸(SPPWZͱ:".-͕࢖͑Δ w$POUSBDU͔Βελϒαʔό΍ςετΛࣗಈੜ੒Ͱ͖Δ IUUQTHJUIVCDPNTQSJOHDMPVETQSJOHDMPVEDPOUSBDU

Slide 42

Slide 42 text

4QSJOH$MPVE$POUSBDU 4$$ $POUSBDU (SPPWZ%4- ࣗಈੜ੒͞ΕΔςετίʔυ

Slide 43

Slide 43 text

4$$ͷ$POUSBDUͱ0QFO"1*υΩϡϝϯτͷҧ͍ w4$$ͷ$POUSBDU wϦΫΤετ˓˓˓Λૹ৴ͨ͠ΒɺϨεϙϯεººº͕ฦͬͯ͘Δ  ˠʮετʔϦʔʯ w0QFO"1*υΩϡϝϯτ wड෇͚ΔϦΫΤετύϥϝʔλ໊͸9ɺܕ͸99  ฦ͢Ϩεϙϯεͷߏ଄͸:ɺܕ͸::  ˠʮ࢓༷ʯ ߏ଄΍ܕΛఆٛ͢Δ͚ͩ

Slide 44

Slide 44 text

$POUSBDUΛ0QFO"1*υΩϡϝϯτʹຒΊࠐΉͱ͍͏ൃ૝ w0QFO"1*υΩϡϝϯτͷ֦ுྖҬʹ$POUSBDU :".-%4- ΛຒΊࠐΉ͜ͱͰɺఆٛ಺༰ͷॏෳΛഉআ͠ɺ୯ҰͷυΩϡ ϝϯτͰ࢓༷ͱετʔϦʔΛ؅ཧՄೳʹͳΔ w0QFO"1*$POUSBDUͷυΩϡϝϯτΛίϯόʔλʹ௨͢͜ͱ ͰɺετʔϦʔ෦෼Λݕূ͢ΔςετίʔυΛੜ੒͢Δ IUUQTHJUIVCDPNTQSJOHGSBNFXPSLHVSVTQSJOHDMPVEDPOUSBDUPB 4QSJOH$MPVE$POUSBDU0QFO"1*$POUSBDU$POWFSUFS +PIO5IPNQTPO !TQSJOHGSBNFXPSLHVSV IUUQTTQSJOHGSBNFXPSLHVSVEFpOJOHTQSJOHDMPVEDPOUSBDUTJOPQFOBQJ

Slide 45

Slide 45 text

$POUSBDUΛ0QFO"1*υΩϡϝϯτʹຒΊࠐΉͱ͍͏ൃ૝ ϦΫΤετ Ϩεϙϯε

Slide 46

Slide 46 text

΍Γ͍ͨࣄͱͪΐͬͱҧ͏ ͜Ε͸͜ΕͰૉఢ͚ͩͲ

Slide 47

Slide 47 text

0QFO"1*υΩϡϝϯτ͔ΒςετίʔυΛੜ੒͍ͨ͠ w"1*αʔό͕ฦ͢Ϩεϙϯεͷߏ଄͕0QFO"1*υΩϡϝϯτͷͦΕͱဃ཭ͯ͠ ͍ͳ͍͔ςετ͍ͨ͠ w $POUSBDUͳͲ͸ॻ͔ͣʹૉͷ 0QFO"1*υΩϡϝϯτΛॻ͚ͩ͘Ͱɺ࠷௿ݶ ͷςετ ˞ ͕ࣗಈతʹ૸Δੈք w ˞ 0QFO"1*͸ʮ࢓༷ʯͷهड़͚ͩͳͷͰɺςετͰ͖Δ͜ͱ͸ݶΒΕΔ w͕ɺϨεϙϯεͷߏ଄͸ςετͰ͖Δ

Slide 48

Slide 48 text

4QSJOH$MPVE$POUSBDU0QFO"1* w0QFO"1*υΩϡϝϯτͷఆٛΛ4$$ͷ$POUSBDUʹ ม׵͢Δ(SBEMF.BWFOϓϥάΠϯ wϨεϙϯεͷߏ଄Λςετ͢Δ$POUSBDUʹม׵ͯ͠ ςετίʔυΛੜ੒͢Δ IUUQTHJUIVCDPNBDLJOUPTITQSJOHDMPVEDPOUSBDUPQFOBQJ ແ͍ͳΒ࡞Ε͹͍͍

Slide 49

Slide 49 text

4QSJOH$MPVE$POUSBDU0QFO"1* ಈ࡞Πϝʔδ 0QFO"1*υΩϡϝϯτ 4QSJOH$MPVE$POUSBDU0QFO"1* 4$$Λར༻ͯ͠$POUSBDU͔Β ςετίʔυΛੜ੒ 0QFO"1*υΩϡϝϯτʹఆٛ͞Ε͍ͯΔ Ϩεϙϯεͷߏ଄Λ$POUSBDUΦϒδΣΫτʹม׵

Slide 50

Slide 50 text

4QSJOH$MPVE$POUSBDU0QFO"1* w·ͩ࡞Γ࢝Ίͨ͹͔Γ wͱΓ͋͑ͣςετ͕ੜ੒͞ΕΔ ಈ࡞͢Δ͔ෆ໌ ͷϨϕϧ w࣮༻Ϩϕϧʹ࢓্࣮͛ͯࡍʹ׆༻͍͖͍ͯͨ͠ wΞεΫϧͷ044ͱͯ͠ҭ͍͖͍ͯͯͨ

Slide 51

Slide 51 text

ίʔυࣗಈੜ੒Λ׆༻ͯ͠ ໌೔དྷΔΤϯδχΞϦϯάΛʂ ΞεΫϧ