如何在swagger ui中映射這個數組json？

Question

我正在昂首闊步UI在PHP和我試圖地圖下方

{ 
    "category": { 
    "id": 0, 
    "name": "string" 
    } 
} 

JSON像 我試了一下，從招搖的用戶界面演示，但無法得到像上述 JSON映射，如何能我得到了這個json映射，那麼註釋是什麼？ 請幫助

我招搖類是

/** 
    * @SWG\Definition(@SWG\Xml(name="MyFl")) 
    */ 
    class MyFl 
    { 

     /** 
    * @SWG\Property(format="int64") 
    * @var int 
    */ 
    public $id; 

    /** 
    * @SWG\Property(example="doggie") 
    * @var string 
    */ 
    public $name; 

    /** 
    * @SWG\Property(type="Category") 
    */ 
    public $category; 

    } 

而且我的帖子API註釋：

/** 
    * @SWG\Post(
    * path="/docs/fl", 
    * tags={"MY"}, 
    * summary="Insert fl info", 
    * operationId="FL", 
    * produces={"application/xml","application/json"}, 
    * @SWG\Parameter(in="body",name="body",description="Insert fl info",required=true,@SWG\Schema(ref="#/definitions/MyFl") 
    * ), 
    * @SWG\Response(response="default", description="successful operation") 
    *) 
    */ 

而且通過這個我得到的模型架構，如：

但我想JSON模式，如：

{ 
     "category": { 
     "id": 0, 
     "name": "string" 
     } 
    } 

請幫助我..

Answer 1

免責聲明：它已經因爲我與招搖的PHP註釋工作了很長一段時間，所以我米不知道這是做到這一點的最佳方式。我的專業知識更多的是JSON模式，而不是swagger-php。

您的數據結構實際上是兩個對象。第一個是具有一個屬性的對象：「類別」。然後，「category」的值是具有兩個屬性的另一個對象：「id」和「name」。我很確定你需要將這些模型作爲兩個獨立的對象進行建模。

/** 
* @SWG\Definition(@SWG\Xml(name="MyFl")) 
*/ 
class MyFl 
{ 

    /** 
    * @SWG\Property(type=Category) <-- Don't know if this is the right way to reference another schema. You will have to check the documentation. 
    */ 
    public $category; 

} 

---

/** 
* @SWG\Definition(@SWG\Xml(name="Category")) 
*/ 
class Category 
{ 

    /** 
    * @SWG\Property(format="int64") 
    * @var int 
    */ 
    public $id; 

    /** 
    * @SWG\Property(example="doggie") 
    * @var string 
    */ 
    public $name; 

} 

希望有所幫助。