Slide 1

Slide 1 text

Web API IBUFOBJOUFSO

Slide 2

Slide 2 text

ֿך闌纏דכ ˖ )551 ˖ 3&45 ˖ (SBQI2- ˖ H31$

Slide 3

Slide 3 text

"1* "QQMJDBUJPO1SPHSBNNJOH*OUFSGBDF ˖ HMJCD ˖ document.getElementById ˖ GET https:!"api.twitter.com/1.1/statuses/ show.json?id=210462857140252672

Slide 4

Slide 4 text

)551 )ZQFSUFYU5SBOTGFS1SPUPDPM

Slide 5

Slide 5 text

)551ךة؎يٓ؎ٝ  )551  )551  )551  (PPHMFָ41%:׾ 涪邌  (PPHMFָ26*$׾ 涪邌  41%:׾⯋ח׃׋ )551ך垥彊⻉  )551PWFS26*$ ׾)551ח何せ

Slide 6

Slide 6 text

)551 ˖ 3'$)ZQFSUFYU5SBOTGFS1SPUPDPM)551 ˖ 3'$)ZQFSUFYU5SBOTGFS1SPUPDPM)551 ˖ 3'$)ZQFSUFYU5SBOTGFS1SPUPDPM )551 .FTTBHF4ZOUBYBOE3PVUJOH ˖ 3'$)ZQFSUFYU5SBOTGFS1SPUPDPM )551 4FNBOUJDTBOE$POUFOU ˖ 3'$)ZQFSUFYU5SBOTGFS1SPUPDPM )551 $POEJUJPOBM3FRVFTUT ˖ 3'$)ZQFSUFYU5SBOTGFS1SPUPDPM )551 3BOHF3FRVFTUT ˖ 3'$)ZQFSUFYU5SBOTGFS1SPUPDPM )551 $BDIJOH ˖ 3'$)ZQFSUFYU5SBOTGFS1SPUPDPM )551 "VUIFOUJDBUJPO

Slide 7

Slide 7 text

)551ךإوٝذ؍ؙأ ˖ ًاحسהة٦؜حزؙٔؒأز ˖ أذ٦ةأٖأهٝأ ˖ قحت٦ ˖ نر؍

Slide 8

Slide 8 text

63- 6OJGPSN3FTPVSDF-PDBUPS https:!"localhost:8000/search?q=text#hello εΩʔϜ:!"ϗετ:ϙʔτ/ύε?ΫΤϦ#ϑϥάϝϯτ 8)"58(63--JWJOH4UBOEBSE

Slide 9

Slide 9 text

/FUDBUד)551ؙٔؒأز $ nc www.hatena.ne.jp 80 !" EOF GET / HTTP/1.1 Host: www.hatena.ne.jp EOF

Slide 10

Slide 10 text

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/ 301 Moved Permanently!#title>!#head> <body bgcolor="white"> <center><h1>301 Moved Permanently!#h1>!#center> !#body> !#html>

Slide 11

Slide 11 text

5-4ד䱸竲׃ג)551ؙٔؒأز $ openssl s_client -connect www.hatena.ne.jp:443 HEAD / HTTP/1.1 Host: www.hatena.ne.jp

Slide 12

Slide 12 text

)551 ؙٔؒأز METHOD target HTTP/1.1 Header: Value body ٖأهٝأ HTTP/1.1 000 Reason Header: Value body

Slide 13

Slide 13 text

ؙٔؒأز遤 METHOD target HTTP/1.1 GET POST PUT HEAD DELETE OPTIONS TRACE CONNECT PATCH / /search?q=text HTTP/1.0 HTTP/1.1

Slide 14

Slide 14 text

قحت٦ Host: www.hatena.ne.jp

Slide 15

Slide 15 text

أذ٦ةأ遤 HTTP/1.1 000 Reason ˖ 1xx*OGPSNBUJPOBM ˖ 2xx4VDDFTTGVM ˖ 3xx3FEJSFDUJPO ˖ 4xx$MJFOU&SSPS ˖ 5xx4FSWFS&SSPS

Slide 16

Slide 16 text

نر؍ ˖ Content-Type: text/htmlˋ)5.- ˖ Content-Type: application/JSONˋ+40/ ˖ Content-Type: application/x-www-form-urlencoded key=value&another_key=another_value

Slide 17

Slide 17 text

نر؍ך㖇簭 Accept-Encoding: gzip, deflate Content-Encoding: gzip ˖ gzip ˖ compress ˖ deflate ˖ identity ˖ br

Slide 18

Slide 18 text

)551 3'$)ZQFSUFYU5SBOTGFS1SPUPDPM7FSTJPO )551

Slide 19

Slide 19 text

)551 ˖ 㛇劤涸זإوٝذ؍ؙأכ㢌׻׵זְ ˖ غ؎شٔדװ׶ה׶ׅ׷ ˖ מהאך5$1؝طؙءّٝ׾⟎䟝涸ח醱侧ךأزٔ٦يחⴓⶴ ׅ׷ ˖ أزٔ٦يך⚥דؿٖ٦ي׾װ׶《׶ׅ׷ ˖ أزٔ٦يך⮚⯓䏝װ⣛㶷ꟼ⤘׮邌植דֹ׷

Slide 20

Slide 20 text

ؿٖ٦ي +-----------------------------------------------+ | Length (24) | +---------------+---------------+---------------+ | Type (8) | Flags (8) | +-+-------------+---------------+-------------------------------+ |R| Stream Identifier (31) | +=+=============================================================+ | Frame Payload (0!!") !!" +---------------------------------------------------------------+ )ZQFSUFYU5SBOTGFS1SPUPDPM7FSTJPO )551 'SBNF'PSNBU

Slide 21

Slide 21 text

%"5"ؿٖ٦ي0x0 +---------------+ |Pad Length? (8)| +---------------+-----------------------------------------------+ | Data (*) !!" +---------------------------------------------------------------+ | Padding (*) !!" +---------------------------------------------------------------+ END_STREAM 0x1 ]PADDED 0x8

Slide 22

Slide 22 text

)&"%&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

Slide 23

Slide 23 text

毟⡂قحت٦ ؙٔؒأز ˖ :method ˖ :authority ˖ :scheme ˖ :path ٖأهٝأ ˖ :status

Slide 24

Slide 24 text

)1"$, 3'$)1"$,)FBEFS$PNQSFTTJPOGPS)551 ˖ عؿوٝ痗〾 ˖ ꫼涸ذ٦ـٕ ˖ ⹛涸ذ٦ـٕ

Slide 25

Slide 25 text

*OEFY )FBEFS/BNF )FBEFS7BMVF  :authority  :method GET  :method POST  :path /  :path /index.html  :scheme http  :scheme https  :status 200

Slide 26

Slide 26 text

)551 ˖ )551ךإوٝذ؍ؙأ׾笝䭯 ˖ מהאך5$1؝طؙءّٝ׾醱侧ךأزٔ٦يחⴓⶴ ˖ 醱侧ךٔا٦أ׾♧䏝חװ׶《׶דֹ׷ ˖ 醱꧟זⵖ䖴ָדֹ׷ ˖ قحت٦׮㖇簭

Slide 27

Slide 27 text

)551 ˖ 26*$زٓٝأه٦ز ˖ 6%1♳ח5$1ה5-4ך堣腉׾ⱄ植 ˖ )551PWFS26*$ ˖ )551׾26*$زٓٝأه٦ز♳ד㹋鄲 ˖ ♶銲חז׏׋堣腉׾⵴ꤐ ˖ 21"$,

Slide 28

Slide 28 text

"1* "QQMJDBUJPO1SPHSBNNJOH*OUFSGBDF

Slide 29

Slide 29 text

-46%T -BSHF4FUPG6OLOPXO%FWFMPQFST ˖ 剑㣐Ⱅ秈侧涸ז"1*׾䲿⣘ׅ׷ 44,%T 4NBMM4FUPG,OPXO%FWFMPQFST ˖ ؙٓ؎،ٝزח剑黝⻉׃׋"1*׾䲿⣘ׅ׷

Slide 30

Slide 30 text

3&45 3FQSFTFOUBUJPOBM4UBUF5SBOTGFS ˖ )551ך➬穈׫׾ֲתֻ⢪ֲ ˖ ٔا٦أ䭷ぢ https:!"api.github.com/repos/hatena/example/ issues/1

Slide 31

Slide 31 text

$36% )551ًاحس $SFBUF POST 3FBE GET 6QEBUF PUTPATCH %FMFUF DELETE

Slide 32

Slide 32 text

(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

Slide 33

Slide 33 text

0QFO"1* ˖ 4XBHHFS ˖ 3&45"1*׾鎸鶢ׅ׷׋׭ך➬圫 ˖ ؝٦س欰䧭ח׮⢪ִ׷

Slide 34

Slide 34 text

(SBQI2- ˖ 'BDFCPPLח״׏גꟚ涪ׁ׸׋ ˖ ؙٓ؎،ٝز⩎ַ׵䗳銲זؿ؍٦ٕس׾䭷㹀ׅ׷ ˖ أؗ٦وַ׵ך؝٦س欰䧭ָדֹ׷

Slide 35

Slide 35 text

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 }

Slide 36

Slide 36 text

ؙؒٔ query GetFirstIssue { repository(name: "Hatena-Intern-2020", owner: "hatena") { issue(number: 1) { author { login } body title } } }

Slide 37

Slide 37 text

H31$

Slide 38

Slide 38 text

H31$PWFS)551 ˖ )551♳ח圓眠ׁ׸׋׮ך ˖ HEADERSؿٖ٦يװDATAؿٖ٦ي H31$8FC ˖ 8FCـٓؐؠぢֽח)551הⴖ׶ꨄ׃׋׮ך ˖ ؟٦غ٦⩎ח׮فٗؗءָ䗳銲

Slide 39

Slide 39 text

1SPUPDPM#VFST ˖ 圓鸡⻉ׁ׸׋ر٦ة׾ءٔ،ٓ؎ؤׅ׷➬穈׫ ˖ غ؎شٔؿؓ٦وحز ˖ *%- *OUFSGBDF%FTDSJQUJPO-BOHVBHF ˖ .protoؿ؋؎ٕ ˖ 31$׾؟ه٦ز׃גְ׷

Slide 40

Slide 40 text

syntax = "proto3"; package account; service Account { rpc Signup(SignupRequest) returns (SignupReply); } message SignupRequest { string name = 1; string password = 2; } message SignupReply { string token = 1; }

Slide 41

Slide 41 text

ًحإ٦آ㘗 message SignupRequest { string name = 1; string password = 2; } ϑΟʔϧυܕ ϑΟʔϧυ໊ = ϑΟʔϧυ൪߸; ˖ ؿ؍٦ٕس殢〾ָꅾ銲 ˖ תדכCZUF ˖ כ✮秈幥׫

Slide 42

Slide 42 text

أؕٓ٦㘗 double float int32 int64 uint32 uint64 sint32 sint64 fixed32 fixed64 sfixed32 sfixed64 bool string bytes

Slide 43

Slide 43 text

repeated Result results = 1; map projects = 3; oneof test_oneof { string name = 4; SubMessage sub_message = 9; }

Slide 44

Slide 44 text

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; }

Slide 45

Slide 45 text

import "google/protobuf/any.proto"; message Message { google.protobuf.Any field = 1; } ˖ google.protobuf.Empty ˖ google.protobuf.Duration ˖ google.protobuf.Timestamp

Slide 46

Slide 46 text

✼䳔䚍 ˖ ؿ؍٦ٕس殢〾 int32 old_field = 6 [deprecated = true]; reserved 2, 15, 9 to 11; reserved "foo", "bar";

Slide 47

Slide 47 text

ؔفءّٝ 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]; }

Slide 48

Slide 48 text

؟٦ؽأהأزٔ٦ي 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) {} }

Slide 49

Slide 49 text

H31$חֶֽ׷"1*鏣鎘 $36% -JTU ˖ CreateEntity ˖ GetEntity ˖ UpdateEntity ˖ DeleteEntity ˖ ListEntities

Slide 50

Slide 50 text

$MPVE'VODUJPOTך⢽ ˖ CallFunction ˖ CreateFunction ˖ GetFunction ˖ UpdateFunction ˖ DeleteFunction ˖ ListFunctions

Slide 51

Slide 51 text

H31$؟٦غ٦׾⡲׷

Slide 52

Slide 52 text

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; }

Slide 53

Slide 53 text

1SPUPDPM$PNQJMFS protoc $ go get github.com/golang/protobuf/protoc-gen-go $ protoc welcome.proto !"go_out=plugins=grpc:.

Slide 54

Slide 54 text

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") )

Slide 55

Slide 55 text

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{} }

Slide 56

Slide 56 text

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() }

Slide 57

Slide 57 text

-FUˏTUSZgrpc_cli

Slide 58

Slide 58 text

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

Slide 59

Slide 59 text

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"'