Package space.arim.dazzleconf.reflect

Interface MethodMirror

@API(status=MAINTAINED) public interface MethodMirror
Service for traversing a type hierarchy and getting and invoking methods on types in that hierarchy.

Usage

Usage is only valid with interface types. A MethodMirror can traverse the declared methods of an interface yielding MethodId for each of them, and it can call those methods in a possibly-efficient manner. It should never return bridge or synthetic methods.

Implementing

Implementing this interface correctly requires a number of considerations. It is recommended to check the library source code as a reference implementation.

  • Nested Class Summary

    Nested Classes
    Modifier and Type
    Interface
    Description
    static interface 
    MethodMirror.Invoker
    A wrapper for an instance whose methods can be called, as long as those methods conform to a certain enclosing type.
    static interface 
    MethodMirror.TypeWalker
    Controller for accessing the reflected methods of a given type

  • Method Summary

    Modifier and Type
    Method
    Description
    @NonNull MethodMirror.Invoker
    makeInvoker(@NonNull Object receiver, @NonNull Class<?> enclosingType)
    Creates an invoker that allows calling methods on the given receiver.
    @NonNull MethodMirror.TypeWalker
    typeWalker(@NonNull ReifiedType.Annotated reifiedType)
    Makes a type walker for the given type.

  • Method Details

    • typeWalker

      @NonNull MethodMirror.TypeWalker typeWalker(@NonNull ReifiedType.Annotated reifiedType)
      Makes a type walker for the given type.

      The type walker allows the caller to control movement and selection of super classes insofar as the control flow suits them.

      Parameters:
      reifiedType - the reified type being walked
      Returns:
      the type walker

    • makeInvoker

      @NonNull MethodMirror.Invoker makeInvoker(@NonNull Object receiver, @NonNull Class<?> enclosingType)
      Creates an invoker that allows calling methods on the given receiver.

      Usage of the invoker is restricted to methods declared in the given enclosing type. The caller upholds the guarantee that no other methods (such as inherited methods) will be called.

      Parameters:
      receiver - the receiver object, on which the methods are called
      enclosingType - the enclosing type
      Returns:
      an invoker for the receiver