UrlRequest.Callback

abstract class UrlRequest.Callback

Subclases directas conocidas
ImplicitFlowControlCallback

Es una implementación de UrlRequest.Callback que elimina la dificultad de administrar el ciclo de vida de la solicitud y procede automáticamente a leer la respuesta por completo.

Subcategorías indirectas conocidas
ByteArrayCronetCallback

Es una especialización de InMemoryTransformCronetCallback que muestra los bytes del cuerpo de forma textual sin ninguna interpretación.

InMemoryTransformCronetCallback

Es una devolución de llamada abstracta de Cronet que lee todo el cuerpo en la memoria y, de manera opcional, lo deserializa antes de pasarlo de nuevo al emisor de la solicitud HTTP.

JsonCronetCallback

Es una especialización de InMemoryTransformCronetCallback que interpreta el cuerpo de la respuesta como JSON.

StringCronetCallback

Es una especialización de InMemoryTransformCronetCallback que interpreta el cuerpo de la respuesta como una cadena.


Los usuarios de Cronet extienden esta clase para recibir devoluciones de llamada que indican el progreso de una UrlRequest que se está procesando. Se pasa una instancia de esta clase al constructor de UrlRequest.Builder cuando se construye la UrlRequest.

Nota: Se invocarán todos los métodos en el subproceso de java.util.concurrent.Executor que se usó durante la construcción de UrlRequest.

Resumen

Constructores públicos

Funciones públicas

Unit
onCanceled(request: UrlRequest!, info: UrlResponseInfo!)

Se invoca si la solicitud se canceló a través de cancel.

abstract Unit
onFailed(
    request: UrlRequest!,
    info: UrlResponseInfo!,
    error: CronetException!
)

Se invoca si la solicitud falla por algún motivo después de start.

abstract Unit
onReadCompleted(
    request: UrlRequest!,
    info: UrlResponseInfo!,
    byteBuffer: ByteBuffer!
)

Se invoca cada vez que se ha leído parte del cuerpo de la respuesta.

abstract Unit
onRedirectReceived(
    request: UrlRequest!,
    info: UrlResponseInfo!,
    newLocationUrl: String!
)

Se invoca cada vez que se encuentra un redireccionamiento.

abstract Unit

Se invoca cuando se recibe el conjunto final de encabezados, después de todos los redireccionamientos.

abstract Unit
onSucceeded(request: UrlRequest!, info: UrlResponseInfo!)

Se invoca cuando la solicitud se completa correctamente.

Constructores públicos

Devolución de llamada

Callback()

Funciones públicas

onCanceled

fun onCanceled(request: UrlRequest!, info: UrlResponseInfo!): Unit

Se invoca si la solicitud se canceló a través de cancel. Una vez que se invoca, no se invoca ningún otro método Callback. La implementación predeterminada no realiza ninguna acción.

Parámetros
request: UrlRequest!

Solicitud que se canceló.

info: UrlResponseInfo!

Información de la respuesta. Puede ser null si no se recibió ninguna respuesta.

onFailed

abstract fun onFailed(
    request: UrlRequest!,
    info: UrlResponseInfo!,
    error: CronetException!
): Unit

Se invoca si la solicitud falla por algún motivo después de start. Una vez que se invoca, no se invoca ningún otro método Callback. error proporciona información sobre la falla.

Parámetros
request: UrlRequest!

Solicitud que falló.

info: UrlResponseInfo!

Información de la respuesta. Puede ser null si no se recibió ninguna respuesta.

error: CronetException!

Información sobre el error.

onReadCompleted

abstract fun onReadCompleted(
    request: UrlRequest!,
    info: UrlResponseInfo!,
    byteBuffer: ByteBuffer!
): Unit

Se invoca cada vez que se ha leído parte del cuerpo de la respuesta. Es posible que solo se complete parte del búfer, incluso si aún no se consumió todo el cuerpo de la respuesta. Con la excepción de onCanceled(), no se invocará ningún otro método Callback para la solicitud, incluidos onSucceeded() y onFailed(), hasta que se llame a UrlRequest.read() para intentar seguir leyendo el cuerpo de la respuesta.

Parámetros
request: UrlRequest!

Solicitud que recibió datos.

info: UrlResponseInfo!

Información de la respuesta.

byteBuffer: ByteBuffer!

El búfer que se pasó a UrlRequest.read(), que ahora contiene los datos recibidos. La posición del búfer se actualiza al final de los datos recibidos. No se cambia el límite del búfer.

Arroja
java.lang.Exception

si se produce un error mientras se procesa una finalización de lectura. Se llamará a onFailed con la excepción arrojada establecida como la causa de CallbackException.

onRedirectReceived

abstract fun onRedirectReceived(
    request: UrlRequest!,
    info: UrlResponseInfo!,
    newLocationUrl: String!
): Unit

Se invoca cada vez que se encuentra un redireccionamiento. Esto solo se invocará entre la llamada a start y onResponseStarted(). Se ignorará el cuerpo de la respuesta de redireccionamiento, si tiene uno. No se seguirá el redireccionamiento hasta que se llame al método followRedirect de URLRequest, ya sea de forma síncrona o asíncrona.

Parámetros
request: UrlRequest!

Solicitud que se está redireccionando.

info: UrlResponseInfo!

Información de la respuesta.

newLocationUrl: String!

Ubicación a la que se redirecciona la solicitud.

Arroja
java.lang.Exception

si se produce un error mientras se procesa un redireccionamiento. Se llamará a onFailed con la excepción arrojada establecida como la causa de CallbackException.

onResponseStarted

abstract fun onResponseStarted(request: UrlRequest!, info: UrlResponseInfo!): Unit

Se invoca cuando se recibe el conjunto final de encabezados, después de todos los redireccionamientos. Solo se invocará una vez por cada solicitud. Con la excepción de onCanceled(), no se invocará ningún otro método Callback para la solicitud, incluidos onSucceeded() y onFailed(), hasta que se llame a UrlRequest.read() para intentar comenzar a leer el cuerpo de la respuesta.

Parámetros
request: UrlRequest!

Solicitud que comenzó a obtener respuesta.

info: UrlResponseInfo!

Información de la respuesta.

Arroja
java.lang.Exception

si se produce un error mientras se procesa el inicio de la respuesta. Se llamará a onFailed con la excepción arrojada establecida como la causa de CallbackException.

onSucceeded

abstract fun onSucceeded(request: UrlRequest!, info: UrlResponseInfo!): Unit

Se invoca cuando la solicitud se completa correctamente. Una vez que se invoca, no se invoca ningún otro método Callback.

Parámetros
request: UrlRequest!

Solicitud que se realizó correctamente.

info: UrlResponseInfo!

Información de la respuesta.