UrlRequest

public abstract class UrlRequest

HTTP リクエスト（GET、PUT、POST など）を制御します。UrlRequest.Builder によって作成されます。UrlRequest.Builder は newUrlRequestBuilder を呼び出して取得できます。注: すべてのメソッドは、newUrlRequestBuilder に渡された Executor で呼び出す必要があります。

概要

ネストされた型
public abstract class UrlRequest.Builder

UrlRequest のビルダー。
public abstract class UrlRequest.Callback

Cronet のユーザーはこのクラスを拡張して、処理中の UrlRequest の進行状況を示すコールバックを受け取ります。

まだ安定版と見なされていない API のアノテーション。
public class UrlRequest.Status

getStatus によって返されるリクエスト ステータス値。
public abstract class UrlRequest.StatusListener

getStatus で使用して UrlRequest のステータスを受信するリスナー クラス。

パブリック コンストラクタ

パブリック メソッド
abstract void

リクエストをキャンセルします。
abstract void

保留中のリダイレクトに従います。
abstract void

リクエストのステータスをクエリします。
abstract boolean

リクエストが正常に開始され、終了（完了、キャンセル、失敗）した場合は true を返します。
abstract void
read(ByteBuffer buffer)

提供されたバッファにレスポンス本文の一部を読み取ろうとします。
abstract void

リクエストを開始します。すべてのコールバックは Callback に送信されます。

パブリック コンストラクタ

UrlRequest

public UrlRequest()

パブリック メソッド

キャンセル

public abstract void cancel()

リクエストをキャンセルします。いつでも呼び出すことができます。キャンセルが完了すると onCanceled() が呼び出され、それ以降のコールバック メソッドは呼び出されません。リクエストが完了しているか、開始していない場合、cancel() を呼び出しても効果はなく、onCanceled() は呼び出されません。 UrlRequest の構築時に渡された Executor が単一のスレッドでタスクを実行し、そのスレッドで cancel() が呼び出された場合、 cancel() が呼び出された後にコールバック メソッド（onCanceled() を除く）は呼び出されません。それ以外の場合、 cancel() の完了後に呼び出すことができるコールバック メソッドは 1 つだけです。

followRedirect

public abstract void followRedirect()

保留中のリダイレクトに従います。 onRedirectReceived() の呼び出しごとに 1 回だけ呼び出す必要があります。

getStatus

public abstract void getStatus(UrlRequest.StatusListener listener)

リクエストのステータスをクエリします。

パラメータ
UrlRequest.StatusListener listener

リクエストの現在のステータスで呼び出される StatusListener。リクエストの作成時に渡された Executor で listener が呼び出されます。

isDone

public abstract boolean isDone()

リクエストが正常に開始され、終了（完了、キャンセル、失敗）した場合は true を返します。

戻り値
boolean

リクエストが正常に開始され、完了（完了、キャンセル、失敗）した場合は true。

read

public abstract void read(ByteBuffer buffer)

提供されたバッファにレスポンス本文の一部を読み取ろうとします。Callback の onResponseStarted() メソッドと onReadCompleted() メソッドの呼び出しごとに、最大 1 回のみ呼び出す必要があります。呼び出しごとに、データの読み取りが行われた場合は Callback'sonReadCompleted() メソッド、読み取るデータがなくなった場合は onSucceeded() メソッド、エラーが発生した場合は onFailed() メソッドのいずれかに対する非同期呼び出しが行われます。

パラメータ
ByteBuffer buffer

ByteBuffer - レスポンスの本文を書き込む。ダイレクト ByteBuffer である必要があります。エンベッダは、リクエストが Callback にコールバックするまで、バッファの位置、上限、位置と上限の間のデータを読み取ったり変更したりしてはなりません。

start

public abstract void start()

リクエストを開始します。すべてのコールバックは Callback に送信されます。1 回だけ呼び出すことができます。cancel が呼び出された場合は呼び出されません。