contributte / apitte

:wrench: An opinionated and enjoyable API framework based on Nette Framework. Supporting content negotiation, debugging, middlewares, attributes, annotations and loving openapi/swagger.
https://contributte.org/packages/contributte/apitte/
MIT License
61 stars 36 forks source link

Method signature instead of RequestParameters #153

Open tprochazka opened 3 years ago

tprochazka commented 3 years ago

I'm migrating my app from using great Drahak\Restful, because this library is sadly not maintained. It was able to automatically map request to method parameters and obtain type and default value from it.

So instead of

/**
 * @Path("/users")
 * @Method("GET")
 * @RequestParameters({
 *      @RequestParameter(name="page", in="query", type="int")
 * })
 */
public function index(ApiRequest $request, ApiResponse $response): ApiResponse {

    $page = $request->getParameter("page", 1);

Was possible to just provide type and default value by signature like that

/**
 * @Path("/users")
 * @Method("GET")
 */
public function index(int $page = 1): ApiResponse {

Only additional attributes can be provided by annotation. Why so the verbose approach was used by Apitte?

f3l1x commented 3 years ago

Hi. Unfortunately no, this relies on PSR-7 + middlewares, so you receive request object as parameter. You can drain whatever you need from ApiRequest, URL parameters, query parameters, headers, whatever.