Django生手需要注意的10个要点

2012-10-31

Django新手需要注意的10个要点Python代码??from?project.app.models?import?Author???缺点在于：应用和项目

Django新手需要注意的10个要点

Python代码?? Django生手需要注意的10个要点

from?project.app.models?import?Author??

缺点在于：应用和项目变成了紧耦合，无法将应用轻易变得可重用。如果将来要换一个项目名称，那你可有得受了。

推荐的做法是：

Python代码?? Django生手需要注意的10个要点

from?app.models?import?Author??

请注意，你需要将项目的路径配置在PYTHONPATH中。

2，不要硬编码MEDIA_ROOT和TEMPLATE_DIRS

项目配置文件settings.py中不要使用如下代码：

Python代码?? Django生手需要注意的10个要点

TEMPLATE_DIRS?=?(?"/home/html/project/templates",)??
MEDIA_ROOT?=?"/home/html/project/appmedia/"???

当你在部署到生产环境，或者迁移服务器的时候，就会发生问题。

推荐使用如下方式：

Python代码?? Django生手需要注意的10个要点

SITE_ROOT?=?os.path.realpath(os.path.dirname(__file__))??
MEDIA_ROOT?=?os.path.join(SITE_ROOT,?'appmedia')??
TEMPLATE_DIRS?=?(?os.path.join(SITE_ROOT,?'templates'),)??

（也可以使用abspath，跟realpath的区别请参考http://rob.cogit8.org/blog/2009/May/05/django-and-relativity-updated/?）

3，不要将静态文件的路径硬编码在模板中

模板中链接CSS，javascript或图片的时候，不建议使用如下方式：

Html代码??

<link?rel="stylesheet"?type="text/css"?href="/appmedia/amazing.css"?/>??
<script?type="text/javascript"?src="/appmedia/jquery.min.js"></script>??

当你的项目需要将静态文件用其他服务器提供的时候，通常会是另外一个http地址，那么你就得把所有的/appmedia/替换成新的地址，做网站写代码已经够乏味的了。

没有后顾之忧的解决方法是使用{{ MEDIA_URL }}代替硬编码的路径：

Html代码??

<link?rel="stylesheet"?type="text/css"?href="{{?MEDIA_URL?}}amazing.css"?/>??
<script?type="text/javascript"?src="{{?MEDIA_URL?}}jquery.min.js"></script>??

模板上下文变量怎么获取到呢？请使用RequestContext即可：

Python代码?? Django生手需要注意的10个要点

return?render_to_response("app/template.html",?{'var':?'foo'},??
context_instance=RequestContext(request))??

从RequestContext里还可以获取到当前用户等信息，更详细的介绍请参考：http://www.b-list.org/weblog/2006/jun/14/django-tips-template-context-processors/

4，不要将业务逻辑代码写到视图里

不要迷惑，虽然你可能看过很多书和例子，它们把逻辑都写在了views.py里，但请你别这么做。因为这样不利于单元测试，不利于重用代码。

那我的业务逻辑应该放哪里呢？推荐放到模型里或者单独建立一个辅助（helper）模块。

当然，从模型得到一个Author，获取Author列表的代码是可以放到视图里面的。

5，部署时别忘记将DEBUG设置成False

我们常常忘记在部署时禁用DEBUG，有很多种方法自动来处理这个配置：

Python代码?? Django生手需要注意的10个要点

import?socket??
??
if?socket.gethostname()?==?'productionserver.com':??
????DEBUG?=?False??
else:??
????DEBUG?=?True???

此方法请参考：http://nicksergeant.com/blog/django/automatically-setting-debug-your-django-app-based-server-hostname

另一种途径是使用不同的配置文件：

Python代码?? Django生手需要注意的10个要点

#文件名：settings_debuy.py??
#包含调试模式的配置信息??
#使用python?manage.py?runserver?settings=settings_debug.py来运行项目??
??
from?settings?import?*??
??
DEBUG?=?True??
??
#还可以配置更多在调试时使用的变量：）??

此方法请参考：http://blog.dpeepul.com/2009/07/02/from-now-you-will-never-forget-to-put-debug-true-in-django-production-environment/

6，只加载一次自定义的模板标签

当需要使用自定义或者第三方的模板标签和模板过滤器时，通常要在模板中使用：

Python代码?? Django生手需要注意的10个要点

{%?load?template_tags?%}??

实际情况是，需要在所有用到自定义模板标签和模板过滤器的模板中都使用上面的代码，这样就不DRY了。

Python代码?? Django生手需要注意的10个要点

from?django?import?template??
??
template.add_to_builtins('app.templatetags.custom_tag_module')??

请将以上代码放到项目启动时能加载的模块中（settings.py, urls.py, models.py等）即可。

上面代码的作用是在项目启动时就把自定义模板标签或过滤器加载进来，模板中任何一个地方都可以使用它们，而不需要{% load template_tags %}。

7，合理配置和使用URL

不要将URL全都配置在一个urls.py文件中，比如：

Python代码?? Django生手需要注意的10个要点

urlpatterns?=?patterns('',??
??url(r'^askalumini/question/$','.....registerInstitution',name='iregister'),??
??url(r'^askalumin/answer/$','someview.....',name='newmemberurl'),??
??url(r'^institution/member/$','someview.....',name="dashboardurl"),??
??url(r'^institution/faculty/$','editInstitute',name="editinstituteurl"),??
??url(r'^memeber/editprofile/$','editProfile',name="editprofileurl"),??
??url(r'^member/changepassword/$','changePassword',name="changepasswordurl"),??
??url(r'^member/forgotpassword/$','forgotPassword',name="forgotpasswordurl"),??
??url(r'^member/changepicture/$','changePicture',name="changepictureurl"),??
??url(r'^member/logout/$','memeberlogout',name="logouturl"),?,??
)??

建议的方式是将各应用的URL配置在各自的urls.py中，这样可以使应用更容易重复使用到不同项目里：

Python代码?? Django生手需要注意的10个要点

urlpatterns?=?patterns('',??
??(r'^$',?include('institution.urls')),??
??(r'^institution/',?include('institution.urls')),??
??(r'^askalumini/',?include('askalumini.urls')),??
??(r'^member/',?include('member.urls')),??
)??

如下是应用askalumini的urls.py：

Python代码?? Django生手需要注意的10个要点

urlpatterns?=?patterns('askalumini.views',??
??url(r'^$','askHome',name='askaluminiurl'),??
??url(r'^questions/(?P<questionno>\d+)/$','displayQuestion',name='askquestiondisplay'),??
??url(r'^askquestions/$','askQuestion',name='askquestionurl'),??
??url(r'^postcomment/$','postComment',name="askquestioncomment")??
)??

刚才提到静态文件路径不要硬编码，url的处理方式也尽量不要硬编码，否则当你更改一个地址时会牵涉到多处的修改，可以使用一些url函数来处理。

在/project/askalumini/urls.py中，为每一个url定义了name，它可以帮助我们有效地在视图、模板和模型中处理url，而不是硬编码。

为保证名称的唯一，请遵照将url命名为<appname>/<somelabel>的习惯用法。

举例来说，在views.py文件中有如下代码：

Python代码?? Django生手需要注意的10个要点

HttpResponseRedirect("/askalumini/questions/54")??

请改为：

Python代码?? Django生手需要注意的10个要点

from?django.core.urlresolvers?import?reverse??
HttpResponseRedirect(reverse('askquestiondisplay',kwargs={'questionno':q.id}))???

在模型中使用models.permalink装饰器来格式url：

Python代码?? Django生手需要注意的10个要点

@models.permalink??
def?get_absolute_url(self):??
????return?('profileurl2',(),{'userid':?self.user.id})??

在模板中使用url标签代替硬编码：

Html代码?

热点排行

编程

Django生手需要注意的10个要点