Go
HTTP-klient
Sök…
Syntax
- resp, err: = http.Get (url) // Skickar en HTTP GET-begäran med standard HTTP-klienten. Ett fel som inte är noll returneras om begäran misslyckas.
- resp, err: = http.Post (url, bodyType, body) // Skickar en HTTP POST-begäran med standard HTTP-klienten. Ett fel som inte är noll returneras om begäran misslyckas.
- resp, err: = http.PostForm (url, värden) // Skapa en HTTP-form POST-begäran med standard HTTP-klienten. Ett fel som inte är noll returneras om begäran misslyckas.
parametrar
Parameter | detaljer |
---|---|
resp | Ett svar av typen *http.Response på en HTTP-begäran |
fela | Ett error . Om inte noll representerar det ett fel som inträffade när funktionen kallades. |
url | En URL av string att göra en HTTP-begäran till. |
kroppstyp | MIME- string för kroppens nyttolast för en POST-begäran. |
kropp | En io.Reader (implementerar Read() ) som kommer att läsas från tills ett fel har uppnåtts för att skickas in som kroppslastbelastning för en POST-begäran. |
värden | En nyckelvärdskarta av typen url.Values . Den underliggande typen är en map[string][]string . |
Anmärkningar
Det är viktigt att defer resp.Body.Close()
efter varje HTTP-begäran som inte returnerar ett icke-noll-fel, annars kommer resurser läckas ut.
Grundläggande GET
Utför en grundläggande GET-begäran och skriver ut innehållet på en webbplats (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))
}
FÅ med URL-parametrar och ett JSON-svar
En begäran om de 10 senaste senast aktiva StackOverflow-inläggen med hjälp av Stack Exchange API.
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)
}
}
Time-out-begäran med ett sammanhang
1.7+
Tidtagning av en HTTP-begäran med en kontext kan utföras med endast standardbiblioteket (inte subrepos) i 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()
Före 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()
Vidare läsning
För mer information om context
Paket Se Context .
PUT-begäran från JSON-objekt
Följande uppdaterar ett User-objekt via en PUT-begäran och skriver ut statuskoden för begäran:
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
Licensierat under CC BY-SA 3.0
Inte anslutet till Stack Overflow