Through this annotation it is possible to indicate the invocation mode of the routine wrapping
the target object method.
The only use case in which this annotation is useful, is when an interface is used as a proxy
of another class methods. The annotation will indicate the type of invocation to be applied to
the wrapping routine.
Note that, unless the
Invoke.InvocationMode.PARALLEL is specified, to each call to a
method of the proxy interface will correspond a single invocation of the wrapping routine.
In case this annotation is absent, the asynchronous invocation mode will be employed.
This annotation is used to decorate methods that are to be invoked in an asynchronous way.
Note that the piece of code inside such methods will be automatically protected so to avoid
concurrency issues. Though, other parts of the code inside the same class will be not.
In order to prevent unexpected behaviors, it is advisable to avoid using the same class fields
(unless immutable) in protected and non-protected code, or to call synchronous methods through
routines as well.
Remember also that, in order for the annotation to properly work at run time, you will need to
add the following rules to your Proguard file (if employing it for shrinking or obfuscation):
-keepattributes RuntimeVisibleAnnotations
-keepclassmembers class ** {
@com.github.dm.jrt.annotation.Invoke *;
}
Created by davide-maestroni on 09/27/2015.