3 namespace Drupal\Component\Plugin\Mapper;
6 * Plugin mapper interface.
8 * Plugin mappers are responsible for mapping a plugin request to its
9 * implementation. For example, it might map a cache bin to a memcache bin.
11 * Mapper objects incorporate the best practices of retrieving configurations,
12 * type information, and factory instantiation.
14 interface MapperInterface {
17 * Gets a preconfigured instance of a plugin.
19 * @param array $options
20 * An array of options that can be used to determine a suitable plugin to
21 * instantiate and how to configure it.
23 * @return object|false
24 * A fully configured plugin instance. The interface of the plugin instance
25 * will depends on the plugin type. If no instance can be retrieved, FALSE
28 public function getInstance(array $options);