fennec 2.0.3

Fennec is a dart web framework with the principal goal make web server side more easy and fast to develop.

Fennec is a dart web framework with the principal goal: make web server side more easy and fast to develop.

Packages

Packages	pub
fennec (core framework)	fennec
fennec_pg	fennec_pg
fennec_jwt	fennec_jwt
fennec_socket_io_server	fennec_socket_io_server

installation:

1. create a simple dart project. you can use terminal for that dart create 'projectname'
2. install the framework from pub.dev

make your first request:

call your Router

Router testRouter = Router(routerPath: '/Test');
testRouter.useMiddleware((
req, res) {
if (1 == 2) {
return Stop(res.forbidden());
}

return Next();
});
testRouter.get(path: '
/
simple1',
requestHandler: (

Request req, Response
res) {
return res.ok('ok');
}
);

Middleware

it must be a typedef MiddlewareHandler and must return always AMiddleWareResponse. here an example how to implement it:

 Future<AMiddleWareResponse> testMiddleware(Request req, Response res) async {
  if (1 == 2) {
    return Next();
  }
  return Stop(res.forbidden(
      body: {"error": "not allowed"}, contentType: ContentType.json));
}

Router Middleware

you can

use also

define a

router middleware
by.
testRouter.useMiddleware((
req, res) {
if (1 == 23) {
return MiddleWareResponse(MiddleWareResponseEnum.next);
}
res.forbidden().send('sddd');
return MiddleWareResponse(MiddleWareResponseEnum.stop);
});

testRouter.get(path: '
/
simple',
requestHandler: TestController
(
).test);

dynamic routes

here is an example hot to use dynamic routes

application.get(path: '
/dynamic_routes/@userId
'
,
requestHandler: (
req, res) {
res.ok(body:{'userId': req.pathParams['userId']},contentType = ContentType.json);
}
);

File System Routing

an example how to handle files

Future fileSystems(Request request, Response response) async {
  response.json({
    'file1': request.files.first.toString(),
  });
}

WebSocket

WebSocket is already integrated in the core of Framework.

how to use it :

WebSocketHandler webSocketHandler = WebSocketHandler();
webSocketHandler.registerWebSocketHandler(server);
webSocketHandler.clientsListener.stream.listen((
event) {
if (event.headers!.value('token') != null) {
webSocketHandler.addClient(event);
} else {
event.webSocket.addError('not allowed');
}
});
//Send data to all registred Clients
webSocketHandler.sendToAllJson({'key': 'value'});

Multithreading

Fennec Framework supports also Multithreading over isolates. To increate the number of used isolates just call the function setNumberOfIsolates. the default number of isolates is 1

example

application.setNumberOfIsolates(1
);

Start your Server and test your first Request

import 'package:fennec/fennec.dart';
import 'package:path/path.dart' as path;

import 'test.dart';

void main(List<String> arguments) async {
  Application application = Application();
  application.setPort(8000).setHost(InternetAddress.loopbackIPv4);
  TestRouter testRouter = TestRouter();
  testRouter.get(
      path: '/simple', requestHandler: TestController().test, middlewares: []);
  testRouter.get(
      path: '/simple1',
      requestHandler: (Request req, Response res) {
        res.send(req.body);
      },
      middlewares: []);
  application.addRouter(testRouter);
  application.addRoute(Route(
      path: '/show',
      requestMethod: RequestMethod.get(),
      requestHandler: (Request req, Response res) {
        res.ok().send('show received');
      },
      middlewares: [
            (req, res) {
          if (1 == 2) {
            return MiddleWareResponse(MiddleWareResponseEnum.next);
          }
          res.forbidden().send('not allowed');
          return MiddleWareResponse(MiddleWareResponseEnum.stop);
        }
      ]));

  Server server = Server(application);
  await server.startServer();
}

deploy

• heroku cloud: here is heroku-buildpack for dart and inside it an example how to deploy Fennec Framework on heroku cloud for free. to test an example you can try this two endpoints:

  • https://fennec-deploy.herokuapp.com/healthcheck/servercheck

  • https://fennec-deploy.herokuapp.com/healthcheck

• for next days, another example for aws and goolge run will be uploaded.

Benchmarks using wrk

after running this endpoint using Fennec Framework on local machine (MacBook Pro (13-inch, 2019, Two Thunderbolt 3 ports), we could gets this data:

• t: number of threads
• c: number of open connections
• d: duration of test

 @Route('/test', RequestMethod.get())
Future test(Request request, Response response) async {
  response.send('hello world');
}

wrk -t1 -c100 -d60s http://localhost:8000/example/test

• Running 1m test @ http://localhost:8000/example/test
• 1 threads and 100 connections
• Thread Stats Avg Stdev Max +/- Stdev
• Latency 6.63ms 1.83ms 86.51ms 96.81%
• Req/Sec 15.30k 1.38k 16.52k 91.17%
• 913472 requests in 1.00m, 177.72MB read
• Requests/sec: 15209.67
• Transfer/sec: 2.96MB

wrk -t10 -c100 -d60s http://localhost:8000/example/test

• Running 1m test @ http://localhost:8000/example/test
• 10 threads and 100 connections
• Thread Stats Avg Stdev Max +/- Stdev
• Latency 6.50ms 1.27ms 104.08ms 96.71%
• Req/Sec 1.55k 124.24 2.41k 87.15%
• 926903 requests in 1.00m, 180.33MB read
• Requests/sec: 15435.91
• Transfer/sec: 3.00MB

import information

Fennec Framework after with version >= 1.0.0 doesn't support more annotations because the big discussions about the library mirrors. as alernatives you can use Route or Route as showed in this example.

License

MIT