理解cppcms中的dispatcher和mapper

问题：如何理解CPPCMS application中的dispatcher()和mapper(). 

#include <cppcms/application.h>
#include <cppcms/applications_pool.h>
#include <cppcms/service.h>
#include <cppcms/http_response.h>
#include <cppcms/url_dispatcher.h>
#include <cppcms/url_mapper.h>
#include <iostream>

class hello : public cppcms::application {
public:
  hello(cppcms::service &srv):cppcms::application(srv){

    dispatcher().assign("/number/(\\d+)", &hello::number, this, 1);
    mapper().assign("number", "/number/{1}");
    
    dispatcher().assign("/smile", &hello::smile, this);
    mapper().assign("smile", "/smile");

    dispatcher().assign("", &hello::welcome, this);
    mapper().assign("");

    mapper().root("/hello");
  }

  void number(std::string num){
    int no = atoi(num.c_str());
    response().out() << "The number is " << no << "<br/>\n";
    response().out() << "<a href='" << url("/") <<"'>Go back</a>";
  }

  void smile(){
    response().out() << ":-) <br/>\n";
    response().out() << "<a href='" << url("/") << "'>Go back</a>";
  }

  void welcome(){
    response().out() << 
      "<h1> Welcome to Page with links </h1>\n"
      "<a href='" << url("/number", 1)  << "'>1</a><br>\n"
      "<a href='" << url("/number", 15) << "'>15</a><br>\n"
      "<a href='" << url("/smile") << "' >:-)</a><br>\n";

  }
};

int main(int argc, char **argv){
  try{
    cppcms::service srv(argc, argv);
    srv.applications_pool().mount(cppcms::applications_factory<hello>());
    srv.run();
  }
  catch(std::exception const &e){
    std::cerr << e.what() << std::endl;
  }
}

 

 

问题解决：CPPCMS web application不同于PHP脚本，而是一个整体的应用程序。因此，每当接收到REQUEST时，根据一些元变量（meta-variable）如PATH_INFO, QUERY STRING等将REQUEST分配给不同的应用程序处理句柄（成员函数）。但是QUERY STRING更适合的是PHP编写的页面， PATH_INFO更适合应用在整体化的CGI应用程序上。

 

基于此，DISPATCHER这个类产生了，这个类的主要功能就是将正则表达式与成员函数进行进行绑定，当然也附带传递函数调用参数。

 

理解了dispatcher()，那如何理解mapper()呢？其实个人认为这个mapper()的实际作用不是十分大。仔细看hello类中的成员函数，里面均调用了url(std::string)语句，这个语句在api reference文档写的十分清楚，实际就是调用mapper。通过给出一个key, 可以查询到对应的正则表达式，然后通过给定的参数构建部分PATH_INFO。

 

示例： url("/number", 15) 

1. "/"作为mapper().root, = "/hello"

2. "number" 对应的value = "/number/{1}" /* mapper().assign("number", "/number/{1}"); */

3. 步骤2获取的value可以绑定一个参数，并且传递的参数15应放置在1的位置。

4. 所以最终形成path_info就是/hello/number/15.

 

当然，我说作用不大的原因是，如果CPPCMS框架不提供mapper组件时，我想大多数DEVELOPER在实际开发网站的过程中也会构建相同功能的工具吧。不过，想来cppcms的作者心是够细的，都为我们提供了如此细节的工具了。

 

当然mapper()也不是一点作用不起，我们知道CGI的RESPONSE消息有四种类型（document response, local redirect response, client redirect response, client redirect response with document)， 其中后面的三种涉及到response header域location的重建。mapper()此时无疑帮你很大忙，因为无需再次解析path_info元变量了。

 

结论：

1. dispatcher()的主要功能就是通过正则表达式匹配path_info元变量，跟应用程序的句柄进行绑定。也同时让我们了解到了作为standalone cgi application与传统分配请求到不同PHP脚本的不同之处。

2. mapper()最多算一个工具类，帮助developer轻易构建script-URI.