com.github.dm.jrt.android.builder

Interface LoaderRoutineBuilder<IN,OUT>

Type Parameters:

IN - the input data type.

OUT - the output data type.

All Superinterfaces:

ConfigurableBuilder<RoutineBuilder<IN,OUT>>, LoaderConfigurableBuilder<LoaderRoutineBuilder<IN,OUT>>, LoaderRoutine<IN,OUT>, Routine<IN,OUT>, RoutineBuilder<IN,OUT>

public interface LoaderRoutineBuilder<IN,OUT>
extends RoutineBuilder<IN,OUT>, LoaderConfigurableBuilder<LoaderRoutineBuilder<IN,OUT>>, LoaderRoutine<IN,OUT>

Interface defining a builder of routines bound to a context lifecycle through loaders.

Routine invocations started through the returned objects can be safely restored after a change in the configuration, so to avoid duplicated calls and memory leaks. Be aware, though, that the invocation results will be dispatched on the configured looper thread, no matter the calling one was, so that, waiting for the outputs right after the routine invocation, may result in a deadlock.
Note that the configuration of the maximum number of concurrent invocations might not work as expected, since the number of running loaders cannot be computed.
Note also that the input data will be cached, so be sure to avoid streaming inputs in order to prevent out of memory errors.
The local context of the invocations will always be the application one.

Created by davide-maestroni on 12/09/2014.

Method Summary

Methods

Modifier and Type	Method and Description
LoaderRoutine<IN,OUT>	buildRoutine()
InvocationConfiguration.Builder<? extends LoaderRoutineBuilder<IN,OUT>>	invocations() Note that the configured asynchronous runner will be ignored.

Methods inherited from interface com.github.dm.jrt.android.builder.LoaderConfigurableBuilder

loaders

Methods inherited from interface com.github.dm.jrt.android.routine.LoaderRoutine

purge, purge, purge

Methods inherited from interface com.github.dm.jrt.routine.Routine

asyncCall, asyncCall, asyncCall, asyncCall, asyncCall, asyncInvoke, parallelCall, parallelCall, parallelCall, parallelCall, parallelCall, parallelInvoke, purge, syncCall, syncCall, syncCall, syncCall, syncCall, syncInvoke

Method Detail

buildRoutine

@Nonnull
LoaderRoutine<IN,OUT> buildRoutine()

Specified by:

buildRoutine in interface RoutineBuilder<IN,OUT>

invocations

@Nonnull
InvocationConfiguration.Builder<? extends LoaderRoutineBuilder<IN,OUT>> invocations()

Note that the configured asynchronous runner will be ignored.

Specified by:

invocations in interface ConfigurableBuilder<RoutineBuilder<IN,OUT>>

Returns:

the invocation configuration builder.