IOT>> mana>> 返回
项目作者： includeos

项目描述 ：
IncludeOS C++ Web Application Framework
高级语言： C++
项目地址: git://github.com/includeos/mana.git
创建时间： 2016-09-27T08:24:01Z
项目社区：https://github.com/includeos/mana
开源协议：
下载


mana

IncludeOS C++ Web Application Framework

Acorn is a web server built with Mana which demonstrates a lot of its potential.

Some insight in the implementation of mana can be found in this post.

Usage

It’s easy to get started - check out the examples.

  1. using namespace mana;
  2. using namespace std::string_literals;
  4. std::unique_ptr<Server> server;
  6. void Service::start(const std::string&)
  7. {
  8.   Router router;
  10.   // GET /
  11.   router.on_get("/", [](auto, auto res) {
  12.     res->add_body("<html><body><h1>Simple example</h1></body></html>"s);
  13.     res->send();
  14.   });
  16.   server = std::make_unique<Server>(net::Inet4::stack());
  17.   server->set_routes(router).listen(80);
  18. }

Routes

Routes is where the server end-points are defined.

  1. Router router;
  3. // GET /
  4. router.on_get("/", [] (auto req, auto res) {
  5.   // Serve index.html
  6. });
  8. // POST /users
  9. router.on_post("/users", [] (auto req, auto res) {
  10.   // Register new user
  11. });
  13. server.set_routes(router);

There is also support for named parameters in routes.

  1. // GET /users/:id
  2. router.on_get("/users/:id(\\d+)", [](auto req, auto res) {
  3.   auto id = req->params().get("id");
  4.   // Do actions according to "id"
  5.   if(id == "42")
  6.     // ...
  7. });

Middleware

Middleware are tasks which are executed before the user code defined in routes.

  1. // Declare a new middleware
  2. class MyMiddleware : public mana::Middleware {
  3.   // ...
  4. };
  6. // Add a middleware object
  7. Middleware_ptr my_mw = std::make_shared<MyMiddleware>();
  8. server.use(my_mw);

It’s also possible to just add a simple task with a lambda.

  1. // Add a middleware lambda
  2. server.use([] (auto req, auto res) {
  3.   // My custom middleware function
  4.   (*next)(); // Don't forget to call next if no response was sent!
  5. });

Psst, there is already some ready-made middleware for Mana!

Attributes

Attributes is a way to extend the Request object with additional data.

  1. // Declare a new attribute
  2. class MyAttribute : public Attribute {
  3.   // ...
  4. };
  6. // Set attribute in middleware
  7. MyMiddleware::process(auto req, auto res, auto next) {
  8.   auto attr = std::make_shared<MyAttribute>();
  9.   req->set_attribute(attr);
  10.   (*next)();
  11. }
  13. // Use attribute in route
  14. router.use("/my-route", [] (auto req, auto res) {
  15.   if(auto attr = req->get_attribute<MyAttribute>()) {
  16.     // Do things with "attr"
  17.   }
  18. });