com.github.dm.jrt.android.builder

Interface LoaderObjectRoutineBuilder

All Superinterfaces:

ConfigurableBuilder<ObjectRoutineBuilder>, LoaderConfigurableBuilder<LoaderObjectRoutineBuilder>, ObjectRoutineBuilder, ProxyConfigurableBuilder<ObjectRoutineBuilder>

public interface LoaderObjectRoutineBuilder
extends ObjectRoutineBuilder, LoaderConfigurableBuilder<LoaderObjectRoutineBuilder>

Interface defining a builder of routines wrapping an object methods.

The single methods can be accessed via reflection or the whole instance can be proxied through an interface.

Created by davide-maestroni on 04/06/2015.

Method Summary

Methods

Modifier and Type	Method and Description
<IN,OUT> LoaderRoutine<IN,OUT>	aliasMethod(String name) Returns a routine used to call the method whose identifying name is specified in an Alias annotation. Optional Priority, ShareGroup, Timeout, TimeoutAction, as well as CacheStrategy, ClashResolution, InputClashResolution, LoaderId and StaleTime method annotations will be honored. Note that such annotations will override any configuration set through the builder.
<TYPE> TYPE	buildProxy(Class<TYPE> itf) Returns a proxy object enabling asynchronous call of the target instance methods.
<TYPE> TYPE	buildProxy(ClassToken<TYPE> itf) Returns a proxy object enabling asynchronous call of the target instance methods.
InvocationConfiguration.Builder<? extends LoaderObjectRoutineBuilder>	invocations() Note that the configured asynchronous runner will be ignored.
<IN,OUT> LoaderRoutine<IN,OUT>	method(Method method) Returns a routine used to call the specified method.
<IN,OUT> LoaderRoutine<IN,OUT>	method(String name, Class<?>... parameterTypes) Returns a routine used to call the specified method.
ProxyConfiguration.Builder<? extends LoaderObjectRoutineBuilder>	proxies()

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

loaders

Method Detail

aliasMethod

@Nonnull
<IN,OUT> LoaderRoutine<IN,OUT> aliasMethod(@Nonnull
                                                 String name)

Returns a routine used to call the method whose identifying name is specified in an Alias annotation.
Optional Priority, ShareGroup, Timeout, TimeoutAction, as well as CacheStrategy, ClashResolution, InputClashResolution, LoaderId and StaleTime method annotations will be honored.
Note that such annotations will override any configuration set through the builder.

Specified by:

aliasMethod in interface ObjectRoutineBuilder

Type Parameters:

IN - the input data type.

OUT - the output data type.

Parameters:

name - the name specified in the annotation.

Returns:

the routine.

Throws:

IllegalArgumentException - if the specified method is not found.

buildProxy

@Nonnull
<TYPE> TYPE buildProxy(@Nonnull
                             ClassToken<TYPE> itf)

Returns a proxy object enabling asynchronous call of the target instance methods.

The routines used for calling the methods will honor the attributes specified in any optional Alias, Priority, ShareGroup, Timeout, TimeoutAction, as well as CacheStrategy, ClashResolution, InputClashResolution, LoaderId and StaleTime annotations.
Note that such annotations will override any configuration set through the builder.

Specified by:

buildProxy in interface ObjectRoutineBuilder

Type Parameters:

TYPE - the interface type.

Parameters:

itf - the token of the interface implemented by the return object.

Returns:

the proxy object.

Throws:

IllegalArgumentException - if the specified class token does not represent an interface.

buildProxy

@Nonnull
<TYPE> TYPE buildProxy(@Nonnull
                             Class<TYPE> itf)

Returns a proxy object enabling asynchronous call of the target instance methods.

The routines used for calling the methods will honor the attributes specified in any optional Alias, Priority, ShareGroup, Timeout, TimeoutAction, as well as CacheStrategy, ClashResolution, InputClashResolution, LoaderId and StaleTime annotations.
Note that such annotations will override any configuration set through the builder.

Specified by:

buildProxy in interface ObjectRoutineBuilder

Type Parameters:

TYPE - the interface type.

Parameters:

itf - the token of the interface implemented by the return object.

Returns:

the proxy object.

Throws:

IllegalArgumentException - if the specified class does not represent an interface.

method

@Nonnull
<IN,OUT> LoaderRoutine<IN,OUT> method(@Nonnull
                                            String name,
                                            @Nonnull
                                            Class<?>... parameterTypes)

Returns a routine used to call the specified method.

The method is searched via reflection ignoring a name specified in an Alias annotation. Though, optional Priority, ShareGroup, Timeout, TimeoutAction, as well as CacheStrategy, ClashResolution, InputClashResolution, LoaderId and StaleTime method annotations will be honored.
Note that such annotations will override any configuration set through the builder.

Specified by:

method in interface ObjectRoutineBuilder

Type Parameters:

IN - the input data type.

OUT - the output data type.

Parameters:

name - the method name.

parameterTypes - the method parameter types.

Returns:

the routine.

Throws:

IllegalArgumentException - if no matching method is found.

method

@Nonnull
<IN,OUT> LoaderRoutine<IN,OUT> method(@Nonnull
                                            Method method)

Returns a routine used to call the specified method.

The method is invoked ignoring a name specified in an Alias annotation. Though, optional Priority, ShareGroup, Timeout, TimeoutAction, as well as CacheStrategy, ClashResolution, InputClashResolution, LoaderId and StaleTime method annotations will be honored.
Note that such annotations will override any configuration set through the builder.

Specified by:

method in interface ObjectRoutineBuilder

Type Parameters:

IN - the input data type.

OUT - the output data type.

Parameters:

method - the method instance.

Returns:

the routine.

invocations

@Nonnull
InvocationConfiguration.Builder<? extends LoaderObjectRoutineBuilder> invocations()

Note that the configured asynchronous runner will be ignored.

Specified by:

invocations in interface ConfigurableBuilder<ObjectRoutineBuilder>

Returns:

the invocation configuration builder.

proxies

@Nonnull
ProxyConfiguration.Builder<? extends LoaderObjectRoutineBuilder> proxies()

Specified by:

proxies in interface ProxyConfigurableBuilder<ObjectRoutineBuilder>