修复分页引擎文档

controller/item_controller.go

@@ -54,7 +54,7 @@ func (c *ItemController) Detail(id uint) mvc.Result {
 // @Accept       json
 // @Produce      json
 // @Param        type path string true "商品类型"
-// @Param		pagingParam query validate.PagingParam true "分页信息"
+// @Param		pagingParam query validate.PagingParam false "分页信息"
 // @Success      200       {object}  []model.ItemModel  "{["id":1],["id":2]}"
 // @Failure      400       {object}  map[string]interface{}  "{"msg": "错误信息","code":0}"
 // @Router       /api/item/list/type/{type} [get]
@@ -97,7 +97,7 @@ func (c *ItemController) GetTypes() mvc.Result {
 // @Accept       json
 // @Produce      json
 // @Param        keyword query string true "搜索关键字"
-// @Param		pagingParam query validate.PagingParam true "分页信息"
+// @Param		pagingParam query validate.PagingParam false "分页信息"
 // @Success      200       {object}  []model.ItemModel  "{["id":1],["id":2]}"
 // @Failure      400       {object}  map[string]interface{}  "{"msg": "错误信息","code":0}"
 // @Router       /api/item/search [get]

docs/docs.go

@@ -330,6 +330,7 @@ const docTemplate = `{
                         "type": "integer",
                         "default": 1,
                         "example": 1,
+                        "description": "@description 页码",
                         "name": "page",
                         "in": "query"
                     },
@@ -466,6 +467,24 @@ const docTemplate = `{
                         "name": "keyword",
                         "in": "query",
                         "required": true
+                    },
+                    {
+                        "minimum": 0,
+                        "type": "integer",
+                        "default": 1,
+                        "example": 1,
+                        "description": "@description 页码",
+                        "name": "page",
+                        "in": "query"
+                    },
+                    {
+                        "maximum": 50,
+                        "type": "integer",
+                        "default": 10,
+                        "example": 10,
+                        "description": "@description 每页数量",
+                        "name": "pageSize",
+                        "in": "query"
                     }
                 ],
                 "responses": {

docs/swagger.json

@@ -324,6 +324,7 @@
                         "type": "integer",
                         "default": 1,
                         "example": 1,
+                        "description": "@description 页码",
                         "name": "page",
                         "in": "query"
                     },
@@ -460,6 +461,24 @@
                         "name": "keyword",
                         "in": "query",
                         "required": true
+                    },
+                    {
+                        "minimum": 0,
+                        "type": "integer",
+                        "default": 1,
+                        "example": 1,
+                        "description": "@description 页码",
+                        "name": "page",
+                        "in": "query"
+                    },
+                    {
+                        "maximum": 50,
+                        "type": "integer",
+                        "default": 10,
+                        "example": 10,
+                        "description": "@description 每页数量",
+                        "name": "pageSize",
+                        "in": "query"
                     }
                 ],
                 "responses": {

docs/swagger.yaml

@@ -364,6 +364,7 @@ paths:
         required: true
         type: string
       - default: 1
+        description: '@description 页码'
         example: 1
         in: query
         minimum: 0
@@ -459,6 +460,20 @@ paths:
         name: keyword
         required: true
         type: string
+      - default: 1
+        description: '@description 页码'
+        example: 1
+        in: query
+        minimum: 0
+        name: page
+        type: integer
+      - default: 10
+        description: '@description 每页数量'
+        example: 10
+        in: query
+        maximum: 50
+        name: pageSize
+        type: integer
       produces:
       - application/json
       responses:

validate/item_validate.go

@@ -18,6 +18,7 @@ type DeleteItemParam struct {
 }
 
 type PagingParam struct {
+	// @description 页码
 	Page int `json:"page" validate:"min=0" example:"1" default:"1"`
 	// @description 每页数量
 	PageSize int `json:"pageSize" validate:"max=50" example:"10" default:"10"`