class FileUrlFieldItemList in File URL 2.0.x
Same name and namespace in other branches
- 8 src/Plugin/Field/FieldType/FileUrlFieldItemList.php \Drupal\file_url\Plugin\Field\FieldType\FileUrlFieldItemList
Represents a configurable entity file URL field.
Hierarchy
- class \Drupal\Core\TypedData\TypedData implements PluginInspectionInterface, TypedDataInterface uses DependencySerializationTrait, StringTranslationTrait, TypedDataTrait
- class \Drupal\Core\TypedData\Plugin\DataType\ItemList implements \Drupal\Core\TypedData\Plugin\DataType\IteratorAggregate, ListInterface
- class \Drupal\Core\Field\FieldItemList implements FieldItemListInterface
- class \Drupal\Core\Field\EntityReferenceFieldItemList implements EntityReferenceFieldItemListInterface
- class \Drupal\file_url\Plugin\Field\FieldType\FileUrlFieldItemList
- class \Drupal\Core\Field\EntityReferenceFieldItemList implements EntityReferenceFieldItemListInterface
- class \Drupal\Core\Field\FieldItemList implements FieldItemListInterface
- class \Drupal\Core\TypedData\Plugin\DataType\ItemList implements \Drupal\Core\TypedData\Plugin\DataType\IteratorAggregate, ListInterface
Expanded class hierarchy of FileUrlFieldItemList
1 file declares its use of FileUrlFieldItemList
- FileUrlFieldItemListTest.php in tests/
src/ Kernel/ FileUrlFieldItemListTest.php
File
- src/
Plugin/ Field/ FieldType/ FileUrlFieldItemList.php, line 13
Namespace
Drupal\file_url\Plugin\Field\FieldTypeView source
class FileUrlFieldItemList extends EntityReferenceFieldItemList {
/**
* {@inheritdoc}
*/
public function getConstraints() {
$constraints = [];
$cardinality = $this
->getFieldDefinition()
->getFieldStorageDefinition()
->getCardinality();
if ($cardinality != FieldStorageDefinitionInterface::CARDINALITY_UNLIMITED) {
$constraints[] = $this
->getTypedDataManager()
->getValidationConstraintManager()
->create('Count', [
'max' => $cardinality,
'maxMessage' => t('%name: this field cannot hold more than @count values.', [
'%name' => $this
->getFieldDefinition()
->getLabel(),
'@count' => $cardinality,
]),
]);
}
// @todo Add a constraint to file URI references.
return $constraints;
}
/**
* {@inheritdoc}
*/
public function defaultValuesForm(array &$form, FormStateInterface $form_state) {
}
/**
* {@inheritdoc}
*/
public function postSave($update) {
/** @var \Drupal\file_url\FileUrlHandler $file_handler */
$file_handler = \Drupal::service('file_url.handler');
$entity = $this
->getEntity();
if (!$update) {
// Add a new usage for newly uploaded files.
foreach ($this
->referencedEntities() as $file) {
if (!$file_handler
->isRemote($file)) {
\Drupal::service('file.usage')
->add($file, 'file', $entity
->getEntityTypeId(), $entity
->id());
}
}
}
else {
// Get current target file entities and file IDs.
$files = $this
->referencedEntities();
$ids = [];
/** @var \Drupal\file\FileInterface $file */
foreach ($files as $file) {
$ids[] = $file
->id();
}
// On new revisions, all files are considered to be a new usage and no
// deletion of previous file usages are necessary.
if (!empty($entity->original) && $entity
->getRevisionId() != $entity->original
->getRevisionId()) {
foreach ($files as $file) {
if (!$file_handler
->isRemote($file)) {
\Drupal::service('file.usage')
->add($file, 'file', $entity
->getEntityTypeId(), $entity
->id());
}
}
return;
}
// Get the file IDs attached to the field before this update.
$field_name = $this
->getFieldDefinition()
->getName();
$original_ids = [];
$langcode = $this
->getLangcode();
$original = $entity->original;
if ($original
->hasTranslation($langcode)) {
$original_items = $original
->getTranslation($langcode)->{$field_name};
foreach ($original_items as $item) {
$file = $file_handler::urlToFile($item->target_id);
if (!$file_handler
->isRemote($file)) {
$original_ids[] = $file
->id();
}
}
}
// Decrement file usage by 1 for files that were removed from the field.
$removed_ids = array_filter(array_diff($original_ids, $ids));
$removed_files = \Drupal::service('entity_type.manager')
->getStorage('file')
->loadMultiple($removed_ids);
foreach ($removed_files as $file) {
\Drupal::service('file.usage')
->delete($file, 'file', $entity
->getEntityTypeId(), $entity
->id());
}
// Add new usage entries for newly added files.
foreach ($files as $file) {
if (!in_array($file
->id(), $original_ids) && !$file_handler
->isRemote($file)) {
\Drupal::service('file.usage')
->add($file, 'file', $entity
->getEntityTypeId(), $entity
->id());
}
}
}
}
/**
* {@inheritdoc}
*/
public function referencedEntities() {
/** @var \Drupal\file_url\FileUrlHandler $file_handler */
$file_handler = \Drupal::service('file_url.handler');
if (empty($this->list)) {
return [];
}
// Collect the IDs of existing entities to load, and directly grab the
// "autocreate" entities that are already populated in $item->entity.
$target_entities = [];
foreach ($this->list as $delta => $item) {
if ($item->target_id !== NULL) {
$file = $file_handler::urlToFile($item->target_id);
$target_entities[$delta] = $file;
}
elseif ($item
->hasNewEntity()) {
$target_entities[$delta] = $item->entity;
}
}
// Ensure the returned array is ordered by deltas.
ksort($target_entities);
return $target_entities;
}
/**
* {@inheritdoc}
*/
public function delete() {
parent::delete();
$entity = $this
->getEntity();
// If a translation is deleted only decrement the file usage by one. If the
// default translation is deleted remove all file usages within this entity.
$count = $entity
->isDefaultTranslation() ? 0 : 1;
foreach ($this
->referencedEntities() as $file) {
if (!FileUrlHandler::isRemote($file)) {
\Drupal::service('file.usage')
->delete($file, 'file', $entity
->getEntityTypeId(), $entity
->id(), $count);
}
}
}
/**
* {@inheritdoc}
*/
public function deleteRevision() {
parent::deleteRevision();
$entity = $this
->getEntity();
// Decrement the file usage by 1.
foreach ($this
->referencedEntities() as $file) {
if (!FileUrlHandler::isRemote($file)) {
\Drupal::service('file.usage')
->delete($file, 'file', $entity
->getEntityTypeId(), $entity
->id());
}
}
}
}
Members
Name | Modifiers | Type | Description | Overrides |
---|---|---|---|---|
DependencySerializationTrait:: |
protected | property | ||
DependencySerializationTrait:: |
protected | property | ||
DependencySerializationTrait:: |
public | function | 2 | |
DependencySerializationTrait:: |
public | function | 2 | |
EntityReferenceFieldItemList:: |
public | function |
Processes the submitted default value. Overrides FieldItemList:: |
|
EntityReferenceFieldItemList:: |
public static | function |
Processes the default value before being applied. Overrides FieldItemList:: |
|
FieldItemList:: |
protected | property | The langcode of the field values held in the object. | |
FieldItemList:: |
protected | property |
Numerically indexed array of field items. Overrides ItemList:: |
1 |
FieldItemList:: |
public | function |
Checks data value access. Overrides AccessibleInterface:: |
1 |
FieldItemList:: |
public | function |
Applies the default value. Overrides TypedData:: |
|
FieldItemList:: |
protected | function |
Helper for creating a list item object. Overrides ItemList:: |
|
FieldItemList:: |
public | function |
Contains the default access logic of this field. Overrides FieldItemListInterface:: |
3 |
FieldItemList:: |
public | function |
Validates the submitted default value. Overrides FieldItemListInterface:: |
1 |
FieldItemList:: |
protected | function | Returns the widget object used in default value form. | |
FieldItemList:: |
protected | function | Calls a method on each FieldItem. | |
FieldItemList:: |
public | function |
Determines equality to another object implementing FieldItemListInterface. Overrides FieldItemListInterface:: |
2 |
FieldItemList:: |
public | function |
Filters out empty field items and re-numbers the item deltas. Overrides FieldItemListInterface:: |
|
FieldItemList:: |
public | function |
Populates a specified number of field items with valid sample data. Overrides FieldItemListInterface:: |
1 |
FieldItemList:: |
public | function |
Gets the entity that field belongs to. Overrides FieldItemListInterface:: |
1 |
FieldItemList:: |
public | function |
Gets the field definition. Overrides FieldItemListInterface:: |
|
FieldItemList:: |
public | function |
Gets the langcode of the field values held in the object. Overrides FieldItemListInterface:: |
|
FieldItemList:: |
public | function |
Returns the value of a given field setting. Overrides FieldItemListInterface:: |
|
FieldItemList:: |
public | function |
Returns the array of field settings. Overrides FieldItemListInterface:: |
|
FieldItemList:: |
public | function |
Determines whether the field has relevant changes. Overrides FieldItemListInterface:: |
1 |
FieldItemList:: |
public | function |
Defines custom presave behavior for field values. Overrides FieldItemListInterface:: |
1 |
FieldItemList:: |
public | function |
Sets the langcode of the field values held in the object. Overrides FieldItemListInterface:: |
|
FieldItemList:: |
public | function |
Sets the data value. Overrides ItemList:: |
|
FieldItemList:: |
public | function |
Returns a renderable array for the field items. Overrides FieldItemListInterface:: |
|
FieldItemList:: |
public | function |
Magic method: Gets a property value of to the first field item. Overrides FieldItemListInterface:: |
|
FieldItemList:: |
public | function |
Magic method: Determines whether a property of the first field item is set. Overrides FieldItemListInterface:: |
|
FieldItemList:: |
public | function |
Magic method: Sets a property value of the first field item. Overrides FieldItemListInterface:: |
|
FieldItemList:: |
public | function |
Magic method: Unsets a property of the first field item. Overrides FieldItemListInterface:: |
|
FileUrlFieldItemList:: |
public | function |
Returns a form for the default value input. Overrides FieldItemList:: |
|
FileUrlFieldItemList:: |
public | function |
Defines custom delete behavior for field values. Overrides FieldItemList:: |
|
FileUrlFieldItemList:: |
public | function |
Defines custom revision delete behavior for field values. Overrides FieldItemList:: |
|
FileUrlFieldItemList:: |
public | function |
Gets a list of validation constraints. Overrides EntityReferenceFieldItemList:: |
|
FileUrlFieldItemList:: |
public | function |
Defines custom post-save behavior for field values. Overrides FieldItemList:: |
|
FileUrlFieldItemList:: |
public | function |
Gets the entities referenced by this field, preserving field item deltas. Overrides EntityReferenceFieldItemList:: |
|
ItemList:: |
public | function |
Appends a new item to the list. Overrides ListInterface:: |
|
ItemList:: |
public | function | ||
ItemList:: |
public | function |
Filters the items in the list using a custom callback. Overrides ListInterface:: |
|
ItemList:: |
public | function |
Returns the first item in this list. Overrides ListInterface:: |
|
ItemList:: |
public | function |
Returns the item at the specified position in this list. Overrides ListInterface:: |
2 |
ItemList:: |
public | function |
Gets the definition of a contained item. Overrides ListInterface:: |
|
ItemList:: |
public | function | ||
ItemList:: |
public | function |
Returns a string representation of the data. Overrides TypedData:: |
|
ItemList:: |
public | function |
Gets the data value. Overrides TypedData:: |
|
ItemList:: |
public | function |
Determines whether the list contains any non-empty items. Overrides ListInterface:: |
|
ItemList:: |
public | function | 1 | |
ItemList:: |
public | function | ||
ItemList:: |
public | function | ||
ItemList:: |
public | function | ||
ItemList:: |
public | function |
React to changes to a child property or item. Overrides TraversableTypedDataInterface:: |
1 |
ItemList:: |
protected | function | Renumbers the items in the list. | |
ItemList:: |
public | function |
Removes the item at the specified position. Overrides ListInterface:: |
|
ItemList:: |
public | function |
Sets the value of the item at a given position in the list. Overrides ListInterface:: |
|
ItemList:: |
public | function | Magic method: Implements a deep clone. | |
StringTranslationTrait:: |
protected | property | The string translation service. | 4 |
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. | |
TypedData:: |
protected | property | The data definition. | 1 |
TypedData:: |
protected | property | The property name. | |
TypedData:: |
protected | property | The parent typed data object. | |
TypedData:: |
public static | function |
Constructs a TypedData object given its definition and context. Overrides TypedDataInterface:: |
|
TypedData:: |
public | function |
Gets the data definition. Overrides TypedDataInterface:: |
|
TypedData:: |
public | function |
Returns the name of a property or item. Overrides TypedDataInterface:: |
|
TypedData:: |
public | function |
Returns the parent data structure; i.e. either complex data or a list. Overrides TypedDataInterface:: |
|
TypedData:: |
public | function |
Gets the definition of the plugin implementation. Overrides PluginInspectionInterface:: |
|
TypedData:: |
public | function |
Gets the plugin_id of the plugin instance. Overrides PluginInspectionInterface:: |
|
TypedData:: |
public | function |
Returns the property path of the data. Overrides TypedDataInterface:: |
|
TypedData:: |
public | function |
Returns the root of the typed data tree. Overrides TypedDataInterface:: |
|
TypedData:: |
public | function |
Sets the context of a property or item via a context aware parent. Overrides TypedDataInterface:: |
|
TypedData:: |
public | function |
Validates the currently set data value. Overrides TypedDataInterface:: |
|
TypedData:: |
public | function | Constructs a TypedData object given its definition and context. | 3 |
TypedDataTrait:: |
protected | property | The typed data manager used for creating the data types. | |
TypedDataTrait:: |
public | function | Gets the typed data manager. | 2 |
TypedDataTrait:: |
public | function | Sets the typed data manager. | 2 |