#27499: Code review changes

Author: sivaschenko

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

@@ -59,22 +59,22 @@ public function __construct(
     /**
      * Return media asset asset list
      *
-     * @param string $mediaFilePath
+     * @param string $path
      *
      * @return AssetInterface
      * @throws IntegrationException
      */
-    public function execute(string $mediaFilePath): AssetInterface
+    public function execute(string $path): AssetInterface
     {
         try {
             $connection = $this->resourceConnection->getConnection();
             $select = $connection->select()
                 ->from($this->resourceConnection->getTableName(self::TABLE_MEDIA_GALLERY_ASSET))
-                ->where(self::MEDIA_GALLERY_ASSET_PATH . ' = ?', $mediaFilePath);
+                ->where(self::MEDIA_GALLERY_ASSET_PATH . ' = ?', $path);
             $data = $connection->query($select)->fetch();
 
             if (empty($data)) {
-                $message = __('There is no such media asset with path "%1"', $mediaFilePath);
+                $message = __('There is no such media asset with path "%1"', $path);
                 throw new NoSuchEntityException($message);
             }
 

app/code/Magento/MediaGalleryApi/Api/Data/AssetInterface.php

@@ -39,7 +39,7 @@ public function getPath(): string;
     public function getTitle(): ?string;
 
     /**
-     * Get source of the file
+     * Get the name of the channel/stock/integration file was retrieved from. null if not identified.
      *
      * @return string|null
      */

app/code/Magento/MediaGalleryApi/Model/Asset/Command/GetByPathInterface.php

@@ -17,8 +17,8 @@ interface GetByPathInterface
     /**
      * Get media asset list
      *
-     * @param string $mediaFilePath
+     * @param string $path
      * @return \Magento\MediaGalleryApi\Api\Data\AssetInterface
      */
-    public function execute(string $mediaFilePath): \Magento\MediaGalleryApi\Api\Data\AssetInterface;
+    public function execute(string $path): \Magento\MediaGalleryApi\Api\Data\AssetInterface;
 }

app/code/Magento/MediaGalleryApi/Model/Asset/Command/SaveInterface.php

@@ -17,7 +17,7 @@
 interface SaveInterface
 {
     /**
-     * Save media asset
+     * Save media asset and return the media asset id
      *
      * @param \Magento\MediaGalleryApi\Api\Data\AssetInterface $mediaAsset
      * @return int