パッケージ google.golang.org/appengine/urlfetch（v1.6.8）

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

変数

ErrTruncatedBody

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 を使用して *http.Client を返します。このクライアントは SSL 証明書の有効性をチェックします。

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

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 に設定されている場合に返されることに注意してください。