1. class
  2. Drupal
  3. \
  4. migrate
  5. \
  6. Plugin
  7. \
  8. Discovery
  9. \
  10. AnnotatedClassDiscoveryAutomatedProviders

AnnotatedClassDiscoveryAutomatedProviders

class AnnotatedClassDiscoveryAutomatedProviders extends AnnotatedClassDiscovery (View source)

internal  This is a temporary solution to the fact that migration source plugins have more than one provider. This functionality will be moved to core in https://www.drupal.org/node/2786355.
 

Determines providers based on a class's and its parent's namespaces.

Traits

DiscoveryTrait

Properties

protected string[] $pluginNamespaces

The namespaces within which to find plugin classes.

 from  AnnotatedClassDiscovery
protected string $pluginDefinitionAnnotationName

The name of the annotation that contains the plugin definition.

 from  AnnotatedClassDiscovery
protected Reader $annotationReader

The doctrine annotation reader.

 from  AnnotatedClassDiscovery
protected string[] $annotationNamespaces

Additional namespaces to be scanned for annotation classes.

 from  AnnotatedClassDiscovery
protected FileCacheInterface $fileCache

The file cache object.

 from  AnnotatedClassDiscovery
protected string $directorySuffix

A suffix to append to each PSR-4 directory associated with a base namespace, to form the directories where plugins are found.

 from  AnnotatedClassDiscovery
protected string $namespaceSuffix

A suffix to append to each base namespace, to obtain the namespaces where plugins are found.

 from  AnnotatedClassDiscovery
protected Traversable $rootNamespacesIterator

A list of base namespaces with their PSR-4 directories.

 from  AnnotatedClassDiscovery
protected ClassFinderInterface $finder

A utility object that can use active autoloaders to find files for classes.

Methods

getDefinitions()

{@inheritdoc}

getDefinition($plugin_id, $exception_on_invalid = TRUE)

{@inheritdoc}

from  DiscoveryTrait
array|null
doGetDefinition(array $definitions, string $plugin_id, bool $exception_on_invalid)

Gets a specific plugin definition.

from  DiscoveryTrait
hasDefinition($plugin_id)

{@inheritdoc}

from  DiscoveryTrait
__construct(string $subdir, Traversable $root_namespaces, string $plugin_definition_annotation_name = 'Drupal\\Component\\Annotation\\Plugin', array $annotation_namespaces = [])

Constructs an AnnotatedClassDiscoveryAutomatedProviders object.

Reader
getAnnotationReader()

Gets the used doctrine annotation reader.

from  AnnotatedClassDiscovery
prepareAnnotationDefinition(AnnotationInterface $annotation, string $class, StaticReflectionParser $parser = NULL)

Prepares the annotation definition.

string[]
getPluginNamespaces()

Gets an array of PSR-4 namespaces to search for plugin classes.

from  AnnotatedClassDiscovery
string|null
getProviderFromNamespace(string $namespace)

Extracts the provider name from a Drupal namespace.

from  AnnotatedClassDiscovery

Details

at line 74
getDefinitions()

{@inheritdoc}

in DiscoveryTrait at line 20
getDefinition($plugin_id, $exception_on_invalid = TRUE)

{@inheritdoc}

Parameters

$plugin_id
$exception_on_invalid

in DiscoveryTrait at line 43
protected array|null doGetDefinition(array $definitions, string $plugin_id, bool $exception_on_invalid)

Gets a specific plugin definition.

Parameters

array $definitions

An array of the available plugin definitions.
string $plugin_id

A plugin id.
bool $exception_on_invalid

If TRUE, an invalid plugin ID will cause an exception to be thrown; if FALSE, NULL will be returned.

Return Value

array|null

A plugin definition, or NULL if the plugin ID is invalid and $exception_on_invalid is TRUE.

Exceptions

PluginNotFoundException

in DiscoveryTrait at line 59
hasDefinition($plugin_id)

{@inheritdoc}

Parameters

$plugin_id

at line 46
__construct(string $subdir, Traversable $root_namespaces, string $plugin_definition_annotation_name = 'Drupal\\Component\\Annotation\\Plugin', array $annotation_namespaces = [])

Constructs an AnnotatedClassDiscoveryAutomatedProviders object.

Parameters

string $subdir

Either the plugin's subdirectory, for example 'Plugin/views/filter', or empty string if plugins are located at the top level of the namespace.
Traversable $root_namespaces

An object that implements \Traversable which contains the root paths keyed by the corresponding namespace to look for plugin implementations. If $subdir is not an empty string, it will be appended to each namespace.
string $plugin_definition_annotation_name

(optional) The name of the annotation that contains the plugin definition. Defaults to 'Drupal\Component\Annotation\Plugin'.
array $annotation_namespaces

(optional) Additional namespaces to be scanned for annotation classes.

in AnnotatedClassDiscovery at line 70
protected Reader getAnnotationReader()

Gets the used doctrine annotation reader.

Return Value

Reader

The annotation reader.

at line 54
protected prepareAnnotationDefinition(AnnotationInterface $annotation, string $class, StaticReflectionParser $parser = NULL)

Prepares the annotation definition.

Parameters

AnnotationInterface $annotation

The annotation derived from the plugin.
string $class

The class used for the plugin.
StaticReflectionParser $parser

in AnnotatedClassDiscovery at line 114
protected string[] getPluginNamespaces()

Gets an array of PSR-4 namespaces to search for plugin classes.

Return Value

string[]

in AnnotatedClassDiscovery at line 101
protected string|null getProviderFromNamespace(string $namespace)

Extracts the provider name from a Drupal namespace.

Parameters

string $namespace

The namespace to extract the provider from.

Return Value

string|null

The matching provider name, or NULL otherwise.