NetworkException

abstract class NetworkException : CronetException

kotlin.Any
   ↳ kotlin.Throwable
     ↳ java.lang.Exception
       ↳ java.io.IOException
         ↳ org.chromium.net.CronetException
           ↳ org.chromium.net.NetworkException
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ố

const 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.

const Int

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

const Int

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

const Int

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

const Int

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

const 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.

const Int

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

const 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.

const Int

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

const Int

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

const Int

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

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

NetworkException(message: String!, cause: Throwable!)

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

Hàm 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.

Hằng số

ERROR_ADDRESS_UNREACHABLE

const val ERROR_ADDRESS_UNREACHABLE = 9: 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.

ERROR_CONNECTION_CLOSED

const val ERROR_CONNECTION_CLOSED = 5: Int

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

ERROR_CONNECTION_REFUSED

const val ERROR_CONNECTION_REFUSED = 7: Int

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

ERROR_CONNECTION_RESET

const val ERROR_CONNECTION_RESET = 8: Int

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

ERROR_CONNECTION_TIMED_OUT

const val ERROR_CONNECTION_TIMED_OUT = 6: Int

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

ERROR_HOSTNAME_NOT_RESOLVED

const val ERROR_HOSTNAME_NOT_RESOLVED = 1: 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.

ERROR_INTERNET_DISCONNECTED

const val ERROR_INTERNET_DISCONNECTED = 2: Int

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

ERROR_NETWORK_CHANGED

const val ERROR_NETWORK_CHANGED = 3: 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. 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

const val ERROR_OTHER = 11: Int

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

const val ERROR_QUIC_PROTOCOL_FAILED = 10: Int

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

const val ERROR_TIMED_OUT = 4: Int

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(message: String!, cause: Throwable!)

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

Tham số
message: String!

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

cause: Throwable!

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.

Hàm công khai

getCronetInternalErrorCode

abstract fun getCronetInternalErrorCode(): Int

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

abstract fun getErrorCode(): Int

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

abstract fun immediatelyRetryable(): 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. 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.