feat: ✨ Aggiunta API CRUD generica

.idea/osm_rewrite.iml

@@ -86,6 +86,7 @@
       <excludeFolder url="file://$MODULE_DIR$/vendor/laravel/framework" />
       <excludeFolder url="file://$MODULE_DIR$/.yarn/cache" />
       <excludeFolder url="file://$MODULE_DIR$/public/build" />
+      <excludeFolder url="file://$MODULE_DIR$/vendor/f9webltd/laravel-api-response-helpers" />
     </content>
     <orderEntry type="inheritedJdk" />
     <orderEntry type="sourceFolder" forTests="false" />

.idea/php.xml

@@ -112,6 +112,7 @@
       <path value="$PROJECT_DIR$/vendor/psr/http-factory" />
       <path value="$PROJECT_DIR$/vendor/laravel/serializable-closure" />
       <path value="$PROJECT_DIR$/vendor/openstamanager/standard_modules" />
+      <path value="$PROJECT_DIR$/vendor/f9webltd/laravel-api-response-helpers" />
     </include_path>
   </component>
   <component name="PhpProjectSharedConfiguration" php_language_level="8.0">

app/Http/Controllers/Api/ApiController.php

@@ -0,0 +1,85 @@
+<?php
+
+namespace App\Http\Controllers\Api;
+
+use App\Http\Controllers\Controller;
+use App\Http\Resources\ApiResource;
+use F9Web\ApiResponseHelpers;
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Http\JsonResponse;
+use Illuminate\Http\Request;
+
+class ApiController extends Controller
+{
+    use ApiResponseHelpers;
+
+    protected string|Model $model = Model::class;
+    protected string|ApiResource $resource = ApiResource::class;
+
+    /**
+     * Display a listing of the resource.
+     */
+    public function index(): JsonResponse
+    {
+        return $this->respondWithSuccess(new $this->resource($this->model::all()));
+    }
+
+    /**
+     * Store a newly created resource in storage.
+     */
+    public function store(Request $request): JsonResponse
+    {
+        $instance = new $this->model();
+        $instance->fill($request->all());
+
+        $created = $instance->save();
+
+        return $created ? $this->respondCreated(new $this->resource($instance)) : $this->respondError();
+    }
+
+    /**
+     * Display the specified resource.
+     */
+    public function show(int $id): JsonResponse
+    {
+        $instance = $this->model::find($id);
+
+        if (!assert($instance instanceof Model)) {
+            return $this->respondNotFound(__('Risorsa non trovata.'));
+        }
+
+        return $this->respondWithSuccess(new $this->resource($this->model::find($id)));
+    }
+
+    /**
+     * Update the specified resource in storage.
+     */
+    public function update(Request $request, int $id): JsonResponse
+    {
+        $instance = $this->model::find($id);
+        if (!assert($instance instanceof Model)) {
+            return $this->respondNotFound(__('Risorsa non trovata.'));
+        }
+
+        $instance->fill($request->all());
+        $updated = $instance->save();
+
+        return $updated ? $this->respondWithSuccess($instance) : $this->respondError();
+    }
+
+    /**
+     * Remove the specified resource from storage.
+     */
+    public function destroy(int $id): JsonResponse
+    {
+        $instance = $this->model::find($id);
+
+        if (!assert($instance instanceof Model)) {
+            return $this->respondNotFound(__('Risorsa non trovata.'));
+        }
+
+        $deleted = $instance->delete();
+
+        return $deleted ? $this->respondNoContent() : $this->respondError();
+    }
+}

app/Http/Controllers/Api/UserController.php

@@ -2,60 +2,10 @@
 
 namespace App\Http\Controllers\Api;
 
-use App\Http\Controllers\Controller;
-use App\Http\Resources\UserResource;
 use App\Models\User;
-use Illuminate\Http\Request;
+use Illuminate\Database\Eloquent\Model;
-use Illuminate\Http\Resources\Json\JsonResource;
 
-class UserController extends Controller
+class UserController extends ApiController
 {
-    /**
+    protected string|Model $model = User::class;
-     * Display a listing of the resource.
-     *
-     * @return \Illuminate\Http\Response
-     */
-    public function index()
-    {
-        return new UserResource(User::all());
-    }
-
-    /**
-     * Store a newly created resource in storage.
-     *
-     * @return \Illuminate\Http\Response
-     */
-    public function store(Request $request)
-    {
-    }
-
-    /**
-     * Display the specified resource.
-     */
-    public function show(int $id): JsonResource
-    {
-        return new UserResource(User::find($id));
-    }
-
-    /**
-     * Update the specified resource in storage.
-     *
-     * @param int $id
-     *
-     * @return \Illuminate\Http\Response
-     */
-    public function update(Request $request, $id)
-    {
-    }
-
-    /**
-     * Remove the specified resource from storage.
-     *
-     * @param int $id
-     *
-     * @return \Illuminate\Http\Response
-     */
-    public function destroy($id)
-    {
-    }
 }

app/Http/Resources/ApiResource.php

@@ -7,7 +7,7 @@ use Illuminate\Http\Request;
 use Illuminate\Http\Resources\Json\JsonResource;
 use JsonSerializable;
 
-class UserResource extends JsonResource
+class ApiResource extends JsonResource
 {
     /**
      * Transform the resource into an array.

composer.json

@@ -31,6 +31,7 @@
     "require": {
         "php": "^8",
         "ext-pdo": "*",
+        "f9webltd/laravel-api-response-helpers": "^1.4",
         "fideloper/proxy": "^4",
         "fruitcake/laravel-cors": "^2",
         "guzzlehttp/guzzle": "^7",

routes/api.php

@@ -3,7 +3,6 @@
 /** @noinspection UnusedFunctionResultInspection */
 
 use App\Http\Controllers\Api\UserController;
-use Illuminate\Http\Request;
 use Illuminate\Support\Facades\Route;
 
 /*