更新範例

Author: Shishamou

publishes/resources/ExamplePack/Resource.php

@@ -4,8 +4,13 @@
 
 use Database\Factories\DummyFactory;
 use Illuminate\Database\Eloquent\Model;
+use Illuminate\Database\Eloquent\Relations;
 use Illuminate\Database\Eloquent\Factories\HasFactory;
 
+/**
+ * @method static \Illuminate\Database\Eloquent\Builder orderByPriority(bool $reversed = false)
+ * @method static \Illuminate\Database\Eloquent\Builder published()
+ */
 class Dummy extends Model
 {
     use HasFactory;
@@ -48,16 +53,27 @@ protected static function newFactory()
         return DummyFactory::new();
     }
 
+    /* =========================================================================
+     * = Relations
+     * =========================================================================
+     */
+
+    // /**
+    //  * @return \Illuminate\Database\Eloquent\Relations\Relation
+    //  */
+    // public function relation(): Relations\Relation
+    // {
+    //     return $this->belongsTo(Relation::class);
+    // }
+
     /* =========================================================================
      * = Scopes
      * =========================================================================
      */
 
     /**
-     * 按照優先度排序
-     *
-     * ```
-     * $query->orderByPriority();
+     * ```php
+     * Dummy::orderByPriority();
      * ```
      *
      * @param  \Illuminate\Database\Eloquent\Builder  $query
@@ -70,10 +86,8 @@ public function scopeOrderByPriority($query, $reversed = false)
     }
 
     /**
-     * 查詢僅上架
-     *
      * ```php
-     * $query->published();
+     * Dummy::published();
      * ```
      *
      * @param  \Illuminate\Database\Eloquent\Builder  $query

publishes/resources/ExampleController.php …blishes/resources/example_controller.phppublishes/resources/ExampleController.php renamed to publishes/resources/example_controller.php publishes/resources/ExampleController.php renamed to publishes/resources/example_controller.php

@@ -0,0 +1,141 @@
+<?php
+
+namespace Tests\Feature;
+
+use App\Models\Dummy;
+use Database\Factories\DummyFactory;
+use Illuminate\Testing\Fluent\AssertableJson;
+use Tests\TestCase;
+
+class DummyApiTest extends TestCase
+{
+    /**
+     * Base path of API.
+     *
+     * @var string
+     */
+    protected string $base = '/api/dummies';
+
+    /**
+     * @param  int|null  $count
+     * @return \Database\Factories\DummyFactory
+     */
+    protected function factory($count = null): DummyFactory
+    {
+        return Dummy::factory($count);
+    }
+
+    // =========================================================================
+    // = BREAD Specs
+    // =========================================================================
+
+    /**
+     * @return void
+     */
+    public function test_browse_records()
+    {
+        $this->factory(3)->create();
+
+        $response = $this->getJson($this->base);
+
+        $response->assertOk();
+
+        $response->assertJsonStructure([
+            'meta',
+            'links',
+            'data' => [
+                '*' => [
+                    'id',
+
+                    // ... Here is where you should put the expected schema of response records.
+                ]
+            ]
+        ]);
+    }
+
+    /**
+     * @return void
+     */
+    public function test_read_specified_record()
+    {
+        $record = $this->factory()->create();
+
+        $response = $this->getJson("{$this->base}/{$record->getKey()}");
+
+        $response->assertOk();
+
+        $response->assertJsonStructure([
+            'data' => [
+                'id',
+
+                // ... Here is where you should put the expected schema of response record.
+            ]
+        ]);
+    }
+
+    /**
+     * @return void
+     */
+    public function test_edit_specified_record()
+    {
+        $record = $this->factory()->create();
+
+        $response = $this->putJson(
+            "{$this->base}/{$record->getKey()}",
+            $data = [
+
+                // ... Here is where you should put the form data for updating.
+
+            ]
+        );
+
+        $response->assertNoContent();
+
+        $this->assertDatabaseHas('dummies', $data);
+    }
+
+    /**
+     * @return void
+     */
+    public function test_add_new_record()
+    {
+        $response = $this->postJson(
+            "{$this->base}",
+            $data = [
+
+                // ... Here is where you should put the form data for creating.
+
+            ]
+        );
+
+        $response->assertCreated();
+
+        $this->assertDatabaseHas('dummies', [
+            ...$data,
+
+            // ... extra checks
+        ]);
+    }
+
+    /**
+     * @return void
+     */
+    public function test_delete_specified_record()
+    {
+        $record = $this->factory()->create();
+
+        $response = $this->deleteJson(
+            "{$this->base}/{$record->getKey()}"
+        );
+
+        $response->assertNoContent();
+
+        $this->assertDatabaseCount('dummies', 0);
+    }
+
+    // =========================================================================
+    // = Extra Specs
+    // =========================================================================
+
+    // ...
+}