2021-06-26 11:23:15 -04:00
|
|
|
<?php
|
|
|
|
|
|
|
|
namespace BookStack\Http\Controllers\Api;
|
2019-12-28 09:58:07 -05:00
|
|
|
|
|
|
|
use BookStack\Api\ListingResponseBuilder;
|
|
|
|
use BookStack\Http\Controllers\Controller;
|
|
|
|
use Illuminate\Database\Eloquent\Builder;
|
|
|
|
use Illuminate\Http\JsonResponse;
|
|
|
|
|
2020-11-22 09:56:19 -05:00
|
|
|
abstract class ApiController extends Controller
|
2019-12-28 09:58:07 -05:00
|
|
|
{
|
2020-01-12 09:45:54 -05:00
|
|
|
protected $rules = [];
|
|
|
|
|
2019-12-28 09:58:07 -05:00
|
|
|
/**
|
|
|
|
* Provide a paginated listing JSON response in a standard format
|
|
|
|
* taking into account any pagination parameters passed by the user.
|
|
|
|
*/
|
2022-02-03 07:33:26 -05:00
|
|
|
protected function apiListingResponse(Builder $query, array $fields, array $modifiers = []): JsonResponse
|
2019-12-28 09:58:07 -05:00
|
|
|
{
|
2022-02-03 07:33:26 -05:00
|
|
|
$listing = new ListingResponseBuilder($query, request(), $fields);
|
|
|
|
|
|
|
|
foreach ($modifiers as $modifier) {
|
|
|
|
$listing->modifyResults($modifier);
|
|
|
|
}
|
2021-06-26 11:23:15 -04:00
|
|
|
|
2019-12-28 09:58:07 -05:00
|
|
|
return $listing->toResponse();
|
|
|
|
}
|
2020-01-12 09:45:54 -05:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Get the validation rules for this controller.
|
2021-11-14 17:03:22 -05:00
|
|
|
* Defaults to a $rules property but can be a rules() method.
|
2020-01-12 09:45:54 -05:00
|
|
|
*/
|
2022-02-03 11:52:28 -05:00
|
|
|
public function getValidationRules(): array
|
2020-01-12 09:45:54 -05:00
|
|
|
{
|
2021-11-14 17:03:22 -05:00
|
|
|
if (method_exists($this, 'rules')) {
|
|
|
|
return $this->rules();
|
|
|
|
}
|
|
|
|
|
2020-01-12 09:45:54 -05:00
|
|
|
return $this->rules;
|
|
|
|
}
|
2021-03-07 17:24:05 -05:00
|
|
|
}
|