Modified to implement CQRS

app/Providers/BusServiceProvider.php

@@ -189,7 +189,7 @@ private function registerCommands(): void
 
 
             $commandBus->register(CreateTosCommand::class, CreateTosCommandHandler::class);
-            
+
             $commandBus->register(
                 AddTranslationCommand::class,
                 AddTranslationCommandHandler::class
@@ -200,7 +200,7 @@ private function registerCommands(): void
                 Category\Handlers\StoreCategoryCommandHandler::class
             );
 
-           
+
 
             $commandBus->register(
                 Category\Commands\DeleteCategoryCommand::class,
@@ -352,6 +352,10 @@ private function registerCommands(): void
                 Media\Commands\UpdateMediaCommand::class,
                 Media\Handlers\UpdateMediaCommandHandler::class
             );
+            $commandBus->register(
+                Media\Commands\UpdateMediaCaptionCommand::class,
+                Media\Handlers\UpdateMediaCaptionCommandHandler::class
+            );
             $commandBus->register(
                 Media\Commands\DeleteMediaCommand::class,
                 Media\Handlers\DeleteMediaCommandHandler::class
@@ -370,7 +374,7 @@ private function registerCommands(): void
                 Apikey\Commands\DeleteApikeyCommand::class,
                 Apikey\Handlers\DeleteApikeyCommandHandler::class
             );
-            
+
             $commandBus->register(
                 Webhook\Commands\CreateWebhookCommand::class,
                 Webhook\Handlers\CreateWebhookCommandHandler::class
@@ -387,7 +391,7 @@ private function registerCommands(): void
                 Webhook\Commands\UpdateWebhookPostsCommand::class,
                 Webhook\Handlers\UpdateWebhookPostsCommandHandler::class
             );
-            
+
 
             $commandBus->register(
                 HXL\Commands\CreateHXLMetaDataCommand::class,
@@ -488,7 +492,7 @@ private function registerQueries(): void
                 Survey\Queries\GetSurveyIdsWithPrivateLocationQuery::class,
                 Survey\Handlers\GetSurveyIdsWithPrivateLocationQueryHandler::class
             );
-            
+
 
 
             $queryBus->register(
@@ -559,7 +563,7 @@ private function registerQueries(): void
                 DataProvider\Queries\FetchDataProviderByIdQuery::class,
                 DataProvider\Handlers\FetchDataProviderByIdQueryHandler::class
             );
-            
+
 
             $queryBus->register(
                 Contact\Queries\FetchContactQuery::class,
@@ -672,7 +676,7 @@ private function registerQueries(): void
             );
 
 
-            
+
 
             return $queryBus;
         });

src/Ushahidi/Modules/V5/Actions/Media/Commands/UpdateMediaCaptionCommand.php

@@ -0,0 +1,62 @@
+<?php
+
+namespace Ushahidi\Modules\V5\Actions\Media\Commands;
+
+use App\Bus\Command\Command;
+use Ushahidi\Modules\V5\Models\Media;
+use Ushahidi\Modules\V5\Requests\MediaRequest;
+use Ushahidi\Core\Entity\Media as MediaEntity;
+use Illuminate\Support\Facades\Auth;
+use Ushahidi\Modules\V5\Helpers\ParameterUtilities;
+
+class UpdateMediaCaptionCommand implements Command
+{
+
+    /**
+     * @var int
+     */
+    private $id;
+
+    /**
+     * @var string
+     */
+    private $caption;
+
+    /**
+     * @var MediaEntity
+     */
+    private $media_entity;
+
+    public function __construct(
+        string $caption,
+        Media $media
+    ) {
+        // $this->id = $id;
+        $input['id'] = $media->id;
+        $input['user_id'] = $media->user_id;
+        $input['caption'] = $caption;
+        $input['mime'] = $media->mime;
+        $input['o_filename'] = $media->o_filename;
+        $input['o_size'] = $media->o_size;
+        $input['o_width'] = $media->o_width;
+        $input['o_height'] = $media->o_height;
+        $input['created'] = strtotime($media->created);
+        $input['updated'] = time();
+
+        $this->media_entity = new MediaEntity($input);
+    }
+
+    // public function getId(): int
+    // {
+    //     return $this->id;
+    // }
+    public function getCaption(): string
+    {
+        return $this->caption;
+    }
+
+    public function getMediaEntity(): MediaEntity
+    {
+        return $this->media_entity;
+    }
+}

src/Ushahidi/Modules/V5/Actions/Media/Handlers/UpdateMediaCaptionCommandHandler.php

@@ -0,0 +1,41 @@
+<?php
+
+namespace Ushahidi\Modules\V5\Actions\Media\Handlers;
+
+use App\Bus\Action;
+use App\Bus\Command\AbstractCommandHandler;
+use App\Bus\Command\Command;
+use Illuminate\Database\Eloquent\ModelNotFoundException;
+use Ushahidi\Core\Exception\NotFoundException;
+use Ushahidi\Modules\V5\Models\Media;
+use Ushahidi\Modules\V5\Repository\Media\MediaRepository;
+use Ushahidi\Modules\V5\Actions\Media\Commands\UpdateMediaCaptionCommand;
+use Illuminate\Support\Facades\DB;
+use Ushahidi\Modules\V5\Models\MediaLock as Lock;
+
+class UpdateMediaCaptionCommandHandler extends AbstractCommandHandler
+{
+    private $media_repository;
+
+    public function __construct(MediaRepository $media_repository)
+    {
+        $this->media_repository = $media_repository;
+    }
+
+    protected function isSupported(Command $command): void
+    {
+        if (!$command instanceof UpdateMediaCaptionCommand) {
+            throw new \Exception('Provided $command is not instance of UpdateMediaCommand');
+        }
+    }
+
+    public function __invoke(Action $action)
+    {
+        /**
+         * @var UpdateMediaCaptionCommand $action
+         */
+        $this->isSupported($action);
+
+        return $this->media_repository->update($action->getMediaEntity()->getId(), $action->getMediaEntity());
+    }
+}

src/Ushahidi/Modules/V5/Http/Controllers/MediaController.php

@@ -10,6 +10,7 @@
 use Ushahidi\Modules\V5\Http\Resources\Media\MediaResource;
 use Ushahidi\Modules\V5\Actions\Media\Commands\CreateMediaCommand;
 use Ushahidi\Modules\V5\Actions\Media\Commands\UpdateMediaCommand;
+use Ushahidi\Modules\V5\Actions\Media\Commands\UpdateMediaCaptionCommand;
 use Ushahidi\Modules\V5\Actions\Media\Commands\DeleteMediaCommand;
 use Ushahidi\Modules\V5\Requests\MediaRequest;
 use Ushahidi\Modules\V5\Models\Media;
@@ -102,38 +103,19 @@ public function delete(int $id)
     }// end delete
 
     /**
-     * Patch media item
+     * Patch media item (currently only caption)
      * @param int $id
      * @param Request $request
      * @return MediaResource|JsonResponse
      * @throws \Illuminate\Auth\Access\AuthorizationException
      */
     public function patch(int $id, Request $request)
     {
-        $media = Media::find($id);
-        $caption = $this->getField('caption', $request->input('caption'));
-        if (!$media) {
-            return self::make404();
-        }
-        if (!$caption) {
-            return self::make422("Caption required for media patch call.");
-        }
-
-        DB::beginTransaction();
-        try {
-            $media->setAttribute('caption', $caption);
-            $this->authorize('update', $media);
-
-            if ($media->save()) {
-                DB::commit();
-                return new MediaResource($media);
-            } else {
-                DB::rollback();
-                return self::make422($media->errors);
-            }
-        } catch (\Exception $e) {
-            DB::rollback();
-            return self::make500($e->getMessage());
-        }
+        $caption = $request->input('caption');
+        $media = $this->queryBus->handle(new FetchMediaByIdQuery($id));
+        $this->authorize('update', $media);
+        $command = new UpdateMediaCaptionCommand($caption, $media);
+        return $this->commandBus->handle($command);
     } // end patch
+
 } //end class

src/Ushahidi/Modules/V5/Repository/Media/MediaRepository.php

@@ -48,7 +48,7 @@ public function create(MediaEntity $entity): int;
      */
     public function update(int $id, MediaEntity $entity): void;
 
-       /**
+    /**
      * This method will delete the Media
      * @param int $id
      */