From 64de27023dc7c72b917a7cd897c368b65ec6625b Mon Sep 17 00:00:00 2001 From: Kazuhiro MUSASHI Date: Sat, 7 Mar 2020 23:49:25 +0800 Subject: [PATCH 1/2] =?UTF-8?q?=E8=A8=98=E4=BA=8B=E3=82=92=E8=BF=BD?= =?UTF-8?q?=E5=8A=A0?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../golang/2020-03-07-how-to-use-net-http.md | 143 ++++++++++++++++++ 1 file changed, 143 insertions(+) create mode 100644 content/labs/golang/2020-03-07-how-to-use-net-http.md diff --git a/content/labs/golang/2020-03-07-how-to-use-net-http.md b/content/labs/golang/2020-03-07-how-to-use-net-http.md new file mode 100644 index 0000000..b92075b --- /dev/null +++ b/content/labs/golang/2020-03-07-how-to-use-net-http.md @@ -0,0 +1,143 @@ ++++ +title = "Golangのnet/httpでREST APIをたたくときのメモ" +date = 2020-03-07T21:12:22+08:00 +Description = "Golangの標準ライブラリnet/httpでREST APIをたたくときのメモです。" +Tags = [] +Categories = ["golang", "programming"] ++++ + +Golang標準ライブラリの`net/http`でREST APIをたたく時に必要となりそうなことをまとめます。 + +## 基本のお作法 +基本はこんな感じになります: + +```go +package main + +import ( + "fmt" + "io/ioutil" + "net/http" + "os" + "time" +) + +func main() { + os.Exit(run(os.Args)) +} + +func run(args []string) int { + // httpのクライアントを作成する + client := &http.Client{} + // タイムアウトの設定をしたほうがいいみたい + client.Timeout = time.Second * 15 + + // リクエストを作成 + req, err := http.NewRequest("POST", "ここにエンドポイントのURL",nil) + if err != nil { + return 1 + } + + // リクエストを実行 + resp, err := client.Do(req) + if err != nil { + return 2 + } + defer resp.Body.Close() + + // レスポンスの読み込み + body, err := ioutil.ReadAll(resp.Body) + if err != nil { + return 3 + } + + // レスポンスの表示 + fmt.Printf("%s", body) + + return 0 +} +``` + +## その他トピック + +### ヘッダーを追加したい +以下のように、生成した`HTTP Requst`オブジェクトにヘッダーを追加します: + +```go + header := http.Header{} + header.Set("Content-Length", "10000") + header.Add("Content-Type", "application/json") + header.Add("Authorization", "Basic anAxYWRtaW46anAxYWRtaW4=") + + req.Header = header +``` + +### HTTPリクエストボディーを指定したい +`http.NewRequest`で`HTTP Request`オブジェクト作成時の3番目の引数に指定します: + +```go + req, err := http.NewRequest("POST", "ここにエンドポイントのURL", byte.NewBuffer(“foo”)) +``` + +どうやら`byte`オブジェクトである必要があるみたい。 + +### HTTPリクエストボディーにJSONを指定したい +`encoding/json`の`json.Marshal`関数で`JSON`オブジェクトを作成し、`byte`オブジェクトに変換します。以下抜粋です: + +```go +type RequestBody struct { + EventId string `json:"eventId"` + Message string `json:"message"` + Attrs Attr `json:"attrs"` +} + +// ... snip ... + + attrs := Attr{ + Severity: "Notice", + JP1_SourceHost: "Localhost", + } + + reqBody := RequestBody{ + EventId: "1FFF", + Message: "test", + } + + jsonValue, _ := json.Marshal(reqBody) + + req, err := http.NewRequest("POST", "ここにエンドポイントのURL", bytes.NewBuffer(jsonValue)) +``` + +### HTTPレスポンスで受け取ったJSONを扱いたい +受け取るレスポンスに対応する構造体を定義して、`json.Unmarsha()`を利用します。[JSON-to-Go: Convert JSON to Go instantly](https://mholt.github.io/json-to-go/)を使うと幸せになれるよ。 + +```go +type Response struct { + Timestamp int64 `json:"timestamp"` + Status int `json:"status"` + Error string `json:"error"` + Exception string `json:"exception"` + Message string `json:"message"` + Path string `json:"path"` + MessageID string `json:"messageId"` + ReturnCode int `json:"returnCode"` +} + +// ... snip ... + + body, err := ioutil.ReadAll(resp.Body) + if err != nil { + return 3 + } + + bytes := []byte(body) + var response Response + json.Unmarshal(bytes, &response) + + fmt.Printf("%d: %s", resp.StatusCode, response.Message) +``` + +## 参考 +- [Go の net/httpでリクエストを投げるまでの足跡 - Qiita](https://qiita.com/takayukioda/items/68c51c5a0e9757a882ee) +- [JSON-to-Go: Convert JSON to Go instantly](https://mholt.github.io/json-to-go/) + From 7da7d7ac645c942df474354e6eeb473a6bef1b63 Mon Sep 17 00:00:00 2001 From: Kazuhiro MUSASHI Date: Sat, 7 Mar 2020 23:56:57 +0800 Subject: [PATCH 2/2] =?UTF-8?q?=E3=83=8F=E3=82=A4=E3=83=A9=E3=82=A4?= =?UTF-8?q?=E3=83=88=E3=81=AE=E6=8C=87=E5=AE=9A=E3=81=AE=E4=BB=95=E6=96=B9?= =?UTF-8?q?=E3=82=92=E5=A4=89=E6=9B=B4?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- content/labs/golang/2020-02-09-how-to-use-nexmo-api.md | 2 +- content/labs/golang/2020-03-07-how-to-use-net-http.md | 10 +++++----- 2 files changed, 6 insertions(+), 6 deletions(-) diff --git a/content/labs/golang/2020-02-09-how-to-use-nexmo-api.md b/content/labs/golang/2020-02-09-how-to-use-nexmo-api.md index 9fb5e7c..9c87bea 100644 --- a/content/labs/golang/2020-02-09-how-to-use-nexmo-api.md +++ b/content/labs/golang/2020-02-09-how-to-use-nexmo-api.md @@ -84,4 +84,4 @@ curl -X "POST" "https://rest.nexmo.com/sms/json" \ ``` ## 参考 -- [GolangでAPI使ってSMS送信 - Qiita](https://qiita.com/KokiAsano/items/fffa3c64a1599ffc53ed) \ No newline at end of file +- [GolangでAPI使ってSMS送信 - Qiita](https://qiita.com/KokiAsano/items/fffa3c64a1599ffc53ed) diff --git a/content/labs/golang/2020-03-07-how-to-use-net-http.md b/content/labs/golang/2020-03-07-how-to-use-net-http.md index b92075b..3fb00e5 100644 --- a/content/labs/golang/2020-03-07-how-to-use-net-http.md +++ b/content/labs/golang/2020-03-07-how-to-use-net-http.md @@ -11,7 +11,7 @@ Golang標準ライブラリの`net/http`でREST APIをたたく時に必要と ## 基本のお作法 基本はこんな感じになります: -```go +``` package main import ( @@ -63,7 +63,7 @@ func run(args []string) int { ### ヘッダーを追加したい 以下のように、生成した`HTTP Requst`オブジェクトにヘッダーを追加します: -```go +``` header := http.Header{} header.Set("Content-Length", "10000") header.Add("Content-Type", "application/json") @@ -75,7 +75,7 @@ func run(args []string) int { ### HTTPリクエストボディーを指定したい `http.NewRequest`で`HTTP Request`オブジェクト作成時の3番目の引数に指定します: -```go +``` req, err := http.NewRequest("POST", "ここにエンドポイントのURL", byte.NewBuffer(“foo”)) ``` @@ -84,7 +84,7 @@ func run(args []string) int { ### HTTPリクエストボディーにJSONを指定したい `encoding/json`の`json.Marshal`関数で`JSON`オブジェクトを作成し、`byte`オブジェクトに変換します。以下抜粋です: -```go +``` type RequestBody struct { EventId string `json:"eventId"` Message string `json:"message"` @@ -111,7 +111,7 @@ type RequestBody struct { ### HTTPレスポンスで受け取ったJSONを扱いたい 受け取るレスポンスに対応する構造体を定義して、`json.Unmarsha()`を利用します。[JSON-to-Go: Convert JSON to Go instantly](https://mholt.github.io/json-to-go/)を使うと幸せになれるよ。 -```go +``` type Response struct { Timestamp int64 `json:"timestamp"` Status int `json:"status"`