UrlRequest.Builder

public static final int REQUEST_PRIORITY_HIGHEST = 4

Prioridade mais alta da solicitação. Transmitido para setPriority.

public static final int REQUEST_PRIORITY_IDLE = 0

A menor prioridade de solicitação. Transmitido para setPriority.

public static final int REQUEST_PRIORITY_LOW = 2

Prioridade baixa da solicitação. Transmitido para setPriority.

public static final int REQUEST_PRIORITY_LOWEST = 1

Prioridade de solicitação muito baixa. Transmitido para setPriority.

public static final int REQUEST_PRIORITY_MEDIUM = 3

Prioridade média da solicitação. Transmitido para setPriority. Essa é a prioridade padrão atribuída à solicitação.

public abstract UrlRequest.Builder addHeader(String header, String value)

Adiciona um cabeçalho da solicitação.

public UrlRequest.Builder addRequestAnnotation(Object annotation)

Associa o objeto de anotação a esta solicitação. É possível adicionar mais de um. Transmitido para um RequestFinishedInfo.Listener, consulte getAnnotations.

public abstract UrlRequest.Builder allowDirectExecutor()

Marca que os executores que esta solicitação usará para notificar callbacks (para UploadDataProviders e UrlRequest.Callbacks) estão realizando a execução in-line intencionalmente, como o directExecutor do Guava ou java.util.concurrent.ThreadPoolExecutor.CallerRunsPolicy.

Aviso:essa opção facilita o bloqueio acidental da linha de execução da rede. Não use se seus callbacks realizarem E/S de disco, adquirirem bloqueios ou chamarem outro código que você não controla e audita com cuidado.

public UrlRequest.Builder bindToNetwork(long networkHandle)

Vincula a solicitação ao identificador de rede especificado. A Cronet vai enviar essa solicitação apenas usando a rede associada a esse identificador. Se essa rede for desconectada, a solicitação vai falhar. O erro exato vai depender da etapa de processamento da solicitação quando a rede for desconectada. Os identificadores de rede podem ser obtidos usando Network#getNetworkHandle. Disponível apenas a partir do Android Marshmallow.

public abstract UrlRequest build()

Cria um UrlRequest usando a configuração neste Builder. O UrlRequest retornado pode ser iniciado chamando start.

public abstract UrlRequest.Builder disableCache()

Desativa o cache para a solicitação. Se o contexto não estiver configurado para usar o cache, essa chamada não terá efeito.

public abstract UrlRequest.Builder setHttpMethod(String method)

Define o verbo do método HTTP a ser usado para esta solicitação.

O padrão quando esse método não é chamado é "GET" se a solicitação não tiver um corpo ou "POST" se tiver.

public abstract UrlRequest.Builder setPriority(int priority)

Define a prioridade da solicitação, que precisa ser um dos valores REQUEST_PRIORITY_*. A solicitação recebe prioridade REQUEST_PRIORITY_MEDIUM se esse método não for chamado.

@UrlRequest.Experimental
public UrlRequest.Builder setRawCompressionDictionary(
    byte[] dictionarySha256Hash,
    ByteBuffer dictionary,
    String dictionaryId
)

Permite que a Cronet use o dicionário de compactação especificado para esta solicitação. Quando especificado, o Cronet pode sinalizar ao servidor a disponibilidade do dicionário de compactação. Para que isso tenha efeito, o CronetEngine que vai executar essa solicitação precisa ter sido configurado para ativar um esquema de compactação compatível com dicionários externos. Isso implementa parcialmente o draft-ietf-httpbis-compression-dictionary no Cronet. A Cronet não processa diretamente os cabeçalhos de resposta "Use-As-Dictionary ". Em vez disso, ela depende do incorporador para: processar e chamar UrlRequest.Builder#setCompressionDictionary para solicitações que correspondem às regras de"Use-As-Dictionary" ou buscar dicionários de compactação por algum outro mecanismo fora da banda e chamar UrlRequest.Builder#setCompressionDictionary. A Cronet vai interpretar o dicionário como correspondente apenas a essa UrlRequest. Se a solicitação for redirecionada e o incorporador decidir seguir o redirecionamento, o dicionário também vai corresponder ao novo URL.

public UrlRequest.Builder setRequestFinishedListener(RequestFinishedInfo.Listener listener)

Define um listener que é invocado após o retorno de onCanceled(), onFailed() ou onSucceeded().

O listener é invocado com as informações de solicitação concluída em um java.util.concurrent.Executor fornecido por getExecutor().

public UrlRequest.Builder setTrafficStatsTag(int tag)

Define a tag android.net.TrafficStats a ser usada ao contabilizar o tráfego de soquete causado por esta solicitação. Consulte os android.net.TrafficStats para mais informações. Se nenhuma tag for definida (por exemplo, se esse método não for chamado), o Android vai considerar o tráfego de soquete causado por essa solicitação como se o valor da tag fosse definido como 0.

OBSERVAÇÃO:definir uma tag impede o compartilhamento de sockets com solicitações de outras tags, o que pode afetar negativamente o desempenho ao proibir o compartilhamento de conexões. Em outras palavras, o uso de sockets multiplexados (por exemplo, HTTP/2 e QUIC) só será permitido se todas as solicitações tiverem a mesma tag de socket.

public UrlRequest.Builder setTrafficStatsUid(int uid)

Define um UID específico para usar ao contabilizar o tráfego de soquete causado por esta solicitação. Consulte android.net.TrafficStats para mais informações. Projetado para uso ao realizar uma operação em nome de outro aplicativo. O autor da chamada precisa ter a permissão MODIFY_NETWORK_ACCOUNTING. Por padrão, o tráfego é atribuído ao UID do caller.

OBSERVAÇÃO:definir um UID impede o compartilhamento de sockets com solicitações de outros UIDs, o que pode afetar negativamente o desempenho ao proibir o compartilhamento de conexões. Em outras palavras, o uso de sockets multiplexados (por exemplo, HTTP/2 e QUIC) só será permitido se todas as solicitações tiverem o mesmo UID definido.

public abstract UrlRequest.Builder setUploadDataProvider(
    UploadDataProvider uploadDataProvider,
    Executor executor
)

Define o provedor de dados de upload. Muda o método para "POST" se não estiver definido explicitamente. Iniciar a solicitação vai gerar uma exceção se um cabeçalho Content-Type não estiver definido.