HOOOS

Drogon框架的7个内建插入点

1 709 Drogon Drogon编程开发框架
Apple

内建插入点

Drogon提供了7个插入点供用户使用,当应用程序运行至插入点的时候,会依次调用用户注册的处理程序(Advice)。关于插入点的说明如下:

  • Beginning: 顾名思义,该插入点在程序开始时到达,具体地说,所有注册在这个插入点上的处理程序会在app().run()方法运行完毕后立即执行。在这个插入点上,所有的controller,filter,plugin,database client都构建完毕了,用户可以在这里得到想要的对象引用或进行一些其他初始化工作,该插入点上的advice只运行一次,调用类型是void(),注册接口是registerBeginningAdvice;

  • NewConnection: 注册到这个插入点上的处理程序会在每个新TCP连接建立时运行,Advice的调用类型是bool(const trantor::InetAddress &, const trantor::InetAddress &),其中第一个参数是TCP连接的远端地址,第二个参数是本地地址,注意返回类型是bool,如果用户返回false,相应的连接将被断开。注册的接口是registerNewConnectionAdvice;

  • HttpResponseCreation: 注册到这个插入点上的处理程序会在每个HTTP Response对象创建时运行,Advice的调用类型是void(const HttpResponsePtr &),其中的参数就是新创建的对象,用户可以在这个处理程序中对所有Response进行一些统一的操作,比如添加某个特殊的header等,这个插入点会影响所有的Response,包括404或任何drogon内部产生的错误响应,也包括应用产生的所有响应。注册的接口是registerHttpResponseCreationAdvice;

  • Sync: 这个插入点的位置在Http请求处理的最前端,用户可以在这里通过返回一个非空的Response对象来拦截这个请求,Advice调用类型是HttpRequestPtr(const HttpRequestPtr &),注册接口是registerSyncAdvice;

  • Pre-Routing: 这个插入点的位置在框架为客户端的请求寻找相应的处理器之前,Advice的调用类型有两个,void(const HttpRequestPtr &,AdviceCallback &&,AdviceChainCallback &&)和void(const HttpRequestPtr &), 前一个和Filter的doFilter方法的调用类型完全一致,实际上,它们的运行方式也是一样的(请参考过滤器),用户可以通过这种Advice拦截客户端请求或者让它通过,后一种调用类型没有拦截能力,不过消耗更低,如果用户不打算拦截,请选择这种Advice注册。注册的接口是registerPreRoutingAdvice;

  • Post-Routing: 这个插入点的位置在找到处理器之后和HTTP方法检测及过滤器处理之前,Advice的调用类型和上个插入点一致,注册接口是registerPostRoutingAdvice;

  • Pre-Handling: 这个插入点的位置在通过了所有过滤器之后和处理器处理之前,Advice的调用类型和上个插入点一致,注册接口是registerPreHandlingAdvice;

  • Post-Handling: 这个插入点的位置在处理器处理完成生成Response之后和发送给客户端之前,Advice的调用类型是oid(const HttpRequestPtr &, const HttpResponsePtr &),注册接口是registerPostHandlingAdvice;

点评评价

captcha
  • 别催我发论文

    我项目中会需要使用一些文件作为缓存或者管道,然后我可以使用Beginning插入点创建这些文件。

健康