NetworkException

public abstract class NetworkException extends CronetException

既知の直接サブクラス
QuicException

NetworkException のサブクラス。 QuicErrorCode からの詳細な QUIC エラーコードが含まれます。


Cronet がネットワーク リクエストの処理に失敗したときに UrlRequest.Callback.onFailed() に渡される例外。この場合、getErrorCodegetCronetInternalErrorCode を使用して、特定のタイプの障害に関する詳細情報を取得できます。getErrorCodeERROR_QUIC_PROTOCOL_FAILED を返した場合、この例外は QuicException にキャストして、詳細情報を取得できます。

概要

定数

static final int

接続先の IP アドレスにアクセスできないことを示すエラーコード。指定されたホストまたはネットワークへのルートがないことを意味します。

static final int

接続が予期せず閉じられたことを示すエラーコード。

static final int

接続試行が拒否されたことを示すエラーコード。

static final int

接続が予期せずリセットされたことを示すエラーコード。

static final int

接続試行がタイムアウトしたことを示すエラーコード。

static final int

リクエストの送信先ホストを IP アドレスに解決できなかったことを示すエラーコード。

static final int

デバイスがネットワークに接続されていないことを示すエラーコード。

static final int

リクエストの処理中にネットワーク構成が変更されたことを示すエラーコード。

static final int

別の種類のエラーが発生したことを示すエラーコード。

static final int

QUIC プロトコルに関連するエラーを示すエラーコード。

static final int

タイムアウトの期限切れを示すエラーコード。

保護されたコンストラクタ

NetworkException(String message, Throwable cause)

ネットワーク エラーが原因で発生した例外を構築します。

パブリック メソッド

abstract int

Cronet 内部エラーコードを返します。

abstract int

エラーコード(ERROR_* のいずれか)を返します。

abstract boolean

このリクエストをすぐに再試行すると成功する可能性がある場合は true、それ以外の場合は false を返します。

継承されるメソッド

継承元: java.lang.Throwable
synchronized final void
synchronized Throwable
synchronized Throwable
String
String
StackTraceElement[]
synchronized final Throwable[]
synchronized Throwable
void
void
setStackTrace(StackTraceElement[] p)
String

定数

ERROR_ADDRESS_UNREACHABLE

public static final int ERROR_ADDRESS_UNREACHABLE = 9

接続先の IP アドレスにアクセスできないことを示すエラーコード。指定されたホストまたはネットワークへのルートがないことを意味します。

ERROR_CONNECTION_CLOSED

public static final int ERROR_CONNECTION_CLOSED = 5

接続が予期せず閉じられたことを示すエラーコード。

ERROR_CONNECTION_REFUSED

public static final int ERROR_CONNECTION_REFUSED = 7

接続試行が拒否されたことを示すエラーコード。

ERROR_CONNECTION_RESET

public static final int ERROR_CONNECTION_RESET = 8

接続が予期せずリセットされたことを示すエラーコード。

ERROR_CONNECTION_TIMED_OUT

public static final int ERROR_CONNECTION_TIMED_OUT = 6

接続試行がタイムアウトしたことを示すエラーコード。

ERROR_HOSTNAME_NOT_RESOLVED

public static final int ERROR_HOSTNAME_NOT_RESOLVED = 1

リクエストの送信先ホストを IP アドレスに解決できなかったことを示すエラーコード。

ERROR_INTERNET_DISCONNECTED

public static final int ERROR_INTERNET_DISCONNECTED = 2

デバイスがネットワークに接続されていないことを示すエラーコード。

ERROR_NETWORK_CHANGED

public static final int ERROR_NETWORK_CHANGED = 3

リクエストの処理中にネットワーク構成が変更されたことを示すエラーコード。getErrorCode がこのコードを返した場合、 QUIC プロトコルが使用されていれば、詳細情報を得るためにこの例外を QuicException にキャストできます。

ERROR_OTHER

public static final int ERROR_OTHER = 11

別の種類のエラーが発生したことを示すエラーコード。getCronetInternalErrorCode を参照して、より具体的な原因を確認できます。

ERROR_QUIC_PROTOCOL_FAILED

public static final int ERROR_QUIC_PROTOCOL_FAILED = 10

QUIC プロトコルに関連するエラーを示すエラーコード。getErrorCode がこのコードを返した場合、この例外を QuicException にキャストして詳細情報を取得できます。

ERROR_TIMED_OUT

public static final int ERROR_TIMED_OUT = 4

タイムアウトの期限切れを示すエラーコード。接続の試行中にタイムアウトが期限切れになった場合は、より具体的な ERROR_CONNECTION_TIMED_OUT として報告されます。

保護されたコンストラクタ

NetworkException

protected NetworkException(String message, Throwable cause)

ネットワーク エラーが原因で発生した例外を構築します。

パラメータ
String message

失敗の説明。

Throwable cause

原因(後で getCause() メソッドで取得するために保存されます)。null 値は許容され、原因が存在しないか不明であることを示します。

パブリック メソッド

getCronetInternalErrorCode

public abstract int getCronetInternalErrorCode()

Cronet 内部エラーコードを返します。これにより、getErrorCode よりも具体的なエラー診断が可能になる可能性がありますが、定数値は Java に公開されず、時間の経過とともに変化する可能性があります。値の最新のリストについては、 こちらをご覧ください。

戻り値
int

Cronet の内部エラーコード。

getErrorCode

public abstract int getErrorCode()

エラーコード(ERROR_* のいずれか)を返します。

戻り値
int

エラーコード。ERROR_* のいずれか。

immediatelyRetryable

public abstract boolean immediatelyRetryable()

このリクエストをすぐに再試行すると成功する可能性がある場合は true、それ以外の場合は false を返します。たとえば、getErrorCodeERROR_NETWORK_CHANGED を返した場合は true を返します。これは、新しいネットワーク構成を使用するとリクエストが成功する可能性があるためです。一方、getErrorCode()ERROR_INTERNET_DISCONNECTED を返した場合は false を返します。これは、リクエストをすぐに再試行しても同じエラーが発生するためです(代わりに、デバイスがネットワーク接続を回復するまで再試行を遅らせる必要があります)。

戻り値
boolean

このリクエストをすぐに再試行すると成功する可能性がある場合は true、それ以外の場合は false