NetworkException

public abstract class NetworkException extends CronetException

Các lớp con trực tiếp đã biết
QuicException

Lớp con của NetworkException chứa mã lỗi QUIC chi tiết từ QuicErrorCode.


Ngoại lệ được truyền đến UrlRequest.Callback.onFailed() khi Cronet không xử lý được một yêu cầu mạng. Trong trường hợp này, bạn có thể dùng getErrorCodegetCronetInternalErrorCode để biết thêm thông tin về loại lỗi cụ thể. Nếu getErrorCode trả về ERROR_QUIC_PROTOCOL_FAILED, thì ngoại lệ này có thể được truyền đến QuicException để cung cấp thêm thông tin chi tiết.

Tóm tắt

Hằng số

static final int

Mã lỗi cho biết không truy cập được vào địa chỉ IP đang được liên hệ, tức là không có tuyến đường nào đến máy chủ hoặc mạng được chỉ định.

static final int

Mã lỗi cho biết kết nối đã bị đóng đột ngột.

static final int

Mã lỗi cho biết yêu cầu kết nối đã bị từ chối.

static final int

Mã lỗi cho biết kết nối đã được đặt lại ngoài dự kiến.

static final int

Mã lỗi cho biết đã hết thời gian chờ kết nối.

static final int

Mã lỗi cho biết máy chủ nhận được yêu cầu không thể phân giải thành một địa chỉ IP.

static final int

Mã lỗi cho biết thiết bị không kết nối với mạng nào.

static final int

Mã lỗi cho biết rằng khi yêu cầu được xử lý, cấu hình mạng đã thay đổi.

static final int

Mã lỗi cho biết đã xảy ra một loại lỗi khác.

static final int

Mã lỗi cho biết một lỗi liên quan đến giao thức QUIC.

static final int

Mã lỗi cho biết thời gian chờ đã hết.

Hàm khởi tạo được bảo vệ

NetworkException(String message, Throwable cause)

Tạo một ngoại lệ do lỗi mạng gây ra.

Phương thức công khai

abstract int

Trả về mã lỗi nội bộ của Cronet.

abstract int

Trả về mã lỗi, một trong các mã ERROR_*.

abstract boolean

Trả về true nếu việc thử lại yêu cầu này ngay lập tức có thể thành công, nếu không thì trả về false.

Các phương thức kế thừa

Từ java.lang.Throwable
synchronized final void
synchronized Throwable
synchronized Throwable
String
String
StackTraceElement[]
synchronized final Throwable[]
synchronized Throwable
void
void
setStackTrace(StackTraceElement[] p)
String

Hằng số

ERROR_ADDRESS_UNREACHABLE

public static final int ERROR_ADDRESS_UNREACHABLE = 9

Mã lỗi cho biết không truy cập được vào địa chỉ IP đang được liên hệ, tức là không có tuyến đường nào đến máy chủ hoặc mạng được chỉ định.

ERROR_CONNECTION_CLOSED

public static final int ERROR_CONNECTION_CLOSED = 5

Mã lỗi cho biết kết nối đã bị đóng đột ngột.

ERROR_CONNECTION_REFUSED

public static final int ERROR_CONNECTION_REFUSED = 7

Mã lỗi cho biết yêu cầu kết nối đã bị từ chối.

ERROR_CONNECTION_RESET

public static final int ERROR_CONNECTION_RESET = 8

Mã lỗi cho biết kết nối đã được đặt lại ngoài dự kiến.

ERROR_CONNECTION_TIMED_OUT

public static final int ERROR_CONNECTION_TIMED_OUT = 6

Mã lỗi cho biết đã hết thời gian chờ kết nối.

ERROR_HOSTNAME_NOT_RESOLVED

public static final int ERROR_HOSTNAME_NOT_RESOLVED = 1

Mã lỗi cho biết máy chủ nhận được yêu cầu không thể phân giải thành một địa chỉ IP.

ERROR_INTERNET_DISCONNECTED

public static final int ERROR_INTERNET_DISCONNECTED = 2

Mã lỗi cho biết thiết bị không kết nối với mạng nào.

ERROR_NETWORK_CHANGED

public static final int ERROR_NETWORK_CHANGED = 3

Mã lỗi cho biết rằng khi yêu cầu được xử lý, cấu hình mạng đã thay đổi. Khi getErrorCode trả về mã này, ngoại lệ này có thể được truyền đến QuicException để biết thêm thông tin nếu giao thức QUIC được dùng.

ERROR_OTHER

public static final int ERROR_OTHER = 11

Mã lỗi cho biết đã xảy ra một loại lỗi khác. Bạn có thể tham khảo getCronetInternalErrorCode để biết nguyên nhân cụ thể hơn.

ERROR_QUIC_PROTOCOL_FAILED

public static final int ERROR_QUIC_PROTOCOL_FAILED = 10

Mã lỗi cho biết một lỗi liên quan đến giao thức QUIC. Khi getErrorCode trả về mã này, bạn có thể truyền ngoại lệ này đến QuicException để biết thêm thông tin.

ERROR_TIMED_OUT

public static final int ERROR_TIMED_OUT = 4

Mã lỗi cho biết thời gian chờ đã hết. Thời gian chờ hết hạn trong khi cố gắng kết nối sẽ được báo cáo là ERROR_CONNECTION_TIMED_OUT cụ thể hơn.

Hàm khởi tạo được bảo vệ

NetworkException

protected NetworkException(String message, Throwable cause)

Tạo một ngoại lệ do lỗi mạng gây ra.

Tham số
String message

giải thích về lỗi.

Throwable cause

nguyên nhân (được lưu để truy xuất sau bằng phương thức getCause()). Được phép sử dụng giá trị rỗng và cho biết rằng nguyên nhân không tồn tại hoặc không xác định.

Phương thức công khai

getCronetInternalErrorCode

public abstract int getCronetInternalErrorCode()

Trả về mã lỗi nội bộ của Cronet. Điều này có thể cung cấp thông tin chẩn đoán lỗi cụ thể hơn so với getErrorCode, nhưng các giá trị hằng số không được hiển thị cho Java và có thể thay đổi theo thời gian. Xem tại đây để biết danh sách giá trị mới nhất.

Giá trị trả về
int

Mã lỗi nội bộ của Cronet.

getErrorCode

public abstract int getErrorCode()

Trả về mã lỗi, một trong các mã ERROR_*.

Giá trị trả về
int

mã lỗi, một trong các mã ERROR_*.

immediatelyRetryable

public abstract boolean immediatelyRetryable()

Trả về true nếu việc thử lại yêu cầu này ngay lập tức có thể thành công, nếu không thì trả về false. Ví dụ: trả về true khi getErrorCode trả về ERROR_NETWORK_CHANGED vì việc thử yêu cầu có thể thành công bằng cách sử dụng cấu hình mạng mới, nhưng false khi getErrorCode() trả về ERROR_INTERNET_DISCONNECTED vì việc thử lại yêu cầu ngay lập tức sẽ gặp phải lỗi tương tự (thay vào đó, bạn nên trì hoãn việc thử lại cho đến khi thiết bị lấy lại được kết nối mạng).

Giá trị trả về
boolean

true nếu việc thử lại yêu cầu này ngay lập tức có thể thành công, false nếu không.