retrofit2

Class Invocation

java.lang.Object

retrofit2.Invocation

public final class Invocation
extends java.lang.Object

A single invocation of a Retrofit service interface method. This class captures both the method that was called and the arguments to the method.

Retrofit automatically adds an invocation to each OkHttp request as a tag. You can retrieve the invocation in an OkHttp interceptor for metrics and monitoring.

 class InvocationLogger implements Interceptor {
   @Override public Response intercept(Chain chain) throws IOException {
     Request request = chain.request();
     Invocation invocation = request.tag(Invocation.class);
     if (invocation != null) {
       System.out.printf("%s.%s %s%n",
           invocation.service().getSimpleName(),
           invocation.method().getName(),
           invocation.arguments());
     }
     return chain.proceed(request);
   }
 }
 

Note: use caution when examining an invocation's arguments. Although the arguments list is unmodifiable, the arguments themselves may be mutable. They may also be unsafe for concurrent access. For best results declare Retrofit service interfaces using only immutable types for parameters!

Method Summary

Modifier and Type	Method and Description
java.util.List<?>	arguments()
java.lang.Object	instance() The instance of service.
java.lang.reflect.Method	method()
static <T> Invocation	of(java.lang.Class<T> service, T instance, java.lang.reflect.Method method, java.util.List<?> arguments)
static Invocation	of(java.lang.reflect.Method method, java.util.List<?> arguments) Deprecated.
java.lang.Class<?>	service()
java.lang.String	toString()

Methods inherited from class java.lang.Object

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

Method Detail

of

public static <T> Invocation of(java.lang.Class<T> service,
                                T instance,
                                java.lang.reflect.Method method,
                                java.util.List<?> arguments)

of

@Deprecated
public static Invocation of(java.lang.reflect.Method method,
                                        java.util.List<?> arguments)

Deprecated.

service

public java.lang.Class<?> service()

instance

@Nullable
public java.lang.Object instance()

The instance of service.

This will never be null when created by Retrofit. Null will only be returned when created by of(Method, List).

method

public java.lang.reflect.Method method()

arguments

public java.util.List<?> arguments()

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object