隣の API のデータを Rails らしく、しなやかに扱う / Handling next-door API data in Rails

Transcript

1. Daisuke Aritomo (@osyoyu) / Kaigi on Rails 2022 ྡͷ API ͷσʔλΛ Rails Β͘͠ɺ͠ͳ΍͔ʹѻ͏
2. @osyoyu Ͱ͢ • ΫοΫύουͰຖ೔ Rails Λॻ͍ͯ·͢ • ී௨ͷ Ruby ͕޷͖ • ISUCON Ͱ Ruby Λ༏উ͍ͤͨ͞
3. ྡͷ API ͷσʔλΛ Rails Β͘͠ɺ͠ͳ΍͔ʹѻ͏
4. API ΞΫηεͳ͠Ͱ͸αʔϏεΛ࡞Εͣ ୭΋͕ API αʔόʔͱΫϥΠΞϯτͷ྆ํΛ࡞Δ େ API ࣌୅
5. API αʔόʔΛ࡞Δͱ͖͸ ϓϥΫςΟεཱ͕֬͞Ε͍ͯΔ
6. ҰํɺΫϥΠΞϯτΛ࡞Δͱ͖͸
7. ҰํɺΫϥΠΞϯτΛ࡞Δͱ͖͸
8. ҰํɺΫϥΠΞϯτΛ࡞Δͱ͖͸ API ΫϥΠΞϯτͷ࡞Γํ͸ 
 ඞͣ͠΋੔ཧ͞Ε͍ͯͳ͍
9. ྡͷ API ͷσʔλΛ Rails Β͘͠ɺ͠ͳ΍͔ʹѻ͏ ͍͍ײ͡ͷ API ΫϥΠΞϯτͷ࡞Γ͔ͨ
10. ʮ͍͍ײ͡ͷ API ΫϥΠΞϯτͷ࡞Γํʯ ΫοΫύουͰ͋Γ͕ͪͳ୊ࡐΛྫʹ 
 έʔεελσΟͯ͠ΈΑ͏
11. ͲͷΑ͏ͳ Ruby ΠϯλʔϑΣʔεʹ͢Δ͔ʁ Ϩγϐίϯςετͷ microservice ͷྫ User (MySQL) Recipe 
 Contest (MySQL) Recipe (API) Recipe 
 ContestEntry (MySQL) N 1 N 1 N 1 1 1
12. • ҟͳΔιʔεछผͷ en ti ty ͸ 
 ҟͳΔऔಘํࣜΛఏڙ͢Δ • MySQL ༝དྷ͸ AR::Base Λ 
 ܧঝ͢ΔΫϥεͰදݱ • ֎෦༝དྷ͸ผͷΫϥεͰදݱ 
 (i.e. AR::Base Λܧঝ͠ͳ͍) (1) ιʔεͷछผʹண໨͢Δ User (MySQL) Recipe 
 Contest (MySQL) Recipe (API) Recipe 
 ContestEntry (MySQL) N 1 N 1 N 1 1 1
14. has_one ͸ૉ௚ʹදݱͰ͖ͦ͏
15. belongs_to Ͱ N+1 ʹͳΓ͕ͪ has_one ͸ૉ௚ʹදݱͰ͖ͦ͏ has_manyͱ belongs_toͷෳ߹
16. (1) ιʔεͷछผʹண໨͢Δ ੑ࣭͕ҟͳΔ (DB/API) σʔλ͕֤ʑʹదͨ͠ߏ଄Λ΋ͭ ϓϩάϥϜͷڍಈΛ૝૾͠΍͍͢ 👍 JOIN ΍ ؔ࿈ (associa ti on) Λදݱ͢Δͷʹແཧ͕ੜ͡Δ 🤔
17. • ಉҰͷυϝΠϯͷ en ti ty ͸ 
 ಉҰͷऔಘํ๏Λఏڙ͢Δ • ΞϓϦͷυϝΠϯ্ͳΒ͹ 
 ͢΂ͯ Ac ti veRecord-like ͳ 
 औಘํࣜΛఏڙ͢Δ (2) υϝΠϯڥքʹண໨͢Δ Tweet (API) User (MySQL) Recipe 
 Contest (MySQL) Recipe (API) Recipe 
 ContestEntry (MySQL) 1 N 1 N 1 1
18. ਓྨͷྺ࢙: ActiveResource, Her, ... • Ac ti veResource • RESTful API Λ͍͍ײ͡ʹ model ͬΆͯ͘͘͠ΕΔ • Rails 3.2 ·Ͱͷඪ४ػೳͩͬͨ • Her • ͜Ε΋ಉ͡Α͏ͳ໨తͷ Gem • ΄͔ʹ΋ Ac ti veRestClient, Spyke, Flexirest ͳͲ͕͋Δ
19. ਓྨͷྺ࢙: ActiveResource, Her, ... • ͜ΕΒ͸ "Res tf ul API" Λେલఏʹ͓͍͍ͯΔ • ಛఆͷ URL ߏ଄ΛٻΊΒΕΔ • ΍ͬͺΓ JOIN ͸ͦ͜·ͰಘҙͰ΋ͳ͍
20. (2) υϝΠϯڥքʹண໨͢Δ ؔ࿈͢ΔσʔλʹಉҰͷૢ࡞ମܥͰΞΫηεͰ͖Δ ʹ σʔλͷར༻͕ࣗવͳܗͰهड़Ͱ͖Δ 👍 ຊདྷҟͳΔૢ࡞ΛಉҰͷૢ࡞ʹݟ͔͚͍ͤͯΔͷͰ 
 ࣮૷ʹແཧ͕ग़͖͕ͯͪ 🤔
21. (2) υϝΠϯڥքʹண໨͢Δ ؔ࿈͢ΔσʔλʹಉҰͷૢ࡞ମܥͰΞΫηεͰ͖Δ ʹ σʔλͷར༻͕ࣗવͳܗͰهड़Ͱ͖Δ 👍 ຊདྷҟͳΔૢ࡞ΛಉҰͷૢ࡞ʹݟ͔͚͍ͤͯΔͷͰ 
 ࣮૷ʹແཧ͕ग़͖͕ͯͪ 🤔 👊👊 ࣮૷Ͱ৐Γӽ͑Ε͹ղܾ 👊👊
22. ͭͬͯ͘ΈΑ͏ʂ
23. AR ෩ API ΫϥΠΞϯτΛͭͬͯ͘ΈΑ͏ • ֎෦ API ͕ఏڙ͢Δ Recipe ʹ͍ͭͯ • Recipe. fi nd(1) ͷΑ͏ͳܗͰΫΤϦͰ͖Δ • @recipe. ti tle ͷΑ͏ͳܗͰϑΟʔϧυΛಡΊΔ • Ϧιʔεαʔόʔʹಛఆͷߏ଄ (RESTful) Λཁٻ͠ͳ͍ • JOIN (has_many, belongs_to, ...) ΋͏·͘͜ͳͤΔ • Α͏ͳʢجຊతͳʣ΋ͷΛͭͬͯ͘ΈΑ͏
24. ͨͱ͑ AR ෩ʹ͢Δ৔߹Ͱ͋ͬͯ΋ɺτϥϯεϙʔτ͸෼཭͢΂͖ ϦτϥΠॲཧͳͲ͸෼཭͍ͨ͠͠ɺgRPC ҠߦͳͲ΋ָʹͳΔ ·ͣ͸ૢ࡞తͳΫϥΠΞϯτΛ༻ҙ Level 1
25. ͦΕΛ࢖ͬͯ Recipe.find ͰϦΫΤετ Level 1 ҰԠ has_one తͳϝιου ΫΤϦ༻ͷϝιου ( fi nd, where) recipe# ti tle ͳͲͰϑΟʔϧυΞΫηε
26. Controller Ͱผݸʹॲཧ͢Ε͹ճආՄೳͰ͸͋Δ͕…… includes(:recipes) ͷΑ͏ʹهड़͍ͨ͠ ͕͢͞ʹ·࣮ͩ༻త͡Όͳ͍͔΋ User Recipe 
 Contest Recipe Recipe 
 ContestEntry recipes (API) ΛԿ౓΋ϦΫΤετͯ͠͠·͏😔ɹɹɹɹ
27. • Recipe. fi nd ͷ಺෦ͰΩϡʔΠϯά͢Δ • Recipe. fi nd ͔Β͸ͻͱ·ͣ Promise తͳΦϒδΣΫτ͕ฦΔ • exAspArk/batch-loader Λར༻ • Recipe. fi nd ͷฦΓ஋ʹରͯ͠ # ti tle ͳͲΛݺͿͱɺอཹ͞Ε͍ͯͨϦΫΤετ͕·ͱΊͯඈͿ BatchLoader Ͱ eager loading ͢Δ Level 2
28. has_one :recipe Ͱهड़͍ͨ͠…… has_many :recipes Ͱهड़͍ͨ͠……
29. API ΋ຊ෺ͷ ActiveRecord ʹͪ͠Ό͏ Level 3 • ຊ෺ͷ Ac ti veRecord Ϋϥεʹͯ͠͠·͏ 
 ͜ͱͰ has_many, belongs_to ͳͲ͕࢖͑Δ • ͜ͷٕΛ࢖͑Δ͔͸ෆม৚݅࣍ୈ • ͜͜Ͱ͸ "recipe.user_id ͕ෆมͰ͋Δ" • (͔ͭ recipe.user_id ͕ FK Ͱ͋Δ͜ͱ) • ෆม৚݅ͷ෦෼͚ͩςʔϒϧʹೖΕΔ
30. • ݸਓతʹ͸ AR ෩Ͱ͸ͳ͘ɺ΋ͬͱૢ࡞తͳܗ͕ྑ͍ͱࢥ͏ • APIClient.update(id: 1, {name: "nanika"}) • τϥϯβΫγϣϯ͕ඞཁͳΒ1ͭͷDB΁ͷ౷߹Λߟ͑Δ΂͖ • ΫϥΠΞϯτͷߏ଄ʹؔ܎ͳ͘ɺ෼͞ΜτϥϯβΫγϣϯ͸ࠔ೉ ͱ͜ΖͰߋ৽ɾ࡟আ͸ʁ Others
31. མͪึͻΖ͍ɾࡉ͔͍࿩ Others • AR ෩ͷΦϒδΣΫτΛ༻ҙ͢ΔʹͤΑɺescape hatch ͸༻ҙͨ͠΄͏͕͍͍ • Ac ti veModel::Model ʹ͍ͭͯ • ͓޷ΈͰ include ͢ΔͱΑ͍Ͱ͠ΐ͏ • valida ti on ΍ callbacks, rou ti ng ͳͲʹؔ࿈͢Δαϙʔτ͕͍͖ͭͯ·͢ • cookpad/expeditor ͰߋͳΔߴ଎ԽΛૂ͏
32. ·ͱΊ ಉҰυϝΠϯͷen ti tyΛಉҰͷૢ࡞ମܥͰѻ͑Δͱؾ͍͍࣋ͪ
33. We are hiring! cookpad.jobs