UrlRequest.Callback

abstract class UrlRequest.Callback

Subclasses diretas conhecidas
ImplicitFlowControlCallback

Uma implementação de UrlRequest.Callback que elimina a dificuldade de gerenciar o ciclo de vida da solicitação e prossegue automaticamente para ler a resposta inteira.

Subclasses indiretas conhecidas
ByteArrayCronetCallback

Uma especialização de InMemoryTransformCronetCallback que retorna os bytes do corpo literalmente, sem nenhuma interpretação.

InMemoryTransformCronetCallback

Um callback abstrato do Cronet que lê o corpo inteiro na memória e, opcionalmente, desserializa o corpo antes de transmiti-lo de volta ao emissor da solicitação HTTP.

JsonCronetCallback

Uma especialização de InMemoryTransformCronetCallback que interpreta o corpo da resposta como JSON.

StringCronetCallback

Uma especialização de InMemoryTransformCronetCallback que interpreta o corpo da resposta como uma string.


Os usuários do Cronet estendem essa classe para receber callbacks que indicam o progresso de uma UrlRequest em processamento. Uma instância dessa classe é transmitida ao construtor de UrlRequest.Builder ao construir a UrlRequest.

Observação: todos os métodos serão invocados na linha de execução do java.util.concurrent.Executor usado durante a construção da UrlRequest.

Resumo

Construtores públicos

Funções públicas

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

Invocado se a solicitação foi cancelada usando cancel.

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

Invocado se a solicitação falhou por qualquer motivo após start.

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

Invocado sempre que parte do corpo da resposta tiver sido lida.

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

Invocado sempre que um redirecionamento é encontrado.

abstract Unit

Invocado quando o conjunto final de cabeçalhos, após todos os redirecionamentos, é recebido.

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

Invocado quando a solicitação é concluída.

Construtores públicos

Callback

Callback()

Funções públicas

onCanceled

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

Invocado se a solicitação foi cancelada usando cancel. Depois de invocado, nenhum outro método Callback será invocado. A implementação padrão não realiza nenhuma ação.

Parâmetros
request: UrlRequest!

Solicitação que foi cancelada.

info: UrlResponseInfo!

Informações da resposta. Pode ser null se nenhuma resposta foi recebida.

onFailed

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

Invocado se a solicitação falhou por qualquer motivo após start. Depois de invocado, nenhum outro método Callback será invocado. error fornece informações sobre a falha.

Parâmetros
request: UrlRequest!

Solicitação que falhou.

info: UrlResponseInfo!

Informações da resposta. Pode ser null se nenhuma resposta foi recebida.

error: CronetException!

Informações sobre o erro.

onReadCompleted

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

Invocado sempre que parte do corpo da resposta tiver sido lida. Apenas parte do buffer pode ser preenchida, mesmo que o corpo da resposta inteiro ainda não tenha sido consumido. Com exceção de onCanceled(), nenhum outro método Callback será invocado para a solicitação, incluindo onSucceeded() e onFailed(), até que UrlRequest.read() seja chamado para tentar continuar lendo o corpo da resposta.

Parâmetros
request: UrlRequest!

Solicitação que recebeu dados.

info: UrlResponseInfo!

Informações da resposta.

byteBuffer: ByteBuffer!

O buffer que foi transmitido para UrlRequest.read(), agora contendo os dados recebidos. A posição do buffer é atualizada para o final dos dados recebidos. O limite do buffer não é alterado.

Gera
java.lang.Exception

Se ocorrer um erro ao processar uma conclusão de leitura. onFailed será chamado com a exceção gerada definida como a causa da CallbackException.

onRedirectReceived

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

Invocado sempre que um redirecionamento é encontrado. Isso só será invocado entre a chamada para start e onResponseStarted(). O corpo da resposta de redirecionamento, se houver, será ignorado. O redirecionamento não será seguido até que o método followRedirect do URLRequest seja chamado, de forma síncrona ou assíncrona.

Parâmetros
request: UrlRequest!

Solicitação sendo redirecionada.

info: UrlResponseInfo!

Informações da resposta.

newLocationUrl: String!

Local para onde a solicitação é redirecionada.

Gera
java.lang.Exception

Se ocorrer um erro ao processar um redirecionamento. onFailed será chamado com a exceção gerada definida como a causa da CallbackException.

onResponseStarted

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

Invocado quando o conjunto final de cabeçalhos, após todos os redirecionamentos, é recebido. Será invocado apenas uma vez para cada solicitação. Com exceção de onCanceled(), nenhum outro método Callback será invocado para a solicitação, incluindo onSucceeded() e onFailed(), até que UrlRequest.read() seja chamado para tentar iniciar a leitura do corpo da resposta.

Parâmetros
request: UrlRequest!

Solicitação que começou a receber resposta.

info: UrlResponseInfo!

Informações da resposta.

Gera
java.lang.Exception

Se ocorrer um erro ao processar o início da resposta. onFailed será chamado com a exceção gerada definida como a causa da CallbackException.

onSucceeded

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

Invocado quando a solicitação é concluída. Depois de invocado, nenhum outro método Callback será invocado.

Parâmetros
request: UrlRequest!

Solicitação que foi concluída.

info: UrlResponseInfo!

Informações da resposta.