1.程序入口( 项目文件 manage.py 启动):
命令行:
python manage.py runserver 0.0.0.0:8000
(参数不做过多的描述)
- django将首先执行
django.core.management.__init__.py
文件的execute_from_command_line
方法,从控制台读取参数。
2.基本参数解析(ManagementUtility):
命令行参数通过
ManagementUtility.execute()
方法解析并执行。
- 在
execute()
中值得注意的是:
-- django 会根据参数--noreload
决定是否对django.setup
进行检查,如果django.setup
未通过,那么程序就结束了(这里的修饰器的用法可以仔细看下)。
-- django 最终执行了ManagementUtility.fetch_command()
,fetch_command
收集了django程序中所有的Commond
。而和当前运行参数匹配的命令为django.contrib.staticfiles
该命令对应django/contrib/staticfiles/management/commands/runserver.py
文件。该文件中的Commond
类继承了django.core.management.commands.runserver.py
的Commond
类,添加了两个重要参数:use_static_handler
和insecure_serving
,重载了get_handler()
。
在get_handler()
中值得注意,django首先调用了get_internal_wsgi_application()
(该方法主要执行了get_wsgi_application()
,想必这个文件大家比较熟悉,在主目录下的wsgi.py
文件中也用的是这个方法获取请求处理句柄的),该方法根据use_static_handler
和insecure_serving
,决定了主要的请求处理句柄。 如果use_static_handler
值为默认值True
且django.conf.setting
为True
时,django主进程使用web服务的处理句柄类StaticFilesHandler
,否则,直接返回WSGIHandler
(关于StaticFilesHandler
和WSGIHandler
我们下次再看他们都是干啥的);StaticFilesHandler
则是WSGIHandler
的子类(该类为实现了wsgi协议的的请求处理类)。
-- django在获取命令行对应的Command
后,执行了Command.run_from_argv()
- 看了下,
django.core.management.commands.runserver.py
文件中Commond
实现BaseCommand
类,其主要参数如下(涉及到服务启动方式):
--ip/port # 服务绑定地址及端口
--use_ipv6 #是否适用IPV6 默认值为False
--use_threading #适用适用多线程 默认值为True
--use_reloader #是否适用自动重载,默认值为True
3.python及django参数处理(Common.run_from_argv()
):
第二步,django返回了和
runserver
命令匹配的Commond
,然后调用了Commond
的run_from_argv()
,其中添加了python及django设置中需要的参数。然后执行Commond
的execute()
,
4.真正的django服务启动(Common.handle()
):
Commond
的execute()
中最重要执行语句的就是self.handle(*args, **options)
。
--handle()
首先验证了传入的参数的合法性。然后执行了,Common.run()
方法,该方法提供了文件重载的方法。也就是我们在测试环境中,变更文件后进程自动重启的开启点。具体代码如下(有兴趣可以看以下):
def run(self, **options):
use_reloader = options['use_reloader']`
if use_reloader:
autoreload.main(self.inner_run, None, options`)
else:
self.inner_run(None, **options)
Common.run
最终执行django.core.management.commands.runserver.Common.inner_run()
,在该方法中,django做了错误及migration
检查,确认系统正常。
-- 最核心的启动代码如下:
handler = self.get_handler(*args, **options)
run(self.addr, int(self.port), handler,ipv6=self.use_ipv6, threading=threading, server_cls=self.server_cls)
Commond.get_handler()
获取了请求处理句柄,这个是在第二步的介绍中提到的,根据不同的配置最终获得不同的处理句柄。根据我们的启动参数,这里返回StaticFilesHandler
。然后将StaticFilesHandler
传入run()
. run方法如下
def run(addr, port, wsgi_handler, ipv6=False, threading=False, server_cls=WSGIServer):
server_address = (addr, port)
if threading:
httpd_cls = type(str('WSGIServer'), (socketserver.ThreadingMixIn, server_cls), {})
else:
httpd_cls = server_cls
httpd = httpd_cls(server_address, WSGIRequestHandler, ipv6=ipv6)
if threading:
# ThreadingMixIn.daemon_threads indicates how threads will behave on an
# abrupt shutdown; like quitting the server by the user or restarting
# by the auto-reloader. True means the server will not wait for thread
# termination before it quits. This will make auto-reloader faster
# and will prevent the need to kill the server manually if a thread
# isn't terminating correctly.
httpd.daemon_threads = True
httpd.set_app(wsgi_handler)
httpd.serve_forever()
- 这个方法传入的是
addr=0.0.0.0, prot=8000, wsgi_hander=StaticFilesHandler, ipv6=False, threading=True, server_cls=WSGIServer
。
-- 这里,示例化了句柄StaticFilesHandler
,启动了服务;如果我们启动参数含有use_threading
参数的话,会根据use_threading
的值去判断服务是否以守护进程方式启动。ok, 到目前为止,django 服务就启起来了。
感谢你的阅读:
推荐一个项目,这能让django快速进行api开发,减少请求参数验证的繁琐。
项目名称:mixrestview