UrlRequest.Builder

const val REQUEST_PRIORITY_HIGHEST = 4: Int

Es la prioridad más alta de la solicitud. Se pasó a setPriority.

const val REQUEST_PRIORITY_IDLE = 0: Int

Es la prioridad de solicitud más baja. Se pasó a setPriority.

const val REQUEST_PRIORITY_LOW = 2: Int

Prioridad de solicitud baja. Se pasó a setPriority.

const val REQUEST_PRIORITY_LOWEST = 1: Int

Prioridad de solicitud muy baja. Se pasó a setPriority.

const val REQUEST_PRIORITY_MEDIUM = 3: Int

Prioridad media de la solicitud. Se pasó a setPriority. Esta es la prioridad predeterminada que se le asigna a la solicitud.

abstract fun addHeader(header: String!, value: String!): UrlRequest.Builder!

Agrega un encabezado de solicitud.

fun addRequestAnnotation(annotation: Any!): UrlRequest.Builder!

Asocia el objeto de anotación con esta solicitud. Puedes agregar más de uno. Se pasa a un RequestFinishedInfo.Listener. Consulta getAnnotations.

abstract fun allowDirectExecutor(): UrlRequest.Builder!

Indica que los ejecutores que usará esta solicitud para notificar devoluciones de llamada (para UploadDataProviders y UrlRequest.Callbacks) realizan intencionalmente la ejecución intercalada, como directExecutor de Guava o java.util.concurrent.ThreadPoolExecutor.CallerRunsPolicy.

Advertencia: Con esta opción, es fácil bloquear accidentalmente el subproceso de red. No se debe usar si tus devoluciones de llamada realizan E/S de disco, adquieren bloqueos o llaman a otro código que no controlas ni auditas cuidadosamente.

fun bindToNetwork(networkHandle: Long): UrlRequest.Builder!

Vincula la solicitud al identificador de red especificado. Cronet enviará esta solicitud solo a través de la red asociada a este identificador. Si se desconecta esta red, la solicitud fallará. El error exacto dependerá de la etapa de procesamiento de la solicitud en la que se desconecte la red. Los identificadores de red se pueden obtener a través de Network#getNetworkHandle. Solo disponible a partir de Android Marshmallow.

abstract fun build(): UrlRequest!

Crea un UrlRequest con la configuración de este Builder. Luego, se puede iniciar el UrlRequest devuelto llamando a start.

abstract fun disableCache(): UrlRequest.Builder!

Inhabilita la caché para la solicitud. Si el contexto no está configurado para usar la caché, esta llamada no tendrá efecto.

abstract fun setHttpMethod(method: String!): UrlRequest.Builder!

Establece el verbo del método HTTP que se usará para esta solicitud.

El valor predeterminado cuando no se llama a este método es "GET" si la solicitud no tiene cuerpo o "POST" si lo tiene.

abstract fun setPriority(priority: Int): UrlRequest.Builder!

Establece la prioridad de la solicitud, que debe ser uno de los valores de REQUEST_PRIORITY_*. La solicitud recibe prioridad REQUEST_PRIORITY_MEDIUM si no se llama a este método.

@UrlRequest.Experimental
fun setRawCompressionDictionary(
    dictionarySha256Hash: ByteArray!,
    dictionary: ByteBuffer!,
    dictionaryId: String!
): UrlRequest.Builder!

Permite que Cronet use el diccionario de compresión especificado para esta solicitud. Cuando se especifica, Cronet puede indicarle al servidor la disponibilidad de dicho diccionario de compresión. Para que esto surta efecto, el objeto CronetEngine que ejecutará esta solicitud debe haberse configurado para habilitar un esquema de compresión que admita diccionarios externos. Esto implementa parcialmente draft-ietf-httpbis-compression-dictionary dentro de Cronet. Cronet no controlará directamente los encabezados de respuesta "Use-As-Dictionary", sino que dependerá del incorporador para que los controle y, luego, llame a UrlRequest.Builder#setCompressionDictionary para las solicitudes que coincidan con las reglas de Use-As-Dictionary, o bien para que recupere diccionarios de compresión a través de algún otro mecanismo fuera de banda y, luego, llame a UrlRequest.Builder#setCompressionDictionary. Cronet interpretará el diccionario como si solo coincidiera con este UrlRequest. Si se redirecciona la solicitud y el sitio que incorpora el contenido decide seguir el redireccionamiento, el diccionario también coincidirá con la URL nueva.

fun setRequestFinishedListener(listener: RequestFinishedInfo.Listener!): UrlRequest.Builder!

Establece un objeto de escucha que se invoca después de que se devuelven onCanceled(), onFailed() o onSucceeded().

Se invoca al objeto de escucha con la información de solicitud finalizada en un java.util.concurrent.Executor proporcionado por getExecutor().

fun setTrafficStatsTag(tag: Int): UrlRequest.Builder!

Establece la etiqueta android.net.TrafficStats que se usará cuando se contabilice el tráfico de sockets causado por esta solicitud. Consulta android.net.TrafficStats para obtener más información. Si no se establece ninguna etiqueta (p.ej., no se llama a este método), Android contabiliza el tráfico de sockets causado por esta solicitud como si el valor de la etiqueta se hubiera establecido en 0.

NOTA: Establecer una etiqueta no permite compartir sockets con solicitudes que tengan otras etiquetas, lo que puede afectar negativamente el rendimiento, ya que se prohíbe el uso compartido de conexiones. En otras palabras, el uso de sockets multiplexados (p.ej., HTTP/2 y QUIC) solo se permitirá si todas las solicitudes tienen la misma etiqueta de socket.

fun setTrafficStatsUid(uid: Int): UrlRequest.Builder!

Establece el UID específico que se usará cuando se contabilice el tráfico de sockets causado por esta solicitud. Consulta android.net.TrafficStats para obtener más información. Se diseñó para usarse cuando se realiza una operación en nombre de otra aplicación. El emisor debe tener el permiso MODIFY_NETWORK_ACCOUNTING. De forma predeterminada, el tráfico se atribuye al UID de la entidad que realiza la llamada.

NOTA: Establecer un UID no permite compartir sockets con solicitudes que tengan otros UID, lo que puede afectar negativamente el rendimiento, ya que se prohíbe el uso compartido de conexiones. En otras palabras, el uso de sockets multiplexados (p.ej., HTTP/2 y QUIC) solo se permitirá si todas las solicitudes tienen establecido el mismo UID.

abstract fun setUploadDataProvider(
    uploadDataProvider: UploadDataProvider!,
    executor: Executor!
): UrlRequest.Builder!

Establece el proveedor de datos de carga. Cambia el método a "POST" si no se establece de forma explícita. Si no se configura un encabezado Content-Type, se arrojará una excepción cuando se inicie la solicitud.