Module page.codeberg.friedolyn.Friedolyn

Package page.codeberg.friedolyn.meta

Class Downloadable

java.lang.Object

page.codeberg.friedolyn.meta.Downloadable

Direct Known Subclasses:

PolledMetadata, UserAgentManager

public abstract class Downloadable
extends Object

Represents a file or other resource that can be fetched from a remote location, such as a web server.

See Also:

• download()
• wasDownloadedWithin(Duration)

Constructor Summary

Constructors

Constructor	Description
Downloadable()

Method Summary

Modifier and Type	Method	Description
abstract boolean	download()	Fetches the resource represented by the object from the remote location that it is available at.
static boolean	wasDownloadedWithin(String dateTimeLastDownload, @NonNull Duration duration)	Checks if the date and time of the last download is within the specified duration from (until) now.
abstract boolean	wasDownloadedWithin(@NonNull Duration duration)	Checks if the resource represented by the object was downloaded more recently than the specified duration, i.e.

Methods inherited from class java.lang.Object

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

Constructor Details

Downloadable

public Downloadable()

Method Details

download

public abstract boolean download()

Fetches the resource represented by the object from the remote location that it is available at.

Returns:

true if the download was successful, false otherwise.

wasDownloadedWithin

public abstract boolean wasDownloadedWithin(@NonNull
 @NonNull Duration duration)

Checks if the resource represented by the object was downloaded more recently than the specified duration, i.e. whether the resource was downloaded within `now - duration`.

Parameters:

duration - The time between the oldest acceptable download date and now.

Returns:

true if the resource was downloaded within the specified duration, false otherwise.

wasDownloadedWithin

public static boolean wasDownloadedWithin(String dateTimeLastDownload,
 @NonNull
 @NonNull Duration duration)

Checks if the date and time of the last download is within the specified duration from (until) now.

Parameters:

dateTimeLastDownload - The date and time of the last download in a format that can be parsed by LocalDateTime.parse(CharSequence).

duration - The time between the oldest acceptable download date and now.

Returns:

true if the resource was downloaded within the specified duration, false otherwise. False if the date and time of the last download could not be parsed or could not becompared with the current date and time.