Go
HTTPクライアント
サーチ…
構文
- resp、err:= http.Get(url)//デフォルトのHTTPクライアントでHTTP GETリクエストを作成します。要求が失敗した場合は、nil以外のエラーが返されます。
- resp、err:= http.Post(url、bodyType、body)//デフォルトのHTTPクライアントでHTTP POSTリクエストを作成します。要求が失敗した場合は、nil以外のエラーが返されます。
- resp、err:= http.PostForm(url、values)//デフォルトのHTTPクライアントでHTTPフォームのPOSTリクエストを作成します。要求が失敗した場合は、nil以外のエラーが返されます。
パラメーター
パラメータ | 詳細 |
---|---|
resp | HTTPリクエストに対する*http.Response 応答 |
間違い | error 。 nilでなければ、関数が呼び出されたときに発生したエラーを表します。 |
URL | HTTPリクエストを行うための型string URL。 |
ボディタイプ | POSTリクエストの本文ペイロードのstring 型のMIMEタイプ。 |
体 | POST要求の本体ペイロードとしてエラーに達するまで読み込まれるio.Reader ( Read() 実装します)。 |
値 | url.Values 型のキー値マップ。基になる型はmap[string][]string です。 |
備考
non-nilエラーを返さないすべてのHTTPリクエストの後にdefer resp.Body.Close()
をdefer resp.Body.Close()
ことが重要です。そうでなければ、リソースはリークされます。
基本的なGET
基本的なGET要求を実行し、サイトの内容を印刷します(HTML)。
package main
import (
"fmt"
"io/ioutil"
"net/http"
)
func main() {
resp, err := http.Get("https://example.com/")
if err != nil {
panic(err)
}
// It is important to defer resp.Body.Close(), else resource leaks will occur.
defer resp.Body.Close()
data, err := ioutil.ReadAll(resp.Body)
if err != nil {
panic(err)
}
// Will print site contents (HTML) to output
fmt.Println(string(data))
}
URLパラメータとJSONレスポンスでGET
Stack Exchange APIを使用して、最近アクティブな上位10個のStackOverflow投稿のリクエスト。
package main
import (
"encoding/json"
"fmt"
"net/http"
"net/url"
)
const apiURL = "https://api.stackexchange.com/2.2/posts?"
// Structs for JSON decoding
type postItem struct {
Score int `json:"score"`
Link string `json:"link"`
}
type postsType struct {
Items []postItem `json:"items"`
}
func main() {
// Set URL parameters on declaration
values := url.Values{
"order": []string{"desc"},
"sort": []string{"activity"},
"site": []string{"stackoverflow"},
}
// URL parameters can also be programmatically set
values.Set("page", "1")
values.Set("pagesize", "10")
resp, err := http.Get(apiURL + values.Encode())
if err != nil {
panic(err)
}
defer resp.Body.Close()
// To compare status codes, you should always use the status constants
// provided by the http package.
if resp.StatusCode != http.StatusOK {
panic("Request was not OK: " + resp.Status)
}
// Example of JSON decoding on a reader.
dec := json.NewDecoder(resp.Body)
var p postsType
err = dec.Decode(&p)
if err != nil {
panic(err)
}
fmt.Println("Top 10 most recently active StackOverflow posts:")
fmt.Println("Score", "Link")
for _, post := range p.Items {
fmt.Println(post.Score, post.Link)
}
}
コンテキストでのタイムアウト要求
1.7+
コンテキストでのHTTP要求のタイムアウトは、1.7+の標準ライブラリ(サブレポジトリではない)だけで達成できます。
import (
"context"
"net/http"
"time"
)
req, err := http.NewRequest("GET", `https://example.net`, nil)
ctx, _ := context.WithTimeout(context.TODO(), 200 * time.Milliseconds)
resp, err := http.DefaultClient.Do(req.WithContext(ctx))
// Be sure to handle errors.
defer resp.Body.Close()
1.7より前
import (
"net/http"
"time"
"golang.org/x/net/context"
"golang.org/x/net/context/ctxhttp"
)
ctx, err := context.WithTimeout(context.TODO(), 200 * time.Milliseconds)
resp, err := ctxhttp.Get(ctx, http.DefaultClient, "https://www.example.net")
// Be sure to handle errors.
defer resp.Body.Close()
参考文献
context
パッケージの詳細については、「 コンテキスト 」を参照してください。
JSONオブジェクトのPUTリクエスト
次のコードは、PUTリクエストを介してUserオブジェクトを更新し、リクエストのステータスコードを出力します。
package main
import (
"bytes"
"encoding/json"
"fmt"
"net/http"
)
type User struct {
Name string
Email string
}
func main() {
user := User{
Name: "John Doe",
Email: "[email protected]",
}
// initialize http client
client := &http.Client{}
// marshal User to json
json, err := json.Marshal(user)
if err != nil {
panic(err)
}
// set the HTTP method, url, and request body
req, err := http.NewRequest(http.MethodPut, "http://api.example.com/v1/user", bytes.NewBuffer(json))
if err != nil {
panic(err)
}
// set the request header Content-Type for json
req.Header.Set("Content-Type", "application/json; charset=utf-8")
resp, err := client.Do(req)
if err != nil {
panic(err)
}
fmt.Println(resp.StatusCode)
}
Modified text is an extract of the original Stack Overflow Documentation
ライセンスを受けた CC BY-SA 3.0
所属していない Stack Overflow