Share
Embed
実践 net/http Middleware パターン / Kizuku.go Vol.1
Ken’ichiro Oyama
July 26, 2024
Transcript
33 slides
-
ࣗݾհ ϗεςΟϯάࣄۀ෦ 2018 த్ೖࣾ খࢁ ݈Ұ Ken’ichiro Oyama গ࣮͠༻తͰখ͞ͳOSSΛॻ͘ͷ͕झຯɻ •
GitHub : k1LoW • Twitter : @k1LoW 2 -
ΞδΣϯμ • net/http ύοέʔδʹ͓͚Δ Middleware ύλʔϯ • Α͘ΘΕΔ Middleware ύλʔϯΛར༻ͨ͠ػೳ
• զʑ͕࣮ફ͍ͯ͠Δ Middleware ύλʔϯΛར༻ͨ͠ػೳ • ·ͱΊ 4 -
• net/http ύοέʔδ • Package http provides HTTP client and
server implementations. • HTTPΫϥΠΞϯτHTTPαʔόͷ࣮ͷͨΊͷύοέʔδ • net/http ύοέʔδʹ͓͚Δ Middleware ύλʔϯ • HTTPϦΫΤετ/ϨεϙϯεΛऔΓѻ͏HTTPαʔόʹ͓͍ͯػೳΛ࣮͢Δࡍʹ༻Ͱ͖ Δ࣮ύλʔϯ 6 net/http ύοέʔδʹ͓͚Δ Middleware ύλʔϯ net/http ύοέʔδʹ͓͚Δ Middleware ύλʔϯͱԿ͔ -
• ʢதུʣ The process of wrapping the Pylons application in
middleware results in a structure conceptually similar to the layers in an onionʢλϚωΪʣ. • ຊηογϣϯʹ͓͚ΔMiddlewareύλʔϯͱಉ͡ • WSGI Middleware HTTPαʔόͱWebΞϓϦέ ʔγϣϯ/ϑϨʔϜϫʔΫͷதؒͷWSGIϨΠϠͰ࣮ݱ • ͪͳΈʹɺHTTPαʔόͷϨΠϠͰWebΞϓϦέʔγϣϯ/ ϑϨʔϜϫʔΫͷϨΠϠͰMiddlewareύλʔϯ͋Δ ʢ͋ͬͯΑ͍ʣ 9 net/http ύοέʔδʹ͓͚Δ Middleware ύλʔϯ WSGI Middleware https://docs.pylonsproject.org/projects/pylons-webframework/en/latest/concepts.html#wsgi-middleware -
• ΞΫηεϩά • CORS • ೝূೝՄ • ΞΫηε੍ޚ 21 Α͘ΘΕΔ
Middleware ύλʔϯΛར༻ͨ͠ػೳ Α͘ΘΕΔ Middleware ύλʔϯΛར༻ͨ͠ػೳ -
• ྫ͑ʮHTTPϓϩΩγαʔόΛGoͰಠࣗʹॻ͘ʯͱ͍͏બ • HTTPαʔόͷػೳΛGoͰॻ͘͜ͱͰɺΑΓυϝΠϯʹಛԽͨ͠ػೳΛఏڙ͢Δ͜ͱ͕Մೳ • ϓϩΩγαʔόͰ net/http ύοέʔδΛ͏͜ͱʹมΘΓͳ͍ɻͭ·ΓɺMiddleware ύ λʔϯͦͷ··࣮ફͰ͖Δ
24 զʑ͕࣮ફ͍ͯ͠Δ Middleware ύλʔϯΛར༻ͨ͠ػೳ વɺHTTPαʔόͷΈΛGoͰॻ͘͜ͱՄೳ -
• rc is a response cache middleware for cache. •
ϦΫΤετʹԠͯ͡ಈతʹΩϟογϡఆΛม͑Δ͜ͱ͕Ͱ͖ΔMiddleware • ΩϟογϡఆΩϟογϡͷฦ٫ rc.Casher ΠϯλʔϑΣʔεΛຬ࣮ͨ͢Λ࡞Δ͜ ͱͰҙͷఆϩδοΫΛΈࠐΉ͜ͱ͕Մೳ • ΩϟογϡετϨʔδಠࣗʹΈࠐΈՄೳ • σΟεΫΩϟογϡͰ͋Εɹɹhttps://github.com/2manymws/rcutil Λ༻Մೳ • Ωϟογϡૢ࡞ʹ͓͚ΔσϑΥϧτͷಈ࡞RFC9111ʹ४ڌ • ϓϩΩγαʔόʹඞཁͳػೳͷΈΛ࣮͍ͯ͠Δ 26 զʑ͕࣮ફ͍ͯ͠Δ Middleware ύλʔϯΛར༻ͨ͠ػೳ https://github.com/2manymws/rc -
• rl is a rate limit middleware for multiple limit
rules. • ϦΫΤετʹԠͯ͡ಈతʹϨʔτϦϛοτͷϧʔϧΛઃఆͰ͖ΔMiddleware • ϨʔτϦϛοτͷϧʔϧΛ rl.Limitter ΠϯλʔϑΣʔεΛຬͨ͢͜ͱͰΈࠐΉ͜ͱ͕Ͱ͖ Δɻ • ϨʔτϦϛοτͷϩδοΫʹSliding Window CounterύλʔϯΛ࠾༻ • https://blog.cloudflare.com/counting-things-a-lot-of-different-things/ • IPϕʔεϗετϕʔεͳͲ࣮ફతͳϦϛοτϧʔϧ http://github.com/2manymws/rlutils ʹޙ չ͍ͯ͠Δ 28 զʑ͕࣮ફ͍ͯ͠Δ Middleware ύλʔϯΛར༻ͨ͠ػೳ https://github.com/2manymws/rl -
• mm is a middleware-middleware for multiple rules. • ϦΫΤετʹԠͯ͡ಈతʹMiddlewareΛΓସ͑Δ͜ͱ͕Ͱ͖ΔMiddleware
• Middlewareద༻ϧʔϧΛ mm.Builder ΠϯλʔϑΣʔεΛຬͨ͢͜ͱͰΈࠐΉ͜ͱ͕Ͱ͖ Δɻ • ·࣮ͩફೖ͍ͯ͠ͳ͍ • ར༻͍ͨ͠Middleware͕ϦΫΤετʹԠͯ͡Γସ͑Δͱ͍͏ػೳΛ࣋ͨͳ͍߹ͳͲʹ༻ ͢ΔΠϝʔδ 30 զʑ͕࣮ફ͍ͯ͠Δ Middleware ύλʔϯΛར༻ͨ͠ػೳ https://github.com/2manymws/mm -
32 ·ͱΊ શͯhttp.Handler • net/httpύοέʔδͷHTTPαʔόhttp.HandlerΛऔΓѻ͏ • http.ServeMuxhttp.Handler • WebΞϓϦέʔγϣϯʹ͓͚ΔʮϧʔλʯͱݺΕΔͷɺ୯ʹʮϦΫΤετύεΛݩʹಈతʹ http.HandlerΛΓ͔͑Δhttp.Handlerʯͱݴ͑Δ
• Middlewarehttp.Handler • શͯͷϦΫΤετ/Ϩεϙϯεʹରͯ͠λϚωΪͷΑ͏ʹhttp.HanderΛϥοϓ͍ͯ͠Δ • MiddlewareͷڍಈϦΫΤετΛݩʹಈతʹมΘ͍͍ͬͯ • Α͏ʮػೳશମΛͲ͏σβΠϯ͢Δ͔ʯʹམͪண͘ • શͯhttp.Handler