Chris@0: <?php
Chris@0: 
Chris@0: namespace Drupal\Component\Plugin;
Chris@0: 
Chris@0: use Drupal\Component\Plugin\Discovery\DiscoveryTrait;
Chris@0: use Drupal\Component\Plugin\Exception\PluginNotFoundException;
Chris@0: 
Chris@0: /**
Chris@0:  * Base class for plugin managers.
Chris@0:  */
Chris@0: abstract class PluginManagerBase implements PluginManagerInterface {
Chris@0: 
Chris@0:   use DiscoveryTrait;
Chris@0: 
Chris@0:   /**
Chris@0:    * The object that discovers plugins managed by this manager.
Chris@0:    *
Chris@0:    * @var \Drupal\Component\Plugin\Discovery\DiscoveryInterface
Chris@0:    */
Chris@0:   protected $discovery;
Chris@0: 
Chris@0:   /**
Chris@0:    * The object that instantiates plugins managed by this manager.
Chris@0:    *
Chris@0:    * @var \Drupal\Component\Plugin\Factory\FactoryInterface
Chris@0:    */
Chris@0:   protected $factory;
Chris@0: 
Chris@0:   /**
Chris@0:    * The object that returns the preconfigured plugin instance appropriate for a particular runtime condition.
Chris@0:    *
Chris@0:    * @var \Drupal\Component\Plugin\Mapper\MapperInterface
Chris@0:    */
Chris@0:   protected $mapper;
Chris@0: 
Chris@0:   /**
Chris@0:    * Gets the plugin discovery.
Chris@0:    *
Chris@0:    * @return \Drupal\Component\Plugin\Discovery\DiscoveryInterface
Chris@0:    */
Chris@0:   protected function getDiscovery() {
Chris@0:     return $this->discovery;
Chris@0:   }
Chris@0: 
Chris@0:   /**
Chris@0:    * Gets the plugin factory.
Chris@0:    *
Chris@0:    * @return \Drupal\Component\Plugin\Factory\FactoryInterface
Chris@0:    */
Chris@0:   protected function getFactory() {
Chris@0:     return $this->factory;
Chris@0:   }
Chris@0: 
Chris@0:   /**
Chris@0:    * {@inheritdoc}
Chris@0:    */
Chris@0:   public function getDefinition($plugin_id, $exception_on_invalid = TRUE) {
Chris@0:     return $this->getDiscovery()->getDefinition($plugin_id, $exception_on_invalid);
Chris@0:   }
Chris@0: 
Chris@0:   /**
Chris@0:    * {@inheritdoc}
Chris@0:    */
Chris@0:   public function getDefinitions() {
Chris@0:     return $this->getDiscovery()->getDefinitions();
Chris@0:   }
Chris@0: 
Chris@0:   /**
Chris@0:    * {@inheritdoc}
Chris@0:    */
Chris@0:   public function createInstance($plugin_id, array $configuration = []) {
Chris@0:     // If this PluginManager has fallback capabilities catch
Chris@0:     // PluginNotFoundExceptions.
Chris@0:     if ($this instanceof FallbackPluginManagerInterface) {
Chris@0:       try {
Chris@0:         return $this->getFactory()->createInstance($plugin_id, $configuration);
Chris@0:       }
Chris@0:       catch (PluginNotFoundException $e) {
Chris@0:         $fallback_id = $this->getFallbackPluginId($plugin_id, $configuration);
Chris@0:         return $this->getFactory()->createInstance($fallback_id, $configuration);
Chris@0:       }
Chris@0:     }
Chris@0:     else {
Chris@0:       return $this->getFactory()->createInstance($plugin_id, $configuration);
Chris@0:     }
Chris@0:   }
Chris@0: 
Chris@0:   /**
Chris@0:    * {@inheritdoc}
Chris@0:    */
Chris@0:   public function getInstance(array $options) {
Chris@0:     return $this->mapper->getInstance($options);
Chris@0:   }
Chris@0: 
Chris@0: }