Your IP : 216.73.217.95
<?php
/*
* This file is part of the TYPO3 CMS project.
*
* It is free software; you can redistribute it and/or modify it under
* the terms of the GNU General Public License, either version 2
* of the License, or any later version.
*
* For the full copyright and license information, please read the
* LICENSE.txt file that was distributed with this source code.
*
* The TYPO3 project - inspiring people to share!
*/
namespace TYPO3\CMS\Core\Resource\Index;
use TYPO3\CMS\Core\SingletonInterface;
use TYPO3\CMS\Core\Utility\GeneralUtility;
/**
* Registry for MetaData extraction Services
*/
class ExtractorRegistry implements SingletonInterface
{
/**
* Registered ClassNames
* @var array
*/
protected $extractors = [];
/**
* Instance Cache for Extractors
*
* @var ExtractorInterface[]
*/
protected $instances;
/**
* Allows to register MetaData extraction to the FAL Indexer
*
* @param string $className
* @throws \InvalidArgumentException
*/
public function registerExtractionService($className)
{
if (!class_exists($className)) {
throw new \InvalidArgumentException('The class "' . $className . '" you are registering is not available', 1422705270);
}
if (!in_array(ExtractorInterface::class, class_implements($className) ?: [])) {
throw new \InvalidArgumentException('The extractor needs to implement the ExtractorInterface', 1422705271);
}
$this->extractors[] = $className;
}
/**
* Get all registered extractors
*
* @return ExtractorInterface[]
*/
public function getExtractors()
{
if ($this->instances === null) {
$this->instances = [];
foreach ($this->extractors as $className) {
$object = $this->createExtractorInstance($className);
$this->instances[] = $object;
}
if (count($this->instances) > 1) {
usort($this->instances, [$this, 'compareExtractorPriority']);
}
}
return $this->instances;
}
/**
* Get Extractors which work for a special driver
*
* @param string $driverType
* @return ExtractorInterface[]
*/
public function getExtractorsWithDriverSupport($driverType)
{
return array_filter(
$this->getExtractors(),
function (ExtractorInterface $extractor) use ($driverType) {
return empty($extractor->getDriverRestrictions())
|| in_array($driverType, $extractor->getDriverRestrictions(), true);
}
);
}
/**
* Compare the priority of two Extractor classes.
* Is used for sorting array of Extractor instances by priority.
* We want the result to be ordered from high to low so a higher
* priority comes before a lower.
*
* @return int -1 a > b, 0 a == b, 1 a < b
*/
protected function compareExtractorPriority(ExtractorInterface $extractorA, ExtractorInterface $extractorB)
{
return $extractorB->getExecutionPriority() - $extractorA->getExecutionPriority();
}
/**
* Create an instance of a Metadata Extractor
*
* @param string $className
* @return ExtractorInterface
*/
protected function createExtractorInstance($className)
{
return GeneralUtility::makeInstance($className);
}
}