Django 新人開發的十個注意點

時間  2019-11-06
標籤 django 新人 開發 十個 注意 欄目 Python 简体版
原文   原文鏈接

      總結一下 Django開發中，注意的事項，特別是新人，因爲水平有限，也只能到這個層次，更多模式思想性的東西，還得在開發中慢慢體會。javascript

      1.各個APP獨立，作到項目的模塊分明。說的有點大，列幾個列子優先css

    

from project.bookmark.models import Tag

     該例子將項目名稱加入其中是不合適，缺點在於：應用和項目變成了緊耦合，沒法將應用輕易變得可重用。若是未來要換一個項目名稱，那你可有得受了。html

    推薦的作法是java

1 from bookmark.models import Tag
djangoa app

    還有個例子python

1 bookmark.views.py
2 
3 from account.models import User
4 from friend.models import FriendShip
5 from bookmark.models import Tag

     該例子在bookmark app中耦合了三個模塊 account,friend,bookmark, 應該儘可能減小這樣的耦合，account,friend 這兩個模塊聯繫比較緊密，能夠合成一個。jquery

    推薦的作法:git

1 bookmark.views.py
2 
3 from account.models import FriendShip,User
4 from bookmark.models import Tag
django-app

      2. 不要硬編碼 MEDIA_ROOT,STATIS_ROOT, github

      在python中關於url的處理，有些原則，好比不要硬編碼，處理成UNIX,WINDOWS兼容的格式，和進行空格的處理等web

     

1 MEDIA_ROOT = 'E:\\test\mugshot\\'
2 STATIC_ROOT = '/VAR/TEMP/STATIC'
Django

    這種作法有不少問題，好比機器遷移，和 應用的移動都會影響。shell

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'),)
View Code

這樣的寫法比較可擴展性。

      3.不要將URL硬編碼在HTML中，

 

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

當你的項目須要將靜態文件用其餘服務器提供的時候，一般會是另一個http地址，那麼你就得把全部的/appmedia/替換成新的地址，作網站寫代碼已經夠乏味的了。

 

沒有後顧之憂的解決方法是使用{{ MEDIA_URL }}代替硬編碼的路徑：

 

 

模板上下文變量怎麼獲取到呢？請使用RequestContext便可：

 

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，有不少種方法自動來處理這個配置：

 

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

 

另外一種途徑是使用不一樣的配置文件：

 

 1 #文件名：settings_debuy.py  
 2 #包含調試模式的配置信息  
 3 #使用python manage.py runserver settings=settings_debug.py來運行項目  
 4   
 5 from settings import *  
 6   
 7 DEBUG = True  
 8   
 9 #還能夠配置更多在調試時使用的變量：）  
10
View Code

 

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

 

6，只加載一次自定義的模板標籤

 

當須要使用自定義或者第三方的模板標籤和模板過濾器時，一般要在模板中使用：

 

Python代碼 
  1. {% load template_tags %}  

 

實際狀況是，須要在全部用到自定義模板標籤和模板過濾器的模板中都使用上面的代碼，這樣就不DRY了。

 

1 from django import template  
2   
3 template.add_to_builtins('app.templatetags.custom_tag_module')

 

 

請將以上代碼放到項目啓動時能加載的模塊中（settings.py, urls.py, models.py等）便可。

 

上面代碼的做用是在項目啓動時就把自定義模板標籤或過濾器加載進來，模板中任何一個地方均可以使用它們，而不須要{% load template_tags %}。

 

7，合理配置和使用URL

 

不要將URL全都配置在一個urls.py文件中，好比：

 

 1 urlpatterns = patterns('',  
 2   url(r'^askalumini/question/$','.....registerInstitution',name='iregister'),  
 3   url(r'^askalumin/answer/$','someview.....',name='newmemberurl'),  
 4   url(r'^institution/member/$','someview.....',name="dashboardurl"),  
 5   url(r'^institution/faculty/$','editInstitute',name="editinstituteurl"),  
 6   url(r'^memeber/editprofile/$','editProfile',name="editprofileurl"),  
 7   url(r'^member/changepassword/$','changePassword',name="changepasswordurl"),  
 8   url(r'^member/forgotpassword/$','forgotPassword',name="forgotpasswordurl"),  
 9   url(r'^member/changepicture/$','changePicture',name="changepictureurl"),  
10   url(r'^member/logout/$','memeberlogout',name="logouturl"), ,  
11 )  
12

 

建議的方式是將各應用的URL配置在各自的urls.py中，這樣可使應用更容易重複使用到不一樣項目裏：

 

1 urlpatterns = patterns('',  
2   (r'^$', include('institution.urls')),  
3   (r'^institution/', include('institution.urls')),  
4   (r'^askalumini/', include('askalumini.urls')),  
5   (r'^member/', include('member.urls')),  
6 )

 

 

以下是應用askalumini的urls.py：

 

1 urlpatterns = patterns('askalumini.views',  
2   url(r'^$','askHome',name='askaluminiurl'),  
3   url(r'^questions/(?P<questionno>/d+)/$','displayQuestion',name='askquestiondisplay'),  
4   url(r'^askquestions/$','askQuestion',name='askquestionurl'),  
5   url(r'^postcomment/$','postComment',name="askquestioncomment")  
6 )
View Code

 

 

剛纔提到靜態文件路徑不要硬編碼，url的處理方式也儘可能不要硬編碼，不然當你更改一個地址時會牽涉到多處的修改，可使用一些url函數來處理。

 

在/project/askalumini/urls.py中，爲每個url定義了name，它能夠幫助咱們有效地在視圖、模板和模型中處理url，而不是硬編碼。

 

爲保證名稱的惟一，請遵守將url命名爲<appname>/<somelabel>的習慣用法。

 

舉例來講，在views.py文件中有以下代碼：

 

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

 

請改成：

 

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

 

 

在模型中使用models.permalink裝飾器來格式url：

 

1 @models.permalink  
2 def get_absolute_url(self):  
3     return ('profileurl2',(),{'userid': self.user.id})
View Code

 

 

在模板中使用url標籤代替硬編碼：

 

1 {% url askquestiondisplay 345 %}  
2 <a href="{% url askquestiondisplay 345 %}"> Ask Question </a>

 

 

8，調試

 

調試一般會藉助一些第三方工具來得到更多的運行時信息。

 

一個請求執行了多少句SQL？花了多長時間？

 

調用的哪一個模板？客戶端設置了什麼COOKIE？SESSION呢？。。。

 

你可使用django-debug-toolbar查看上面甚至更多的信息：http://github.com/robhudson/django-debug-toolbar

 

另外一個工具是Werkzeug debugger，它能夠在錯誤頁面打開python shell，讓你更方便的跟蹤錯誤信息，請訪問：http://blog.dpeepul.com/2009/07/14/python-shell-right-on-the-django-error-page/ 得到更多信息。

 

還有pdb，一個強大的調試工具：http://ericholscher.com/blog/2008/aug/31/using-pdb-python-debugger-django-debugging-series-/

 

9，瞭解pinax備用

 

django最大的優勢是代碼重用，DRY，pinax就是這樣一個平臺，包含了許多可拿來直接使用的代碼，好比openid，電子郵件驗證等等。請訪問：http://pinaxproject.com/

 

10，瞭解一些著名的第三方應用

 

1）數據庫升級工具

 

什麼是數據庫升級工具？你運行了syncdb，運行了一年以後，對模型作了更改，添加了字段，刪除了字段，要再運行syncdb嗎？或者ALTER TABLE ...？

 

django-evolutions能夠幫你完成上面的事情，但它好像不夠強壯：http://code.google.com/p/django-evolution/

 

South能很強壯地完成上面的事情，可是須要學學怎麼用：http://south.aeracode.org/

 

2）模板系統

 

django自帶的模板系統是能夠替換的，而且各自有優缺點。

 

template-utils加強了模板的比較標籤等功能 ，並提供其餘的一些實用特性：http://django-template-utils.googlecode.com/svn/trunk/docs/

 

Jinja是一個完整的第三方模板系統，能夠替換默認模板系統，它提供了許多優越的特性：http://jinja.pocoo.org/2/

 

3）第三方應用

 

django command extensions提供了不少實用的命令行功能：

 

shell_plus加載全部django模型

 

runserver_plus整合了Werkzeug調試工具

 

生成模型圖表，你能夠展現給你的老闆

 

……

 

請參考：http://ericholscher.com/blog/2008/sep/12/screencast-django-command-extensions/

 

Sorl能夠生成縮略圖：http://code.google.com/p/sorl-thumbnail/

 

…………

 

---END---

 

另外，從原文的評論裏也有很多發現：

相關文章
相關標籤/搜索
每日一句
    每一个你不满意的现在，都有一个你没有努力的曾经。
本站公眾號
   歡迎關注本站公眾號,獲取更多信息
聯繫我們 最近搜索 最新文章 沪ICP备13005482号-10 MyBatis教程 SQL 教程 MySQL教程 Java 教程 Thymeleaf 教程 Hibernate教程 Spring教程 Redis教程