org.apache.flink.tests.util.cache

Interface DownloadCache

All Superinterfaces:

ExternalResource, org.junit.rules.TestRule

All Known Implementing Classes:

LolCache, PersistingDownloadCache, TravisDownloadCache

public interface DownloadCache
extends ExternalResource

A DownloadCache allows tests to download a files and/or directories and optionally caches them.

Whether, how, and for how long files are cached is implementation-dependent.

Method Summary

Modifier and Type	Method and Description
static DownloadCache	get() Returns the configured DownloadCache implementation, or a LolCache if none is configured.
Path	getOrDownload(String url, Path targetDir) Returns either a cached or newly downloaded version of the given file.

Methods inherited from interface org.apache.flink.util.ExternalResource

afterTestFailure, afterTestSuccess, apply, before

Method Detail

getOrDownload

Path getOrDownload(String url,
                   Path targetDir)
            throws IOException

Returns either a cached or newly downloaded version of the given file. The returned file path is guaranteed to be located in the given target directory.

Parameters:

url - File/directory to download

targetDir - directory to place file in

Returns:

downloaded or cached file

Throws:

IOException - if any IO operation fails

get

static DownloadCache get()

Returns the configured DownloadCache implementation, or a LolCache if none is configured.

Returns:

configured DownloadCache, or LolCache is none is configured