本文从设计框架角度介绍mochiweb项目源码,用于总结并备忘最近对mochiweb源码的研究学习,下面直接开始讲解:
假如用mochiweb框架新建一个erlang项目sango,则可以观察到新建的项目文件中包括sango_web.erl,从该文件的
start方法开始分析,截图如下:
需要特别留意的是当前客户端项目的loop方法以及当前客户端项目的模块名称被作为参数传入了mochiweb_http模块的
start方法,参数信息为一系列二元元组组成的列表,包含配置的服务器ip,服务器监听端口,服务器存放静态页面文件的
路径等信息,在mochiweb_http模块内对传入的参数进行了格式化处理,包括为传入参数增加不被包含的字段信息,更改
传入的loop方法格式,使得被调用的loop方法指向mochiweb_http模块的loop方法,并将传入的用户项目的loop方法
信息作为mochiweb_http的loop方法的参数以供其他进程来构造mochiweb_http模块的call_body方法参数信息,
从而转折调用sango_web模块的loop方法(详细的过程在后面会分析)。
在mochiweb_http模块内对传入的参数进行了格式化处理后会立即调用mochiweb_socket_server模块的start方法,
该start方法经过start_link方法,start_server方法的处理后,会将传入的参数转换成一个mochiweb_socket_server
记录,在start_server方法实现中会创建一个gen_server进程,该进程的进程标识符是sango_web(注意:不是mochiweb_socket_server或别的什么东西),我们接着观察mochiweb_socket_server模块的init方法,发现该
服务器进程创建了一个Socket的监听器对象,在创建监听器对象的过程中通过调用new_acceptor_pool方法,创建了
默认配置的16个Socket对象池,
观察上面截图中的Loop参数,我们可以知道它是类似
{mochiweb_http, loop, [fun (Req) ->
sango_web:loop(Req, DocRoot)
end]}
这样的值,我们跟踪观察mochiweb_acceptor模块的start_link方法,发现服务器进程创建了16个接收来自客户端socket请求信息的子进程,mochiweb_acceptor子进程一方面通过调用服务器进程的accept方法刷新服务器端持久
信息State(即调用handle_cast({accepted, Pid, Timing....)方法),另一方面通过call_loop(Loop, Socket)方法
调用mochiweb_http模块的loop方法,下面先从功能上描述mochiweb_http模块的loop方法的用途,然后再分析
其内部细节:
mochiweb_http的loop方法通过本方法的处理逻辑以及通过调用其他的辅助方法,实现从Socket中读取来自客户端
的请求头信息,然后构造Request对象,然后再通过调用用户项目sango_web模块的loop方法,再次从Socket中
提取来自客户端的请求参数,并根据请求参数的格式匹配,通过用户构造的api_bridge:handler(Path, Params)方法
来调用针对的用户项目的各个功能,当调用用户项目方法完成后,通过调用mochiweb_http模块的after_response
方法返回信息给客户端,然后再根据客户端的请求信息来判断是否关闭当前Socket;另外,前面在提到mochiweb_acceptor子进程在调用服务器进程的accepted处理方法时,会删除当前已经使用过的mochiweb_acceptor子进程,同时新建一个mochiweb_acceptor子进程并刷新服务器的State状态信息。
下面我们详细跟踪一下mochiweb_http模块的loop方法,该方法设置了Socket接受格式后,首先通过request方法
接收来自客户端的Socket请求头信息,这些请求头信息包括:Content-Type,Content-Length,Accept,Host
和User-Agent,每个头信息就是一条Socket请求信息,接收完毕请求头信息后调用call_body(Body, Req)方法,
该方法中,Req参数是新建的客户端请求信息对象,Body参数正是经过mochiweb_acceptor子进程处理后的,包含
了用户项目模块sango_web的loop方法体的信息,总之就是调用sango_web模块的loop方法。
最终,通过重重包装处理,我们回到了用户项目的loop方法,观察sango_web模块的loop方法: