Added onLoadStarted callback to Loader's callback

This commit is contained in:
Colin Kho 2024-07-31 22:35:39 -07:00 committed by Ian Baker
parent 266f16823f
commit 1cc1bf02ef

View File

@ -90,6 +90,18 @@ public final class Loader implements LoaderErrorThrower {
/** A callback to be notified of {@link Loader} events. */
public interface Callback<T extends Loadable> {
/**
* Called when a load has started for the first time or through a retry.
*
* @param loadable The loadable whose load has completed.
* @param elapsedRealtimeMs {@link SystemClock#elapsedRealtime} when the load ended.
* @param loadDurationMs The duration in milliseconds of the load since {@link #startLoading}
* was called.
* @param error The load error of the previous load attempt if this is a retry, otherwise null
* @param errorCount The number of errors this load has encountered thus far.
*/
default void onLoadStarted(T loadable, long elapsedRealtimeMs, long loadDurationMs, @Nullable IOException error, int errorCount) {}
/**
* Called when a load has completed.
*
@ -531,6 +543,9 @@ public final class Loader implements LoaderErrorThrower {
}
private void execute() {
long nowMs = SystemClock.elapsedRealtime();
long durationMs = nowMs - startTimeMs;
Assertions.checkNotNull(this.callback).onLoadStarted(loadable, nowMs, durationMs, currentError, errorCount);
currentError = null;
downloadExecutor.execute(Assertions.checkNotNull(currentTask));
}