Package com.google.common.reflect

Class Invokable<T,R>

java.lang.Object
java.lang.reflect.AccessibleObject
com.google.common.reflect.Invokable<T,R>
Type Parameters:
T - the type that owns this method or constructor.
R - the return type of (or supertype thereof) the method or the declaring type of the constructor.
All Implemented Interfaces:
AnnotatedElement, GenericDeclaration, Member
@Beta @Deprecated(since="2022-12-01") public abstract class Invokable<T,R> extends AccessibleObject implements GenericDeclaration
Deprecated.
The Google Guava Core Libraries are deprecated and will not be part of the AEM SDK after April 2023
Wrapper around either a Method or a Constructor. Convenience API is provided to make common reflective operation easier to deal with, such as isPublic(), getParameters() etc.

In addition to convenience methods, TypeToken.method(java.lang.reflect.Method) and TypeToken.constructor(java.lang.reflect.Constructor<?>) will resolve the type parameters of the method or constructor in the context of the owner type, which may be a subtype of the declaring class. For example: 

   
    Method getMethod = List.class.getMethod("get", int.class);
    Invokable<List<String>, ?> invokable = new TypeToken<List<String>>() {}.method(getMethod);
    assertEquals(TypeToken.of(String.class), invokable.getReturnType()); // Not Object.class!
    assertEquals(new TypeToken<List<String>>() {}, invokable.getOwnerType());
Since:
14.0

  • Method Details

    • from

      public static Invokable<?,Object> from(Method method)
      Deprecated.
      Returns Invokable of method.

    • from

      public static <T> Invokable<T,T> from(Constructor<T> constructor)
      Deprecated.
      Returns Invokable of constructor.

    • isOverridable

      public abstract boolean isOverridable()
      Deprecated.
      Returns true if this is an overridable method. Constructors, private, static or final methods, or methods declared by final classes are not overridable.

    • isVarArgs

      public abstract boolean isVarArgs()
      Deprecated.
      Returns true if this was declared to take a variable number of arguments.

    • invoke

      public final R invoke(@Nullable T receiver, Object... args) throws InvocationTargetException, IllegalAccessException
      Deprecated.
      Invokes with receiver as 'this' and args passed to the underlying method and returns the return value; or calls the underlying constructor with args and returns the constructed instance.
      Throws:
      IllegalAccessException - if this Constructor object enforces Java language access control and the underlying method or constructor is inaccessible.
      IllegalArgumentException - if the number of actual and formal parameters differ; if an unwrapping conversion for primitive arguments fails; or if, after possible unwrapping, a parameter value cannot be converted to the corresponding formal parameter type by a method invocation conversion.
      InvocationTargetException - if the underlying method or constructor throws an exception.

    • getReturnType

      public final TypeToken<? extends R> getReturnType()
      Deprecated.
      Returns the return type of this Invokable.

    • getParameters

      public final ImmutableList<Parameter> getParameters()
      Deprecated.
      Returns all declared parameters of this Invokable. Note that if this is a constructor of a non-static inner class, unlike Constructor.getParameterTypes(), the hidden this parameter of the enclosing class is excluded from the returned parameters.

    • getExceptionTypes

      public final ImmutableList<TypeToken<? extends Throwable>> getExceptionTypes()
      Deprecated.
      Returns all declared exception types of this Invokable.

    • returning

      public final <R1 extends R> Invokable<T,R1> returning(Class<R1> returnType)
      Deprecated.
      Explicitly specifies the return type of this Invokable. For example: 
         
   Method factoryMethod = Person.class.getMethod("create");
   Invokable<?, Person> factory = Invokable.of(getNameMethod).returning(Person.class);

    • returning

      public final <R1 extends R> Invokable<T,R1> returning(TypeToken<R1> returnType)
      Deprecated.
      Explicitly specifies the return type of this Invokable.

    • getDeclaringClass

      public final Class<? super T> getDeclaringClass()
      Deprecated.
      Specified by:
      getDeclaringClass in interface Member

    • getOwnerType

      public TypeToken<T> getOwnerType()
      Deprecated.
      Returns the type of T.

    • isAnnotationPresent

      public final boolean isAnnotationPresent(Class<? extends Annotation> annotationClass)
      Deprecated.
      Specified by:
      isAnnotationPresent in interface AnnotatedElement
      Overrides:
      isAnnotationPresent in class AccessibleObject

    • getAnnotation

      public final <A extends Annotation> A getAnnotation(Class<A> annotationClass)
      Deprecated.
      Specified by:
      getAnnotation in interface AnnotatedElement
      Overrides:
      getAnnotation in class AccessibleObject

    • getAnnotations

      public final Annotation[] getAnnotations()
      Deprecated.
      Specified by:
      getAnnotations in interface AnnotatedElement
      Overrides:
      getAnnotations in class AccessibleObject

    • getDeclaredAnnotations

      public final Annotation[] getDeclaredAnnotations()
      Deprecated.
      Specified by:
      getDeclaredAnnotations in interface AnnotatedElement
      Overrides:
      getDeclaredAnnotations in class AccessibleObject

    • setAccessible

      public final void setAccessible(boolean flag) throws SecurityException
      Deprecated.
      Overrides:
      setAccessible in class AccessibleObject
      Throws:
      SecurityException

    • isAccessible

      public final boolean isAccessible()
      Deprecated.
      Overrides:
      isAccessible in class AccessibleObject

    • getName

      public final String getName()
      Deprecated.
      Specified by:
      getName in interface Member

    • getModifiers

      public final int getModifiers()
      Deprecated.
      Specified by:
      getModifiers in interface Member

    • isSynthetic

      public final boolean isSynthetic()
      Deprecated.
      Specified by:
      isSynthetic in interface Member

    • isPublic

      public final boolean isPublic()
      Deprecated.
      Returns true if the element is public.

    • isProtected

      public final boolean isProtected()
      Deprecated.
      Returns true if the element is protected.

    • isPackagePrivate

      public final boolean isPackagePrivate()
      Deprecated.
      Returns true if the element is package-private.

    • isPrivate

      public final boolean isPrivate()
      Deprecated.
      Returns true if the element is private.

    • isStatic

      public final boolean isStatic()
      Deprecated.
      Returns true if the element is static.

    • isFinal

      public final boolean isFinal()
      Deprecated.
      Returns true if this method is final, per Modifier.isFinal(getModifiers()).

      Note that a method may still be effectively "final", or non-overridable when it has no final keyword. For example, it could be private, or it could be declared by a final class. To tell whether a method is overridable, use isOverridable().

    • isAbstract

      public final boolean isAbstract()
      Deprecated.
      Returns true if the method is abstract.

    • isNative

      public final boolean isNative()
      Deprecated.
      Returns true if the element is native.

    • isSynchronized

      public final boolean isSynchronized()
      Deprecated.
      Returns true if the method is synchronized.

    • equals

      public boolean equals(@Nullable Object obj)
      Deprecated.
      Overrides:
      equals in class Object

    • hashCode

      public int hashCode()
      Deprecated.
      Overrides:
      hashCode in class Object

    • toString

      public String toString()
      Deprecated.
      Overrides:
      toString in class Object