はてなリモートインターン2020 Web API 講義資料

https://hatenacorp.jp/intern2020/public_broadcast

Transcript

1. Web API IBUFOBJOUFSO
2. ֿך闌纏דכ ˖ )551 ˖ 3&45 ˖ (SBQI2- ˖ H31$
3. "1* "QQMJDBUJPO
   1SPHSBNNJOH
   *OUFSGBDF ˖ HMJCD ˖ document.getElementById ˖ GET https:!"api.twitter.com/1.1/statuses/ show.json?id=210462857140252672
4. )551 )ZQFSUFYU
   5SBOTGFS
   1SPUPDPM
5. )551ךة؎يٓ؎ٝ  )551  )551  )551  (PPHMFָ41%:׾ 涪邌  (PPHMFָ26*$׾ 涪邌  41%:׾⯋ח׃׋ )551ך垥彊⻉  )551PWFS26*$ ׾)551ח何せ
6. )551 ˖ 3'$
   
   )ZQFSUFYU
   5SBOTGFS
   1SPUPDPM
   
   )551 ˖ 3'$
   
   )ZQFSUFYU
   5SBOTGFS
   1SPUPDPM
   
   )551 ˖ 3'$
   
   )ZQFSUFYU
   5SBOTGFS
   1SPUPDPM
   )551 
   .FTTBHF
   4ZOUBY
   BOE
   3PVUJOH ˖ 3'$
   
   )ZQFSUFYU
   5SBOTGFS
   1SPUPDPM
   )551 
   4FNBOUJDT
   BOE
   $POUFOU ˖ 3'$
   
   )ZQFSUFYU
   5SBOTGFS
   1SPUPDPM
   )551 
   $POEJUJPOBM
   3FRVFTUT ˖ 3'$
   
   )ZQFSUFYU
   5SBOTGFS
   1SPUPDPM
   )551 
   3BOHF
   3FRVFTUT ˖ 3'$
   
   )ZQFSUFYU
   5SBOTGFS
   1SPUPDPM
   )551 
   $BDIJOH ˖ 3'$
   
   )ZQFSUFYU
   5SBOTGFS
   1SPUPDPM
   )551 
   "VUIFOUJDBUJPO
7. )551ךإوٝذ؍ؙأ ˖ ًاحسהة٦؜حزؙٔؒأز ˖ أذ٦ةأٖأهٝأ ˖ قحت٦ ˖ نر؍
8. 63- 6OJGPSN
   3FTPVSDF
   -PDBUPS https:!"localhost:8000/search?q=text#hello εΩʔϜ:!"ϗετ:ϙʔτ/ύε?ΫΤϦ#ϑϥάϝϯτ 
   8)"58(
   63-
   -JWJOH
   4UBOEBSE
9. /FUDBUד)551ؙٔؒأز $ nc www.hatena.ne.jp 80 !" EOF GET / HTTP/1.1 Host: www.hatena.ne.jp EOF
10. HTTP/1.1 301 Moved Permanently Server: awselb/2.0 Date: Mon, 03 Aug 2020 01:58:38 GMT Content-Type: text/html Content-Length: 150 Connection: keep-alive Location: https:!"www.hatena.ne.jp:443/ <html> <head><title>301 Moved Permanently!#title>!#head> <body bgcolor="white"> <center><h1>301 Moved Permanently!#h1>!#center> !#body> !#html>
11. 5-4ד䱸竲׃ג)551ؙٔؒأز $ openssl s_client -connect www.hatena.ne.jp:443 HEAD / HTTP/1.1 Host: www.hatena.ne.jp
12. )551 ؙٔؒأز METHOD target HTTP/1.1 Header: Value body ٖأهٝأ HTTP/1.1 000 Reason Header: Value body
13. ؙٔؒأز遤 METHOD target HTTP/1.1 GET POST PUT HEAD DELETE OPTIONS TRACE CONNECT PATCH / /search?q=text HTTP/1.0 HTTP/1.1
14. قحت٦ Host: www.hatena.ne.jp
15. أذ٦ةأ遤 HTTP/1.1 000 Reason ˖ 1xx
    *OGPSNBUJPOBM ˖ 2xx
    4VDDFTTGVM ˖ 3xx
    3FEJSFDUJPO ˖ 4xx
    $MJFOU
    &SSPS ˖ 5xx
    4FSWFS
    &SSPS
16. نر؍ ˖ Content-Type: text/html
    ˋ
    )5.- ˖ Content-Type: application/JSON
    ˋ
    +40/ ˖ Content-Type: application/x-www-form-urlencoded key=value&another_key=another_value
17. نر؍ך㖇簭 Accept-Encoding: gzip, deflate Content-Encoding: gzip ˖ gzip ˖ compress ˖ deflate ˖ identity ˖ br
18. )551 3'$
    
    )ZQFSUFYU
    5SBOTGFS
    1SPUPDPM
    7FSTJPO
    
    )551
19. )551 ˖ 㛇劤涸זإوٝذ؍ؙأכ㢌׻׵זְ ˖ غ؎شٔדװ׶ה׶ׅ׷ ˖ מהאך5$1؝طؙءّٝ׾⟎䟝涸ח醱侧ךأزٔ٦يחⴓⶴ ׅ׷ ˖ أزٔ٦يך⚥דؿٖ٦ي׾װ׶《׶ׅ׷ ˖ أزٔ٦يך⮚⯓䏝װ⣛㶷ꟼ⤘׮邌植דֹ׷
20. ؿٖ٦ي +-----------------------------------------------+ | Length (24) | +---------------+---------------+---------------+ | Type (8) | Flags (8) | +-+-------------+---------------+-------------------------------+ |R| Stream Identifier (31) | +=+=============================================================+ | Frame Payload (0!!") !!" +---------------------------------------------------------------+ 
    )ZQFSUFYU
    5SBOTGFS
    1SPUPDPM
    7FSTJPO
    
    )551
    
    'SBNF
    'PSNBU
21. %"5"ؿٖ٦ي0x0 +---------------+ |Pad Length? (8)| +---------------+-----------------------------------------------+ | Data (*) !!" +---------------------------------------------------------------+ | Padding (*) !!" +---------------------------------------------------------------+ END_STREAM
    0x1
    ]
    PADDED
    0x8
22. )&"%&34ؿٖ٦ي0x1 +---------------+ |Pad Length? (8)| +-+-------------+-----------------------------------------------+ |E| Stream Dependency? (31) | +-+-------------+-----------------------------------------------+ | Weight? (8) | +-+-------------+-----------------------------------------------+ | Header Block Fragment (*) !!" +---------------------------------------------------------------+ | Padding (*) !!" +---------------------------------------------------------------+ END_STREAM
    0x1
    ]
    END_HEADERS
    0x4
    ]
    PADDED
    0x8
    ]
    PRIORITY
    0x20
23. 毟⡂قحت٦ ؙٔؒأز ˖ :method ˖ :authority ˖ :scheme ˖ :path ٖأهٝأ ˖ :status
24. )1"$, 3'$
    
    )1"$,
    )FBEFS
    $PNQSFTTJPO
    GPS
    )551 ˖ عؿوٝ痗〾 ˖ ꫼涸ذ٦ـٕ ˖ ⹛涸ذ٦ـٕ
25. *OEFY )FBEFS
    /BNF )FBEFS
    7BMVF  :authority  :method GET  :method POST  :path /  :path /index.html  :scheme http  :scheme https  :status 200
26. )551 ˖ )551ךإوٝذ؍ؙأ׾笝䭯 ˖ מהאך5$1؝طؙءّٝ׾醱侧ךأزٔ٦يחⴓⶴ ˖ 醱侧ךٔا٦أ׾♧䏝חװ׶《׶דֹ׷ ˖ 醱꧟זⵖ䖴ָדֹ׷ ˖ قحت٦׮㖇簭
27. )551 ˖ 26*$زٓٝأه٦ز ˖ 6%1♳ח5$1ה5-4ך堣腉׾ⱄ植 ˖ )551PWFS26*$ ˖ )551׾26*$زٓٝأه٦ز♳ד㹋鄲 ˖ ♶銲חז׏׋堣腉׾⵴ꤐ ˖ 21"$,
28. "1* "QQMJDBUJPO
    1SPHSBNNJOH
    *OUFSGBDF
29. -46%T
    -BSHF
    4FU
    PG
    6OLOPXO
    %FWFMPQFST ˖ 剑㣐Ⱅ秈侧涸ז"1*׾䲿⣘ׅ׷ 44,%T
    4NBMM
    4FU
    PG
    ,OPXO
    %FWFMPQFST ˖ ؙٓ؎،ٝزח剑黝⻉׃׋"1*׾䲿⣘ׅ׷
30. 3&45 3FQSFTFOUBUJPOBM
    4UBUF
    5SBOTGFS ˖ )551ך➬穈׫׾ֲתֻ⢪ֲ ˖ ٔا٦أ䭷ぢ https:!"api.github.com/repos/hatena/example/ issues/1
31. $36% )551ًاحس $SFBUF POST 3FBE GET 6QEBUF PUT
    
    PATCH %FMFUF DELETE
32. (JU)VCך؎ءُ٦؝ًٝز ˖ GET /repos/:owner/:repo/issues/ comments/:comment_id ˖ POST /repos/:owner/:repo/issues/:issue_number/ comments ˖ PATCH /repos/:owner/:repo/issues/ comments/:comment_id ˖ DELETE /repos/:owner/:repo/issues/ comments/:comment_id
33. 0QFO"1* ˖ 4XBHHFS ˖ 3&45
    "1*׾鎸鶢ׅ׷׋׭ך➬圫 ˖ ؝٦س欰䧭ח׮⢪ִ׷
34. (SBQI2- ˖ 'BDFCPPLח״׏גꟚ涪ׁ׸׋ ˖ ؙٓ؎،ٝز⩎ַ׵䗳銲זؿ؍٦ٕس׾䭷㹀ׅ׷ ˖ أؗ٦وַ׵ך؝٦س欰䧭ָדֹ׷
35. 4%-
    4DIFNB
    %FOJUJPO
    -BOHVBHF interface Actor { login: String! } type Issue { author: Actor body: String! title: String! } type Repository { issue(number: Int!): Issue } type Query { repository(name: String!, owner: String!): Repository }
36. ؙؒٔ query GetFirstIssue { repository(name: "Hatena-Intern-2020", owner: "hatena") { issue(number: 1) { author { login } body title } } }
37. H31$
38. H31$
    PWFS
    )551 ˖ )551♳ח圓眠ׁ׸׋׮ך ˖ HEADERSؿٖ٦يװDATAؿٖ٦ي H31$
    8FC ˖ 8FCـٓؐؠぢֽח)551הⴖ׶ꨄ׃׋׮ך ˖ ؟٦غ٦⩎ח׮فٗؗءָ䗳銲
39. 1SPUPDPM
    #VFST ˖ 圓鸡⻉ׁ׸׋ر٦ة׾ءٔ،ٓ؎ؤׅ׷➬穈׫ ˖ غ؎شٔؿؓ٦وحز ˖ *%-
    *OUFSGBDF
    %FTDSJQUJPO
    -BOHVBHF ˖ .protoؿ؋؎ٕ ˖ 31$׾؟ه٦ز׃גְ׷
40. syntax = "proto3"; package account; service Account { rpc Signup(SignupRequest) returns (SignupReply); } message SignupRequest { string name = 1; string password = 2; } message SignupReply { string token = 1; }
41. ًحإ٦آ㘗 message SignupRequest { string name = 1; string password = 2; } ϑΟʔϧυܕ ϑΟʔϧυ໊ = ϑΟʔϧυ൪߸; ˖ ؿ؍٦ٕس殢〾ָꅾ銲 ˖ תדכCZUF ˖ כ✮秈幥׫
42. أؕٓ٦㘗 double float int32 int64 uint32 uint64 sint32 sint64 fixed32 fixed64 sfixed32 sfixed64 bool string bytes
43. repeated Result results = 1; map<string, Project> projects = 3; oneof test_oneof { string name = 4; SubMessage sub_message = 9; }
44. message SearchRequest { string query = 1; int32 page_number = 2; int32 result_per_page = 3; enum Corpus { UNIVERSAL = 0; WEB = 1; IMAGES = 2; LOCAL = 3; NEWS = 4; PRODUCTS = 5; VIDEO = 6; } Corpus corpus = 4; }
45. import "google/protobuf/any.proto"; message Message { google.protobuf.Any field = 1; } ˖ google.protobuf.Empty ˖ google.protobuf.Duration ˖ google.protobuf.Timestamp
46. ✼䳔䚍 ˖ ؿ؍٦ٕس殢〾 int32 old_field = 6 [deprecated = true]; reserved 2, 15, 9 to 11; reserved "foo", "bar";
47. ؔفءّٝ option go_package = "github.com/hatena/example/pb"; enum EnumAllowingAlias { option allow_alias = true; UNKNOWN = 0; STARTED = 1; RUNNING = 1; } message Example { int32 old_field = 6 [deprecated = true]; }
48. ؟٦ؽأהأزٔ٦ي service RouteGuide { rpc GetFeature(Point) returns (Feature) {} rpc ListFeatures(Rectangle) returns (stream Feature) {} rpc RecordRoute(stream Point) returns (RouteSummary) {} rpc RouteChat(stream RouteNote) returns (stream RouteNote) {} }
49. H31$חֶֽ׷"1*鏣鎘 $36%
    
    -JTU ˖ CreateEntity ˖ GetEntity ˖ UpdateEntity ˖ DeleteEntity ˖ ListEntities
50. $MPVE
    'VODUJPOTך⢽ ˖ CallFunction ˖ CreateFunction ˖ GetFunction ˖ UpdateFunction ˖ DeleteFunction ˖ ListFunctions
51. H31$؟٦غ٦׾⡲׷
52. syntax = "proto3"; option go_package = "./pb"; package welcome; service Welcome { rpc Greet(GreetRequest) returns (GreetReply); } message GreetRequest { string name = 1; } message GreetReply { string message = 1; }
53. 1SPUPDPM
    $PNQJMFS protoc $ go get github.com/golang/protobuf/protoc-gen-go $ protoc welcome.proto !"go_out=plugins=grpc:.
54. package main import ( "context" "flag" "fmt" "github.com/hatena/intern-grpc/pb" "google.golang.org/grpc" "google.golang.org/grpc/reflection" "log" "net" "os" "os/signal" ) var ( port = flag.Int("port", 10000, "The server port") )
55. type welcomeServer struct { pb.UnimplementedWelcomeServer } func (s *welcomeServer) Greet( ctx context.Context, req *pb.GreetRequest ) (*pb.GreetReply, error) { return &pb.GreetReply{ Message: fmt.Sprintf("Welcome %s", req.Name), }, nil } func newServer() *welcomeServer { return &welcomeServer{} }
56. func main() { lis, err !" net.Listen("tcp", fmt.Sprintf(":%d", *port)) if err !# nil { log.Fatalf("failed to listen: %v", err) } grpcServer !" grpc.NewServer() pb.RegisterWelcomeServer(grpcServer, newServer()) reflection.Register(grpcServer) go func() { log.Printf("start gRPC server port: %v", *port) grpcServer.Serve(lis) }() quit !" make(chan os.Signal) signal.Notify(quit, os.Interrupt) !$quit log.Printf("stopping gRPC server!!%") grpcServer.GracefulStop() }
57. -FUˏT
    USZ
    grpc_cli
58. grpc_cli $ docker run !"rm !"publish 10000:10000 hatena/intern-2020-grpc-adventure:latest $ docker run !"rm hatena/grpc_cli:latest ls host.docker.internal:10000 -l
59. grpc_cli $ grpc_cli ls localhost:10000 -l $ grpc_cli type localhost:10000 welcome.GreetRequest $ grpc_cli call localhost:10000 welcome.Welcome.Greet 'name: "John Appleseed"'