UrlRequest

public abstract class UrlRequest


Controla uma solicitação HTTP (GET, PUT, POST etc.). Criado por UrlRequest.Builder, que pode ser obtido chamando newUrlRequestBuilder. Observação: todos os métodos precisam ser chamados no Executor transmitido para newUrlRequestBuilder.

Resumo

Tipos aninhados

public abstract class UrlRequest.Builder

Criador de UrlRequests.

public abstract class UrlRequest.Callback

Os usuários da Cronet estendem essa classe para receber callbacks que indicam o progresso de um UrlRequest que está sendo processado.

Uma anotação para APIs que ainda não são consideradas estáveis.

public class UrlRequest.Status

Valores de status da solicitação retornados por getStatus.

public abstract class UrlRequest.StatusListener

Classe de listener usada com getStatus para receber o status de um UrlRequest.

Construtores públicos

Métodos públicos

abstract void

Cancela a solicitação.

abstract void

Segue um redirecionamento pendente.

abstract void

Consulta o status da solicitação.

abstract boolean

Retorna true se a solicitação foi iniciada e concluída (realizada, cancelada ou falhou).

abstract void
read(ByteBuffer buffer)

Tenta ler parte do corpo da resposta no buffer fornecido.

abstract void

Inicia a solicitação. Todos os callbacks vão para Callback.

Construtores públicos

UrlRequest

public UrlRequest()

Métodos públicos

cancelar

public abstract void cancel()

Cancela a solicitação. Pode ser chamado a qualquer momento. onCanceled() será invocado quando o cancelamento for concluído e nenhum outro método de callback será invocado. Se a solicitação tiver sido concluída ou não tiver sido iniciada, chamar cancel() não terá efeito e onCanceled() não será invocado. Se o Executor transmitido durante a construção de UrlRequest executar tarefas em uma única linha de execução e cancel() for chamado nessa linha, nenhum método de callback (além de onCanceled()) será invocado após a chamada de cancel(). Caso contrário, no máximo um método de callback poderá ser invocado após a conclusão de cancel().

followRedirect

public abstract void followRedirect()

Segue um redirecionamento pendente. Só pode ser chamado no máximo uma vez para cada invocação de onRedirectReceived().

getStatus

public abstract void getStatus(UrlRequest.StatusListener listener)

Consulta o status da solicitação.

Parâmetros
UrlRequest.StatusListener listener

Um StatusListener que será invocado com o status atual da solicitação. listener será invocado de volta no Executor transmitido quando a solicitação foi criada.

isDone

public abstract boolean isDone()

Retorna true se a solicitação foi iniciada e concluída (realizada, cancelada ou falhou).

Retorna
boolean

true se a solicitação foi iniciada e concluída (realizada, cancelada ou falhou).

Lidos

public abstract void read(ByteBuffer buffer)

Tenta ler parte do corpo da resposta no buffer fornecido. Só pode ser chamado no máximo uma vez em resposta a cada invocação dos métodos onResponseStarted() e onReadCompleted() do Callback. Cada chamada resultará em uma chamada assíncrona para o método Callback'sonReadCompleted() se os dados forem lidos, para o método onSucceeded() se não houver mais dados a serem lidos ou para o método onFailed() se houver um erro.

Parâmetros
ByteBuffer buffer

ByteBuffer para gravar o corpo da resposta. Precisa ser um ByteBuffer direto. O incorporador não pode ler ou modificar a posição, o limite ou os dados do buffer entre a posição e o limite até que a solicitação retorne ao Callback.

start

public abstract void start()

Inicia a solicitação. Todos os callbacks vão para Callback. Só pode ser chamado uma vez. Não pode ser chamado se cancel tiver sido chamado.