ExecutableInstantiator class abstract interface

Provides a high-level, reflection-based utility to dynamically instantiate classes and invoke methods on objects at runtime, while automatically resolving arguments and selecting the most appropriate executable.

The ExecutableInstantiator is designed for frameworks or libraries that require dynamic execution of constructors or methods without static knowledge of their signatures. It leverages:

• Executable selectors to choose the best matching constructor or method
• Argument resolvers to automatically provide values for positional and named parameters

Core Responsibilities

1. Dynamically instantiate classes discovered at runtime
2. Dynamically invoke instance methods on objects
3. Automatically select the best executable using configurable rules
4. Auto-resolve constructor and method parameters based on type bindings or predicates
5. Provide fluent API for chaining selectors and argument resolvers

Use Cases

• Dynamic plugin or module instantiation
• Runtime method invocation with dependency injection support
• Reflection-based framework utilities
• Dynamic wiring of services or components discovered at runtime

Example

final instantiator = ExecutableInstantiator.of(MyClass)
  .withSelector(ExecutableSelector().and(Class<ApplicationContext>()))
  .withArgumentResolver(ExecutableArgumentResolver().and(Class<ApplicationContext>(), context);

// Create a new instance
final instance = instantiator.newInstance<MyClass>();

// Invoke a method dynamically
final result = instantiator.invoke<String>(instance, "doWork");