一、基本配置
1.1、创建django程序
- 终端命令:django-admin startproject [mysite]
- IDE创建Django程序时,本质上都是自动执行上述命令
其他常用命令:
python manage.py runserver 0.0.0.0
python manage.py startapp appname
python manage.py syncdb
python manage.py makemigrations
python manage.py migrate
python manage.py createsuperuser
1.2、程序目录
1.3、配置文件
1、数据库
1
2
3
4
5
6
7
8
9
10
|
DATABASES
=
{
'default'
: {
'ENGINE'
:
'django.db.backends.mysql'
,
'NAME'
:
'dbname'
,
'USER'
:
'root'
,
'PASSWORD'
:
'xxx'
,
'HOST'
: '',
'PORT'
: '',
}
}
|
1
2
3
4
5
6
|
# 由于Django内部连接MySQL时使用的是MySQLdb模块,而python3中还无此模块,所以需要使用pymysql来代替
# 如下设置放置的与project同名的配置的 __init__.py文件中
import
pymysql
pymysql.install_as_MySQLdb()
|
2、模版
1
2
3
|
TEMPLATE_DIRS
=
(
os.path.join(BASE_DIR,
'templates'
),
)
|
3、静态文件
1
2
3
|
STATICFILES_DIRS
=
(
os.path.join(BASE_DIR,
'static'
),
)
|
4、admin后台管理中文显示
'django.contrib.sessions.middleware.SessionMiddleware',
'django.middleware.locale.LocaleMiddleware', # 设置admin为中文(这个位置是固定的),不能放在'....SessionMiddleware'之前,也不能放在'...CommonMiddleware'之后
'django.middleware.common.CommonMiddleware',
二、路由系统
2.1、单一路由对应
1
|
url(r
'^index$'
, views.index),
|
2.2、基于正则的路由
1
2
|
url(r
'^index/(\d*)'
, views.index),
url(r
'^manage/(?P<name>\w*)/(?P<id>\d*)'
, views.manage),
|
** 注意:使用带固定参数的路由时,需要相当于在views函数中固定死了形参名称,形参名称与正则路由中的名称必须一致,否则会提示函数参数出错,如下:
app0目录下的urls.py定义如下正则路由:
url(r'^test-(?P<user>\w*)-(?P<pid>\d*)$', views.regex_additional_parameter),
app0目录下的views.py定义的函数regex_additional_parameter的参数就必须是user, pid,不能是别的_user, _pid等
def regex_additional_parameter(request, user, pid):
print(user, pid)
return render(request, 'app0/regex_additional_parameter.html', {'user': user, 'pid': pid}, )
否则的话:
TypeError at /app0/test-root-123123
regex_additional_parameter() got an unexpected keyword argument 'user'
Request Method: | GET |
---|---|
Request URL: | http://127.0.0.1:8000/app0/test-root-123123 |
Django Version: | 1.11.7 |
Exception Type: | TypeError |
Exception Value: | regex_additional_parameter() got an unexpected keyword argument 'user' |
Exception Location: | /Library/Frameworks/Python.framework/Versions/3.6/lib/python3.6/site-packages/django/core/handlers/base.py in _get_response, line 185 |
Python Executable: | /Library/Frameworks/Python.framework/Versions/3.6/bin/python3.6 |
2.3、添加额外的参数
1
|
url(r
'^manage/(?P<name>\w*)'
, views.manage,{
'id'
:
333
}),
|
2.4、为路由映射设置名称
1
2
|
url(r
'^home'
, views.home, name
=
'h1'
),
url(r
'^index/(\d*)'
, views.index, name
=
'h2'
),
|
设置名称之后,可以在不同的地方调用,如:
- 模板中使用生成URL {% url 'h2' 2012 %}
- 函数中使用生成URL reverse('h2', args=(2012,)) 路径:django.urls.reverse
- Model中使用获取URL 自定义get_absolute_url() 方法,kwargs={'nid': self.id}中的nid必须与views.py函数中的参数名称一致。
class NewType(models.Model): caption = models.CharField(max_length=16) def get_absolute_url(self): """ 为每个对象生成一个URL 应用:在对象列表中生成查看详细的URL,使用此方法即可!!! :return: """ # return '/%s/%s' % (self._meta.db_table, self.id) # 或 from django.urls import reverse return reverse('h1', kwargs={'nid': self.id})
获取请求匹配成功的URL信息:request.resolver_match
2.5、根据app对路由规则进行分类
1
|
url(r
'^web/'
,include(
'web.urls'
)),
|
2.6、命名空间
在学习django的过程中,最为惊奇的就是url的配置。
a. project.urls.py
1
2
3
4
5
6
|
from
django.conf.urls
import
url,include
urlpatterns
=
[
url(r
'^a/'
, include(
'app01.urls'
, namespace
=
'author-polls'
)),
url(r
'^b/'
, include(
'app01.urls'
, namespace
=
'publisher-polls'
)),
]
|
b. app01.urls.py
1
2
3
4
5
6
7
|
from
django.conf.urls
import
url
from
app01
import
views
app_name
=
'app01'
urlpatterns
=
[
url(r
'^(?P<pk>\d+)/$'
, views.detail, name
=
'detail'
)
]
|
c. app01.views.py
1
2
3
|
def
detail(request, pk):
print
(request.resolver_match)
return
HttpResponse(pk)
|
以上定义带命名空间的url之后,使用name生成URL时候,应该如下:
- v = reverse('app01:detail', kwargs={'pk':11})
- {% url 'app01:detail' pk=12 pp=99 %}
django中的路由系统和其他语言的框架有所不同,在django中每一个请求的url都要有一条路由映射,这样才能将请求交给对应view中的函数去处理。其他大部分的Web框架则是对一类的url请求做一条路由映射,从而是路由系统变得简洁。
通过反射机制,为django开发一套动态的路由系统Demo: 点击下载
2.7、当存在多个app的时候,恰好还有同名模版怎么办
(先给方法,再讲原理)
.步骤
1.确定新增的这个app在settings.py的INSTALLED_APPS里面已经注册好了
2.确定setting.py里面的TEMPLATES中的APP_DIRS设置为True
3.在app下新建文件夹templates,在templates里面建立app同名文件夹,再放入html模版
4.引用模版的时候,采用”appname/index.html” 这种方式即可
.原理
我用的是Django1.8版本
Django模板载入有两种模式:
- django.template.loaders.filesystem.Loader 它会遍历所有app中的templates然后找到符合名字的就返回
- django.template.loaders.app_directories.Loader 它会从app对应的templates目录中查找要渲染的模板文件,即使找不到也不去其他app里面找
通识:通常在APP各自的templates目录中保存APP特定的模板,并不直接在APP对应templates目录中直接存放模板文件本身,而是在该目录中在创建一层以APP名称命名的目录,比如APP名称为sqlreview则存放该APP模板的目录为…/sqlreview/templates/sqlreview/,在指定要渲染的模板时可以通过模板文件的上一层目录来限定模板文件,以避免混淆,这实际上是提供了一个命名空间。比如return render(request, ‘sqlreview/base.html’,context),可以在/var/www/site/mycitsm/sqlreview/templates目录中找到该模板。这样便不用担心Django载入的模板究竟是不是对的、需要的那个模板。
Django1.8中 进行如下设置
TEMPLATES = [
{
'BACKEND': 'django.template.backends.django.DjangoTemplates',
'DIRS': [],
'APP_DIRS': True, 'OPTIONS': { 'context_processors': [ 'django.template.context_processors.debug', 'django.template.context_processors.request', 'django.template.context_processors.media', 'django.contrib.auth.context_processors.auth', 'django.contrib.messages.context_processors.messages', ], }, }, ]
APP_DIRS的值设置为TRUE,表示启用django.template.loaders.app_directories.Loader,DIRS为空即可.
如果不设置APP_DIRS或者设置为False,则启用django.template.loaders.filesystem.Loader模式,这个模式需要把DIRS设置好,要不然找不到任何模版
三、模板
3.1、模版的执行
模版的创建过程,对于模版,其实就是读取模版(其中嵌套着模版标签),然后将 Model 中获取的数据插入到模版中,最后将信息返回给用户。
def current_datetime(request): now = datetime.datetime.now() html = "<html><body>It is now %s.</body></html>" % now return HttpResponse(html)
from django import template
t = template.Template('My name is {{ name }}.')
c = template.Context({'name': 'Adrian'})
print t.render(c)
import datetime
from django import template
import DjangoDemo.settings
now = datetime.datetime.now()
fp = open(settings.BASE_DIR+'/templates/Home/Index.html')
t = template.Template(fp.read())
fp.close()
html = t.render(template.Context({'current_date': now}))
return HttpResponse(html)
from django.template.loader import get_template
from django.template import Context
from django.http import HttpResponse
import datetime
def current_datetime(request):
now = datetime.datetime.now()
t = get_template('current_datetime.html')
html = t.render(Context({'current_date': now}))
return HttpResponse(html)
return render_to_response('Account/Login.html',data,context_instance=RequestContext(request))
3.2、模版语言
模板中也有自己的语言,该语言可以实现数据展示
- {{ item }}
- {% for item in item_list %}
<a>{{ item }}</a>
{% endfor %}
for loop.counter
for loop.first
for loop.last
- {% if ordered_warranty %}
{% else %}
{% endif %}
- 母板:{% block title %}
{% endblock %}
- 子板:{% extends "base.html" %}
{% block title %}
...
{% endblock %}
- 帮助方法:
{{ item.event_start|date:"Y-m-d H:i:s"}}
{{ bio|truncatewords:"30" }}
{{ my_list|first|upper }}
{{ name|lower }}
3.3、自定义simple_tag
a、在app中创建templatetags模块
b、创建任意 .py 文件,如:xx.py
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
|
#!/usr/bin/env python
#coding:utf-8
from
django
import
template
from
django.utils.safestring
import
mark_safe
register
=
template.Library()
@register
.simple_tag
def
my_simple_time(v1,v2,v3):
return
v1
+
v2
+
v3
@register
.simple_tag
def
my_input(
id
,arg):
result
=
"<input type='text' id='%s' class='%s' />"
%
(
id
,arg,)
return
mark_safe(result)
|
c、在使用自定义simple_tag的html文件中导入之前创建的 xx.py 文件名
1
|
{
%
load xx
%
}
|
d、使用simple_tag
1
2
|
{
%
my_simple_time
1
2
3
%
}
{
%
my_input
'id_username'
'hide'
%
}
|
e、在settings中配置当前app,不然django无法找到自定义的simple_tag
1
2
3
4
5
6
7
8
9
|
INSTALLED_APPS
=
(
'django.contrib.admin'
,
'django.contrib.auth'
,
'django.contrib.contenttypes'
,
'django.contrib.sessions'
,
'django.contrib.messages'
,
'django.contrib.staticfiles'
,
'app01'
,
)
|
更多见文档:https://docs.djangoproject.com/en/1.10/ref/templates/language/
四、中间件
django 中的中间件(middleware),在django中,中间件其实就是一个类,在请求到来和结束后,django会根据自己的规则在合适的时机执行中间件中相应的方法。
在django项目的settings模块中,有一个 MIDDLEWARE_CLASSES 变量,其中每一个元素就是一个中间件,如下图。
****中间件路径:与mange.py在同一目录下的文件夹 wupeiqi/middleware下的auth.py文件中的Authentication类
****也可以放在app下面,如:在app0目录下面的文件夹app0mid/middleware下的custom.py文件中的RequestExecute类,对应settings.py中,中间件注册如下:
'app0.app0mid.middleware.custom.RequestExecute',
4.1、中间件中可以定义四个方法,分别是:
- process_request(self,request)
- process_view(self, request, callback, callback_args, callback_kwargs)
- process_template_response(self,request,response)
- process_exception(self, request, exception)
- process_response(self, request, response)
以上方法的返回值可以是None和HttpResonse对象,如果是None,则继续按照django定义的规则向下执行,如果是HttpResonse对象,则直接将该对象返回给用户。
4.2、自定义中间件
1、创建中间件类
1
2
3
4
5
6
7
8
9
10
11
12
|
class
RequestExeute(
object
):
def
process_request(
self
,request):
pass
def
process_view(
self
, request, callback, callback_args, callback_kwargs):
i
=
1
pass
def
process_exception(
self
, request, exception):
pass
def
process_response(
self
, request, response):
return
response
|
2、注册中间件
1
2
3
4
5
6
7
8
9
10
|
MIDDLEWARE_CLASSES
=
(
'django.contrib.sessions.middleware.SessionMiddleware'
,
'django.middleware.common.CommonMiddleware'
,
'django.middleware.csrf.CsrfViewMiddleware'
,
'django.contrib.auth.middleware.AuthenticationMiddleware'
,
'django.contrib.auth.middleware.SessionAuthenticationMiddleware'
,
'django.contrib.messages.middleware.MessageMiddleware'
,
'django.middleware.clickjacking.XFrameOptionsMiddleware'
,
'wupeiqi.middleware.auth.RequestExeute'
,
)
|
五、admin
django amdin是django提供的一个后台管理页面,该管理页面提供完善的html和css,使得你在通过Model创建完数据库表之后,就可以对数据进行增删改查,而使用django admin 则需要以下步骤:
- 创建后台管理员
- 配置url
- 注册和配置django admin后台管理页面
1、创建后台管理员
1
|
python manage.py createsuperuser
|
2、配置后台管理url
1
|
url(r
'^admin/'
, include(admin.site.urls))
|
3、注册和配置django admin 后台管理页面
*设置后台为中文:
'django.contrib.sessions.middleware.SessionMiddleware',
'django.middleware.locale.LocaleMiddleware', # 一定放在django.contrib.sessions.middleware.SessionMiddleware之后,设置admin管理界面为中文
*设置在页面中显示的字段名称:
1 class NewType(models.Model): 2 caption = models.CharField(max_length=16, verbose_name='用户名') 3 pwd = models.CharField(max_length=64, verbose_name='密码') 4 5 def __str__(self): # 显示每条记录的名称而不是NewType object 6 return self.caption 7 8 # def __unicode__(self): # 在Python3.6.1中不生效 9 # return self.pwd 10 class Meta: 11 verbose_name = '用户信息表' # 设置数据表的显示名称 12 verbose_name_plural = '用户信息表'
1 from django.contrib import admin 2 from .models import NewType 3 4 # Register your models here. 5 6 7 class NewTypeAdmin(admin.ModelAdmin): 8 list_display = ('id', 'caption', 'pwd') # 查询结果中显示的字段 9 search_fields = ('caption', ) # 设置查询字段 10 list_filter = ('caption', 'id', ) # 设置最右边的过滤器 11 12 13 admin.site.register(NewType, NewTypeAdmin)
a、在admin中执行如下配置
1
2
3
4
5
6
7
8
|
from
django.contrib
import
admin
from
app01
import
models
admin.site.register(models.UserType)
admin.site.register(models.UserInfo)
admin.site.register(models.UserGroup)
admin.site.register(models.Asset)
|
b、设置数据表名称
1
2
3
4
5
6
|
class
UserType(models.Model):
name
=
models.CharField(max_length
=
50
)
class
Meta:
verbose_name
=
'用户类型'
verbose_name_plural
=
'用户类型'
|
c、打开表之后,设定默认显示,需要在model中作如下配置
1
2
3
4
5
|
class
UserType(models.Model):
name
=
models.CharField(max_length
=
50
)
def
__unicode__(
self
):
return
self
.name
|
1
2
3
4
5
6
7
8
9
10
11
12
|
from
django.contrib
import
admin
from
app01
import
models
class
UserInfoAdmin(admin.ModelAdmin):
list_display
=
(
'username'
,
'password'
,
'email'
)
admin.site.register(models.UserType)
admin.site.register(models.UserInfo,UserInfoAdmin)
admin.site.register(models.UserGroup)
admin.site.register(models.Asset)
|
d、为数据表添加搜索功能
1
2
3
4
5
6
7
8
9
10
11
12
|
from
django.contrib
import
admin
from
app01
import
models
class
UserInfoAdmin(admin.ModelAdmin):
list_display
=
(
'username'
,
'password'
,
'email'
)
search_fields
=
(
'username'
,
'email'
)
admin.site.register(models.UserType)
admin.site.register(models.UserInfo,UserInfoAdmin)
admin.site.register(models.UserGroup)
admin.site.register(models.Asset)
|
e、添加快速过滤
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
|
from
django.contrib
import
admin
from
app01
import
models
class
UserInfoAdmin(admin.ModelAdmin):
list_display
=
(
'username'
,
'password'
,
'email'
)
search_fields
=
(
'username'
,
'email'
)
list_filter
=
(
'username'
,
'email'
)
admin.site.register(models.UserType)
admin.site.register(models.UserInfo,UserInfoAdmin)
admin.site.register(models.UserGroup)
admin.site.register(models.Asset)
|
更多:http://docs.30c.org/djangobook2/chapter06/