#27499: MediaGallery bulk interfaces introduced

Author: sivaschenko

app/code/Magento/MediaGallery/Model/Asset/Command/DeleteByDirectoryPath.php

@@ -14,9 +14,8 @@
 use Psr\Log\LoggerInterface;
 
 /**
- * Class DeleteByDirectoryPath
- *
  * Remove asset(s) that correspond the provided directory path
+ * @deprecated use \Magento\MediaGalleryApi\Api\DeleteAssetsByPathInterface instead
  */
 class DeleteByDirectoryPath implements DeleteByDirectoryPathInterface
 {

app/code/Magento/MediaGallery/Model/Asset/Command/DeleteByPath.php

@@ -15,6 +15,7 @@
 
 /**
  * Class DeleteByPath
+ * @deprecated use \Magento\MediaGalleryApi\Api\DeleteAssetsByPathInterface instead
  */
 class DeleteByPath implements DeleteByPathInterface
 {

app/code/Magento/MediaGallery/Model/Asset/Command/GetById.php

@@ -17,6 +17,7 @@
 
 /**
  * Get media asset by id
+ * @deprecated use \Magento\MediaGalleryApi\Api\GetAssetsByIdsInterface instead
  */
 class GetById implements GetByIdInterface
 {

app/code/Magento/MediaGallery/Model/Asset/Command/GetByPath.php

@@ -16,7 +16,8 @@
 use Psr\Log\LoggerInterface;
 
 /**
- * Class GetListByIds
+ * Class GetByPath
+ * @deprecated use \Magento\MediaGalleryApi\Api\GetAssetsByPathInterface instead
  */
 class GetByPath implements GetByPathInterface
 {

app/code/Magento/MediaGallery/Model/Asset/Command/Save.php

@@ -16,6 +16,7 @@
 
 /**
  * Class Save
+ * @deprecated use \Magento\MediaGalleryApi\Api\SaveAssetInterface instead
  */
 class Save implements SaveInterface
 {

app/code/Magento/MediaGallery/Model/AssetKeywords.php

@@ -0,0 +1,53 @@
+<?php
+/**
+ * Copyright © Magento, Inc. All rights reserved.
+ * See COPYING.txt for license details.
+ */
+declare(strict_types=1);
+
+namespace Magento\MediaGallery\Model;
+
+use Magento\Framework\Model\AbstractExtensibleModel;
+use Magento\MediaGalleryApi\Api\Data\AssetKeywordsInterface;
+use Magento\MediaGalleryApi\Api\Data\AssetKeywordsExtensionInterface;
+
+/**
+ * Asset's Keywords
+ */
+class AssetKeywords extends AbstractExtensibleModel implements AssetKeywordsInterface
+{
+    private const ASSET_ID = 'asset_id';
+    private const KEYWORDS = 'keywords';
+
+    /**
+     * @inheritdoc
+     */
+    public function getAssetId(): int
+    {
+        return (int) $this->getData(self::ASSET_ID);
+    }
+
+    /**
+     * @inheritdoc
+     */
+    public function getKeywords(): array
+    {
+        return $this->getData(self::KEYWORDS);
+    }
+
+    /**
+     * @inheritdoc
+     */
+    public function getExtensionAttributes(): AssetKeywordsExtensionInterface
+    {
+        return $this->_getExtensionAttributes();
+    }
+
+    /**
+     * @inheritdoc
+     */
+    public function setExtensionAttributes(AssetKeywordsExtensionInterface $extensionAttributes): void
+    {
+        $this->_setExtensionAttributes($extensionAttributes);
+    }
+}

app/code/Magento/MediaGallery/Model/Directory/Command/CreateByPath.php

@@ -9,13 +9,13 @@
 
 use Magento\Cms\Model\Wysiwyg\Images\Storage;
 use Magento\Framework\Exception\CouldNotSaveException;
-use Magento\MediaGalleryApi\Model\Directory\Command\CreateByPathInterface;
+use Magento\MediaGalleryApi\Api\CreateDirectoriesByPathsInterface;
 use Psr\Log\LoggerInterface;
 
 /**
  * Create folder by provided path
  */
-class CreateByPath implements CreateByPathInterface
+class CreateByPath implements CreateDirectoriesByPathsInterface
 {
     /**
      * @var LoggerInterface
@@ -40,19 +40,31 @@ public function __construct(
     }
 
     /**
-     * Create new directory by the provided path in the media storage
-     *
-     * @param string $path
-     * @param string $name
-     * @throws CouldNotSaveException
+     * @inheritdoc
      */
-    public function execute(string $path, string $name): void
+    public function execute(array $paths): void
     {
-        try {
-            $this->storage->createDirectory($name, $this->storage->getCmsWysiwygImages()->getStorageRoot() . $path);
-        } catch (\Exception $exception) {
-            $this->logger->critical($exception);
-            throw new CouldNotSaveException(__('Failed to create the folder'), $exception);
+        $failedPaths = [];
+        foreach ($paths as $path) {
+            try {
+                $name = end(explode('/', $path));
+                $this->storage->createDirectory(
+                    $name,
+                    $this->storage->getCmsWysiwygImages()->getStorageRoot() . $path
+                );
+            } catch (\Exception $exception) {
+                $this->logger->critical($exception);
+                $failedPaths[] = $path;
+            }
+        }
+
+        if (!empty($failedPaths)) {
+            throw new CouldNotSaveException(
+                __(
+                    'Could not save directories: %paths',
+                    implode(' ,', $failedPaths)
+                )
+            );
         }
     }
 }

app/code/Magento/MediaGallery/Model/Directory/Command/DeleteByPath.php

@@ -9,13 +9,13 @@
 
 use Magento\Cms\Model\Wysiwyg\Images\Storage;
 use Magento\Framework\Exception\CouldNotDeleteException;
-use Magento\MediaGalleryApi\Model\Directory\Command\DeleteByPathInterface;
+use Magento\MediaGalleryApi\Api\DeleteDirectoriesByPathsInterface;
 use Psr\Log\LoggerInterface;
 
 /**
  * Delete directory from media storage by path
  */
-class DeleteByPath implements DeleteByPathInterface
+class DeleteByPath implements DeleteDirectoriesByPathsInterface
 {
     /**
      * @var LoggerInterface
@@ -40,18 +40,27 @@ public function __construct(
     }
 
     /**
-     * Removes directory and corresponding thumbnails directory from media storage if not in blacklist
-     *
-     * @param string $path
-     * @throws CouldNotDeleteException
+     * @inheritdoc
      */
-    public function execute(string $path): void
+    public function execute(array $paths): void
     {
-        try {
-            $this->storage->deleteDirectory($this->storage->getCmsWysiwygImages()->getStorageRoot() . $path);
-        } catch (\Exception $exception) {
-            $this->logger->critical($exception);
-            throw new CouldNotDeleteException(__('Failed to delete the folder'), $exception);
+        $failedPaths = [];
+        foreach ($paths as $path) {
+            try {
+                $this->storage->deleteDirectory($this->storage->getCmsWysiwygImages()->getStorageRoot() . $path);
+            } catch (\Exception $exception) {
+                $this->logger->critical($exception);
+                $failedPaths[] = $path;
+            }
+        }
+
+        if (!empty($failedPaths)) {
+            throw new CouldNotDeleteException(
+                __(
+                    'Could not delete directories: %paths',
+                    implode(' ,', $failedPaths)
+                )
+            );
         }
     }
 }

app/code/Magento/MediaGallery/Model/Directory/IsBlacklisted.php

@@ -7,12 +7,12 @@
 
 namespace Magento\MediaGallery\Model\Directory;
 
-use Magento\MediaGalleryApi\Model\Directory\IsBlacklistedInterface;
+use Magento\MediaGalleryApi\Api\IsPathBlacklistedInterface;
 
 /**
  * Check if the path is blacklisted for media gallery. Directory path may be blacklisted if it's reserved by the system
  */
-class IsBlacklisted implements IsBlacklistedInterface
+class IsBlacklisted implements IsPathBlacklistedInterface
 {
     /**
      * @var Config