restart 0.0.2

Restart is an implementation of a REST API for Dart. The aim is to provide a way of registering easily some endpoints by use of annotations which is similar to many Java API.

Restart

Restart is an implementation of a REST API for Dart.

The aim is to provide a way of registering easily some endpoints by use of annotations which is similar to many Java API.

Restart focuses on doing only one thing : providing a way to handle HTTP methods easily which means that no DI nor anything else is used and the user can consequently use any other library.

The use would be as follow for the declaration of endpoints:

class Endpoint {
  @Get('/api/todo')
  HttpResponse list(HttpRequest req) {...}

  @Put('/api/todo/{id}') // ability to have parameters passed as positional parameters
  HttpResponse update(HttpRequest req, String id) {...}
}

And as follow for the launch of the HTTP server:

new SimpleRest()..registerEndpoints(new TodoEndpoint())..listen('0.0.0.0', 9000);

One might ask why an instantiated object is provided to the registerEndpoints method? This is a design point of view because the user might have to do some IoC and consequently would not want me to instantiate that Object for him.

Please, do not hesitate to open issues in case of bugs or if you think I am missing some important features. Pull requests are also welcome.

Positional parameters

It is important to understand that when the method is invoked the parameters are provided positionally as they are declared in the URI. This means that if I have the following URI - '/{id}/foo/{bar}' - my method signature has to be :

anything(HttpRequest req, String id, String bar) {...}

And cannot be :

anything(HttpRequest req, String bar, String id) {...}

In version 0.0.1, all the parameters are provided as strings and needs to be parsed manually. The support for dynamic parameter parsing is a task planned for next version (0.0.2).

Adding new HTTP method to restart

It is now also possible to add support for non supported HTTP method with the following code :

/// Adds the support for the PATCH method
class Patch extends HttpEndpoint{
  const Patch(String uri) : super(uri);
}

And this can be then be used :

class Endpoints {
  @Patch('/foo/bar')
  HttpResponse anything(HttpRequest req) {...}
}