HttpBuildCache

API文档:HttpBuildCache

HTTP 构建缓存的配置对象。缓存条目通过 GET 加载并通过 PUT 请求存储。

成功的 GET 请求必须返回状态为 200(缓存命中)或 404(缓存未命中)的响应,缓存命中响应包括缓存条目作为响应正文。成功的 PUT 请求必须返回任何 2xx 响应。

PUT 请求还可能返回 413 Payload Too Large 响应,以指示有效负载大于可接受的范围。HttpBuildCache.isUseExpectContinue()启用 时这很有用。

重定向响应可以与 301、302、303、307 或 308 响应一起发出。重定向对 PUT 请求的响应必须使用 307 或 308 才能重播 PUT。否则,重定向后将跟随 GET 请求。

任何其他类型的响应都将被视为错误,导致在构建的其余部分禁用远程缓存。

配置凭据后(请参阅 参考资料HttpBuildCache.getCredentials()),将使用 HTTP 基本身份验证发送它们。

请求传输期间失败的请求在建立 TCP 连接后将自动重试。这包括连接丢失、读取或写入超时以及连接重置等低级网络故障。在放弃并在构建的其余部分禁用缓存之前,请求将重试 3 次。

特性

财产描述
allowInsecureProtocol

指定是否可以接受通过不安全的 HTTP 连接与构建缓存进行通信。

allowUntrustedServer

指定是否可以接受使用不受信任的 SSL 证书与 HTTP 构建缓存后端进行通信。

enabled

是否启用构建缓存。

push

给定的构建是否可以将输出存储在构建缓存中。

url

缓存的 URI。

useExpectContinue

指定是否应对存储请求使用 HTTP Expect-Continue。该值默认为false。启用后,在尝试之前会先与服务器检查存储请求是否成功。当可能处理可能被服务器拒绝并返回 413 Payload Too Large 响应的大型工件时,这特别有用,因为它避免了传输大文件只是为了拒绝它的开销。由于初始检查需要额外的网络通信,这种快速失败行为的代价是成功请求的额外边际开销。注意:并非所有 HTTP 服务器都支持 Expect-Continue。

方法

方法描述
credentials(configuration)

配置用于访问 HTTP 缓存后端的凭据。

脚本块

无脚本块

物业详情

boolean allowInsecureProtocol

指定是否可以接受通过不安全的 HTTP 连接与构建缓存进行通信。

出于安全目的,这有意要求用户根据具体情况选择使用不安全的协议。

Gradle 故意不提供允许普遍禁用此检查的全局系统/gradle 属性。

允许通过不安全协议进行通信允许中间人冒充目标服务器,并使攻击者能够 向系统提供恶意可执行代码。

另请参阅: 想要接管 Java 生态系统吗?您所需要的只是一个中间人!

boolean allowUntrustedServer

指定是否可以接受使用不受信任的 SSL 证书与 HTTP 构建缓存后端进行通信。

HTTP 构建缓存后端的 SSL 证书可能不受信任,因为它是内部配置的或自签名的证书。

在这种情况下,您可以配置构建 JVM 环境以信任该证书,或将此属性设置为true禁用服务器身份验证。

允许与不受信任的服务器进行通信可以使数据在传输过程中保持加密状态,但也使中间人更容易冒充目标服务器并捕获数据。

如果使用 HTTP 协议指定服务器(即禁用了 SSL),则该值无效。

boolean enabled

是否启用构建缓存。

boolean push

给定的构建是否可以将输出存储在构建缓存中。

URI url

缓存的 URI。

boolean useExpectContinue

指定是否应对存储请求使用 HTTP Expect-Continue。该值默认为false。启用后,在尝试之前会先与服务器检查存储请求是否成功。当可能处理可能被服务器拒绝并返回 413 Payload Too Large 响应的大型工件时,这特别有用,因为它避免了传输大文件只是为了拒绝它的开销。由于初始检查需要额外的网络通信,这种快速失败行为的代价是成功请求的额外边际开销。注意:并非所有 HTTP 服务器都支持 Expect-Continue。

方法详情

void credentials(配置)Action<? super HttpBuildCacheCredentials>

配置用于访问 HTTP 缓存后端的凭据。