13
13
14
14
namespace Sonata \PageBundle \Controller \Api ;
15
15
16
- use FOS \RestBundle \Controller \Annotations \QueryParam ;
17
- use FOS \RestBundle \Controller \Annotations \View ;
16
+ use FOS \RestBundle \Controller \Annotations as Rest ;
18
17
use FOS \RestBundle \Request \ParamFetcherInterface ;
18
+ use FOS \RestBundle \View \View ;
19
19
use Nelmio \ApiDocBundle \Annotation \ApiDoc ;
20
20
use Sonata \BlockBundle \Model \BlockInterface ;
21
21
use Sonata \BlockBundle \Model \BlockManagerInterface ;
@@ -76,17 +76,17 @@ public function __construct(SiteManagerInterface $siteManager, PageManagerInterf
76
76
* output={"class"="Sonata\DatagridBundle\Pager\PagerInterface", "groups"={"sonata_api_read"}}
77
77
* )
78
78
*
79
- * @QueryParam(name="page", requirements="\d+", default="1", description="Page for 'page' list pagination")
80
- * @QueryParam(name="count", requirements="\d+", default="10", description="Number of pages by page")
81
- * @QueryParam(name="enabled", requirements="0|1", nullable=true, strict=true, description="Enabled/Disabled pages filter")
82
- * @QueryParam(name="edited", requirements="0|1", nullable=true, strict=true, description="Edited/Up to date pages filter")
83
- * @QueryParam(name="internal", requirements="0|1", nullable=true, strict=true, description="Internal/Exposed pages filter")
84
- * @QueryParam(name="root", requirements="0|1", nullable=true, strict=true, description="Filter pages having no parent id")
85
- * @QueryParam(name="site", requirements="\d+", nullable=true, strict=true, description="Filter pages for a specific site's id")
86
- * @QueryParam(name="parent", requirements="\d+", nullable=true, strict=true, description="Get pages being child of given page id")
87
- * @QueryParam(name="orderBy", map=true, requirements="ASC|DESC", nullable=true, strict=true, description="Order by array (key is field, value is direction)")
79
+ * @Rest\ QueryParam(name="page", requirements="\d+", default="1", description="Page for 'page' list pagination")
80
+ * @Rest\ QueryParam(name="count", requirements="\d+", default="10", description="Number of pages by page")
81
+ * @Rest\ QueryParam(name="enabled", requirements="0|1", nullable=true, strict=true, description="Enabled/Disabled pages filter")
82
+ * @Rest\ QueryParam(name="edited", requirements="0|1", nullable=true, strict=true, description="Edited/Up to date pages filter")
83
+ * @Rest\ QueryParam(name="internal", requirements="0|1", nullable=true, strict=true, description="Internal/Exposed pages filter")
84
+ * @Rest\ QueryParam(name="root", requirements="0|1", nullable=true, strict=true, description="Filter pages having no parent id")
85
+ * @Rest\ QueryParam(name="site", requirements="\d+", nullable=true, strict=true, description="Filter pages for a specific site's id")
86
+ * @Rest\ QueryParam(name="parent", requirements="\d+", nullable=true, strict=true, description="Get pages being child of given page id")
87
+ * @Rest\ QueryParam(name="orderBy", map=true, requirements="ASC|DESC", nullable=true, strict=true, description="Order by array (key is field, value is direction)")
88
88
*
89
- * @View(serializerGroups={"sonata_api_read"}, serializerEnableMaxDepthChecks=true)
89
+ * @Rest\ View(serializerGroups={"sonata_api_read"}, serializerEnableMaxDepthChecks=true)
90
90
*
91
91
* @return PagerInterface
92
92
*/
@@ -128,7 +128,7 @@ public function getPagesAction(ParamFetcherInterface $paramFetcher)
128
128
*
129
129
* @ApiDoc(
130
130
* requirements={
131
- * {"name"="id", "dataType"="integer", "requirement"="\d+", "description"="page id "}
131
+ * {"name"="id", "dataType"="integer", "requirement"="\d+", "description"="Page identifier "}
132
132
* },
133
133
* output={"class"="Sonata\PageBundle\Model\PageInterface", "groups"={"sonata_api_read"}},
134
134
* statusCodes={
@@ -137,9 +137,9 @@ public function getPagesAction(ParamFetcherInterface $paramFetcher)
137
137
* }
138
138
* )
139
139
*
140
- * @View(serializerGroups={"sonata_api_read"}, serializerEnableMaxDepthChecks=true)
140
+ * @Rest\ View(serializerGroups={"sonata_api_read"}, serializerEnableMaxDepthChecks=true)
141
141
*
142
- * @param $id
142
+ * @param int $id Page identifier
143
143
*
144
144
* @return PageInterface
145
145
*/
@@ -153,7 +153,7 @@ public function getPageAction($id)
153
153
*
154
154
* @ApiDoc(
155
155
* requirements={
156
- * {"name"="id", "dataType"="integer", "requirement"="\d+", "description"="page id "}
156
+ * {"name"="id", "dataType"="integer", "requirement"="\d+", "description"="Page identifier "}
157
157
* },
158
158
* output={"class"="Sonata\BlockBundle\Model\BlockInterface", "groups"={"sonata_api_read"}},
159
159
* statusCodes={
@@ -162,9 +162,9 @@ public function getPageAction($id)
162
162
* }
163
163
* )
164
164
*
165
- * @View(serializerGroups={"sonata_api_read"}, serializerEnableMaxDepthChecks=true)
165
+ * @Rest\ View(serializerGroups={"sonata_api_read"}, serializerEnableMaxDepthChecks=true)
166
166
*
167
- * @param $id
167
+ * @param int $id Page identifier
168
168
*
169
169
* @return BlockInterface[]
170
170
*/
@@ -178,7 +178,7 @@ public function getPageBlocksAction($id)
178
178
*
179
179
* @ApiDoc(
180
180
* requirements={
181
- * {"name"="id", "dataType"="integer", "requirement"="\d+", "description"="page id "}
181
+ * {"name"="id", "dataType"="integer", "requirement"="\d+", "description"="Page identifier "}
182
182
* },
183
183
* output={"class"="Sonata\BlockBundle\Model\BlockInterface", "groups"={"sonata_api_read"}},
184
184
* statusCodes={
@@ -187,9 +187,9 @@ public function getPageBlocksAction($id)
187
187
* }
188
188
* )
189
189
*
190
- * @View(serializerGroups={"sonata_api_read"}, serializerEnableMaxDepthChecks=true)
190
+ * @Rest\ View(serializerGroups={"sonata_api_read"}, serializerEnableMaxDepthChecks=true)
191
191
*
192
- * @param $id
192
+ * @param int $id Page identifier
193
193
*
194
194
* @return PageInterface[]
195
195
*/
@@ -205,7 +205,7 @@ public function getPagePagesAction($id)
205
205
*
206
206
* @ApiDoc(
207
207
* requirements={
208
- * {"name"="id", "dataType"="integer", "requirement"="\d+", "description"="page identifier"}
208
+ * {"name"="id", "dataType"="integer", "requirement"="\d+", "description"="Page identifier"}
209
209
* },
210
210
* input={"class"="sonata_page_api_form_block", "name"="", "groups"={"sonata_api_write"}},
211
211
* output={"class"="Sonata\PageBundle\Model\Block", "groups"={"sonata_api_read"}},
@@ -216,10 +216,10 @@ public function getPagePagesAction($id)
216
216
* }
217
217
* )
218
218
*
219
- * @View(serializerGroups={"sonata_api_read"}, serializerEnableMaxDepthChecks=true)
219
+ * @Rest\ View(serializerGroups={"sonata_api_read"}, serializerEnableMaxDepthChecks=true)
220
220
*
221
- * @param int $id A Page identifier
222
- * @param Request $request A Symfony request
221
+ * @param int $id Page identifier
222
+ * @param Request $request Symfony request
223
223
*
224
224
* @throws NotFoundHttpException
225
225
*
@@ -260,7 +260,7 @@ public function postPageBlockAction($id, Request $request)
260
260
* }
261
261
* )
262
262
*
263
- * @param Request $request A Symfony request
263
+ * @param Request $request Symfony request
264
264
*
265
265
* @throws NotFoundHttpException
266
266
*
@@ -276,7 +276,7 @@ public function postPageAction(Request $request)
276
276
*
277
277
* @ApiDoc(
278
278
* requirements={
279
- * {"name"="id", "dataType"="integer", "requirement"="\d+", "description"="page identifier"}
279
+ * {"name"="id", "dataType"="integer", "requirement"="\d+", "description"="Page identifier"}
280
280
* },
281
281
* input={"class"="sonata_page_api_form_page", "name"="", "groups"={"sonata_api_write"}},
282
282
* output={"class"="Sonata\PageBundle\Model\Page", "groups"={"sonata_api_read"}},
@@ -287,8 +287,10 @@ public function postPageAction(Request $request)
287
287
* }
288
288
* )
289
289
*
290
- * @param int $id A Page identifier
291
- * @param Request $request A Symfony request
290
+ * @Rest\Put("", name="")
291
+ *
292
+ * @param int $id Page identifier
293
+ * @param Request $request Symfony request
292
294
*
293
295
* @throws NotFoundHttpException
294
296
*
@@ -304,7 +306,7 @@ public function putPageAction($id, Request $request)
304
306
*
305
307
* @ApiDoc(
306
308
* requirements={
307
- * {"name"="id", "dataType"="integer", "requirement"="\d+", "description"="page identifier"}
309
+ * {"name"="id", "dataType"="integer", "requirement"="\d+", "description"="Page identifier"}
308
310
* },
309
311
* statusCodes={
310
312
* 200="Returned when page is successfully deleted",
@@ -313,11 +315,11 @@ public function putPageAction($id, Request $request)
313
315
* }
314
316
* )
315
317
*
316
- * @param int $id A Page identifier
318
+ * @param int $id Page identifier
317
319
*
318
320
* @throws NotFoundHttpException
319
321
*
320
- * @return \FOS\RestBundle\View\ View
322
+ * @return View
321
323
*/
322
324
public function deletePageAction ($ id )
323
325
{
@@ -333,7 +335,7 @@ public function deletePageAction($id)
333
335
*
334
336
* @ApiDoc(
335
337
* requirements={
336
- * {"name"="id", "dataType"="integer", "requirement"="\d+", "description"="page identifier"}
338
+ * {"name"="id", "dataType"="integer", "requirement"="\d+", "description"="Page identifier"}
337
339
* },
338
340
* statusCodes={
339
341
* 200="Returned when snapshots are successfully queued for creation",
@@ -342,11 +344,11 @@ public function deletePageAction($id)
342
344
* }
343
345
* )
344
346
*
345
- * @param int $id A Page identifier
347
+ * @param int $id Page identifier
346
348
*
347
349
* @throws NotFoundHttpException
348
350
*
349
- * @return \FOS\RestBundle\View\ View
351
+ * @return View
350
352
*/
351
353
public function postPageSnapshotAction ($ id )
352
354
{
@@ -371,7 +373,7 @@ public function postPageSnapshotAction($id)
371
373
*
372
374
* @throws NotFoundHttpException
373
375
*
374
- * @return \FOS\RestBundle\View\ View
376
+ * @return View
375
377
*/
376
378
public function postPagesSnapshotsAction ()
377
379
{
@@ -389,7 +391,7 @@ public function postPagesSnapshotsAction()
389
391
/**
390
392
* Retrieves page with id $id or throws an exception if it doesn't exist.
391
393
*
392
- * @param $id
394
+ * @param mixed $id Page identifier
393
395
*
394
396
* @throws NotFoundHttpException
395
397
*
@@ -409,7 +411,7 @@ protected function getPage($id)
409
411
/**
410
412
* Retrieves Block with id $id or throws an exception if it doesn't exist.
411
413
*
412
- * @param $id
414
+ * @param mixed $id Block identifier
413
415
*
414
416
* @throws NotFoundHttpException
415
417
*
@@ -430,7 +432,7 @@ protected function getBlock($id)
430
432
* Write a page, this method is used by both POST and PUT action methods.
431
433
*
432
434
* @param Request $request Symfony request
433
- * @param int|null $id A page identifier
435
+ * @param int|null $id Page identifier
434
436
*
435
437
* @return FormInterface
436
438
*/
0 commit comments