UrlRequest.Builder

最高请求优先级。传递给 setPriority(int)。

最低请求优先级。传递给 setPriority(int)。

低请求优先级。传递给 setPriority(int)。

非常低请求优先级。传递给 setPriority(int)。

中请求优先级。如果未调用此方法，请求将被赋予 REQUEST_PRIORITY_MEDIUM 优先级。这是赋予请求的默认优先级。

添加请求头。

将注解对象与此请求相关联。可以添加多个。传递给 RequestFinishedInfo.Listener，请参见 RequestFinishedInfo.getAnnotations()。

标记此请求将用于通知回调（针对 UploadDataProvider 和 UrlRequest.Callback）的执行器有意执行内联操作，例如 Guava 的 directExecutor 或 ThreadPoolExecutor.CallerRunsPolicy。

警告：此选项很容易意外阻塞网络线程。如果您的回调执行磁盘 I/O、获取锁或调用其他您未仔细控制和审计的代码，则不应使用此选项。

使用此 UrlRequest.Builder 中的配置创建 UrlRequest。然后可以通过调用 UrlRequest.start() 启动返回的 UrlRequest。

禁用请求的缓存。如果上下文未设置为使用缓存，此调用无效。

设置此请求使用的 HTTP 方法动词。

如果未调用此方法，则默认值为“GET”（如果请求没有正文）或“POST”（如果请求有正文）。

设置请求的优先级，该优先级应是 REQUEST_PRIORITY_* 值之一。如果未调用此方法，请求将被赋予 REQUEST_PRIORITY_MEDIUM 优先级。

设置一个监听器，该监听器在 onCanceled()、onFailed() 或 onSucceeded() 返回后调用。

监听器在 Executor 上调用，并提供由 getExecutor() 提供的请求完成信息。

设置用于统计此请求引起的套接字流量的 TrafficStats 标签。有关更多信息，请参阅 TrafficStats。如果未设置标签（例如未调用此方法），则 Android 会将此请求引起的套接字流量统计为标签值设置为 0。

注意：设置标签会阻止与具有其他标签的请求共享套接字，这可能会通过禁止连接共享对性能产生不利影响。换句话说，只有当所有请求都具有相同的套接字标签时，才允许使用多路复用套接字（例如 HTTP/2 和 QUIC）。

设置用于统计此请求引起的套接字流量的特定 UID。有关更多信息，请参阅 TrafficStats。设计用于在代表另一个应用程序执行操作时使用。调用者必须持有 MODIFY_NETWORK_ACCOUNTING 权限。默认情况下，流量归因于调用者的 UID。

注意：设置 UID 会阻止与具有其他 UID 的请求共享套接字，这可能会通过禁止连接共享对性能产生不利影响。换句话说，只有当所有请求都设置了相同的 UID 时，才允许使用多路复用套接字（例如 HTTP/2 和 QUIC）。

设置上传数据提供程序。如果未明确设置，则将方法切换为“POST”。如果未设置 Content-Type 头，则启动请求会抛出异常。