UrlRequest.Callback

public 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 textualmente 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á 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

Métodos públicos
void

Se invoca si la solicitud se canceló a través de cancel.
abstract void
onFailed(
    UrlRequest request,
    UrlResponseInfo info,
    CronetException error
)

Se invoca si la solicitud falla por algún motivo después de start.
abstract void
onReadCompleted(
    UrlRequest request,
    UrlResponseInfo info,
    ByteBuffer byteBuffer
)

Se invoca cada vez que se ha leído parte del cuerpo de la respuesta.
abstract void
onRedirectReceived(
    UrlRequest request,
    UrlResponseInfo info,
    String newLocationUrl
)

Se invoca cada vez que se encuentra un redireccionamiento.
abstract void

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

Se invoca cuando la solicitud se completa correctamente.

Constructores públicos

Devolución de llamada

public Callback()

Métodos públicos

onCanceled

public void onCanceled(UrlRequest request, UrlResponseInfo info)

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
UrlRequest request

Solicitud que se canceló.
UrlResponseInfo info

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

onFailed

public abstract void onFailed(
    UrlRequest request,
    UrlResponseInfo info,
    CronetException error
)

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
UrlRequest request

Solicitud que falló.
UrlResponseInfo info

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

Información sobre el error.

onReadCompleted

public abstract void onReadCompleted(
    UrlRequest request,
    UrlResponseInfo info,
    ByteBuffer byteBuffer
)

Se invoca cada vez que se ha leído parte del cuerpo de la respuesta. Solo se puede propagar 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 continuar leyendo el cuerpo de la respuesta.

Parámetros
UrlRequest request

Solicitud que recibió datos.
UrlResponseInfo info

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

public abstract void onRedirectReceived(
    UrlRequest request,
    UrlResponseInfo info,
    String newLocationUrl
)

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
UrlRequest request

Solicitud que se redirecciona.
UrlResponseInfo info

Información de la respuesta.
String newLocationUrl

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

public abstract void onResponseStarted(UrlRequest request, UrlResponseInfo info)

Se invoca cuando se recibe el conjunto final de encabezados, después de todos los redireccionamientos. Solo se invocará una vez para 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
UrlRequest request

Solicitud que comenzó a obtener una respuesta.
UrlResponseInfo info

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

public abstract void onSucceeded(UrlRequest request, UrlResponseInfo info)

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

Parámetros
UrlRequest request

Solicitud que se realizó correctamente.
UrlResponseInfo info

Información de la respuesta.