GoでWeb APIを作る - JSON Hyper-Schemaからいろいろ生成する

2015.08.24 リブセンス様社内勉強会LT資料

Transcript

1. GoͰWeb APIΛ࡞Δ JSON Hyper-Schema͔Β͍Ζ͍Ζੜ੒͢Δ @tutuming
2. ࣗݾ঺հ • แ ௚໵ • @tutuming • גࣜձࣾ WACUL CTO We are hiring!
3. ԿΛ࡞͍ͬͯΔ͔ • AIΞφϦετ • Google Analytics ࿈ܞ • ࣗಈղੳ • αΠτͷ՝୊Λݟ͚ͭΔ We are hiring!
4. AIΞφϦετͷߏ੒ • όοΫΤϯυ Go, MongoDB, Elasticsearch • ϑϩϯτΤϯυ TypeScript (CoffeeScript) , AngularJS
5. Go ΍ͬͯΔਓ !?
6. ࠓ೔఻͍͑ͨ͜ͱ REST API ΛGoͰ։ൃ͢Δͱ͖ • APIυΩϡϝϯτ • ܕఆٛ • όϦσʔγϣϯ • ϋϯυϥͷͻͳܗ ͍Ζ͍Ζࣗಈੜ੒͢ΔͱḿΔΑ
7. Why Go? • εέʔϧ͢Δ࢓૊Έ -> gorutine, channel • ੩తܕ෇͚ -> มߋʹର͢Δ҆৺ײ • ίϯύΠϧҰॠ -> εΫϦϓτݴޠΈ͍ͨʹಈ͔ͤΔ • ϘτϜΞοϓͷจԽ
8. REST API with Go ΠϯλʔϑΣΠε(JSONͱͷϚοϐϯά)ఆٛͷͭΒΈ map[string]interface{} // ͓खܰ <-> ܕͷϝϦοτͳ͠ struct ఆٛ // ݎ࿚ <-> खͰॻ͘ͷ͠ΜͲ͍
9. ੜ੒ͨ͠Β͑͑΍Μ • JSON Hyper-Schema • http://json-schema.org/latest/json-schema- hypermedia.html • JSONͷܕఆٛɺόϦσʔγϣϯఆٛ • + Http্ͷϦιʔεఆٛ = REST ͜Ε΍Ͱʂ
10. ͡ΌʔΜ schema.json ॻ͘ͷͭΒͨΜ 1ϑΝΠϧ 4000ߦ
11. prmd by heroku • https://github.com/interagent/prmd • YAMLͰ ෳ਺ϑΝΠϧʹ෼͚ͯ؅ཧͰ͖Δ • -> 1ͭͷschema.json ʹcombine • schema.json ͔Β υΩϡϝϯτ΋ੜ੒Ͱ͖Δ
12. શମߏ੒
13. JSON ܕఆٛ
14. Go struct ੜ੒
15. Validator ੜ੒ https://github.com/wcl48/valval
16. Ϧιʔεఆٛ
17. endpoint ࿮૊Έੜ੒ ্ͷؔ਺Λड͚औͬͯ ύϥϝʔλͷόϦσʔγϣϯ JSONͷੜ੒ͳͲΛߦ͏ॲཧΛroterʹઃఆ // GETύϥϝʔλ // PaymentͷϦετΛฦ͢
18. APIมߋϑϩʔ • YAMLॻ͘ • ఆٛɾυΩϡϝϯτੜ੒ • ίϯύΠϧΤϥʔ௚͢ • ϩδοΫ࣮૷ • ςετॻ͘
19. ར༻ऀͷ੠ • υοτΛଧͬͨΒิ׬͕ग़ΔͷͰɺ伳ḜԌ͕࣏Γ·ͨ͠ (29ࡀ உੑ) • ܕ͕͋ΔͱϦϦʔεޙ҆৺ͯ͠຾Ε·͢ (29ࡀ உੑ) • υΩϡϝϯτͱ࣮૷͕ҧ͏ͬͯԥΒΕͳ͘ͳͬͨ (29ࡀ உੑ) • ੜ੒ࣦഊͨ͠ͱ͖ͷΤϥʔ͕Θ͔Γʹ͍͘ (29ࡀ உੑ)
20. ·ͱΊ • Go ͸ྑ͍ݴޠ ͚ͩͲ • Web API ࡞Δͱ͖ɺJSONͷܕఆٛͭΒ͍ • ಛʹϦϦʔε௚ޙ͸มߋ΋ଟ͍ • JSON Hyper-Schema Λ prmd ͳͲͷิॿπʔϧͰੜ੒ͯ͠ • υΩϡϝϯτɺܕఆٛɺόϦσʔλɺϋϯυϥͷͻͳܗΛੜ੒͢Δ ͱ • ͱͯ΋ޮ཰తɺݎ࿚ͳ։ൃαΠΫϧ͕Ͱ͖͕͋ΔͷͰ͓͢͢Ί
21. Thank you! Any questions?