org.jboss.arquillian.drone.webdriver.binary.downloading.source

Class GoogleStorageSource

java.lang.Object

org.jboss.arquillian.drone.webdriver.binary.downloading.source.GoogleStorageSource

All Implemented Interfaces:

ExternalBinarySource

Direct Known Subclasses:

SeleniumGoogleStorageSource

public abstract class GoogleStorageSource
extends Object
implements ExternalBinarySource

GoogleStorageSource source is an abstract class that helps you to retrieve either latest release or a release with some version from some specific google storage. Eg. http://selenium-release.storage.googleapis.com/ for selenium bits or https://chromedriver.storage.googleapis.com/ for chrome web-drivers

Author:

Matous Jobanek

Constructor Summary

Constructors

Constructor and Description
GoogleStorageSource(String storageUrl, HttpClient httpClient)
GoogleStorageSource(String storageUrl, String urlToLatestRelease, HttpClient httpClient)

Method Summary

Modifier and Type	Method and Description
protected abstract String	getExpectedKeyRegex(String requiredVersion, String directory) It is expected that this abstract method should return a regex that represents a key of an expected binary/file stored in the google storage.
ExternalBinary	getLatestRelease() Retrieves information about the latest release of binary and returns an instance of ExternalBinary that represents the latest release.
ExternalBinary	getReleaseForVersion(String requiredVersion) Retrieves information about a binary release with the desired version and returns an instance of ExternalBinary that represents the found release.

Methods inherited from class java.lang.Object

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

Constructor Detail

GoogleStorageSource

public GoogleStorageSource(String storageUrl,
                           HttpClient httpClient)

Parameters:

storageUrl - An url to a google storage from which information about releases should be retrieved from

GoogleStorageSource

public GoogleStorageSource(String storageUrl,
                           String urlToLatestRelease,
                           HttpClient httpClient)

Parameters:

storageUrl - An url to a google storage from which information about releases should be retrieved from

urlToLatestRelease - An url where a version of the latest release could be retrieved from

Method Detail

getLatestRelease

public ExternalBinary getLatestRelease()
                                throws Exception

Description copied from interface: ExternalBinarySource

Retrieves information about the latest release of binary and returns an instance of ExternalBinary that represents the latest release.

Specified by:

getLatestRelease in interface ExternalBinarySource

Returns:

An instance of ExternalBinary that contains information about the latest release of the binary.

Throws:

Exception - If anything bad happens

getReleaseForVersion

public ExternalBinary getReleaseForVersion(String requiredVersion)
                                    throws Exception

Description copied from interface: ExternalBinarySource

Retrieves information about a binary release with the desired version and returns an instance of ExternalBinary that represents the found release.

Specified by:

getReleaseForVersion in interface ExternalBinarySource

Parameters:

requiredVersion - A version of a binary release that should be retrieved.

Returns:

An instance of ExternalBinary that contains information about a binary release with the desired version.

Throws:

Exception

getExpectedKeyRegex

protected abstract String getExpectedKeyRegex(String requiredVersion,
                                              String directory)

It is expected that this abstract method should return a regex that represents a key of an expected binary/file stored in the google storage. Key consist of directory_name + / + file_name. Keys are visible on the root of the google storage url (without index.html suffix)

Parameters:

requiredVersion - The required version set using method getReleaseForVersion(java.lang.String), or otherwise null

directory - The directory for the current binary the regex is being matched against

Returns:

A regex that represents a key of an expected binary/file stored in the google storage.