org.gradle.api.internal.externalresource.transport.http

Class HttpResourceAccessor

java.lang.Object

org.gradle.api.internal.externalresource.transport.http.HttpResourceAccessor

All Implemented Interfaces:

ExternalResourceAccessor

public class HttpResourceAccessor
extends Object
implements ExternalResourceAccessor

Constructor Summary

Constructors

Constructor and Description
HttpResourceAccessor(HttpClientHelper http)

Method Summary

Methods

Modifier and Type	Method and Description
ExternalResourceMetaData	getMetaData(String location) Obtains only the metadata about the resource.
ExternalResource	getResource(String location) Obtain the resource at the given location.
HashValue	getResourceSha1(String location) Obtain the SHA-1 checksum for the resource at the given location.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

HttpResourceAccessor

public HttpResourceAccessor(HttpClientHelper http)

Method Detail

getResource

public ExternalResource getResource(String location)
                             throws IOException

Description copied from interface: ExternalResourceAccessor

Obtain the resource at the given location. If the resource does not exist, this method should return null. If the resource may exist but can't be accessed due to some configuration issue, the implementation may either return null or throw an IOException to indicate a fatal condition.

Specified by:

getResource in interface ExternalResourceAccessor

Parameters:

location - The address of the resource to obtain

Returns:

The resource if it exists, otherwise null

Throws:

IOException - If the resource may exist, but not could be obtained for some reason

getMetaData

public ExternalResourceMetaData getMetaData(String location)

Description copied from interface: ExternalResourceAccessor

Obtains only the metadata about the resource. If it is determined that the resource does not exist, this method should return null. If it is not possible to determine whether the resource exists or not, this method should return a metadata instance with null/non value values (e.g. -1 for content length) to indicate that the resource may indeed exist, but the metadata for it cannot be obtained. If the resource may exist but can't be accessed due to some configuration issue, the implementation may either return an empty metadata object or throw an IOException to indicate a fatal condition.

Specified by:

getMetaData in interface ExternalResourceAccessor

Parameters:

location - The location of the resource to obtain the metadata for

Returns:

The available metadata if possible, an ?empty? metadata object if the metadata can't be reliably be obtained, null if the resource doesn't exist

getResourceSha1

public HashValue getResourceSha1(String location)

Description copied from interface: ExternalResourceAccessor

Obtain the SHA-1 checksum for the resource at the given location. Implementation is optional. If it is not feasible to obtain this without reading the entire resource, implementations should return null.

Specified by:

getResourceSha1 in interface ExternalResourceAccessor

Parameters:

location - The address of the resource to obtain the sha-1 of

Returns:

The sha-1 if it can be cheaply obtained, otherwise null.