urlfetch パッケージ

import "google.golang.org/appengine/urlfetch"

はじめに

urlfetch パッケージは http.RoundTripper の実装を提供します。この実装は、App Engine の urlfetch サービスによって URL を取得します。

索引

変数
func Client(ctx context.Context) *http.Client
type Transport
    func (t *Transport) RoundTrip(req *http.Request) (res *http.Response, err error)

変数

var ErrTruncatedBody = errors.New("urlfetch: truncated body")

ErrTruncatedBody は、応答の Body が App Engine のプロキシによって切り捨てられた場合に、Body からの最後の Read() の後に返されるエラーです。

func Client

func Client(ctx context.Context) *http.Client

Client はデフォルトの urlfetch Transport を使用して *httpClient を返します。このクライアントはデフォルトの期限が 5 秒間であり、このクライアントが SSL 証明書の有効性をチェックします。

このクライアントを経由するリクエストには、提供されたコンテキストの期限が使用されます。クライアントに締め切りがない場合は、デフォルトの 5 秒が使用されます。

type Transport

type Transport struct {
    Context context.Context

    // Controls whether the application checks the validity of SSL certificates
    // over HTTPS connections. A value of false (the default) instructs the
    // application to send a request to the server only if the certificate is
    // valid and signed by a trusted certificate authority (CA), and also
    // includes a hostname that matches the certificate. A value of true
    // instructs the application to perform no certificate validation.
    AllowInvalidServerCertificate bool
}

Transport は App Engine の http.RoundTripper の実装です。ユーザーは通常、このトランスポートを使用して http.Client を作成し、このトランスポートを直接使用する代わりにその Client を使用する必要があります。

func (*Transport) RoundTrip

func (t *Transport) RoundTrip(req *http.Request) (res *http.Response, err error)

RoundTrip は単一の HTTP リクエストを発行し、その応答を返します。RoundTrip は http.RoundTripper インターフェースごとに、サポートされないリクエストがあった場合や、URL フェッチ プロキシが失敗した場合にのみエラーを返します。5xx、403、404 などの HTTP レスポンス コードは、トランスポートに関してはエラーではなく、err が nil に設定されている場合に返されることに注意してください。

このページは役立ちましたか?評価をお願いいたします。

フィードバックを送信...

Go の App Engine スタンダード環境