class PrivateFileSchemeHandler in Acquia Content Hub 8.2
File scheme handler for private files.
Plugin annotation
@FileSchemeHandler(
id = "private",
label = @Translation("Private file handler")
)
Hierarchy
- class \Drupal\Component\Plugin\PluginBase implements DerivativeInspectionInterface, PluginInspectionInterface
- class \Drupal\Core\Plugin\PluginBase uses DependencySerializationTrait, MessengerTrait, StringTranslationTrait
- class \Drupal\acquia_contenthub\Plugin\FileSchemeHandler\PrivateFileSchemeHandler implements FileSchemeHandlerInterface, ContainerFactoryPluginInterface
- class \Drupal\Core\Plugin\PluginBase uses DependencySerializationTrait, MessengerTrait, StringTranslationTrait
Expanded class hierarchy of PrivateFileSchemeHandler
File
- src/
Plugin/ FileSchemeHandler/ PrivateFileSchemeHandler.php, line 26
Namespace
Drupal\acquia_contenthub\Plugin\FileSchemeHandlerView source
class PrivateFileSchemeHandler extends PluginBase implements FileSchemeHandlerInterface, ContainerFactoryPluginInterface {
/**
* The file system object.
*
* @var \Drupal\Core\File\FileSystemInterface
*/
protected $fileSystem;
/**
* Common actions for Content Hub.
*
* @var \Drupal\acquia_contenthub\ContentHubCommonActions
*/
private $contentHubCommonActions;
/**
* PrivateFileSchemeHandler constructor.
*
* @param array $configuration
* The plugin configuration.
* @param string $plugin_id
* The plugin id.
* @param mixed $plugin_definition
* The definition.
* @param \Drupal\Core\File\FileSystemInterface $file_system
* The file system.
* @param \Drupal\acquia_contenthub\ContentHubCommonActions $common_actions
* Content Hub Common Actions.
*/
public function __construct(array $configuration, string $plugin_id, $plugin_definition, FileSystemInterface $file_system, ContentHubCommonActions $common_actions) {
parent::__construct($configuration, $plugin_id, $plugin_definition);
$this->fileSystem = $file_system;
$this->contentHubCommonActions = $common_actions;
}
/**
* {@inheritdoc}
*/
public static function create(ContainerInterface $container, array $configuration, $plugin_id, $plugin_definition) {
return new static($configuration, $plugin_id, $plugin_definition, $container
->get('file_system'), $container
->get('acquia_contenthub_common_actions'));
}
/**
* {@inheritdoc}
*
* @throws \Exception
*/
public function addAttributes(CDFObject $object, FileInterface $file) {
$uri = $file
->getFileUri();
$webhook_url = Url::fromUri('internal:/acquia-contenthub/webhook', [
'absolute' => TRUE,
])
->toString();
$object
->addAttribute('file_scheme', CDFAttribute::TYPE_STRING, 'private');
$object
->addAttribute('file_location', CDFAttribute::TYPE_STRING, $webhook_url);
$object
->addAttribute('file_uri', CDFAttribute::TYPE_STRING, $uri);
}
/**
* {@inheritdoc}
*/
public function getFile(CDFObject $object) {
if ($object
->getAttribute('file_location') && $object
->getAttribute('file_uri') && $object
->getUuid()) {
$url = $object
->getAttribute('file_location')
->getValue()[LanguageInterface::LANGCODE_NOT_SPECIFIED];
$uri = $object
->getAttribute('file_uri')
->getValue()[LanguageInterface::LANGCODE_NOT_SPECIFIED];
$uuid = $object
->getUuid();
$dirname = $this->fileSystem
->dirname($uri);
if ($this->fileSystem
->prepareDirectory($dirname, FileSystemInterface::CREATE_DIRECTORY)) {
try {
$contents = $this->contentHubCommonActions
->requestRemoteEntity($url, $uri, $uuid, 'private');
} catch (\Exception $exception) {
\Drupal::messenger()
->addError(t('Unable to request file.'));
}
return $this
->saveData($contents, $uri, FileSystemInterface::EXISTS_REPLACE);
}
}
return FALSE;
}
/**
* Save the data to file system.
*
* @param string $data
* Data to save.
* @param string $destination
* Destination of data.
* @param int $replace
* Replacement option.
*
* @return bool|string
* String saved or bool if failed.
*/
private function saveData(string $data, string $destination, int $replace) {
try {
return $this->fileSystem
->saveData($data, $destination, $replace);
} catch (FileWriteException $e) {
\Drupal::messenger()
->addError(t('The file could not be created.'));
return FALSE;
} catch (FileException $e) {
return FALSE;
}
}
}
Members
Name | Modifiers | Type | Description | Overrides |
---|---|---|---|---|
DependencySerializationTrait:: |
protected | property | An array of entity type IDs keyed by the property name of their storages. | |
DependencySerializationTrait:: |
protected | property | An array of service IDs keyed by property name used for serialization. | |
DependencySerializationTrait:: |
public | function | 1 | |
DependencySerializationTrait:: |
public | function | 2 | |
MessengerTrait:: |
protected | property | The messenger. | 29 |
MessengerTrait:: |
public | function | Gets the messenger. | 29 |
MessengerTrait:: |
public | function | Sets the messenger. | |
PluginBase:: |
protected | property | Configuration information passed into the plugin. | 1 |
PluginBase:: |
protected | property | The plugin implementation definition. | 1 |
PluginBase:: |
protected | property | The plugin_id. | |
PluginBase:: |
constant | A string which is used to separate base plugin IDs from the derivative ID. | ||
PluginBase:: |
public | function |
Gets the base_plugin_id of the plugin instance. Overrides DerivativeInspectionInterface:: |
|
PluginBase:: |
public | function |
Gets the derivative_id of the plugin instance. Overrides DerivativeInspectionInterface:: |
|
PluginBase:: |
public | function |
Gets the definition of the plugin implementation. Overrides PluginInspectionInterface:: |
3 |
PluginBase:: |
public | function |
Gets the plugin_id of the plugin instance. Overrides PluginInspectionInterface:: |
|
PluginBase:: |
public | function | Determines if the plugin is configurable. | |
PrivateFileSchemeHandler:: |
private | property | Common actions for Content Hub. | |
PrivateFileSchemeHandler:: |
protected | property | The file system object. | |
PrivateFileSchemeHandler:: |
public | function |
Overrides FileSchemeHandlerInterface:: |
|
PrivateFileSchemeHandler:: |
public static | function |
Creates an instance of the plugin. Overrides ContainerFactoryPluginInterface:: |
|
PrivateFileSchemeHandler:: |
public | function |
Makes file available to Drupal through the correct stream wrapper. Overrides FileSchemeHandlerInterface:: |
|
PrivateFileSchemeHandler:: |
private | function | Save the data to file system. | |
PrivateFileSchemeHandler:: |
public | function |
PrivateFileSchemeHandler constructor. Overrides PluginBase:: |
|
StringTranslationTrait:: |
protected | property | The string translation service. | 1 |
StringTranslationTrait:: |
protected | function | Formats a string containing a count of items. | |
StringTranslationTrait:: |
protected | function | Returns the number of plurals supported by a given language. | |
StringTranslationTrait:: |
protected | function | Gets the string translation service. | |
StringTranslationTrait:: |
public | function | Sets the string translation service to use. | 2 |
StringTranslationTrait:: |
protected | function | Translates a string to the current language or to a given language. |